summaryrefslogtreecommitdiffstats
path: root/Doc/howto
Commit message (Collapse)AuthorAgeFilesLines
* Fix 404 link to the pyporting mailing list (GH-27320)Rohit Nishad2021-08-041-3/+3
| | | | Co-authored-by: Mariatta Wijaya <Mariatta@users.noreply.github.com> Co-authored-by: Łukasz Langa <lukasz@langa.pl>
* bpo-44399: Document another example of unexpected behavior. (GH-27407)Vinay Sajip2021-07-281-1/+3
|
* bpo-44740: Make minor edits to lowercasing "internet" and "web". (GH-27385)Mariusz Felisiak2021-07-271-1/+1
| | | Follow up to 11749e2dc20ad6a76e9a39e948853e89b2b4bbed
* bpo-44740: Lowercase "internet" and "web" where appropriate. (#27378)Mariusz Felisiak2021-07-263-3/+3
| | | Co-authored-by: Łukasz Langa <lukasz@langa.pl>
* Small text fixes for enum.rst (#27322)Elliot Waite2021-07-261-8/+9
| | | Co-authored-by: Ethan Furman <ethan@stoneleaf.us>
* bpo-44399: Update logging cookbook to document patterns to be avoided. ↵Vinay Sajip2021-07-251-0/+79
| | | | (GH-27348)
* Remove effbot urls (GH-26308)E-Paine2021-05-221-5/+1
|
* Fix error in Enum documentation example code that was referring to the wrong ↵krisaoe2021-05-041-1/+1
| | | | enum. (#25837)
* bpo-43987: Add "Annotations Best Practices" HOWTO doc. (#25746)larryhastings2021-05-022-0/+227
| | | Add "Annotations Best Practices" HOWTO doc.
* Use the zero argument form of super() in examples for Python3 docs. (GH-22314)Andre Delfino2021-04-261-6/+6
|
* Add more tests. Fix code excerpt. (GH-25549)Raymond Hettinger2021-04-231-3/+18
|
* bpo-43917: Fix pure python equivalent for classmethod (GH-25544)Raymond Hettinger2021-04-231-1/+12
| | | Reported by Yahor Harunovich.
* Add doctests (GH-25474)Raymond Hettinger2021-04-191-3/+45
|
* bpo-43774: Add more links to configure options (GH-25363)Victor Stinner2021-04-121-3/+5
|
* bpo-43774: Document configure options (GH-25283)Victor Stinner2021-04-081-1/+1
| | | | | | Add Doc/using/configure.rst documentation to document configure, preprocessor, compiler and linker options. Add a new section about the "Python debug build".
* Replace broken example code with correct simpler code. (GH-25162)Raymond Hettinger2021-04-031-2/+2
| | | | | | The open() was missing 'w' to indicate it was in a write-mode. Even then, the open().close() operation was distracting because it is an unusual way to "touch" as file. Using os.remove() instead is simpler and less distracting.
* Add more tests for the descriptor tutorial (GH-25164)Raymond Hettinger2021-04-031-7/+57
|
* bpo-43677: Fix a minor error in Doc/howto/descriptor.rst (#25123)Zackery Spytz2021-04-011-1/+1
| | | It should be PyMethod_Type, not Py_MethodType.
* bpo-40066: Enum: modify `repr()` and `str()` (GH-22392)Ethan Furman2021-03-312-0/+1417
| | | | | | | | | * Enum: streamline repr() and str(); improve docs - repr() is now ``enum_class.member_name`` - stdlib global enums are ``module_name.member_name`` - str() is now ``member_name`` - add HOW-TO section for ``Enum`` - change main documentation to be an API reference
* bpo-43648: Remove redundant datefmt option in logging file config (GH-25051)Harry2021-03-291-1/+0
| | | | | [bpo-43648](): Remove redundant datefmt option in logging file config Automerge-Triggered-By: GH:vsajip
* bpo-43427: Separte the method overview from the static method specifics. ↵Raymond Hettinger2021-03-131-2/+6
| | | | (GH-24787)
* Simple typo fix (GH-24448)Andrew Tennikoff2021-02-051-1/+1
|
* Minor readability improvements. Also note performance impact of __slots__. ↵Raymond Hettinger2021-02-051-8/+11
| | | | (GH-24456)
* bpo-43082: Remove redundant 'the' in Descriptor howto (GH-24394)diegoe2021-02-031-1/+1
|
* bpo-42048: Clinic Howto: Document AC's defining_class converter (GH-23978)Erlend Egeberg Aasland2021-01-201-0/+62
|
* bpo-27794: Add `name` attribute to `property` class (GH-23967)Yurii Karabas2020-12-301-6/+16
|
* bpo-9694: Fix misleading phrase "optional arguments" (GH-23858)Raymond Hettinger2020-12-231-11/+12
|
* Typo: fix inverted sense of statement (GH-23288)basak2020-11-251-1/+1
| | | | | | | Looks like a "not" was inadvertently omitted in commit e6a7ea4. Classmethods are useful when data stored in specific instances are *not* needed. Automerge-Triggered-By: GH:JulienPalard
* Add more tests to the descriptor howto guide (GH-23506)Raymond Hettinger2020-11-251-4/+25
|
* Add doctests to the descriptor HowTo (GH-23500)Raymond Hettinger2020-11-251-57/+397
|
* Descriptor HowTo: Improve the fidelity of the member object simulation ↵Raymond Hettinger2020-11-231-11/+46
| | | | (GH-23475)
* More updates to the descriptor howto guide (GH-23238)Raymond Hettinger2020-11-161-45/+62
|
* Minor grammar edits for the descriptor howto guide (GH-#23175)Raymond Hettinger2020-11-061-10/+10
|
* bpo-42236: Enhance init and encoding documentation (GH-23109)Victor Stinner2020-11-021-5/+5
| | | | | | | | | | | | | | | | | | | | | 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.
* Minor formatting edits to the descriptor howto guide (GH-23092)Raymond Hettinger2020-11-021-19/+20
|
* Add member objects to the descriptor howto guide (GH-23084)Raymond Hettinger2020-11-021-0/+156
|
* Expand and clarify the "Invoking Descriptors" section of the Descriptor ↵Raymond Hettinger2020-11-011-37/+78
| | | | HowTo (GH-23078)
* Split-out a fourth section in the descriptor HowTo guide (GH-22965)Raymond Hettinger2020-10-251-46/+50
|
* Second round of updates to the descriptor howto guide (GH-22946)Raymond Hettinger2020-10-251-96/+156
|
* bpo-19072: Update descriptor howto for decorator chaining (GH-22934)Raymond Hettinger2020-10-241-3/+13
|
* Create a primer section for the descriptor howto guide (GH-22906)Raymond Hettinger2020-10-231-58/+494
|
* Revert "Fix all Python Cookbook links (#22205)" (GH-22424)Andre Delfino2020-09-271-1/+1
| | | This commit reverts commit ac0333e1e117b7f61ed7ef1dbcdb6e515ada603b as the original links are working again and they provide extended features such as comments and alternative versions.
* Fix all Python Cookbook links (#22205)Andre Delfino2020-09-151-1/+1
|
* [doc] Update documentation on logging optimization. (GH-22075)Vinay Sajip2020-09-031-14/+16
|
* bpo-40204: Fix Sphinx sytanx in howto/instrumentation.rst (GH-21858)Victor Stinner2020-08-131-13/+11
| | | | Use generic '.. object::' to declare markers, rather than abusing '.. c:function::' which fails on Sphinx 3.
* Remove incorrect mention of method.__class__ in descriptor docs (GH-21665)Yonatan Goldschmidt2020-07-281-4/+2
|
* Fixes dead links to Django's logging config docs (GH-20823)kevin seelbach2020-06-141-2/+2
| | | | | Fixes two outdated URLs to point at the current "stable" version of Django's logging documentation. Automerge-Triggered-By: @vsajip
* Use f-strings in argparse HOWTO (GH-20070)Rémi Lapeyre2020-05-211-17/+17
|
* Doc: change 'Posix' for 'POSIX' (GH-20001)Mathieu Dupuy2020-05-171-1/+1
|
* closes bpo-40166: Change Unicode Howto so that it does not have a specific ↵amaajemyfren2020-04-071-2/+3
| | | | | 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.