Hello, Recently I was tasked to find a tool to aid in documentation for our projects.
Our codebase is commented using doxygen comments and we are (slowly) moving from a horde of compiler specific project files to a BBv2 based build system. I also have been pushing the company to use standard/Boost libraries where available instead of rolling our own with some success. Quickbook seems like a good candidate. I mocked up a few documentation files in it and I actually rather enjoy writing documentation with its quirky syntax. It fits nicely into a BBv2 based toolchain, compliments our doxygen documentation, and produces a good looking final product. There is a major problem that I couldn't find a solution to in the quickbook/boostbook documentation. The generated documentation automatically gets the "Boost C++ Libraries" navigation header placed at the top of each page. Is quickbook meant only for internal Boost documentation? If so it seems like a shame, its syntax is so much more pleasant than authoring raw html. If not how can I suppress this header? As a bonus it'd be nice to be able to configure my own header as a replacement without breaking Boost documentation (i.e. it'd have to be configurable at the qbk or Jamfile level). Thanks, Michael Marcin ------------------------------------------------------------------------- Using Tomcat but need to do more? Need to support web services, security? Get stuff done quickly with pre-integrated technology to make your job easier Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
