Re: Sphinx integration
Dave Abrahams <[email protected]>
| Newsgroups | gmane.comp.lib.boost.documentation |
|---|---|
| Message-ID | <[email protected]> |
on Mon Oct 03 2011, "Paul A. Bristow" <pbristow-AT-hetp.u-net.com> wrote: > Using Doxygen properly and fully, I feel that Boost documentation > could be much improved. > > What is wrong is the common delusion that you just chuck your C++ code > into Doxygen it magically does the whole job : it doesn't - it is a > tool for *helping you to document your source code*. > > You have to do the work - and experience has shown that it is much > easier done when you first write > the code! If that is indeed the case, Paul, someone (I'm lookin' at you) needs to write a guide to using Doxygen for Boost. I would definitely try to use it next time if someone could show me how to make it really work for our docs. -- Dave Abrahams BoostPro Computing http://www.boostpro.com