> > 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. 

Yeah, I see what you mean about the html, but even there it is a bit
uneven.  Take a look at:

http://www.cs.rpi.edu/~gregod/boost/doc/html/ch02s04.html

You will note that under the definitions bullet the words 'return' and 'void'
are emphasized.  Of course some of this will ultimately be personal
preference.
 
> > 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.

Ok, I'll try it out and let you know how it goes.

Jeff




-------------------------------------------------------
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

Reply via email to