Ned Deily
122fc136b3
Revert "bpo-30487: automatically create a venv and install Sphinx when running make (GH-4346)" ( #4592 )
Fix breakage documented in bpo-32149.
This reverts commit d8d6b91221 .
8 years ago
Caleb Hattingh
d8d6b91221
bpo-30487: automatically create a venv and install Sphinx when running make (GH-4346)
8 years ago
Ned Deily
590665c399
bpo-31036: Allow sphinx and blurb to be found automatically ( #3440 )
Rather than requiring the path to blurb and/or sphinx-build to be specified to the make rule, enhance the Doc/Makefile to look for each first in a virtual environment created by make venv and, if not found, look on the normal process PATH. This allows the Doc/Makefile to take advantage of an installed spinx-build or blurb and, thus, do the right thing most of the time. Also, make the directory for the venv be configurable and document the `make venv` target.
8 years ago
Ned Deily
fcd97d4438
Include additional changes to support blurbified NEWS ( #3340 )
8 years ago
Julien
dff9b5f9d6
bpo-31045: Language switch ( #2652 )
* Doc: Indicate the language
* Renaming version_switcher to switchers (to add language_switcher).
* Adding language switch.
* Doc switchers: Enhance readability of regex parsing versions.
* Doc switchers: Desambiguate the need of a replace(/\/+$/g, '') by proper naming.
* Doc switchers: py3k can't reach js, it's redirected server-side by nginx.
* Doc switchers: Examples matching actual regexes.
* Doc switchers: Better fallback on unexisting translated version.
9 years ago
Nick Coghlan
7a82f9c2b9
bpo-30052: Always regenerate cross-references ( #1339 )
* bpo-30052: Always regenerate cross-references
The patch for bpo-30052 changed the preferred link target
for :func:`bytes` and :func`bytearray` references to be the
respective type definitions rather than the corresponding
builtin function entries.
This patch changes the daily documentation builds to disable
the output caching in Sphinx, in order to ensure that
cross-reference changes like this one are reliably picked
up and applied automatically after merging.
9 years ago
Roger
b3f1f59cf4
Rename Doc/README.txt to Doc/README.rst and add formatting ( #104 )
* Reformat Doc/README.txt to Doc/README.rst
* Update mention of Doc/README.rst
* Update mention of README.txt to README.rst
* Make line fold
* rstlint ignore Doc/README.rst
* conf.py ignore Doc/README.rst
* Update issue tracker url in Docs/README.rst
9 years ago
Victor Stinner
91b0e7d0ca
Doc/Makefile: set PYTHON to python3 ( #124 )
rstlint.py run by "make check" doesn't support Python 2.
"make venv" runs "$(PYTHON) -m venv", whereas Python 2 doens't
provide the venv module: it's a module of Python 3 standard library.
9 years ago
Ryan Gonzalez
e7ffb99f84
Fix some sphinx warnings ( #9 )
* Fix some deprecation warnings in Doc/conf.py
* Fix an rst error in Misc/NEWS
9 years ago
Larry Hastings
8f24f665d7
Regenerated pydoc topics for 3.4.6rc1. (Also fixed doc error, improved build.)
9 years ago
Victor Stinner
9f2e377beb
Issue #27896 : Allow passing sphinx options to Doc/Makefile
Patch written by Julien Palard.
9 years ago
Victor Stinner
57acb82d27
Issue #27896 : Allow passing sphinx options to Doc/Makefile
Patch written by Julien Palard.
9 years ago
Georg Brandl
4b9e75ba7f
Docs: add html-stable autobuild variant
10 years ago
Zachary Ware
bfba2cd406
Don't doc check the venv dir
10 years ago
Larry Hastings
e8ff0caa72
Regenerated pydoc topic index in preparation for Python 3.5.0b2.
11 years ago
Benjamin Peterson
82c05a54a2
fix path to patchlevel.py
11 years ago
Brett Cannon
d5ea39d1b8
Issue #22394 : Add a 'venv' command to Doc/Makefile.
This will create a venv using the interpreter specified by the PYTHON
variable for the Makefile that also install Sphinx. Typical usage is
expected to be:
cd Doc
make venv PYTHON=../python
make html PYTHON=venv/bin/python3
11 years ago
Georg Brandl
61bd1dcf9b
Move Doc/tools/sphinxext content to Doc/tools, there is no need for the nested subdirectory anymore.
11 years ago
Georg Brandl
97e9ec688c
Move Doc/tools/sphinxext content to Doc/tools, there is no need for the nested subdirectory anymore.
11 years ago
Georg Brandl
2b1a0a30c9
Dont define an empty SPHINXOPTS, which overrides a definition from the environment.
11 years ago
Benjamin Peterson
efd713b82b
allow archives for rc releases to be built ( closes #22484 )
11 years ago
Serhiy Storchaka
17f5f817de
Issue #15759 : "make suspicious", "make linkcheck" and "make doctest" in Doc/
now display special message when and only when there are failures.
12 years ago
Zachary Ware
9393fffa5f
Issue #17386 : List the 'htmlview' target in the Doc/Makefile help output.
12 years ago
Georg Brandl
865bdbf4af
Doc: do not compress .epub for dist, it is already zipped.
12 years ago
Éric Araujo
f446d7a70b
Remove references to make targets deleted in eef7899ea7ab
12 years ago
Georg Brandl
f7b2f36f74
Doc: do not rely on checked-out Sphinx toolchain from svn.python.org anymore
Nowadays it is likely that people will have Sphinx installed,
and if not, they will know how to install it.
This also simplifies life a lot for distribution packagers,
who typically do not want the doc build process to connect
to external web resources.
12 years ago
Georg Brandl
8bd656ddb8
Closes #20258 : Sphinx toolchain: move back to Jinja2 2.3.1 with support for Py2.5.
12 years ago
Georg Brandl
5636eb7b93
Update Sphinx toolchain.
12 years ago
Georg Brandl
44d2429a25
Doc/Makefile: also do "make suspicious" during daily autobuild
12 years ago
Georg Brandl
01f47e82a3
Add a autobuild-quick target that only rebuilds HTML.
13 years ago
Georg Brandl
5fb657dfab
Add a autobuild-quick target that only rebuilds HTML.
13 years ago
Georg Brandl
55f23c4233
#8040 : port versionswitcher patch to 2.6.
13 years ago
Ezio Melotti
8645890f8b
#8040 : enable the versionswitcher for the autobuild-dev target.
13 years ago
Ezio Melotti
58864b3cad
#8040 : enable the versionswitcher for the autobuild-dev target.
13 years ago
Georg Brandl
0472bc8709
Use newer version of Pygments that handles "yield from".
13 years ago
Sandro Tosi
bbd41d0874
update Sphinx reference from 0.6.7 to 1.0.7
14 years ago
Georg Brandl
7f3cd98beb
Fix target path in message.
15 years ago
Georg Brandl
6dc50f34dd
Update to 1.0.7.
15 years ago
Georg Brandl
183fe81f8f
#10130 : Prepare for building epub-format docs.
15 years ago
Georg Brandl
cfa8e29d1c
Switch to Sphinx 1.0.5.
15 years ago
Georg Brandl
4263ad8d37
Update Sphinx to 0.6.7.
15 years ago
Georg Brandl
5ad8ed5f26
Update to Sphin 1.0.4.
15 years ago
Georg Brandl
2471063dc7
Merged revisions 85276 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k
........
r85276 | georg.brandl | 2010-10-06 12:35:24 +0200 (Mi, 06 Okt 2010) | 1 line
Fix the suspicious builder not to write CRLF, update suspicious file and add instructions to Makefile.
........
15 years ago
Georg Brandl
e5e6bc68f9
Merged revisions 85276 via svnmerge from
svn+ssh://svn.python.org/python/branches/py3k
........
r85276 | georg.brandl | 2010-10-06 12:35:24 +0200 (Mi, 06 Okt 2010) | 1 line
Fix the suspicious builder not to write CRLF, update suspicious file and add instructions to Makefile.
........
15 years ago
Georg Brandl
19b3e00627
Fix the suspicious builder not to write CRLF, update suspicious file and add instructions to Makefile.
15 years ago
Éric Araujo
716ac385d9
Revert accidental commit, apologies for the noise
16 years ago
Éric Araujo
f63a6fc24e
Update
16 years ago
Georg Brandl
203947fa59
Merged revisions 83663 via svnmerge from
svn+ssh://svn.python.org/python/branches/py3k
........
r83663 | georg.brandl | 2010-08-03 14:36:57 +0200 (Di, 03 Aug 2010) | 1 line
A couple of nits how to ignore errors.
........
16 years ago
Georg Brandl
10c78a78a7
Merged revisions 83663 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k
........
r83663 | georg.brandl | 2010-08-03 14:36:57 +0200 (Di, 03 Aug 2010) | 1 line
A couple of nits how to ignore errors.
........
16 years ago
Georg Brandl
38557f2ac9
A couple of nits how to ignore errors.
16 years ago