Improved Phobos dox

[Andrei Alexandrescu]

On 9/15/13 9:53 PM, H. S. Teoh wrote:
> On Mon, Sep 16, 2013 at 06:15:35AM +0200, deadalnix wrote:
>> On Sunday, 15 September 2013 at 18:38:54 UTC, Sönke Ludwig wrote:
>>> Am 15.09.2013 19:20, schrieb Walter Bright:
>>>> On 9/15/2013 12:53 AM, Vladimir Panteleev wrote:
>>>>> What happened with Ddox? This looks like an improvement in both
>>>>> function and aesthetics:
>>>>>
>>>>> http://vibed.org/temp/phobos/std/array.html
>>>>
>>>> It doesn't document the parameters, return type, and doesn't
>>>> recognize embedded hyperlinks.
>>>
>>> Just as a reminder, this is the current version:
>>> http://vibed.org/temp/d-programming-language.org/phobos/std/array.html
>>
>> I'm sold, that is awesome !
>
> Me too.  Why aren't we working towards that, instead of trying to cook
> up yet another hack on top of the current poor state of documentation?

https://github.com/D-Programming-Language/dlang.org/pull/271 consists 
mainly of a reorganization of the ddoc macros for PDF and ebook 
generation purposes, as well as helpers such as plaintext generator and 
"debugger". These are good starting points for anyone using ddoc for 
generating their own documentations.

I was at it so I thought I'd improve on the bag-of-words-at-the-top 
morass, too. It only took a little time. That was apparently 
unsuccessful so I'll remove it from the pull request.

https://github.com/D-Programming-Language/dlang.org/pull/267 is the pull 
request using ddox. That's a larger change of build tooling, which I 
plan to get to after 271 (with a revert to the bag-of-words) gets in.


Andrei