Boost logo

Boost :

Subject: [boost] [fusion] html docs woes
From: Eric Niebler (eric_at_[hidden])
Date: 2011-07-16 16:38:16

I'm merging [72977] to release
(<>) and am given a
headache by the fact that Fusion has its HTML docs checked in. The docs
are automatically generated from the qbk files so committing them to svn
is strictly unnecessary, AFAICT.

Why is this a problem?

- Any change to any qbk file results in a huge number of diffs to the
HTML docs (due to changed ids), resulting in a huge commit, long upload
times, long download times, long merge times.

- It makes viewing a changeset all but impossible because the meaningful
changes are lost in the noise of meaningless diffs to automatically
generated files.

- It leads to unnecessary merge conflicts when merging commits from
trunk to release. I'm going to have to regenerate the docs on the
release branch and upload them all ... for no benefit!

Can Fusion be changed to build its html docs as a normal part of Boost's
doc build procedure like other Boost libraries?


Eric Niebler
BoostPro Computing

Boost list run by bdawes at, gregod at, cpdaniel at, john at