Message 341806 - Python tracker

Message341806

Author gregory.p.smith
Recipients gregory.p.smith
Date 2019-05-07.19:37:17
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1557257837.73.0.0332753639305.issue36838@roundup.psfhosted.org>
In-reply-to
Content
Running make in the Doc directory does not install all necessary tooling on its own.  This is a hurdle to getting beginners up to speed on making documentation changes (often their very first changes in the CPython project).

```
:~/oss/cpython/throwaway:master$ make -C Doc html
make: Entering directory '/.../oss/cpython/throwaway/Doc'
mkdir -p build
Building NEWS from Misc/NEWS.d with blurb
/bin/sh: line 5: blurb: command not found
Makefile:44: recipe for target 'build' failed
make: *** [build] Error 127
make: Leaving directory '/.../oss/cpython/throwaway/Doc'
```

Doc builders need to run `make -C Doc venv` first.  Just updating the logic to print that as an error message when the venv or any of the necessary tools within it are missing would be more welcoming.
History
Date User Action Args
2019-05-07 19:37:17gregory.p.smithsetrecipients: + gregory.p.smith
2019-05-07 19:37:17gregory.p.smithsetmessageid: <1557257837.73.0.0332753639305.issue36838@roundup.psfhosted.org>
2019-05-07 19:37:17gregory.p.smithlinkissue36838 messages
2019-05-07 19:37:17gregory.p.smithcreate