Andrey Semashev wrote:
I think auto-generated files should never be committed. This bloats history and checkouts, adds problems when committing changes and doesn't offer any benefits. Also this ignores any possible changes in the build tool chain and stylesheets and resources, if you commit them as well.
I'm with Andrey here.
Paul A. Bristow wrote:
However this would mean that users would have to generate the html (and assumes that all the tools like Doxygen and autoIndex are setup right - an unwelcome requirement).
The built documentation is mostly targeted for users, and for users we already have docs on the website.
Users can also download the PDF documentation distribution that is available separately along with every Boost release. Maybe a similar HTML documentation distribution could additionally be made available. Glen