Re: [boost] [thread][string-algp][1.34] Doc build

From: Roland Schwarz (roland.schwarz_at_[hidden])
Date: 2007-01-01 09:46:03

John Maddock wrote:
> There are a couple of warnings from both the string-algo and thread lib doc 
> builds that look like they might be errors:
> 
> Citation to nonexistent publication abbrev:
> Citation to nonexistent publication abbrev:
> 
> Any ideas?  Presumably something common to both libs?

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?

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!

Nevertheless the docs were built, and I logged everything. Nowhere I 
could find the "Citation to nonexistent publication abbrev:".

How did you get this?

Please describe step by step.

Roland