Re: [jamboost] new doc stuff

From: Rene Rivera (grafik666_at_[hidden])
Date: 2002-04-06 16:34:26

On 2002-04-06 at 03:07 PM, david.abrahams_at_[hidden] (David Abrahams) wrote:

>The doc module is full of docs. How do I ask for documentation on the
>doc module?

--help-modules will tell you that you can do --help-<module-name>, that is
--help-doc.

>I get this:
>
>bjam -sBOOST_BUILD_PATH=c:/boost/tools/build/new --help
>Unable to load Boost.Build, it seems that the build system files where
>located, but the build system is not defined. Attempted to use, as the
>bootstrap, this file: c:/tmp\boost-build.jam. Please consult the
>documentation at 'http://www.boost.org'.
>
>
>1. It seems you meant to write "were" instead of "where" above

I do that a lot, I hate English ;-)

>2. What does it mean "the build system is not defined?" I think we could
>do better.

It means that we found some form of bootstrap file, but when it was loaded
it did not load/define the build system. I'll think of a more verbose
message :-]

>If I place the file in tools/build/new, I get:
>
>bjam --help
>Unable to load Jamfile. Could not find a Jamfile in this directory:
>c:\boost\tools\build\new. Attempted to find it with this pattern:
>[Jj]amfile. [Jj]amfile.jam. Please consult the documentation at
>'http://www.boost.org'.
>
>
>Which doesn't seem like the best response either.
>
>With bjam -sJAMFILE=test.jam --help I do get some help:

Yea, the boost-build.jam that I gave you is the one I use for testing. Which
is a hack and requires a Jamfile to be present. When we have the finished
load order it will work without problems, more famous last words.

> These are the available options for obtaining documentation. Some
>options
> have additional instructions on how to get more detailed information.
>
>* --help; This help message.
>* --help-modules; Brief information on available modules.
>* --help-rules; Brief information on global rules.
>* --help-variables; Brief information on global variables.
>
>For more information consult the documentation at
>'http://www.boost.org'.
>
>Which looks cool!

Thanks, any comments on the code itself? Or on how to use it, from a
programming perspective?

-- grafik - Don't Assume Anything
-- rrivera_at_[hidden] - grafik_at_[hidden]
-- 102708583_at_icq - Grafik666_at_AIM - Grafik_at_[hidden]