Documentation Layout

[Brad Anderson]

On Wed, Mar 28, 2012 at 6:32 PM, Matt Peterson <ricochet1k at gmail.com> wrote:

> On Wednesday, 28 March 2012 at 07:00:58 UTC, Brad Anderson wrote:
>
>> [...]
>>
>> I've been trying to generate parsable ddoc output for use in an
>> autocomplete for the search box (symbol names + short documentation
>> excerpts for context).  I had some luck but couldn't strip it down to the
>> bare minimum information I wanted to extract so I got it in my head that I
>> should try adding documentation to dmd's json output instead.  I haven't
>> attempted this yet.  I think the search is very important.  Right now
>> someone basically has to tell you where which module certain
>> structs/classes are in std.typecons has a lot of useful stuff but nobody
>> would ever think to check there to find out where tuples or RefCounted
>> are.
>>  Just yesterday I was very confused about why the documentation for
>> 'recurrence' had gone missing but it turns out it's in std.range, not
>> std.algorithm.
>> [...]
>>
>
> As long as normal documentation output is turned on, my Json improvements (
> https://github.com/D-**Programming-Language/dmd/pull/**813<https://github.com/D-Programming-Language/dmd/pull/813>)
> will output the (unformatted) documentation comments associated with all
> top-level declarations. Take a look at that.
>

Oh great.  Saves me some trouble.

Regards,
Brad Anderson
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.puremagic.com/pipermail/digitalmars-d/attachments/20120328/7ef96dce/attachment.html>