Boost logo

Boost :

From: John Maddock (john_at_[hidden])
Date: 2007-01-01 10:45:46

> I am trying to look into this (for thread).
> However the doc build process does look to me like black magic. Also I
> could not find anywhere the rationale why building the docs does
> overwrite files that are under source control.
> I am trying to compile the doc from BOOST_ROOT/doc. Is this the wrong
> place?

Nope, that's where I built from.

> Then the process generates files under bin.v2, which is what I
> expected.
> But surprisingly also files under:
> doc/xml
> doc/html
> and under libs/
> are generated. Even uglier: some files which are under source control
> are overwritten!

Yep, we have "placeholders" that redirect to the nightly doc build, but when
the release is put together these get overwritten with the "true" versions.

> Nevertheless the docs were built, and I logged everything. Nowhere I
> could find the "Citation to nonexistent publication abbrev:".
> How did you get this?

Just as you did: built from /doc under win32 on the release branch. I've
just done another cvs update so I'll try again.


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