[docs] [issue30492] 'make clinic' does not work for out of tree builds / clinic.py is not in the devguide

[Gregory P. Smith]

New submission from Gregory P. Smith:

I never do in-tree builds anymore because they make me feel dirty and leave build artifacts cluttering up my source tree.

make clinic does not work for out of tree builds.

To reproduce:

~$ git clone ...cpython repo...
~$ mkdir build && cd build
~/build$ ../cpython/configure --with-pydebug
~/build$ make clinic
./python -E ./Tools/clinic/clinic.py --make
./python: can't open file './Tools/clinic/clinic.py': [Errno 2] No such file or directory
Makefile:545: recipe for target 'clinic' failed
make: *** [clinic] Error 2

Per https://docs.python.org/3/howto/clinic.html it looks like I can just manually run clinic.py on the files I have modified.  Ideally the build system would take care of that for me.  But all I really want is a single command that keeps me up to date.

python3 Tools/clinic/clinic.py  appears to be that command.  Even if it isn't fixed for out of tree builds, use of clinic needs to be in the devguide.

----------
assignee: docs at python
components: Argument Clinic, Documentation
messages: 294604
nosy: docs at python, gregory.p.smith, larry
priority: normal
severity: normal
stage: needs patch
status: open
title: 'make clinic' does not work for out of tree builds / clinic.py is not in the devguide
type: compile error
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue30492>
_______________________________________