0d29e7a06f
Fix minor grammar error ( #31325 )
...
"an" followed by consonant should be "a"
2022-02-14 10:45:48 -08:00
f0a648152f
bpo-46502: Remove "How do I tell incomplete input" from FAQ (GH-30925)
...
Since,
- Py_CompileString no longer allows to distinguish "incomplete input"
from "invalid input"
- there is no alternative solution available from the Python C API
due to how the new parser works (rewritten in 3.9)
- the only supported way is to manually import the codeop module from C
and use its API as IDLE does, and accept its own complications
it is desirable to remove this Q&A from the official FAQ.
2022-01-26 23:49:06 +00:00
b9d8980d89
bpo-43698: do not use `...` as argument name in docs (GH-30502)
2022-01-26 19:06:10 +09:00
123a3527dd
bpo-45845: Change link for pyserial (GH-29675)
2021-11-20 14:56:42 -05:00
9852339145
bpo-44844: Remove unresponsive web link (GH-29651)
...
Threading notes by Aahz from OSCON 2001.
2021-11-20 13:21:14 -05:00
bc2bc0dbdb
bpo-45846: Fix capitalisation of Van Rossum at the start of sentence (GH-29641)
2021-11-20 11:35:39 +02:00
105582e74c
bpo-45434: Remove Include/eval.h header file (GH-28973)
...
Move Include/eval.h content into Include/ceval.h and
Include/cpython/ceval.h, and remove Include/eval.h.
2021-10-15 13:06:05 +02:00
380c440875
bpo-20692: Add Programming FAQ entry for 1.__class__ error. (GH-28918)
...
To avoid error, add either space or parentheses.
2021-10-13 01:14:58 -04:00
241bda785a
[doc] Fix typos found using codespell (GH-28744)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-10-05 23:48:44 +02:00
36122e1814
bpo-41203: Replace Mac OS X and OS X with macOS (GH-28515)
...
Replace old names when they refer to actual versions of macOS.
Keep historical names in references to older versions.
Co-authored-by: Patrick Reader <_@pxeger.com>
2021-09-22 20:33:36 +03:00
eec340ea3a
bpo-4442: Document use of __new__ for subclasses of immutable types (GH-27866)
2021-08-22 21:27:06 +02:00
6a358bb948
bpo-44903: Removed othergui.rst and list of GUI frameworks (GH-27762)
2021-08-17 11:00:58 +02:00
11749e2dc2
bpo-44740: Lowercase "internet" and "web" where appropriate. ( #27378 )
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-07-27 00:11:55 +02:00
29987f7265
bpo-40939: Remove documentation for `PyParser_*` & add porting notes (GH-26855)
...
I tried to be relatively thorough and give lots of links.
One reason is that this wasn't deprecated very long; also it seems people running into this tend to not be familiar with similar APIs.
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
2021-06-24 14:57:28 +02:00
51f45d085d
bpo-13814: Explain why generators are not context managers (GH-26835)
...
Put entry in Design FAQ after a question about a context manager for assignment.
Original patch by Aidan Lowe.
2021-06-21 17:23:29 -04:00
e5c7ee1156
Remove dubious suggestion (GH-26789)
...
Remove the weakref example. If a new instance is created and the same arguments are passes, it raises a ReferenceError.
2021-06-18 19:19:32 -05:00
7f01f77f8f
bpo-44310: Add a FAQ entry for caching method calls (GH-26731)
2021-06-17 15:39:42 -05:00
ee3d78ef73
Point to recent link to PyFLTK (GH-26315)
2021-05-25 17:37:28 -03:00
2a1e6698b1
bpo-30757: Improve "How to make stand-alone binaries" FAQ (GH-26309)
...
Co-authored-by: denfromufa <denfromufa@users.noreply.github.com>
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
2021-05-22 23:03:09 +01:00
e9f66aedf4
Remove effbot urls (GH-26308)
2021-05-22 14:09:54 +02:00
08a4803863
[doc] Do some polishing in IDEs section (GH-22070)
2021-04-28 18:06:53 -07:00
d28b346953
Fix broken links and improve stand-alone tools list in FAQ GH-22124
2021-04-25 18:10:05 -07:00
fd79af7ae2
Doc: Try to enhance wording on circular imports. (GH-24705)
2021-04-13 18:03:22 +02:00
9825bdfbd5
bpo-43723: Deprecate camelCase aliases from threading (GH-25174)
...
The snake_case names have existed since Python 2.6, so there is
no reason to keep the old camelCase names around. One similar
method, threading.Thread.isAlive, was already removed in
Python 3.9 (bpo-37804).
2021-04-12 10:42:53 +02:00
7bc25ec727
bpo-20503: Show how isinstance() works with ABC registered classes. (GH-25175)
2021-04-05 12:48:24 -07:00
f8775e4f72
bpo-43325: Add FAQ entry for identity tests (GH-25168)
2021-04-03 19:54:49 -07:00
93d33b47af
Fix typo in the word "spaghetti" (GH-24866)
...
Automerge-Triggered-By: GH:Mariatta
2021-03-15 10:23:03 -07:00
5e29021a5e
bpo-43199: Briefly explain why no goto (GH-24852)
...
Answer "Why is there no goto?" in the Design and History FAQ.
2021-03-14 18:12:04 -04:00
a22bca6b1e
bpo-42128: Add documentation for pattern matching (PEP 634) ( #24664 )
...
This is a first edition, ready to go out with the implementation. We'll iterate during the rest of the period leading up to 3.10.0.
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
Co-authored-by: Fidget-Spinner <28750310+Fidget-Spinner@users.noreply.github.com>
Co-authored-by: Brandt Bucher <brandt@python.org>
Co-authored-by: Raymond Hettinger <1623689+rhettinger@users.noreply.github.com>
Co-authored-by: Guido van Rossum <guido@python.org>
2021-02-28 20:08:38 -08:00
fb2e94692e
Doc: Do not suggest `s[::-1]` for reversed order (GH-22457)
2020-10-21 17:25:07 +09:00
4642ccd1c3
Doc: Do not encourage using a base class name in a derived class (GH-22177)
2020-10-21 14:25:05 +09:00
33242a9328
bpo-41292: Fixes dead link to cx_freeze from Windows FAQ (GH-21463)
2020-10-19 23:02:43 +01:00
5d9e657517
Link to the msvcrt module from the Windows FAQ ( #22268 )
2020-10-19 22:46:21 +01:00
a22a19f354
bpo-40341: Remove some "discouraged solutions" in Doc/faq/programming.rst (GH-22726)
2020-10-16 11:44:17 -07:00
060937da98
bpo-41774: Tweak new programming FAQ entry (GH-22562)
...
Remove mention of space in "remove multiple items from list".
2020-10-05 10:31:44 -04:00
c8bb24166e
[doc] Update references to NumPy (GH-22458)
...
Numeric(al) Python to NumPy. It seems the old name hasn't been used for some time.
2020-10-01 16:22:14 -07:00
5b0181d1f6
bpo-41774: Add programming FAQ entry (GH-22402)
...
In the "Sequences (Tuples/Lists)" section, add
"How do you remove multiple items from a list".
2020-09-29 01:02:44 -04:00
e8a2076e14
Revert "Fix all Python Cookbook links ( #22205 )" (GH-22424)
...
This commit reverts commit ac0333e1e1
2020-09-27 01:47:25 +01:00
778ad926cb
[doc] Teach 0-args form of super in Programming FAQ (GH-22176)
2020-09-20 10:09:50 -07:00
ac0333e1e1
Fix all Python Cookbook links ( #22205 )
2020-09-15 21:13:26 +01:00
1d25f5bf7b
Remove reference to Boa Constructor. (GH-22012)
2020-09-01 22:22:55 -05:00
dea82b6731
[doc] Remove references to PyChecker. (GH-22011)
2020-09-01 22:21:12 -05:00
7173fc84e6
bpo-41573: Update release versions in General FAQ (GH-21915)
2020-08-21 18:28:54 -04:00
67acf74c4e
Doc: Add output to example code in programming FAQ (GH-21346)
...
Add output hint to document, part faq/programming, section [How do I write a function with output parameters (call by reference)?](https://docs.python.org/3/faq/programming.html#how-do-i-write-a-function-with-output-parameters-call-by-reference ).
This patch make the output hint just like prefix code block.
2020-08-08 12:29:03 -07:00
3fa4799c3f
Update FAQ release schedule and estimated users (GH-21180)
...
Update FAQ to include:
* The new yearly release schedule from PEP 602
* Estimated users from "tens of thousands" to "millions"
2020-06-30 05:42:43 -04:00
3ab3475c42
bpo-24914: mention Python supports multiple paradigms in the FAQ ( #20658 )
2020-06-08 11:07:29 -07:00
fd33cdbd05
Fix plural typo in documentation (GH-19799)
...
Co-authored-by: Alex Povel <python@alexpovel.de>
2020-04-29 19:17:12 -03:00
caf1aadf3d
bpo-40348: Fix typos in the programming FAQ (GH-19729)
2020-04-26 20:23:52 -07:00
5aafa54879
bpo-40340: Separate examples more clearly in the programming FAQ (GH-19688)
2020-04-24 19:39:04 -04:00
5807efd4c3
bpo-38558: Link to further docs from walrus operator mention in tutorial (GH-16973)
2020-02-03 18:11:19 +01:00
6c7bb38ff2
bpo-39136: Fixed typos (GH-17720)
...
funtion -> function; configuraton -> configuration; defintitions -> definitions;
focusses -> focuses; necesarily -> necessarily; follwing -> following;
Excape -> Escape,
2019-12-28 17:16:02 -05:00
25fc088607
bpo-38600: Change the mark up of NULL in the C API documentation. (GH-16950)
...
Replace all *NULL* with ``NULL``.
2019-10-30 12:03:20 +02:00
87d6cd3604
bpo-38237: Make pow's arguments have more descriptive names and be keyword passable (GH-16302)
...
Edit: `math.pow` changes removed on Mark's request.
https://bugs.python.org/issue38237
Automerge-Triggered-By: @rhettinger
2019-09-20 21:28:49 -07:00
6357c95716
bpo-35224: Additional documentation for Assignment Expressions (GH-15935)
...
Add or update assignment expression documentation for:
- FAQ - Design
- Reference - Expressions
- Reference - Lexical Analysis
https://bugs.python.org/issue35224
Automerge-Triggered-By: @matrixise
2019-09-11 07:37:12 -07:00
88b24f96ae
Minor changes in Doc/faq/library. ( #15449 )
...
* Minor changes.
* Update Doc/faq/library.rst
Co-Authored-By: Kyle Stanley <aeros167@gmail.com>
* Apply suggestions from aeros167.
* Update Doc/faq/library.rst
Co-Authored-By: Kyle Stanley <aeros167@gmail.com>
* Apply suggestions from aeros167 + re-add a "a" that was accidentally deleted.
2019-09-09 17:00:43 +02:00
3aa48b88c7
bpo-36167: fix an incorrect capitalization (GH-14482)
2019-08-29 01:40:50 -04:00
a0f7119f15
bpo-37352: Minor word-smithing for design.rst (GH #14730 )
2019-07-16 08:13:38 -07:00
6f2a8c0857
bpo-37456: Slash ('/') is now part of syntax. (GH-14627)
2019-07-06 18:13:02 -04:00
d0068000b2
Docs: Improved phrasing (GH-14069)
...
* Docs: Improved phrasing
Removed usage of second person pronouns in the section and made the assumption of "uneasiness" in code style transition more neutral.
* Removed trailing whitespace on line 34
2019-06-20 21:43:07 -07:00
70c5f2ae6e
Use more PEP 570 syntax in the documentation. (GH-13720)
2019-06-01 11:38:24 +03:00
7114c6504a
Docs: FIX broken links. (GH-13491)
2019-05-25 20:02:24 +02: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
9b5a0efcdc
Fix typos in documentation ( #13344 )
2019-05-16 00:34:24 -04:00
cf48e55f7f
bpo-33882: mention breakpoint() in debugger-related FAQ (GH-7759)
2019-05-03 12:53:21 -04:00
c88feceb44
Doc: define PY_SSIZE_T_CLEAN always (GH-12794)
2019-04-13 10:46:21 +09:00
6cd658b1a5
bpo-34203: FAQ: improve wording of paragraph about 2.x vs. 3.x (GH-9821)
2019-03-26 23:10:40 +02:00
6661c1720e
Replace "DOS box" with link to Windows FAQ. (GH-12390)
2019-03-24 15:03:54 -04:00
1aeeaeb79e
bpo-21314: Add a FAQ entry about positional only parameters (GH-10641)
2019-03-10 21:30:11 +10:00
ccb92e814d
Update FAQ to point to Infrastructure Team website. (GH-12077)
2019-02-27 17:23:34 -05:00
55e335d7d5
Remove empty Dictionaries section from programming FAQ (GH-12026)
2019-02-25 11:22:07 -05:00
2b57c43f21
bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174)
2018-12-19 08:09:46 +02:00
55f41e45b4
Correct a couple of unbalanced parenthesis. (GH-10779)
2018-12-05 21:45:30 +02:00
5719f275b7
Doc: Delete now useless Windows FAQ section (GH-10557)
2018-11-26 17:13:41 +01:00
a1c4001408
Doc: Delete "how do I emulate os.kill" section in Windows FAQ (GH-10487)
...
That section is a tip on how to kill process on Windows for Python prior to 2.7 and 3.2.
3.1 end of support was April 2012 and 2.6 was October 2013, so that hasn't been need for supported versions of Python for more than 5 years. Beside not being needed anymore for a long time, when I read it with the eyes of a Python profane, it makes Python looks bad, like a language from the parts with warts you need to circumvent.
Let's delete that :)
2018-11-23 15:35:07 +01:00
64313478bc
bpo-32613: Update window FAQ (GH-5552)
2018-11-14 16:22:27 +01:00
e483f02423
bpo-35044, doc: Use the :exc: role for the exceptions (GH-10037)
2018-10-26 12:52:11 +02:00
d262250d07
bpo-35032: Remove inaccessible videos from faq/Windows (GH-10004)
...
https://bugs.python.org/issue35032
2018-10-20 08:27:03 -07:00
4505f65ae7
bpo-34203: FAQ now recommends python 3.x over 2.x (GH-9796)
2018-10-12 12:16:43 +03:00
a378254186
closes bpo-33883: Mention type checkers in the FAQ. (GH-7760)
2018-09-10 22:12:41 -07:00
c48e26dcad
bpo-27671: Update FAQ about why len is function (GH-8432)
2018-07-31 14:49:22 +09:00
8d41278045
bpo-33888: Use CPython instead of Python in the FAQ (GH-7767)
...
Make the change where discussing the CPython implementation of lists and dicts.
2018-07-07 19:25:47 -04:00
a6e1e41e05
Update Stackless Python wiki URL (GH-8072)
...
It was moved from bitbucket to GitHub.
2018-07-04 21:31:38 -07:00
c6cd164cff
bpo-30660: Doc: Optimize PNG files by optipng (GH-8032)
...
Using OptiPNG 0.7.7.
Used command is: `find . -name '*.png' | xargs optipng -o7`
2018-07-01 16:02:52 +09:00
866c168a5f
bpo-33957: Doc: Use better wording (GH-7912)
2018-06-26 17:27:05 +09:00
38cf49bf69
bpo-33887: Add TOC to Design and History FAQ(GH-7766)
2018-06-23 11:27:16 -07:00
2707e41a5c
bpo-33836: Recommend keyword-only param for memoization in FAQ (GH-7687)
...
Update the the signature in the code example to make `_cache` a keyword-only parameter.
2018-06-15 20:29:11 -07:00
396ecb9c3e
bpo-33799: Remove non-ordered dicts comments from FAQ
2018-06-08 15:38:07 +09:00
19177fbd5d
bpo-33503: Fix the broken pypi link in the source and the documentation (GH-6814)
2018-05-15 14:58:35 -04:00
46936d5a71
Improve highlighting of some code blocks. (GH-6401)
2018-04-08 19:18:04 +03:00
78553138be
Fix typos '.::' should typically just be '::'. (GH-6165)
2018-03-28 23:14:15 +02:00
5bb0005f9f
Make formatting of some return codes conforming to the general style. ( #5587 )
2018-02-09 13:31:19 +02:00
338cd83c5d
bpo-25910: Link redirections in docs ( #1933 )
...
Fixes some redirection links in docs.
2018-01-20 01:25:37 +01:00
4f29f3c84b
trivial: link updates in documentation ( #2765 )
2017-12-13 14:37:51 +02:00
1b4587a246
bpo-25910: Fixes redirection from http to https ( #4674 )
2017-12-06 17:39:33 +01:00
384899dfae
bpo-30737: Update DevGuide links to new URL (GH-3228)
...
Update old devguide links from https://docs.python.org/devguide to https://devguide.python.org
2017-08-30 09:37:43 -07:00
e9d978fd1b
Fix a typo in the Programming FAQ. ( #3230 )
...
subobjects, not subobjecs.
2017-08-28 13:43:26 -07:00
d3ed2877a7
Remove outdated FOX from GUI FAQ (GH-2538)
...
FXpy doesn't have a Python 3 port and it only
supports Python 2.2 and older versions.
Reported by Alex Walters on docs@p.o.
2017-07-04 09:13:10 +03:00
909a6f626f
bpo-27200: Fix doctests in programming.rst and datetime.rst ( #401 )
2017-03-18 19:59:33 +03:00
b2ee40ed9c
Change some mercurial/ hg.python.org references. ( #8 )
2017-02-16 07:18:42 -08:00
2b501866ed
Travis CI: run rstlint.py in the docs job ( #68 )
...
Currently, http://buildbot.python.org/all/buildslaves/ware-docs
buildbot is only run as post-commit. For example, bpo-29521 (PR#41)
introduced two warnings, unnotified by the Travis CI docs job.
Modify the docs job to run toosl/rstlint.py.
Fix also the two minor warnings which causes the buildbot slave to
fail.
2017-02-13 15:30:05 +01:00
Scott Noyes
Mateusz Łoskot
Nikita Sobolev
Terry Jan Reedy
JMcB
Victor Stinner
Christian Clauss
Serhiy Storchaka
Raymond Hettinger
Gautam Chaudhuri
Mariusz Felisiak
Petr Viktorin
Mark
Erlend Egeberg Aasland
E-Paine
Andre Delfino
Julien Palard
Jelle Zijlstra
Kazantcev Andrey
Daniel F Moisset
Michel Samia
abdo
Zackery Spytz
wyz23x2
Jiajie Zhong
Brett Cannon
Alex Povel
Cajetan Rodrigues
Adorilson Bezerra
Gurupad Hegde
Ammar Askar
Emily Morehouse
Antoine
avinassh
Ilya Kamenshchikov
Aeros
Stéphane Wirtel
Xtreak
Inada Naoki
Tal Einat
Ned Deily
Lysandros Nikolaou
Mathieu Dupuy
Gus Goulart
INADA Naoki
Srinivas Reddy Thatiparthy (శ్రీనివాస్ రెడ్డి తాటిపర్తి)
Noah Haasis
Sanyam Khurana
jimmy
Lisa Hewus Fresh
Gregory P. Smith
Berker Peksag
Marco Buttu
Senthil Kumaran
Victor Stinner