Worst Phobos documentation evar!

[Andrei Alexandrescu via Digitalmars-d]

On 12/30/14 10:19 AM, H. S. Teoh via Digitalmars-d wrote:
> On Mon, Dec 29, 2014 at 05:45:08PM -0800, Andrei Alexandrescu via Digitalmars-d wrote:
>> On 12/29/14 3:47 PM, H. S. Teoh via Digitalmars-d wrote:
>>> On Mon, Dec 29, 2014 at 11:12:54PM +0000, Adam D. Ruppe via Digitalmars-d wrote:
>>>> On Monday, 29 December 2014 at 23:11:09 UTC, Walter Bright wrote:
>>>>> $(TROW all          , `all!"a > 0"([1, 2, 3, 4])` returns `true`  )
>>>>
>>>> Would that still work if the first column was something like (0,0) -
>>>> including a comma?
>>>>
>>>> I've advocated nicer macros before, ddoc's recursive expansion makes
>>>> for a lot of nice options, but the comma being a separator kinda
>>>> worries me.
>>>
>>> We've already had to resort to $(COMMA) hacks to work around comma
>>> issues in Phobos docs. :-(
>>
>> That's to be expected from any macro system.
>>
>>> Not to mention that as it stands, ddoc is only really convenient for
>>> HTML output; while it's certainly *possible* to target it for non-HTML
>>> output, it's a pain. Take LaTeX, for example.
>>
>> I have successfully generated LaTeX from dlang.org and phobos.
>
> Of what quality?

Excellent.

> Have you actually looked at the LaTeX output to see if
> it's actually correct?

Of course.

> I doubt it's actually 100% correct.

It is. https://github.com/D-Programming-Language/dlang.org/pull/736.

Destroyed?


Andrei