Re: [boost] [iterator] What documentation is actual?

Subject: Re: [boost] [iterator] What documentation is actual?
From: Edward Diener (eldiener_at_[hidden])
Date: 2017-08-26 19:12:07

On 8/26/2017 1:52 PM, Andrey Semashev via Boost wrote:
> Hi,
> 
> While moving next_prior.hpp to Boost.Iterator I've noticed that thete 
> are basically two versions of the documentation in Boost.Iterator: rst 
> and QuickBook. It seems like QuickBook is in progress of being written 
> and is largely a conversion of rst, but is incomplete in some places.
> 
> I'd like to ask what's the plan about it?

The rst doc is being distributed. I have no idea when the quickbook 
version was begun and why it did not replace the rst doc. I am not even 
sure how the rst doc gets regenerated.

> 
> Since I don't know rst I converted the original documentation of 
> next_prior.hpp to QuickBook and added it to the current QuickBook docs. 
> I also converted advance() and distance() docs to QuickBook and fixed a 
> few problems in the docs so that it is at least browsable and readable.
> 
> If we have no plans to switch to QuickBook then I suppose it is better 
> to remove them to avoid confusion. Also, someone has to convert 
> next_prior.hpp docs to rst (I don't know how to do this).