on Tue Jul 16 2013, "Paul A. Bristow"
-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Dave Abrahams Sent: Tuesday, July 16, 2013 4:46 AM To: boost@lists.boost.org Subject: Re: [boost] Status of various Boost initiatives?
This all sounds very promising but can I ask a further question.
Has anyone given any thought to how Boost documentation will work in GIT?
*Any* thought? Of course!
I've recently converted some documentation
Converted it to what?
To Quickbook, Doxygen generated C++ reference section from the code, and Autoindexed with links to examples, header files, other Boost libraries etc.
OK...
and though the conversion itself was quite painless, the links to icons, examples, tests, other Boost library documentation and files caused me some trouble, and would appear likely to be disrupted by GITerization, potentially causing some serious work, especially for big libraries (no prizes for guessing which I particularly have in mind ;).
Yes, we might want to create a repository for common resources that individual libraries can include as a submodule.
But I do expect paths to need adjustment.
That might be quite a lot of work ;-)
OK then, I suppose, it will. But still practically nothing compared to figuring out how to do the conversion.
And take some time, especially for older libraries with intermittent maintenance.
But keep up the good work.
Thanks :-) I hope most of my work is nearly done now. -- Dave Abrahams