From: Angus Leeming (angus.leeming_at_[hidden])
Date: 2004-09-30 06:07:09
Eric Niebler wrote:
> Joel de Guzman and I, with the help of many smart folks on the
> boost-docs list[*], have been working on improving the look-n-feel of
> Boost's documentation. We're ready to commit the new style, but wanted
> to check here first.
> Volodya was good enough to put up a copy of Boost's docs with the new
> style applied. You can preview them here:
> Please say whether you like the new style or not. If not, be specific
> about why.
I tried it with the text-only browser lynx. In general all looks perfectly
readable, but I do notice one strangeness: snippets of code which should
have a larger left margin than the text actually have no left margin at
Cut and paste from that page gives a fair view of how it is rendered by
The first example is the simplest possible: it only handles two
options. Here's the source code (the full program is in
// Declare the supported options.
po::options_description desc("Allowed options");
("help", "produce help message")
("compression", po::value<int>(), "set compression level")
This isn't a problem of your new stylesheet in particular. The same
behaviour is found when using the .css file in boost cvs. However, it
would be nice if this could be improved.
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk