[Boost-build] generating the documentation from cloned rep

Subject: [Boost-build] generating the documentation from cloned rep
From: Alain Miniussi (alain.miniussi_at_[hidden])
Date: 2015-04-20 05:46:16

Hi

I am trying to generate the documentation from a cloned repository in 
order to validate some doc changes.

According to
http://www.boost.org/doc/libs/1_58_0/doc/html/boostbook/getting/started.html

I should do the following:

"The script requires: sh, curl and gunzip. To perform the installation, 
execute the script tools/boostbook/setup_boostbook.sh from a directory 
where you would like the resulting XSL, DTD, and Apache FOP 
installations to occur."

If I do that I get:
[alainm_at_tagir tools]$  ../../tools/boostbook/setup_boostbook.sh
  .....
Using existing FOP distribution (version 0.94).
ERROR: Please set the BOOST_ROOT environment variable to refer to your
Boost installation or copy user-config.jam into your home directory.
[alainm_at_tagir tools]$

But my BOOST_ROOT is set to the right place:
[alainm_at_tagir tools]$ echo $BOOST_ROOT
/scratch/alainm/view/modular-boost
[alainm_at_tagir tools]$

The reason is that the script is looking for:
$BOOST_ROOT/tools/build/user-config.jam
which does not exist.

I am not sure why it should exist nor what is the purpose of 
"user-config.jam" (I only have a projet-config.jam at the project root) 
but there seems to be smething wrong either with the script or the error 
message.

Thanks

Alain