January 06, 2015 Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Let's crowdsource the review. Please check the entries linked from here: http://dlang.org/library/index.html. Andrei |
January 06, 2015 Re: Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Andrei Alexandrescu | On Tuesday, 6 January 2015 at 22:43:45 UTC, Andrei Alexandrescu wrote:
> Let's crowdsource the review. Please check the entries linked from here: http://dlang.org/library/index.html.
>
> Andrei
Is it intentional for all of the stdc pages to be empty?
|
January 07, 2015 Re: Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Andrei Alexandrescu | http://dlang.org/library/core/math/ldexp.html "Compute n * 2⊃" Huh? |
January 07, 2015 Re: Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Posted in reply to weaselcat | On Tuesday, 6 January 2015 at 23:44:30 UTC, weaselcat wrote:
> Is it intentional for all of the stdc pages to be empty?
I think it's intentional that they don't duplicate the documentation for those headers, but we probably should add links to pages that document the C headers.
|
January 07, 2015 Re: Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Andrei Alexandrescu | std.string looks fine only the indexOfNeither and lastIndexOfNeither are missing |
January 07, 2015 Re: Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Danny | On Wednesday, 7 January 2015 at 00:06:28 UTC, Danny wrote: > http://dlang.org/library/core/math/ldexp.html > > "Compute n * 2⊃" > > Huh? Weird. It's `Compute n * 2$(SUP exp)` in the source[1]. SUP is a locally defined macro. Maybe ddox doesn't like local macros? 1. https://github.com/D-Programming-Language/druntime/blob/v2.066.1/src/core/math.d#L96 |
January 07, 2015 Re: Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Robert burner Schadek | On 1/6/15 4:26 PM, Robert burner Schadek wrote:
> std.string looks fine only the indexOfNeither and lastIndexOfNeither are
> missing
Could you please fix -- thanks! -- Andrei
|
January 07, 2015 Re: Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Brad Anderson | On 1/6/15 4:42 PM, Brad Anderson wrote: > On Wednesday, 7 January 2015 at 00:06:28 UTC, Danny wrote: >> http://dlang.org/library/core/math/ldexp.html >> >> "Compute n * 2⊃" >> >> Huh? > > Weird. > > It's `Compute n * 2$(SUP exp)` in the source[1]. SUP is a locally > defined macro. Maybe ddox doesn't like local macros? > > 1. > https://github.com/D-Programming-Language/druntime/blob/v2.066.1/src/core/math.d#L96 Yah, looks like a problem with ddox. Anyhow for now I fixed by using SUPERSCRIPT. https://github.com/D-Programming-Language/druntime/commit/8f655bbdd8f7aa77907053c918d78d2286c93ab2 http://dlang.org/library-prerelease/core/math/ldexp.html Andrei |
January 07, 2015 Re: Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Posted in reply to weaselcat | On 1/6/15 3:44 PM, weaselcat wrote:
> On Tuesday, 6 January 2015 at 22:43:45 UTC, Andrei Alexandrescu wrote:
>> Let's crowdsource the review. Please check the entries linked from
>> here: http://dlang.org/library/index.html.
>>
>> Andrei
>
> Is it intentional for all of the stdc pages to be empty?
It's a somewhat unfortunate fallout of the level of granularity. I think each of these headers should include a standard text and a link to some good documentation in C-land. -- Andrei
|
January 07, 2015 Re: Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Andrei Alexandrescu | On 1/6/15 5:43 PM, Andrei Alexandrescu wrote:
> Let's crowdsource the review. Please check the entries linked from here:
> http://dlang.org/library/index.html.
std.algorithm has many of the "descriptions" showing samples. Also, I know the table at the top is to make things easier for standard ddoc, should that be removed?
BTW, I'm all for the docs to be switched. Just the cross-referencing alone is worth it.
-Steve
|
Copyright © 1999-2021 by the D Language Foundation