Boost logo

Boost :

Subject: Re: [boost] Review request: auto-index tool
From: Patrick Horgan (phorgan1_at_[hidden])
Date: 2011-01-24 13:03:26


On 01/24/2011 02:02 AM, Paul A. Bristow wrote:
> ... elision by patrick...
> So I feel we need to encourage library authors to produce:
>
> 1 PDF version as well as HTML (and so use Quickbook?).
>
> 2 Quickbook and Doxygen reference section.
>
> 2 Doxygen comments in C++ code about everything. (Perhaps GSoC or
> Boost.Guild people could volunteer to do this?).
>
> 3 Auto-indexing of functions.,classes ... as standard. (So we need to get
> auto-index into next Boost release package).
>
> 4 Conventional word index - Indexing of words in the text.
>
> 5 A user-friendly Quickbook template so new authors can get going quickly.
>
> (I don't feel I am alone in finding that it's pretty hard going getting
> setting up all the tools in place, jamfiles, correct links to tools and
> headers. Moving the code messes some 'would-be' relative address in
> jamfiles. Getting locations of images users graphs, equations, logos,
> admonitions, navigations, png versus svg images etc have caused me grief.
> The requirement to use only relative addressing means that there are loads
> of copies of image files bloating the file system. And to produce a
> packable html requires installing images and style sheet(s)).

What a wonderful email. I would volunteer to put Doxygen comments in
C++ code for someone. It seems like we not only need a user-friendly
Quickbook template, but a good tutorial document from someone that's
fought through this and has found success.

Patrick


Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk