>-----Original Message----- >From: [EMAIL PROTECTED] >[mailto:[EMAIL PROTECTED] On Behalf Of >John Maddock >Sent: 06 June 2007 18:00 >To: Boost documentation format, structure, and processing discussion >Subject: Re: [Boost-docs] [boost-docs] >[BoostBook]featureproposal:librarieslogos
>I guess that would be beta.boost.org, the libraries are at: >http://beta.boost.org/doc/libs/1_34_0 > >My gut feeling is that we should have "one true stylesheet" >used throughout? I strongly agree with this - despite everyone having better taste than everyone else ;-) - the whole documentation is much improved if the style is uniform. >personally I'd >rather keep what we have, even if they are a little bland :-) I'm also a bland fan. You displease fewer of the people less of the time. >I'm also unsure about the source-code highlighting used: this >one really is >subjective and depends a lot on which IDE you're used to I >suspect, but I >prefer the slightly larger font in the existing stylesheet, it >might be the >combination of small text and keywords-in-bold that doesn't >work for me >(though interestingly I'm used to IDE's that does put keywords >in a bold font!). I'm amazed at how much more difficult reading docs code examples is compared to the IDE or Textpad (favoured editor) - because of the font and color change. I also feel that source-code highlighting is really, really important. It really should be consistent throughout Boost code samples - and may even tempt people to change their IDE to match? FWIW, I like blue kewords and green comments, purple 'squiggles' and red numerics. I like a fixed width and this implies all bold or all normal fonts or the point of fixed width is lost. I like Lucida Console better than Courier. Paul --- Paul A Bristow Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB +44 1539561830 & SMS, Mobile +44 7714 330204 & SMS [EMAIL PROTECTED] ------------------------------------------------------------------------- This SF.net email is sponsored by DB2 Express Download DB2 Express C - the FREE version of DB2 express and take control of your XML. No limits. Just data. Click to get it now. http://sourceforge.net/powerbar/db2/ _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
