delta/cpython-git.git/Doc/Makefile, branch main github.com: python/cpython.git GH-103903: Test the minimum Sphinx version in CI (#103904) 2023-04-27T18:27:38+00:00 Adam Turner 9087854+AA-Turner@users.noreply.github.com 2023-04-27T18:27:38+00:00 44b5c21f4124f9fa1312fada313c80c6abfa6d49 






Add JOBS parameter to docs Makefile (#101395)
2023-01-31T13:29:29+00:00

Christophe Nanteuil
35002064+christopheNan@users.noreply.github.com

2023-01-31T13:29:29+00:00

1a62ae84c687791bc1dfb54d1eb75e1c7277bb04












Docs: Move .PHONY to each section to avoid copy/paste omissions (#99396)
2022-11-27T17:48:29+00:00

Hugo van Kemenade
hugovk@users.noreply.github.com

2022-11-27T17:48:29+00:00

969620d59ab12fc55d0e757a6fbee6aff29830ea












Mark all targets in `Doc/Makefile` as `PHONY` (GH-98189)
2022-10-12T19:40:47+00:00

Nikita Sobolev
mail@sobolevn.me

2022-10-12T19:40:47+00:00

4414586172a7b22ce5b7508c68401e6dc2ac49cc












gh-86404: Doc: Drop now unused make suspicious and rstlint. (GH-98179)
2022-10-11T13:31:33+00:00

Julien Palard
julien@palard.fr

2022-10-11T13:31:33+00:00

4067c6d7fe9b0b266367aafa8cde71e2761cb764

They have been replaced by
[sphinx-lint](https://github.com/sphinx-contrib/sphinx-lint).




They have been replaced by
[sphinx-lint](https://github.com/sphinx-contrib/sphinx-lint).






Speedup: build docs in parallel (GH-92733)
2022-05-16T11:52:00+00:00

Hugo van Kemenade
hugovk@users.noreply.github.com

2022-05-16T11:52:00+00:00

a487623c6b784847a8a1e47b4597b0ae2b8def87












Restore default role check in `make check`. (#92290)
2022-05-15T15:34:52+00:00

Ezio Melotti
ezio.melotti@gmail.com

2022-05-15T15:34:52+00:00

953ab0795243900ccccaaca069d932730a86fc20

* Restore default role check in `make check`.

* Options first, then files.

* Update `make.bat` too.

* Add a comment explaining the extra options.

* No reason to ignore the README.rst.

* Enable default-role check in sphinx-lint.

Co-authored-by: Julien Palard <julien@palard.fr>

* Update sphinx-lint default-role check.

* Fix use of the default role in the docs.

* Update make.bat to check for the default role too.

* Fix comment in make.bat.

Co-authored-by: Julien Palard <julien@palard.fr>




* Restore default role check in `make check`.

* Options first, then files.

* Update `make.bat` too.

* Add a comment explaining the extra options.

* No reason to ignore the README.rst.

* Enable default-role check in sphinx-lint.

Co-authored-by: Julien Palard <julien@palard.fr>

* Update sphinx-lint default-role check.

* Fix use of the default role in the docs.

* Update make.bat to check for the default role too.

* Fix comment in make.bat.

Co-authored-by: Julien Palard <julien@palard.fr>






bpo-36329: Remove 'make -C Doc serve' in favour of 'make -C Doc htmlview' (GH-32354)
2022-04-29T13:47:26+00:00

Hugo van Kemenade
hugovk@users.noreply.github.com

2022-04-29T13:47:26+00:00

89c6b2b8f615a1c1827a92c4582c213b1a5027fb

Also updated `make -C htmlview` so it used a full path with `file://`, because the original didn't open the page (macOS).

For example:
```sh
cd Doc

# Doesn't open anything:
python3 -c "import webbrowser; webbrowser.open('build/html/index.html')"

# Opens the docs page e.g. file:///Users/hugo/github/cpython/Doc/build/html/index.html :
python3 -c "import os, webbrowser; webbrowser.open('file://' + os.path.realpath('build/html/index.html'))"
```

https://bugs.python.org/issue36329




Also updated `make -C htmlview` so it used a full path with `file://`, because the original didn't open the page (macOS).

For example:
```sh
cd Doc

# Doesn't open anything:
python3 -c "import webbrowser; webbrowser.open('build/html/index.html')"

# Opens the docs page e.g. file:///Users/hugo/github/cpython/Doc/build/html/index.html :
python3 -c "import os, webbrowser; webbrowser.open('file://' + os.path.realpath('build/html/index.html'))"
```

https://bugs.python.org/issue36329






bpo-42238: [doc] moving from rstlint.py to sphinx-lint. (GH-31097)
2022-02-10T07:59:04+00:00

Julien Palard
julien@palard.fr

2022-02-10T07:59:04+00:00

b878b3af0b3a9e3ab3ffcaf90a4066dfb3bb7cac












Allows to specify the port on which serve documentation (GH-31145)
2022-02-06T10:22:06+00:00

Christophe Nanteuil
35002064+christopheNan@users.noreply.github.com

2022-02-06T10:22:06+00:00

f1e29cea8516d04c16d94bcb7bf24d4e2d32ffce

[user@localhost]$ make serve      # default configuration, no change
python3 ../Tools/scripts/serve.py build/html
Serving build/html on port 8000, control-C to stop
^CShutting down.

[user@localhost]$ make serve SERVE_PORT=8080 # new option
python3 ../Tools/scripts/serve.py build/html 8080
Serving build/html on port 8080, control-C to stop




[user@localhost]$ make serve      # default configuration, no change
python3 ../Tools/scripts/serve.py build/html
Serving build/html on port 8000, control-C to stop
^CShutting down.

[user@localhost]$ make serve SERVE_PORT=8080 # new option
python3 ../Tools/scripts/serve.py build/html 8080
Serving build/html on port 8080, control-C to stop