Author mdk
Recipients abarry, benjamin.peterson, docs@python, mdk, terry.reedy, vstinner, zach.ware
Date 2016-07-24.14:50:33
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1469371833.75.0.351945053239.issue26546@psf.upfronthosting.co.za>
In-reply-to
Content
I'm on the way of simplifying my [pull request for docsbuild-script](https://github.com/python/docsbuild-scripts/pull/1) with two goals in mind:

 - Simplify to make it more robust
 - Avoid executing external (~untrusted) Makefile on docs.python.org servers

To achieve this, I need to pass sphinx options to the `Doc/Makefile`, I'd like to call, typically:

    make autobuild-stable SPHINXOPTS='-D language=fr -D locale_dirs=./locale/'

Which work if `Doc/Makefile` don't erase but append to the `SPHINXOPTS` variable. Which is done by `allow_sphinxopts.diff`.

We may simplify it further by adding `locale_dirs` to `Doc/conf.py` which does not break the english build, but I'm not sure if it's of any interest.

We may abstract it further by accepting a new parameter like SPHINXLANG='fr', with a default of 'en', but in every case I think it's a good thing to allow passing arbitrary SPHINXOPTS so let's start with this?
History
Date User Action Args
2016-07-24 14:50:33mdksetrecipients: + mdk, terry.reedy, vstinner, benjamin.peterson, docs@python, zach.ware, abarry
2016-07-24 14:50:33mdksetmessageid: <1469371833.75.0.351945053239.issue26546@psf.upfronthosting.co.za>
2016-07-24 14:50:33mdklinkissue26546 messages
2016-07-24 14:50:33mdkcreate