Re: [boost] How to handle generated html files with modular-boost and GIT?

Subject: Re: [boost] How to handle generated html files with modular-boost and GIT?
From: Glen Fernandes (glen.fernandes_at_[hidden])
Date: 2014-06-20 11:24:54

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