Ken Jin
99fdd78200
bpo-43766: Fix TypeGuard docs ( #25660 )
2021-04-27 08:55:08 -07:00
Pablo Galindo
f5c5c0c362
Fix type group capture in the PEG highlight tool (GH-25464)
2021-04-18 00:18:13 +01:00
Victor Stinner
62ec638648
bpo-43862: Enhance -W cmdline option documentation (GH-25439)
...
The -W format is "action:message:category:module:lineno".
Update also the Python manual page.
2021-04-16 19:12:14 +02:00
Erlend Egeberg Aasland
3386ca0b36
bpo-20364: Improve sqlite3 placeholder docs (GH-25003)
2021-04-14 15:28:55 +03:00
Pablo Galindo
20ac34772a
Fix Sphinx errors in the documentation and re-activate the suspicious check (GH-25368)
...
The suspicious check is still executed as part of the release process and release managers have been
lately fixing some actual errors that the suspicious target can find. For this reason, reactivate the suspicious
until we decide what to do in a coordinated fashion.
2021-04-12 20:53:15 +01:00
Victor Stinner
f32d022147
bpo-43778: Fix Sphinx glossary_search extension (GH-25286)
...
Create the _static/ directory if it doesn't exist.
Add also constants for the static directory and the JSON filename.
2021-04-09 00:07:01 +02:00
Jules Lasne
dbfabcc0c3
Fixed linenumber missing when audit hook has an error (GH-24692)
...
See https://github.com/sphinx-doc/sphinx/issues/8932
Co-authored-by: tk0miya <i.tkomiya@gmail.com>
2021-03-01 22:59:58 +01:00
Pablo Galindo
cc12888f9b
Remove unused suspicious rule in the docs
2021-03-01 16:48:59 +00:00
Brandt Bucher
145bf269df
bpo-42128: Structural Pattern Matching (PEP 634) (GH-22917)
...
Co-authored-by: Guido van Rossum <guido@python.org>
Co-authored-by: Talin <viridia@gmail.com>
Co-authored-by: Pablo Galindo <pablogsal@gmail.com>
2021-02-26 14:51:55 -08:00
Pablo Galindo
58fb156edd
bpo-42997: Improve error message for missing : before suites (GH-24292)
...
* Add to the peg generator a new directive ('&&') that allows to expect
a token and hard fail the parsing if the token is not found. This
allows to quickly emmit syntax errors for missing tokens.
* Use the new grammar element to hard-fail if the ':' is missing before
suites.
2021-02-02 19:54:22 +00:00
Pablo Galindo
de833b6013
Fix 'make suspicious' for the itertools module (GH-24097)
2021-01-04 17:24:22 +00:00
Ammar Askar
8c5d0347ef
bpo-34398: Allow glossary results to show up on search page (GH-8773)
2020-12-18 20:00:51 +01:00
Julien Palard
b9735420aa
bpo-42238: Check Misc/NEWS.d/next/ for reStructuredText issues. (GH-23802)
2020-12-18 10:48:08 +01:00
Matěj Cepl
b63a620014
bpo-42579: Make workaround for various versions of Sphinx more robust (GH-23662)
...
The solution in gh#python/cpython#13236 is too strict because it
effectively requires the use of Sphinx >= 2.0. It is not too difficult to
make the same solution more robust so it works with all normal versions
of Sphinx.
2020-12-07 20:05:13 +00:00
Dong-hee Na
09490a109f
bpo-42042: Use ids attribute instead of names attribute (GH-22739)
2020-11-14 00:15:17 +09:00
Julien Palard
ee2549c2ba
bpo-41028: Doc: Move switchers to docsbuild-scripts. (GH-20969)
2020-11-07 12:28:31 +01:00
Raymond Hettinger
148c76b27c
Expand and clarify the "Invoking Descriptors" section of the Descriptor HowTo (GH-23078)
2020-11-01 09:10:06 -08:00
Teugea Ioan-Teodor
3317466061
bpo-42061: Document __format__ for IP addresses (GH-23018)
...
Automerge-Triggered-By: GH:ericvsmith
2020-10-29 15:17:59 -07:00
Raymond Hettinger
8d3d7314d4
Create a primer section for the descriptor howto guide (GH-22906)
2020-10-23 12:55:39 -07:00
larryhastings
283f9a253b
Remove 3.5 from Doc version switcher in master. ( #22886 )
2020-10-22 06:16:21 -07:00
Andre Delfino
fb2e94692e
Doc: Do not suggest `s[::-1]` for reversed order (GH-22457)
2020-10-21 17:25:07 +09:00
Raymond Hettinger
871934d4cf
bpo-4356: Add key function support to the bisect module (GH-20556)
2020-10-19 22:04:01 -07:00
Dong-hee Na
6595cb0af4
bpo-35293: Remove RemovedInSphinx40Warning (GH-22198)
...
* bpo-35293: Remove RemovedInSphinx40Warning
* Update Misc/NEWS.d/next/Documentation/2020-09-12-17-37-13.bpo-35293._cOwPD.rst
Co-authored-by: Victor Stinner <vstinner@python.org>
* bpo-35293: Apply Victor's review
Co-authored-by: Victor Stinner <vstinner@python.org>
2020-09-18 18:22:36 +09:00
Pablo Galindo
a5634c4067
bpo-41746: Add type information to asdl_seq objects (GH-22223)
...
* Add new capability to the PEG parser to type variable assignments. For instance:
```
| a[asdl_stmt_seq*]=';'.small_stmt+ [';'] NEWLINE { a }
```
* Add new sequence types from the asdl definition (automatically generated)
* Make `asdl_seq` type a generic aliasing pointer type.
* Create a new `asdl_generic_seq` for the generic case using `void*`.
* The old `asdl_seq_GET`/`ast_seq_SET` macros now are typed.
* New `asdl_seq_GET_UNTYPED`/`ast_seq_SET_UNTYPED` macros for dealing with generic sequences.
* Changes all possible `asdl_seq` types to use specific versions everywhere.
2020-09-16 19:42:00 +01:00
Pablo Galindo
5a4a963a6c
Fix invalid escape sequences in the peg_highlight Sphinx extension (GH-22047)
2020-09-02 15:29:38 +01:00
Pablo Galindo
72cabb2aa6
bpo-40939: Use the new grammar for the grammar specification documentation (GH-19969)
...
(We censor the heck out of actions and some other stuff using a custom "highlighter".)
Co-authored-by: Guido van Rossum <guido@python.org>
2020-07-27 11:20:36 -07:00
Julien Palard
7f03445d01
Doc: fix import of asdl.py when called from outside Doc/. (GH-21529)
2020-07-20 09:48:40 +02:00
Julien Palard
a103e73ce8
bpo-40742: Doc: fix parallel build. (GH-21237)
2020-07-06 22:28:15 +02:00
Florian Dahlitz
735d902b36
bpo-40798: Generate a different message for already removed elements (GH-20483)
2020-05-30 09:47:32 +02:00
Julien Palard
19e3e00264
Doc: Python 3.10 in sidebar and version switcher. (GH-20209)
2020-05-19 14:26:43 +02:00
Batuhan Taskaya
b7a78ca74a
bpo-40517: Implement syntax highlighting support for ASDL (GH-19967)
2020-05-07 13:57:26 -07:00
Raymond Hettinger
eff870b618
Revert "bpo-40517: Implement syntax highlighting support for ASDL ( #19928 )" ( #19950 )
...
This reverts commit d60040ba22
.
2020-05-05 22:33:55 -07:00
Batuhan Taskaya
d60040ba22
bpo-40517: Implement syntax highlighting support for ASDL ( #19928 )
2020-05-05 22:24:39 -07:00
Inada Naoki
39c34933fc
Fix download.html (GH-18902)
...
`<tt>` is not allowed.
Co-authored-by: Kyle Stanley <aeros167@gmail.com>
2020-03-11 13:23:24 +09:00
Serhiy Storchaka
13d52c2686
bpo-34822: Simplify AST for subscription. (GH-9605)
...
* Remove the slice type.
* Make Slice a kind of the expr type instead of the slice type.
* Replace ExtSlice(slices) with Tuple(slices, Load()).
* Replace Index(value) with a value itself.
All non-terminal nodes in AST for expressions are now of the expr type.
2020-03-10 18:52:34 +02:00
opavlyuk
21da76d1f1
bpo-34788: Add support for scoped IPv6 addresses (GH-13772)
...
Automerge-Triggered-By: @asvetlov
2020-02-26 06:33:57 -08:00
Inada Naoki
f4800b8ed3
Doc: Change Python 2 status to EOL. (GH-17885)
2020-01-07 15:52:44 +09:00
David Coles
386d00cc34
Remove use of deprecated `array.fromstring` method (GH-17332)
2019-11-26 15:31:09 +09:00
Serhiy Storchaka
138ccbb022
bpo-38738: Fix formatting of True and False. (GH-17083)
...
* "Return true/false" is replaced with "Return ``True``/``False``"
if the function actually returns a bool.
* Fixed formatting of some True and False literals (now in monospace).
* Replaced "True/False" with "true/false" if it can be not only bool.
* Replaced some 1/0 with True/False if it corresponds the code.
* "Returns <bool>" is replaced with "Return <bool>".
2019-11-12 16:57:03 +02:00
Marco Rougeth
85c6f8c65c
bpo-38592 Add pt-br switcher to Python Docs website (GH-16924)
...
* 📜 🤖 Added by blurb_it.
2019-10-27 09:30:12 +01:00
Serhiy Storchaka
d898d20e8c
bpo-38557: Improve documentation for list and tuple C API. (GH-16925)
2019-10-26 22:59:18 +03:00
Ned Deily
3f36043db2
Update doc switcher list for 3.8.0 (GH-16809)
2019-10-15 17:26:05 -04:00
Julien Palard
4504b4500d
Doc: 3.8 is now stable. (GH-16790)
2019-10-14 18:13:38 -04:00
Ricardo Bánffy
15ae75d660
bpo-38294: Add list of no-longer-escaped chars to re.escape documentation. (GH-16442)
...
Prior to 3.7, re.escape escaped many characters that don't have
special meaning in Python, but that use to require escaping in other
tools and languages. This commit aims to make it clear which characters
were, but are no longer escaped.
2019-10-07 23:54:35 +03:00
Julien Palard
2c910c1e73
bpo-36675: Remove obsolete code. (GH-16024)
...
Does no longer work since Sphinx moved the trim_doctest_flag option in
the configuration.
2019-09-12 12:23:53 +01:00
Anjali Bansal
97b817eae3
bpo-33187: Document ElementInclude (XInclude) support in ElementTree (GH-8861)
2019-09-11 15:09:53 +01:00
Dmitry Shachnev
c3d679fd39
bpo-37504: Fix documentation build with texinfo builder (GH-14606)
...
In the table model used by docutils, the `cols` attribute of `tgroup`
nodes is mandatory, see [1]. It is used in texinfo builder in [2].
[1]: https://www.oasis-open.org/specs/tm9901.htm#AEN348
[2]: https://github.com/sphinx-doc/sphinx/blob/v2.1.2/sphinx/writers/texinfo.py#L1129
* Doc: Add texinfo support to the Makefile
2019-09-10 15:40:50 +01:00
Jason R. Coombs
17499d8270
bpo-38086: Sync importlib.metadata with importlib_metadata 0.21. (GH-15840)
...
https://gitlab.com/python-devs/importlib_metadata/-/tags/0.21
2019-09-10 14:53:31 +01:00
Julien Palard
63c98ed2d2
Doc: Fix PDF build (NoUri). (GH-15739)
2019-09-09 12:54:56 +02:00
Anthony Sottile
e1786b5416
bpo-36853: Fix suspicious.py to actually print the unused rules ( #13579 )
...
* Fix suspicious.py to actually print the unused rules
* Fix the other `self.warn` calls
2019-09-02 12:01:23 -04:00