On Wed, Mar 28, 2012 at 6:32 PM, Matt Peterson <ricochet1k@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) 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