Thread overview
executeShell signature in documentation
Nov 27, 2018
Andre Pany
Nov 27, 2018
H. S. Teoh
Nov 28, 2018
Seb
Nov 29, 2018
Andre Pany
Nov 27, 2018
Adam D. Ruppe
November 27, 2018
Hi,
While searching for "dlang executeShell" the first hit is: https://dlang.org/library/std/process/execute_shell.html
The signature is rather strange: ...const(string[string]) env = cast(const(string[string]))null,
  Config config = cast(Config)0,
  ulong maxOutput = 18446744073709551615LU...

If I open the documentation by starting from dlang.org there is a different signature shown, a lot more readable:
...const string[string] env = null, Config config = Config.none, size_t maxOutput = size_t.max...

Could that be fixed?

Kind regards
Andre
November 27, 2018
On Tue, Nov 27, 2018 at 06:48:00PM +0000, Andre Pany via Digitalmars-d wrote:
> Hi,
> While searching for "dlang executeShell" the first hit is:
> https://dlang.org/library/std/process/execute_shell.html
> The signature is rather strange: ...const(string[string]) env =
> cast(const(string[string]))null,
>   Config config = cast(Config)0,
>   ulong maxOutput = 18446744073709551615LU...
> 
> If I open the documentation by starting from dlang.org there is a
> different signature shown, a lot more readable:
> ...const string[string] env = null, Config config = Config.none, size_t
> maxOutput = size_t.max...
> 
> Could that be fixed?
[...]

Ouch. That needs to be fixed.  Please file a bug:

	https://issues.dlang.org/enter_bug.cgi


T

-- 
It only takes one twig to burn down a forest.
November 27, 2018
On Tuesday, 27 November 2018 at 18:48:00 UTC, Andre Pany wrote:
> Hi,
> While searching for "dlang executeShell"

If searching for D documentation, use my website instead.

http://dpldocs.info/executeShell

It is reasonably legible there. Along with everything else being reasonably legible.
November 28, 2018
On Tuesday, 27 November 2018 at 18:54:05 UTC, H. S. Teoh wrote:
> On Tue, Nov 27, 2018 at 06:48:00PM +0000, Andre Pany via Digitalmars-d wrote:
>> Hi,
>> While searching for "dlang executeShell" the first hit is:
>> https://dlang.org/library/std/process/execute_shell.html
>> The signature is rather strange: ...const(string[string]) env =
>> cast(const(string[string]))null,
>>   Config config = cast(Config)0,
>>   ulong maxOutput = 18446744073709551615LU...
>> 
>> If I open the documentation by starting from dlang.org there is a
>> different signature shown, a lot more readable:
>> ...const string[string] env = null, Config config = Config.none, size_t
>> maxOutput = size_t.max...
>> 
>> Could that be fixed?
> [...]
>
> Ouch. That needs to be fixed.  Please file a bug:
>
> 	https://issues.dlang.org/enter_bug.cgi
>
>
> T

This is the ddox build of dlang.org and thus a bug in ddox and should be filled there accordingly:

https://github.com/rejectedsoftware/ddox

November 29, 2018
On Wednesday, 28 November 2018 at 12:09:11 UTC, Seb wrote:
> On Tuesday, 27 November 2018 at 18:54:05 UTC, H. S. Teoh wrote:
>> On Tue, Nov 27, 2018 at 06:48:00PM +0000, Andre Pany via Digitalmars-d wrote:
>>> [...]
>> [...]
>>
>> Ouch. That needs to be fixed.  Please file a bug:
>>
>> 	https://issues.dlang.org/enter_bug.cgi
>>
>>
>> T
>
> This is the ddox build of dlang.org and thus a bug in ddox and should be filled there accordingly:
>
> https://github.com/rejectedsoftware/ddox

Thanks a lot. Issue https://github.com/rejectedsoftware/ddox/issues/217 created.

Kind regards
André