On 8/26/2015 11:52 AM, Glen Fernandes wrote:
Robert wrote:
Long standing boost policy is to require HTML files. How they are generated has been according to the preference the author - or I guess the maintainer. Unless we want to change this policy - I guess there's not a lot to discuss.
Policy is a separate matter. This is more about convenience/maintainability.
I use Quickbook now and I like that I do not have to generate the documentation myself and keep the generated .html files in my repository. All that lives in the repository is my .qbk content. Many other authors/maintainers also do this.
If Sphinx was supported similarly, and I had the choice between Quickbook and Sphinx, I'd probably move to .rst from .qbk.
If there were a Boost sphinx tool as part of Boost I don't see why those who want to use .rst instead of .qbk files should not be able to do so. But whatever is used there needs to be something in Boost so that any end-user can generate the HTML docs using the Build system.