Boost logo

Boost-Build :

From: Rene Rivera (grafik.list_at_[hidden])
Date: 2004-02-03 12:22:04

Samuel Krempp wrote:

> the online-help system is a good thing, but I don't think it's suited for
> the basic facilities a new typically will be looking for.
> I have a hard time guessing what module to look in for some rule I want info
> on, I'd much rather have an html page list most of the rules..
> finding the right module where to look is not always intuitive, and just
> getting the list of modules as a starting point is :
> 1. slow to run (more than 20s on my system)
> 2. too detailed (so many modules you just can't expect the user to find the
> right module in which to look for the rule he wants help on)
> and the modules descriptions are not homogenous at all for now.
> 3. not as convenient for the user as a html page would be
> (clicking a link is so much better than copy-pasting to a command-line and
> running a help command)
> Having the online-help system generate static docs once after each update
> would probably be ideal, but simply copying the most important rules to a
> page would already be an improvement.
> IMO there should be a full page describing available rules, rather than a
> paragraph with a ew rules mentionned like it is at the moment in

The inline-help can generate that complete page of documentation for you. Try

cd boost-root/tools/build/v2
bjam --help-enable-detailed --help-output html --help-output-file reference

Which should produce a "reference.html" file. The generated docs are in
alphabetical order. It includes modules, their variables, and rules.

-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. -
-- rrivera/ - grafik/ - 102708583/icq

Boost-Build list run by bdawes at, david.abrahams at, gregod at, cpdaniel at, john at