[issue36838] running 'make html' from the Doc tree emits an unwelcoming error message

[Gregory P. Smith]

Gregory P. Smith <greg at krypto.org> added the comment:

I noted this at the mentored sprints this year when I suggested my mentee "cd Doc ; make html" to show them how to build the docs, check that they build and see what they look like.

Once upon a time we used to auto-fetch and install sphinx (long ago?), this appears to have changed to make venv.  This PR at least tells people what to do.  Having the build file auto create the venv is... not quite desired.  The way the Makefile is setup, it'll all still work if people have a late enough blurb and sphinx-build on their PATH.  if we auto install the venv, those installed tools will override _both_ of those so if someone _wanted_ the version on their PATH for some reason it would override that (... i really don't recommend it but i'm not gonna break this for blurb or sphinx developers who may like this).

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue36838>
_______________________________________