>-----Original Message----- >From: [EMAIL PROTECTED] >[mailto:[EMAIL PROTECTED] On Behalf Of >Andrew Sutton >Sent: 20 July 2007 15:39 >To: Boost documentation format, structure, and processing discussion >Subject: Re: [Boost-docs] stl docs > >> Having an "Official" Boost reference document for the >standard library >> would be great. Assuming it'd be in quickbook or similar, it might >> even be turnable into a treeware version. >> >> It's nowhere near everything that's needed, but I can offer >under some >> appropriate license some articles I've been writing that >might make an >> acceptable starting point: >> http://gpwiki.org/index.php/C_plus_plus:Modern_C_plus_plus > >This is more tutorial-style documentation - which isn't really my >priority at the moment.
But I'm impressed by the *style* of, say, vector *examples*: http://gpwiki.org/index.php/C_plus_plus:Modern_C_plus_plus:Vectors (Except that, in nit-pick mode, I can't understand why comments don't start their sentences with Capital Letter, and end with a period?) This is the sort of example that I believe would be most helpful, and I hope can be referenced directly from Quickbook. Doxygen seems fine for reference, but I've not seen it produce *nice* annotated examples. Perhaps that's my ignorance though? 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: Microsoft Defy all challenges. Microsoft(R) Visual Studio 2005. http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/ _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
