Re: [PATCH] Use Doxygen for internals documentation

[Doug Evans <dje@google.com>]

On Thu, Feb 6, 2014 at 3:55 PM, Stan Shebs <stanshebs@earthlink.net> wrote:
> Here is the official patch for the introduction of Doxygen that I
> proposed last fall.
>
> This differs from the RFC version in including a filter as
> suggested by Pedro, and having an index page that points to the
> different sets of pages.
>
> Among other things, the filter gives us the option of flagging
> Doxygen comments with "/* * ", which is lower-impact than the
> previous requirement of putting "/**" on a line by itself - in
> other words, just adding a " *" to existing comments.
>
> As before, "cd doc; make doxy" in an objdir creates, then browse
> doc/doxy/index.html to connect to everything.
>
> In the absence of any fatal flaws, I expect to commit this next
> week, and then follow up with patches that doxygenate some
> representative header files.  At some point we'll also want to
> add a snapshot-generated set of pages to the website.

Awesome!