Stuart Prescott <[email protected]> writes: > I've wondered if the invocation of sphinx is slowly becoming > standardised enough that we could start configuring and running it > through some set of PYBUILD_SPHINX_* environment variables.
On numerous occasions, and I believe ‘towncrier’ was one, I have found the flexibility allowed by an executable configuration (‘conf.py’ in the documentation source directory) leads to breakage using unmodified build invocations. I can't recall the details now. But I suspect that too many Sphinx build systems have customised ‘conf.py’ such that they still require special handling. The motivation is good, though. Probably a lot of Sphinx build systems in source packages are standard enough that we could get away with some good defaults. -- \ “One time a cop pulled me over for running a stop sign. He | `\ said, ‘Didn't you see the stop sign?’ I said, ‘Yeah, but I | _o__) don't believe everything I read.’” —Steven Wright | Ben Finney
