cleaning all generated files

[pinsardfr]

Hi

I am using Sphinx v1.3.1 with autosummary extension (just awesome by the way).

I am wondering if the fact that all generated directorties are not removed by the "make clean" is a feature and why ...

Here a real case

 $ make html
 ...
$ find . -name "_generated_"
./_build/doctrees/pypago/generated
./_build/html/_sources/pypago/generated
./_build/html/pypago/generated
./source/pypago/generated

$ make clean
Removing everything under '_build'...

$ find . -name "_generated_"
./source/pypago/generated

Should'nt this ./source/pypago/generated be also deleted or produced
somewhere in _build directory (independant of a builder ?) instead ?

Regards

[leotrs]

I have the same question.

[luccareinehr]

There's an added difficulty to this: the directory where autosummary stores the generated files depends on the arguments passed to the directive when called.

For example,

.. autosummary::
  :toctree: generated

  module_name

will place the files in the generated/ folder.

[luccareinehr]

Also, it wouldn't be right to just delete all files with the same command as make clean. Since the user can edit every generated .rst, he may add text to these docs that would be lost unintentionally.

[mgeier]

This might be related: #10641