10 Jan
2016
10 Jan
'16
2:45 a.m.
Rene Rivera
[...]
1. A library is required to have HTML documentation. 2. A library *can* integrate into the global Boost documentation. 3. If a library doesn't do #2 it *must* provide prebuilt HTML documentation.
Hence, even though Predef uses quickbook, it's never done #2. Therefore Predef does #3
Can't a library provide a Jamfile that generates the documentation, even if that documentation does not integrate with the global Boost documentation? It would be straightforward to require that doing `cd doc && b2` generates the documentation into `doc/html`, with index.html as an entry point. Committing pre-generated documentation is a big no-no, at least for me. Regards, Louis