January 10, 2015 Re: Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Vladimir Panteleev | On Wednesday, 7 January 2015 at 08:46:41 UTC, Vladimir Panteleev wrote: > * I still have reservations about using Disqus. I'm quite happy with the self hosted isso comments on my blog. https://code.dawg.eu/reducing-vibed-turnaround-time-part-2-less-compiling.html#isso-thread |
January 11, 2015 Re: Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Andrei Alexandrescu | On 1/9/15 4:17 PM, Andrei Alexandrescu wrote:
> On 1/9/15 12:59 PM, Jacob Carlborg wrote:
>> On 2015-01-09 20:46, Andrei Alexandrescu wrote:
>>
>>> Stuff's up! http://dlang.org/library-prerelease/core/stdc/complex.html.
>>> I couldn't get rid of the darn space between the header name and the
>>> period. -- Andrei
>>
>> Is it just me or are the actual declarations missing?
>>
> Oh yah :o). Steve? -- Andrei
Apparently, the documentation generator ignores items that are tagged as documented but without any substance.
If I compile a simple doc with a "///" before an item, it does show up when I do dmd -D. So I have no idea how to make it work for this new doc system.
-Steve
|
January 11, 2015 Re: Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Steven Schveighoffer | On 1/11/15 11:26 AM, Steven Schveighoffer wrote:
> On 1/9/15 4:17 PM, Andrei Alexandrescu wrote:
>> On 1/9/15 12:59 PM, Jacob Carlborg wrote:
>>> On 2015-01-09 20:46, Andrei Alexandrescu wrote:
>>>
>>>> Stuff's up! http://dlang.org/library-prerelease/core/stdc/complex.html.
>>>> I couldn't get rid of the darn space between the header name and the
>>>> period. -- Andrei
>>>
>>> Is it just me or are the actual declarations missing?
>>>
>> Oh yah :o). Steve? -- Andrei
>
> Apparently, the documentation generator ignores items that are tagged as
> documented but without any substance.
>
> If I compile a simple doc with a "///" before an item, it does show up
> when I do dmd -D. So I have no idea how to make it work for this new doc
> system.
Martin Nowak? Sönke Ludwig?
Andrei
|
January 12, 2015 Re: Ready to make page-per-item ddocs the default? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Andrei Alexandrescu | On Sunday, 11 January 2015 at 19:52:42 UTC, Andrei Alexandrescu wrote: > On 1/11/15 11:26 AM, Steven Schveighoffer wrote: >> On 1/9/15 4:17 PM, Andrei Alexandrescu wrote: >>> On 1/9/15 12:59 PM, Jacob Carlborg wrote: >>>> On 2015-01-09 20:46, Andrei Alexandrescu wrote: >>>> >>>>> Stuff's up! http://dlang.org/library-prerelease/core/stdc/complex.html. >>>>> I couldn't get rid of the darn space between the header name and the >>>>> period. -- Andrei >>>> >>>> Is it just me or are the actual declarations missing? >>>> >>> Oh yah :o). Steve? -- Andrei >> >> Apparently, the documentation generator ignores items that are tagged as >> documented but without any substance. >> >> If I compile a simple doc with a "///" before an item, it does show up >> when I do dmd -D. So I have no idea how to make it work for this new doc >> system. > > Martin Nowak? Sönke Ludwig? > > Andrei That's a feature, not a bug ! (tm) I think what's going on is that `--only-documented` is somehow specified. I had a glance at dlang.org and couldn't find the flag, but it's present by default if you build with dub, and I have no idea how Phobos' ddox are build ATM. `--only-documented` filters everything that have an empty comment out (https://github.com/rejectedsoftware/ddox/blob/master/source/ddox/main.d#L193). Which looks like a bug (or at least, something that has been overlooked), as dmd differentiate between empty comment and no comment. |
Copyright © 1999-2021 by the D Language Foundation