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.