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

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

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

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.