[New-bugs-announce] [issue35249] Docs Makefile always rebuilds entire doc

Jules Lasne report at bugs.python.org
Wed Nov 14 15:08:26 EST 2018

New submission from Jules Lasne <jules.lasne at gmail.com>:

When working on the Documentation or when translating it, I often have to rebuild the doc locally to see the changes I made and see how it looks.

However, with the current configuration, It takes (on my computer at least) more than 4 minutes to build.

After investigating, I've found out that the build options on the Makefile of python-docs-fr and of cpython/Docs both have the `E` and `a` options set, which forces a complete rebuild, even when running locally.


My proposal is to add a `make dev` in the `python-docs-fr` Makefile and add in `cpython/Docs` a mode which will only recompile the needed files.

components: Build
messages: 329930
nosy: seluj78
priority: normal
severity: normal
status: open
title: Docs Makefile always rebuilds entire doc
type: performance
versions: Python 3.7

Python tracker <report at bugs.python.org>

More information about the New-bugs-announce mailing list