Re: [boost] [iterator] Regenerating the iterator docs

-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Edward Diener Sent: 25 August 2015 18:01 To: boost@lists.boost.org Subject: Re: [boost] [iterator] Regenerating the iterator docs

On 8/25/2015 12:56 PM, Daniel James wrote:

...

On 24 August 2015 at 19:06, Edward Diener wrote:

...

I have updated a very small portion of the iterator docs and now I need to regenerate the documentation. Evidently despite iterator having quickbook documentation the actual documentation presented to end-users is created from RST files, python scripts, and make files. But I do not see the process of regenerating the docs explained anywhere so I am wondering if anyone knows how to do it.

When I've changed them, I think I just used rst2html with the rst files that I updated.

There is also a pdf version of the rst file that needs to be generated.

A PDF version will come automatically from the Quickbook version - provided any additional info in the .rst is converted to doxygen-syntax comments. This is safe provided we assume that any inadvertent mistakes in this process will be caught by running the test suite. (If they are not, there is something wrong with the tests!) I am willing to do this if people think it worthwhile. Paul --- Paul A. Bristow Prizet Farmhouse Kendal UK LA8 8AB +44 (0) 1539 561830