4b9aad4999
bpo-42236: Enhance init and encoding documentation (GH-23109)
...
Enhance the documentation of the Python startup, filesystem encoding
and error handling, locale encoding. Add a new "Python UTF-8 Mode"
section.
* Add "locale encoding" and "filesystem encoding and error handler"
to the glossary
* Remove documentation from Include/cpython/initconfig.h: move it to
Doc/c-api/init_config.rst.
* Doc/c-api/init_config.rst:
* Document command line options and environment variables
* Document default values.
* Add a new "Python UTF-8 Mode" section in Doc/library/os.rst.
* Add warnings to Py_DecodeLocale() and Py_EncodeLocale() docs.
* Document how Python selects the filesystem encoding and error
handler at a single place: PyConfig.filesystem_encoding and
PyConfig.filesystem_errors.
* PyConfig: move orig_argv member at the right place.
2020-11-02 16:49:54 +01:00
e9208f0e74
Minor formatting edits to the descriptor howto guide (GH-23092)
2020-11-01 20:15:50 -08:00
74fa464b81
Add member objects to the descriptor howto guide (GH-23084)
2020-11-01 18:02:37 -08:00
148c76b27c
Expand and clarify the "Invoking Descriptors" section of the Descriptor HowTo (GH-23078)
2020-11-01 09:10:06 -08:00
e6a7ea4f2e
Split-out a fourth section in the descriptor HowTo guide (GH-22965)
2020-10-25 07:12:50 -07:00
4a9c637938
Second round of updates to the descriptor howto guide (GH-22946)
2020-10-24 20:34:39 -07:00
8e5b0fdce3
bpo-19072: Update descriptor howto for decorator chaining (GH-22934)
2020-10-23 18:37:27 -07:00
8d3d7314d4
Create a primer section for the descriptor howto guide (GH-22906)
2020-10-23 12:55:39 -07:00
e8a2076e14
Revert "Fix all Python Cookbook links ( #22205 )" (GH-22424)
...
This commit reverts commit ac0333e1e1
2020-09-27 01:47:25 +01:00
ac0333e1e1
Fix all Python Cookbook links ( #22205 )
2020-09-15 21:13:26 +01:00
cdbff3527c
[doc] Update documentation on logging optimization. (GH-22075)
2020-09-03 19:44:12 +01:00
43577c01a2
bpo-40204: Fix Sphinx sytanx in howto/instrumentation.rst (GH-21858)
...
Use generic '.. object::' to declare markers, rather than abusing
'.. c:function::' which fails on Sphinx 3.
2020-08-13 19:15:38 +02:00
f6a16e8a82
Remove incorrect mention of method.__class__ in descriptor docs (GH-21665)
2020-07-28 16:56:26 -07:00
714217f956
Fixes dead links to Django's logging config docs (GH-20823)
...
Fixes two outdated URLs to point at the current "stable" version of Django's logging documentation.
Automerge-Triggered-By: @vsajip
2020-06-14 10:23:47 -07:00
7efb826c3e
Use f-strings in argparse HOWTO (GH-20070)
2020-05-20 21:22:59 -07:00
65460565df
Doc: change 'Posix' for 'POSIX' (GH-20001)
2020-05-17 23:29:51 +02:00
8ea10a9446
closes bpo-40166: Change Unicode Howto so that it does not have a specific number of assigned code points. (GH-19328)
...
Change the number of code points from a specific number to a link to the latest standard that has a description of how many code points there are.
2020-04-06 23:16:02 -05:00
51796e5d26
Update some www.unicode.org URLs to use HTTPS. (GH-18912)
2020-03-10 21:10:59 -07:00
7598a93139
PyPy already supports Python 3 (GH-18774)
2020-03-06 11:08:17 +00:00
35eac4500a
Doc: Fix external links to functional programming tutorial. (GH-18249)
2020-01-29 14:10:54 +01:00
8271441d8b
bpo-39374: Updated sorting documentation (GH-18177)
2020-01-25 14:18:58 -08:00
e6ae90dede
Replace links in howto/pyporting.rst with sphinx references (GH-17781)
...
Signed-off-by: Oleg Höfling <oleg.hoefling@gmail.com>
2020-01-05 17:08:14 -05:00
5383956583
bpo-38830: Correct slot signature in Qt example. (GH-17220)
2019-11-18 12:03:22 +00:00
e835b31d2b
bpo-38600: NULL -> ``NULL``. (GH-17001)
...
Also fix some other formatting.
2019-10-30 21:37:16 +02:00
32a960f8e1
Correct Roman-numeral example in Unicode HOWTO. (GH-15541)
2019-09-08 12:42:13 +03:00
5eca7f3f38
bpo-15999: Always pass bool instead of int to socket.setblocking(). (GH-15621)
2019-09-01 12:12:52 +03:00
03acba6f1a
bpo-25777: Wording describes a lookup, not a call (GH-15573)
2019-08-28 22:59:43 -07:00
77df9a1573
correct roman numeral VII description (GH-15523)
2019-08-26 09:12:50 -07:00
472eced677
Refined Qt GUI example in the logging cookbook. (GH-15045)
2019-07-31 07:36:45 +01:00
1ed915e8ae
Add Qt GUI example to the logging cookbook. (GH-14978)
2019-07-27 13:46:53 +01:00
d309352c6f
Update logging cookbook to show multiple worker processes using the concurrent.futures module. ( #14905 )
2019-07-22 12:14:50 +01:00
84de34e39e
bpo-32934: Clarified meaning of 'capacity' for BufferingHandler and MemoryHandler. (GH-14498)
2019-07-01 12:41:21 +01:00
8b2aa1fdde
Use `python -m pip install` in porting guide and venv docs (GH-13257)
...
This is to help prevent people from accidentally installing into the wrong Python interpreter if they are not aware of which Python interpreter `pip` points to.
2019-06-21 11:20:21 -07:00
ca7b504a4d
bpo-37111: Add 'encoding' and 'errors' parameters to logging.basicCon… (GH-14008)
2019-06-17 17:40:52 +01:00
e042a4553e
Do not use explicit inheritance from object in the documentation. (GH-13936)
2019-06-10 13:35:52 +03:00
70c5f2ae6e
Use more PEP 570 syntax in the documentation. (GH-13720)
2019-06-01 11:38:24 +03:00
b82e17e626
bpo-36842: Implement PEP 578 (GH-12613)
...
Adds sys.audit, sys.addaudithook, io.open_code, and associated C APIs.
2019-05-23 08:45:22 -07:00
f98c3c59c0
docs 36789: resolve incorrect note regarding UTF-8 (GH-13111)
2019-05-17 06:44:17 -04:00
cbb6484573
Doc: Replace the deprecated highlightlang directive by highlight. ( #13377 )
...
highlightlang is deprecated since April 2018 in Sphinx.
See https://github.com/sphinx-doc/sphinx/pull/4845
2019-05-17 15:25:34 +05:30
3b2f9ab31d
doc: fix broken link on howto/unicode page ( #13160 )
...
Thank you @redshiftzero on the first PR 👏
2019-05-10 00:43:39 +05:30
a6de52c74d
bpo-32913: Added re.Match.groupdict example to regex HOWTO (GH-5821)
2019-04-17 15:43:30 -07:00
abbdd1fc5c
bpo-23984: Improve descriptor documentation (GH-1034)
...
https://bugs.python.org/issue23984
2019-03-19 19:55:55 -07:00
97c288df61
bpo-20906: Various revisions to the Unicode howto ( #8394 )
...
* bpo-20906: Corrections & revisions to Unicode HOWTO
* bpo-34484: don't describe range as a Private Use Area
2019-03-03 23:10:28 -05:00
3bacf61265
bpo-35584: Clarify role of caret in a class class (GH-11946)
...
https://bugs.python.org/issue35584
2019-02-19 11:32:18 -08:00
cda73a5af2
bpo-35781: Changed references to deprecated 'warn' method in logging documentation in favour of 'warning' (GH-11654)
2019-01-23 07:27:13 +00:00
f0c743604f
bpo-35722: Updated the documentation for the 'disable_existing_loggers' parameter (GH-11525)
2019-01-23 07:12:39 +00:00
2b57c43f21
bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174)
2018-12-19 08:09:46 +02:00
3f819ca138
bpo-35110: Fix unintentional spaces around hyphens and dashes. (GH-10231)
2018-10-31 02:26:06 +02:00
12e696b4f0
bpo-35042: Use the :pep: role where a PEP is specified ( #10036 )
2018-10-26 15:58:26 -07:00
12d0ff1230
Remove ">>>" from testsetup. (GH-10017)
...
Fixes doc build breakage from 890a4b9293
2018-10-20 16:51:05 -07:00
Victor Stinner
Raymond Hettinger
Andre Delfino
Vinay Sajip
Yonatan Goldschmidt
kevin seelbach
Rémi Lapeyre
Mathieu Dupuy
amaajemyfren
Benjamin Peterson
Slam
Julien Palard
Juhana Jauhiainen
Oleg Höfling
Serhiy Storchaka
Greg Price
Ethan Furman
Brad
Steve Dower
redshiftzero
Stéphane Wirtel
redshiftzero
josh
Shubham Aggarwal
Andrew Kuchling
yuji38kwmt
Géry Ogam