Gregory P. Smith <g...@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 <rep...@bugs.python.org>
<https://bugs.python.org/issue36838>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to