Subject: Re: [boost] Status of various Boost initiatives?
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2013-07-21 13:12:07
> -----Original Message-----
> From: Boost [mailto:boost-bounces_at_[hidden]] On Behalf Of Daniel James
> Sent: Saturday, July 20, 2013 7:09 PM
> To: boost_at_[hidden]
> Subject: Re: [boost] Status of various Boost initiatives?
> On Sat, 20 Jul 2013, at 07:26 PM, Paul A. Bristow wrote:
> > All sounds plausible but the proof of the pudding ...
> > It is moving from experimental to sandbox to trunk to Boostbook
> > collections that has caused me (and John even) some grief. This is
> > where a ' official convention' on where everything lives might help.
> Hopefully, git should make this easier, since you can work in a git branch within the normal boost
> > I feel that it would be very useful to be able to produce links easily
> > even to the level of section or paragraphs or anchors within other
> > libraries, and of course to their header, test and example files too.
> > I feel these links are a major benefit to readers now that Boost has
> > become so large (and further expansion seems inevitable).
> Right now the best way to do that is using 'boost:' links. You might be able to use docbook's
'olink' tag, I
> think that's more of a build problem than anything.
> > It would be nice if the pdf version links work too, but that may be
> > asking too much. Some people like the PDF format for its
> > self-contained nature - and that you can use the Find function in the
> > whole document, something that you can't easily do with html - only
> > the html page that you are on.
> You should be able to setup 'boost:' links to link to the site in pdf documentation. I think by
> > Some form of local and global index would also be useful. I still
> > find trouble finding things that I know are there, despite googling
> > from boost.org.
> The big problem there is dealing with different documentation formats.
> Even quickbook based documentation has a variety of reference formats (e.g. asio, geometry,
> Could maybe combine the output from autoindex, John would be the person to ask about that, and
> independent of modularization really.
Thanks for these suggestions. I'll go back to using boost: and see if I can get it to work right
with pdfs as you outline.
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk