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

On 8/26/2015 6:41 AM, Paul A. Bristow wrote:

...

-----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.

If you are willing to do this for the latest iterator docs on 'develop', and create a PR for the changes, I will approve the PR. As usual let's do this on 'develop' and afterwards I can merge the changes to 'master'.