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

Subject: Re: [boost] [iterator] Regenerating the iterator docs
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2015-08-26 09:43:47

> -----Original Message-----
> From: Boost [mailto:boost-bounces_at_[hidden]] On Behalf Of Edward Diener
> Sent: 26 August 2015 12:53
> To: boost_at_[hidden]
> Subject: 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_at_[hidden]] On Behalf Of
> >> Edward Diener
> >> Sent: 25 August 2015 18:01
> >> To: boost_at_[hidden]
> >> 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 <eldiener_at_[hidden]> 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'.

Since I am thwarted by what I was just going to do, I'll take this on.

Paul

---
Paul A. Bristow
Prizet Farmhouse
Kendal UK LA8 8AB
[phone]