Ready to make page-per-item ddocs the default?

[Mathias LANG via Digitalmars-d]

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.