Re: Sphinx integration
Dave Abrahams <[email protected]>
| Newsgroups | gmane.comp.lib.boost.documentation |
|---|---|
| Message-ID | <[email protected]> |
on Tue Oct 11 2011, Mateusz Loskot <mateusz-AT-loskot.net> wrote: >> Sorry, I don't know what you mean by "implement the unification for use >> and processing of Doxygen in Boost." Could you explain? > > I mean that, presumably, it is a good idea if all Boost libraries > documented using Doxygen use exactly the same tool to transform the > Doxygen comments into API reference in BoostBook or QuickBook format. > > This way, look & feel of all API references would be consistent > and authors would probably be encouraged to update comments for better > Boost API documentation coverage. +1 In fact, it shouldn't be up to the individual libraries; the transformation should be part of the documentation build process. -- Dave Abrahams BoostPro Computing http://www.boostpro.com