Attempting to build doc for sandbox project failure
I have setup BoostBook on my system following the instructions at Boost in the BoostBook documentation. I attempted to generate documentation for one of the sandbox projects, going to the dandbox project's libs/doc directory and executing bjam --v2 there. I received a message saying that "error: Did not find Jamfile or project-root.jam in any parent directory." But I can clearly see a Jamfile in the sandboxes root directory. Does anybod have any idea what has gone wrong ?
On 04/04/2006 03:33 PM, Edward Diener wrote:
I have setup BoostBook on my system following the instructions at Boost in the BoostBook documentation. I attempted to generate documentation for one of the sandbox projects, going to the dandbox project's libs/doc directory and executing bjam --v2 there. I received a message saying that "error: Did not find Jamfile or project-root.jam in any parent directory." But I can clearly see a Jamfile in the sandboxes root directory. Does anybod have any idea what has gone wrong ?
I had to put a Jamfile.v2 to "connect" my sandbox boost to the "main" boost. My directory structure is: <main_boost_root> bin.v2 Jamfile.v2 //main Jamfile.v2 ... sandbox torjo boost-root ... lje Jamfile.v2 //connecting Jamfile.v2 boost fields_visitation libs fields_visitation doc Jamfile.v2 fields_visitation.xml The contents of connecting Jamfile.v2 is: project boost : requirements <include>. <include>../torjo/boost-root : usage-requirements <include>. <include>../torjo/boost-root ; but I should change that since I'm no longer using torjo's rangelib. Anyway, it worked for me now. However, I also remember making some changes to boostdoc which allowed building docs in a: <boost-root>/libs/<library>/doc directory instead of in the: <boost-root>/doc directory. The changes were described by Joao in post with headers: From - Wed Jan 4 04:56:26 2006 Subject: [Boost-docs] Re: Quickbook Documentation Sender: boost-docs-admin@lists.sourceforge.net
Larry Evans wrote:
On 04/04/2006 03:33 PM, Edward Diener wrote:
I have setup BoostBook on my system following the instructions at Boost in the BoostBook documentation. I attempted to generate documentation for one of the sandbox projects, going to the dandbox project's libs/doc directory and executing bjam --v2 there. I received a message saying that "error: Did not find Jamfile or project-root.jam in any parent directory." But I can clearly see a Jamfile in the sandboxes root directory. Does anybod have any idea what has gone wrong ?
I had to put a Jamfile.v2 to "connect" my sandbox boost to the "main" boost. My directory structure is:
<main_boost_root> bin.v2 Jamfile.v2 //main Jamfile.v2 ... sandbox torjo boost-root ... lje Jamfile.v2 //connecting Jamfile.v2 boost fields_visitation libs fields_visitation doc Jamfile.v2 fields_visitation.xml
The contents of connecting Jamfile.v2 is:
project boost : requirements <include>. <include>../torjo/boost-root : usage-requirements <include>. <include>../torjo/boost-root ;
I realized after I posted my message that the Boost snadbox has a Jamfile but no Jamfile.v2. I do not know jamfile syntax. How does this Jamfile.v2 just above connect to the Jamfile.v2 in the boost root ? I will take it for granted it does and use it without the torjo lines, and hopefully that will work.
but I should change that since I'm no longer using torjo's rangelib. Anyway, it worked for me now. However, I also remember making some changes to boostdoc which allowed building docs in a:
<boost-root>/libs/<library>/doc
directory instead of in the:
<boost-root>/doc
directory. The changes were described by Joao in post with headers:
Thanks, I will look for that message.
From - Wed Jan 4 04:56:26 2006 Subject: [Boost-docs] Re: Quickbook Documentation Sender: boost-docs-admin@lists.sourceforge.net
Edward Diener <eddielee@tropicsoft.com> writes:
I realized after I posted my message that the Boost snadbox has a Jamfile but no Jamfile.v2.
You should probably know that the sandbox is not really supposed to be a unified thing. In fact after we move to SVN the sandbox will be reorganized so that there are project directories at the top level, each one of which has boost/ and libs/ directories below that. Right now it's possible, if you're using parts of the sandbox, for Boost headers to be masked by other parts that you didn't intend to use. In other words, I don't think you should expect to be able to build docs for the entire sandbox at once from some top-level directory. -- Dave Abrahams Boost Consulting www.boost-consulting.com
David Abrahams wrote:
Edward Diener <eddielee@tropicsoft.com> writes:
I realized after I posted my message that the Boost snadbox has a Jamfile but no Jamfile.v2.
You should probably know that the sandbox is not really supposed to be a unified thing. In fact after we move to SVN the sandbox will be reorganized so that there are project directories at the top level, each one of which has boost/ and libs/ directories below that. Right now it's possible, if you're using parts of the sandbox, for Boost headers to be masked by other parts that you didn't intend to use.
In other words, I don't think you should expect to be able to build docs for the entire sandbox at once from some top-level directory.
I was just trying to generate documentation for a particular sandbox entry, not for all of them. I am glad to hear that the sandbox will be better organized after the boost move to SVN and I will also be happy when SVN replaces CVS.
Larry Evans wrote:
On 04/04/2006 03:33 PM, Edward Diener wrote:
I have setup BoostBook on my system following the instructions at Boost in the BoostBook documentation. I attempted to generate documentation for one of the sandbox projects, going to the dandbox project's libs/doc directory and executing bjam --v2 there. I received a message saying that "error: Did not find Jamfile or project-root.jam in any parent directory." But I can clearly see a Jamfile in the sandboxes root directory. Does anybod have any idea what has gone wrong ?
I had to put a Jamfile.v2 to "connect" my sandbox boost to the "main" boost. My directory structure is:
<main_boost_root> bin.v2 Jamfile.v2 //main Jamfile.v2 ... sandbox torjo boost-root ... lje Jamfile.v2 //connecting Jamfile.v2 boost fields_visitation libs fields_visitation doc Jamfile.v2 fields_visitation.xml
The contents of connecting Jamfile.v2 is:
project boost : requirements <include>. <include>../torjo/boost-root : usage-requirements <include>. <include>../torjo/boost-root ;
I tried a Jamfile.v2 of project boost : requirements <include>. : usage-requirements <include>. ; in my boost sandbox root directory, but I still received the messages: error: Could not find parent for project at '../../..' error: Did not find Jamfile or project-root.jam in any parent directory.
but I should change that since I'm no longer using torjo's rangelib. Anyway, it worked for me now. However, I also remember making some changes to boostdoc which allowed building docs in a:
<boost-root>/libs/<library>/doc
directory instead of in the:
<boost-root>/doc
directory. The changes were described by Joao in post with headers:
From - Wed Jan 4 04:56:26 2006 Subject: [Boost-docs] Re: Quickbook Documentation Sender: boost-docs-admin@lists.sourceforge.net
I could not find this either in this NG or the boost documentation NG. Since I have not been allowed to post any questions to the latter, and since I can not get this to work, I am just going to assume that BoostBook is broken with v2 of the build system and if it ever gets fixed in the future I can then try to use it again. This may be a good example of a technology getting so complicated that it becomes impossible for even the simplest thing to be done. Sorry to show my pique but this really should not be so hard to do.
On 04/04/2006 08:42 PM, Edward Diener wrote: [snip]
directory. The changes were described by Joao in post with headers:
From - Wed Jan 4 04:56:26 2006 Subject: [Boost-docs] Re: Quickbook Documentation Sender: boost-docs-admin@lists.sourceforge.net
I could not find this either in this NG or the boost documentation NG. Since I have not been allowed to post any questions to the latter, and Try here:
http://tinyurl.com/os8lr [snip]
This may be a good example of a technology getting so complicated that it becomes impossible for even the simplest thing to be done. Sorry to show my pique but this really should not be so hard to do.
No problem. I think I understand since I've had trouble doing what seems simple (to one used to Makefiles), but turns out not to be :(
_______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Larry Evans wrote:
On 04/04/2006 08:42 PM, Edward Diener wrote: [snip]
directory. The changes were described by Joao in post with headers:
From - Wed Jan 4 04:56:26 2006 Subject: [Boost-docs] Re: Quickbook Documentation Sender: boost-docs-admin@lists.sourceforge.net
I could not find this either in this NG or the boost documentation NG. Since I have not been allowed to post any questions to the latter, and Try here:
Adding the project-root.jam to the root directory of boost-sandbox got everything working. Thanks for your help ! When Boost Build v2 officially comes out next release as the normal Boost Build system with hopefully decent documentation, I will look at bjam and learn it.
participants (3)
-
David Abrahams -
Edward Diener -
Larry Evans