Re: [boost] [range] Should html docs be checked in?

Subject: Re: [boost] [range] Should html docs be checked in?
From: Nathan Ridge (zeratul976_at_[hidden])
Date: 2013-12-28 13:23:35

> From Daniel's reply and my very elementary understanding of Boost's build
> process, I think it's only necessary to revision the quickbook files, and
> that all files generated from the latter need not be revisioned. <MyTake>
> Generally, I don't think it's a good idea to revision auto-generated
> files, since minor differences in the generator version may result in
> harmless but extraneous deltas between the generated files that were
> revisioned in the repo by doc-generator-v1.0 and the ones generated by
> someone else like me who generated the same files using a newer (or
> slightly older) doc-generator-v1.1. This can get really cumbersome because
> a revision diff (i.e., git diff) will display all the harmless
> auto-generated diffs in addition to the real ones. </MyTake>

Agreed. There is a ticket tracking this work, by the way [1].

Regards,
Nate

[1] https://svn.boost.org/trac/boost/ticket/7789