Re: [jamboost] doc module!

From: Rene Rivera (grafik666_at_[hidden])
Date: 2002-07-08 10:29:16

[2002-07-08] David Abrahams wrote:

>Rene, I've just been playing around with your new help system, and I have
>to say this is *totally* cool!

Thanks :-)

>Obviously, some refinements are needed, e.g. in output formatting and in
>speed for --help-all. Anyway, I find it very exciting!

Formatting is on my list, output to HTML, handling "module _X_ { }" syntax,
variable parsing is a bit strange, and not being able to get the docs for
"os.path" because of the "." :-(

As for the speed of help-all... It might take special parse handling for
that because it has to parse all the available files and it's not exactly
fast in doing that. I'm thinking of a short version of the parse is in order
for that.

[2002-07-08] Vladimir Prus wrote:

>Rene Rivera wrote:
>> Update of /cvsroot/boost/boost/tools/build/new
>> In directory usw-pr-cvs1:/tmp/cvs-serv30423
>>
>> Modified Files:
>> doc.jam
>> Log Message:
>> Most of the parsing is done, and generating docs. Minimally usefull as
>> inline help.
>
>Rene, this is great! I've just tried it and... don't know what you mean by 
>"minimally usefull"... it's extremely usefull as it is, as far as I'm 
>concerned.

Thanks, again :-)

>If you have some time, can you add "--help" option to the options
description 
>in "boost_build_v2.html"? I think that "--help" interface is easy enough,
so 
>it would be OK to just say that "--help" option gives access to the help 
>system, and don't explain all the other "--help*" options.

Will do! (tonight).

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