ddox-generated Phobos documentation is available for review

Andrei Alexandrescu SeeWebsiteForEmail at erdani.org
Tue Mar 11 11:03:13 PDT 2014


On 3/11/14, 10:38 AM, Jacob Carlborg wrote:
> On 2014-03-11 16:52, Andrej Mitrovic wrote:
>
>> I think on pages where we provide a cheat-sheet like in std.algorithm
>> it's probably a good idea to remove the auto-generated list of
>> functions, because it's essentially a duplicated list (and the
>> cheat-sheet is better because it's humanly organized):
>>
>> http://dlang.org/library/std/algorithm.html
>
> The correct solution is making the automatically generated one as good
> as the manually. It shouldn't be hard to add a new Ddoc macro that is
> recognized and indicates which category a symbol belongs to. Something
> like:
>
> /// $(CATEGORY searching)
> void foo ();

Yes to that. I seem to recall we have something similar on the homepage.

Could you please get something started to serve as a pattern to follow 
for all of us?


Thanks,

Andrei




More information about the Digitalmars-d mailing list