classification
Title: Docs Makefile always rebuilds entire doc
Type: performance Stage: resolved
Components: Build Versions: Python 3.7
process
Status: closed Resolution: works for me
Dependencies: Superseder:
Assigned To: Nosy List: mdk, seluj78
Priority: normal Keywords: patch

Created on 2018-11-14 20:08 by seluj78, last changed 2018-11-14 20:50 by mdk. This issue is now closed.

Pull Requests
URL Status Linked Edit
PR 10547 closed python-dev, 2018-11-14 20:09
Messages (3)
msg329930 - (view) Author: Jules Lasne (seluj78) * Date: 2018-11-14 20:08
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.

https://github.com/python/cpython/blob/9ee1d42f019ac827f73479ce241e95733d050e67/Doc/Makefile#L178-L208
https://github.com/python/python-docs-fr/commit/af8c7a95ab5bc50523ba919c74bb6e6b89d16962

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.
msg329931 - (view) Author: Julien Palard (mdk) * (Python committer) Date: 2018-11-14 20:30
A `make html` builds the doc in 11s on my machine on the 2nd run, I think this is the build you're searching?
msg329934 - (view) Author: Jules Lasne (seluj78) * Date: 2018-11-14 20:45
Fixed in https://github.com/python/python-docs-fr/pull/426
History
Date User Action Args
2018-11-14 20:50:34mdksetstage: patch review -> resolved
2018-11-14 20:48:45mdksetresolution: works for me
stage: resolved -> patch review
2018-11-14 20:45:57seluj78setstatus: open -> closed

messages: + msg329934
stage: patch review -> resolved
2018-11-14 20:30:37mdksetnosy: + mdk
messages: + msg329931
2018-11-14 20:09:29python-devsetkeywords: + patch
stage: patch review
pull_requests: + pull_request9795
2018-11-14 20:08:26seluj78create