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:
> 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).
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk