Commit graph

300 commits

Author SHA1 Message Date
Miss Islington (bot)
7534c50985
[3.9] gh-76773: Update docs mentioning no-longer-supported Windows versions & features (GH-92529) (GH-92610)
(cherry picked from commit f1bbcba74f)


Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>

Automerge-Triggered-By: GH:serhiy-storchaka
2022-05-10 02:28:24 -07:00
Thaddeus1499
e48da72647
[3.9] Remove effbot urls (GH-26308). (#92162)
(cherry picked from commit e9f66aedf4)

Co-authored-by: E-Paine <63801254+E-Paine@users.noreply.github.com>
2022-05-02 12:22:05 -06:00
Miss Islington (bot)
090a0f6ffb
Fix typo in Programming FAQ (GH-92083)
I believe the word "with" was missing here.
(cherry picked from commit 2a7efa3242)

Co-authored-by: Matt Harding <majaharding@gmail.com>
2022-05-02 08:20:09 -07:00
Miss Islington (bot)
0bd2d58f36
Fix minor grammar error (GH-31325)
"an" followed by consonant should be "a"
(cherry picked from commit 0d29e7a06f)

Co-authored-by: Scott Noyes <snoyes@gmail.com>
2022-02-14 11:10:38 -08:00
Pablo Galindo Salgado
dafada393f
[3.9] bpo-46502: Remove "How do I tell incomplete input" from FAQ (GH-30925) (GH-30934)
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..
(cherry picked from commit f0a648152f)

Co-authored-by: Mateusz Łoskot <mateusz@loskot.net>

Co-authored-by: Mateusz Łoskot <mateusz@loskot.net>
2022-01-27 00:16:44 +00:00
Miss Islington (bot)
49971b2d18
bpo-43698: do not use ... as argument name in docs (GH-30502)
(cherry picked from commit b9d8980d89)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2022-01-26 04:42:39 -08:00
Miss Islington (bot)
e81e1d7f81
[3.9] bpo-45845: Change link for pyserial (GH-29675)
(cherry picked from commit 123a3527dd)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2021-11-20 15:52:07 -05:00
Miss Islington (bot)
d1855ed752
bpo-44844: Remove unresponsive web link (GH-29651)
Threading notes by Aahz from OSCON 2001.
(cherry picked from commit 9852339145)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2021-11-20 10:44:04 -08:00
Miss Islington (bot)
e88f9787ab
bpo-45846: Fix capitalisation of Van Rossum at the start of sentence (GH-29641) (GH-29657)
(cherry picked from commit bc2bc0dbdb)

Co-authored-by: JMcB <joel.mcbride1@live.com>
2021-11-20 16:57:37 +01:00
Miss Islington (bot)
cc90732d15
bpo-20692: Add Programming FAQ entry for 1.__class__ error. (GH-28918)
To avoid error, add either space or parentheses.
(cherry picked from commit 380c440875)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2021-10-12 22:40:18 -07:00
Christian Clauss
edef03aaa8
[3.9] [doc] Fix typos found using codespell (GH-28744) (GH-28759) 2021-10-06 15:57:39 +02:00
Miss Islington (bot)
d747f5e805
[doc] Update references to NumPy (GH-22458) (GH-28749)
Numeric(al) Python to NumPy. It seems the old name hasn't been used for some time.
(cherry picked from commit c8bb24166e)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2021-10-06 15:04:48 +02:00
Miss Islington (bot)
f1d5cdef57
bpo-41203: Replace Mac OS X and OS X with macOS (GH-28515) (GH-28524)
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>
(cherry picked from commit 36122e1814)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2021-09-23 13:25:57 +03:00
Łukasz Langa
ac87b07a10
[3.9] bpo-4442: Document use of __new__ for subclasses of immutable types (GH-27866) (GH-27900)
(cherry picked from commit eec340ea3a)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2021-08-22 22:14:25 +02:00
Miss Islington (bot)
e21b66b044
bpo-44903: Removed othergui.rst and list of GUI frameworks (GH-27762) (GH-27790)
(cherry picked from commit 6a358bb948)

Co-authored-by: Gautam Chaudhuri <gautam.chaudhuri.1803@gmail.com>
2021-08-17 12:09:09 +02:00
Miss Islington (bot)
d881002fbd
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.
(cherry picked from commit 51f45d085d)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2021-06-21 18:03:06 -04:00
Miss Islington (bot)
e7078ee116
Point to recent link to PyFLTK (GH-26315) (GH-26367)
(cherry picked from commit ee3d78ef73)

Co-authored-by: Mark <mark@qtrac.eu>

Co-authored-by: Mark <mark@qtrac.eu>
2021-05-25 18:03:43 -03:00
Miss Islington (bot)
099e6a4096
bpo-30757: Improve "How to make stand-alone binaries" FAQ (GH-26309) (GH-26312)
Co-authored-by: denfromufa <denfromufa@users.noreply.github.com>
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
(cherry picked from commit 2a1e6698b1)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2021-05-22 23:23:11 +01:00
Miss Islington (bot)
c4e503ed80
[doc] Do some polishing in IDEs section (GH-22070) (GH-25703)
(cherry picked from commit 08a4803863)

Co-authored-by: Andre Delfino <adelfino@gmail.com>

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2021-04-28 18:09:03 -07:00
Miss Islington (bot)
2b475dc1ff
Fix broken links and improve stand-alone tools list in FAQ GH-25609
(cherry picked from commit d28b346953)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2021-04-25 18:43:43 -07:00
Miss Islington (bot)
028d5286d4
bpo-20503: Show how isinstance() works with ABC registered classes. (GH-25175) (GH-25202) 2021-04-05 13:11:50 -07:00
Miss Islington (bot)
de0b2b1330
bpo-43325: Add FAQ entry for identity tests (GH-25168) (GH-25178) 2021-04-03 20:05:50 -07:00
Miss Islington (bot)
83f676092e
Fix typo in the word "spaghetti" (GH-24866)
Automerge-Triggered-By: GH:Mariatta
(cherry picked from commit 93d33b47af)

Co-authored-by: Kazantcev Andrey <45011689+heckad@users.noreply.github.com>
2021-03-15 10:45:04 -07:00
Miss Islington (bot)
c3f03333c3
bpo-43199: Briefly explain why no goto (GH-24852)
Answer "Why is there no goto?" in the Design and History FAQ.
(cherry picked from commit 5e29021a5e)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2021-03-14 21:21:36 -07:00
Miss Skeleton (bot)
03bfb07937
Doc: Do not suggest s[::-1] for reversed order (GH-22457)
(cherry picked from commit fb2e94692e)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-10-21 01:47:54 -07:00
Miss Skeleton (bot)
f72101bb62
Doc: Do not encourage using a base class name in a derived class (GH-22177)
(cherry picked from commit 4642ccd1c3)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-10-21 17:11:13 +09:00
Miss Skeleton (bot)
e67f186898
bpo-41292: Fixes dead link to cx_freeze from Windows FAQ (GH-21463)
(cherry picked from commit 33242a9328)

Co-authored-by: Michel Samia <m.samia@seznam.cz>
2020-10-19 15:24:05 -07:00
Miss Skeleton (bot)
9b5e373aa8
Link to the msvcrt module from the Windows FAQ (GH-22268)
(cherry picked from commit 5d9e657517)

Co-authored-by: abdo <abd.nh25@gmail.com>
2020-10-19 15:08:36 -07:00
Miss Skeleton (bot)
0fbddb14dc
bpo-40341: Remove some "discouraged solutions" in Doc/faq/programming.rst (GH-22726) (GH-22727)
(cherry picked from commit a22a19f354)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2020-10-16 13:27:59 -07:00
Miss Skeleton (bot)
75dd70e1ce
bpo-41774: Tweak new programming FAQ entry (GH-22562)
Remove mention of space in "remove multiple items from list".
(cherry picked from commit 060937da98)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2020-10-05 07:53:26 -07:00
Miss Islington (bot)
868c8e41eb
bpo-41774: Add programming FAQ entry (GH-22402)
In the "Sequences (Tuples/Lists)" section, add
"How do you remove multiple items from a list".
(cherry picked from commit 5b0181d1f6)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2020-09-28 22:27:06 -07:00
Miss Islington (bot)
bafaf07275
[doc] Remove references to PyChecker. (GH-22054)
(cherry picked from commit dea82b6731)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-09-02 08:29:33 -05:00
Miss Islington (bot)
e2e033807f
Remove reference to Boa Constructor. (GH-22056)
(cherry picked from commit 1d25f5bf7b)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-09-02 08:29:16 -05:00
Miss Islington (bot)
429a86a120
bpo-41573: Update release versions in General FAQ (GH-21915) (#21938)
(cherry picked from commit 7173fc84e6)
Co-authored-by: wyz23x2 <52805709+wyz23x2@users.noreply.github.com>
2020-08-22 03:47:37 -04:00
Miss Islington (bot)
6860cf5387
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.htmlGH-how-do-i-write-a-function-with-output-parameters-call-by-reference).

This patch make the output hint just like prefix code block.
(cherry picked from commit 67acf74c4e)

Co-authored-by: Jiajie Zhong <zhongjiajie955@hotmail.com>
2020-08-09 11:54:26 -07:00
Miss Islington (bot)
083ed52832
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"
(cherry picked from commit 3fa4799c3f)

Co-authored-by: E-Paine <63801254+E-Paine@users.noreply.github.com>
2020-06-30 02:51:12 -07:00
Miss Islington (bot)
b155381314
bpo-24914: mention Python supports multiple paradigms in the FAQ (GH-20658) (GH-20737)
(cherry picked from commit 3ab3475c42)

Co-authored-by: Brett Cannon <brett@python.org>

Co-authored-by: Brett Cannon <brett@python.org>
2020-06-08 11:53:36 -07:00
Alex Povel
fd33cdbd05
Fix plural typo in documentation (GH-19799)
Co-authored-by: Alex Povel <python@alexpovel.de>
2020-04-29 19:17:12 -03:00
Zackery Spytz
caf1aadf3d
bpo-40348: Fix typos in the programming FAQ (GH-19729) 2020-04-26 20:23:52 -07:00
Cajetan Rodrigues
5aafa54879
bpo-40340: Separate examples more clearly in the programming FAQ (GH-19688) 2020-04-24 19:39:04 -04:00
Adorilson Bezerra
5807efd4c3
bpo-38558: Link to further docs from walrus operator mention in tutorial (GH-16973) 2020-02-03 18:11:19 +01:00
Gurupad Hegde
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
Serhiy Storchaka
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
Ammar Askar
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
Emily Morehouse
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
Antoine
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
avinassh
3aa48b88c7 bpo-36167: fix an incorrect capitalization (GH-14482) 2019-08-29 01:40:50 -04:00
Ilya Kamenshchikov
a0f7119f15 bpo-37352: Minor word-smithing for design.rst (GH #14730) 2019-07-16 08:13:38 -07:00
Terry Jan Reedy
6f2a8c0857
bpo-37456: Slash ('/') is now part of syntax. (GH-14627) 2019-07-06 18:13:02 -04:00
Aeros
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