On Sunday 19 January 2003 04:02 pm, Jeff Garland wrote:
> > The alphabetized/categorized list of libraries generated from the
> > BoostBook documentation now includes all libraries that have (only) HTML
> > documentation, so it is now possible to replace boost/libs/libraries.htm
> > with the generated doc/html/libraries.html. Here is the HTML:
> >
> > http://www.cs.rpi.edu/~gregod/boost/doc/html/libraries.html
>
> Doug --
>
> This is looking really good! Looks like it is time to seriously
> consider converting my docs :-)
Great!
> Scanning thru the PDF I noticed a few things:
> 1) On page 36, 39 (and others) the text overflows the table boundaries.
Ah, thanks. I'll fix those as soon as I have the chance.
> 2) In code I notice that typename, typedef, class and other keywords
> are bolded. Wouldn't it be better to demphasize keywords and emphasize
> the function names, types and other elements that are the point of
> the documentation? Looks like this is being controlled by the markup
> in the source...
Interesting. In the HTML output, most of the important elements are emphasized
by links, so (to me) the bolding of keywords just makes it look it a little
nicer. On the PDF, however, the bold keywords stand out and the important
elements don't get links, so they don't stick out at all. It should be
relatively easy to make that sort of thing configurable, and it might be
valuable to alter the layout for different media.
> 3) I was trying to run make from the sandbox in /examples and it is looking
> for Makefile.def which isn't there. More generally, is there a list of
> things I need somewhere to be able to get my environment set up?
>
> Jeff
I just finished wiping out the need for Makefile.def, and have added a basic
set of links for getting xsltproc up and running in Unix and Windows (on the
Wiki). Just grab the appropriate xsltproc and you'll be all set: the makefile
needs no additional configuration.
Doug
-------------------------------------------------------
This SF.NET email is sponsored by: FREE SSL Guide from Thawte
are you planning your Web Server Security? Click here to get a FREE
Thawte SSL guide and find the answers to all your SSL security issues.
http://ads.sourceforge.net/cgi-bin/redirect.pl?thaw0026en
_______________________________________________
Boost-docs mailing list
[EMAIL PROTECTED]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
