On 23/12/10 11:58, Denis Arnaud wrote: > 2010/12/23 Mateusz Loskot <[email protected] <mailto:[email protected]>> >> It seems 3.1.0 gets closer by now :) >> I hope so. The part that scares me is to the documentation update :-) > > Do you need help on that part?
I've updated installation part (see in the repo). I'm going to add "long version" for compilations, to explain how to configure to build all, shared or static only, with/without burried headers, etc. I would definitely appreciate if you (or anyone) could review and spot missing or incorrect bits. > [You may remember that I had migrated, again for RedHat/Fedora > packaging, the HTML documentation into Doxygen-ready pages. It may help > to maintain the documentation more easily. I guess, though, that it will > be difficult to migrate for the 3.1.0 release. So, if you want, and in > case other developers find an interest into it, I can re-work on that > part after the release] Yes, after release is good. Actually, Doxygen is good for the API part, but it kind of sucks if you want to write more elaborate essays explaining design, architecture, installation, performance tips, etc. In Boost.Geometry project, we parse Doxygen XML output with our own tools and I would say...I think it would be easier to write documentation manually in Boost Quickbook files and have complete control on it :-) Best regards, -- Mateusz Loskot, http://mateusz.loskot.net Charter Member of OSGeo, http://osgeo.org Member of ACCU, http://accu.org ------------------------------------------------------------------------------ Learn how Oracle Real Application Clusters (RAC) One Node allows customers to consolidate database storage, standardize their database environment, and, should the need arise, upgrade to a full multi-node Oracle RAC database without downtime or disruption http://p.sf.net/sfu/oracle-sfdevnl _______________________________________________ Soci-users mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/soci-users
