AN Long
b4240fd68e
gh-114955: Add clear to MutableSequence's mixin methods in document (gh-114956)
2024-02-03 09:33:58 -06:00
Mariusz Felisiak
28bb2961ba
Update LOGGING example taken from Django docs. ( #114903 )
...
For example, Django no longer provides a custom NullHandler
6c66a41c3d
* Remove require_debug_true.
2024-02-03 09:37:21 +02:00
Skip Montanaro
00d7109075
Normalize heading underline in multiprocessing.rst ( #114923 )
...
This gets rid of the mildly confusing `>>>>>>>' underlines which look vaguely like `diff` punctuation.
2024-02-02 17:56:00 -08:00
Terry Jan Reedy
1183f1e6bf
gh-114913: Add newline to subprocess doc ( #114941 )
...
*creationflags* is a separate topic from *startupinfo*.
Start sentence with 'If given', like previous sentence.
2024-02-02 23:14:32 +00:00
John Belmonte
73d20cafb5
Correct timedelta description (GH-101417)
...
It only represents the difference between two datetime or
date objects, not between two time objects.
2024-02-02 23:42:17 +02:00
Serhiy Storchaka
b27812d632
Fix indentation of "versionchanged" in datetime.rst (GH-114933)
2024-02-02 23:09:16 +02:00
Serhiy Storchaka
c12240ed28
gh-114728: Fix documentation for comparison of objects in datetime module (GH-114749)
2024-02-02 20:53:24 +02:00
patenaud
9872855a31
GH-69695: Update `PyImport_ImportModule` description (GH-103836)
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-02-02 17:31:55 +01:00
Steven Ward
ee66c33349
gh-114909: Add --first-weekday option to usage message ( #114910 )
2024-02-02 17:13:00 +02:00
Justin Williams
d29f57f603
gh-103360: Add link in stdtypes.rst to escape sequences in lexical_analysis.rst (GH-103638)
2024-02-02 15:32:46 +02:00
Sam Gross
d0f1307580
gh-114329: Add PyList_GetItemRef function (GH-114504)
...
The new `PyList_GetItemRef` is similar to `PyList_GetItem`, but returns
a strong reference instead of a borrowed reference. Additionally, if the
passed "list" object is not a list, the function sets a `TypeError`
instead of calling `PyErr_BadInternalCall()`.
2024-02-02 14:03:15 +01:00
Michal Kaptur
53339a0ef7
Move "format" param doc of shutil.make_archive() on its own paragraph (GH-103829)
2024-02-02 10:00:18 +00:00
Oleg Iarygin
500ede0117
gh-89891: Refer SharedMemory implementation as POSIX (GH-104678)
...
It only uses POSIX API.
2024-02-01 19:57:36 +00:00
Nikita Sobolev
dc01b919c7
gh-101100: Fix sphinx warnings in howto/logging.rst ( #114846 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-02-01 20:37:55 +02:00
Skip Montanaro
c9c6e04380
Correct description of inheriting from another class ( #114660 )
...
"inherits <someclass>" grates to this reader. I think it should be "inherits from <someclass>".
2024-02-01 10:07:16 -08:00
Nicholas Hollander
e9dab65638
gh-105031: Clarify datetime documentation for ISO8601 (GH-105049)
2024-02-01 17:24:15 +00:00
Guido van Rossum
2dea1cf7fd
Write about Tier 2 and JIT in "what's new 3.13" ( #114826 )
...
(This will soon be superseded by Ken Jin's much more detailed version.)
2024-02-01 08:54:44 -08:00
Christophe Nanteuil
de6f97cd35
Fix typos in ElementTree documentation (GH-108848)
...
PI objects instead of comment objects.
2024-02-01 11:34:04 +02:00
technillogue
5ce193e65a
gh-114364: Fix awkward wording about mmap.mmap.seekable ( #114374 )
...
---------
Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
2024-02-01 06:03:58 +00:00
srinivasan
57c3e775df
gh-114648: Add IndexError exception to tutorial datastructures list.pop entry ( #114681 )
...
Remove redundant explanation of optional argument.
2024-01-31 22:46:49 -05:00
Skip Montanaro
586057e9f8
gh-67230: Add versionadded notes for QUOTE_NOTNULL and QUOTE_STRINGS ( #114816 )
...
As @GPHemsley pointed out, #29469 omitted `versionadded` notes for the 2 new items.
2024-01-31 22:11:16 -05:00
Pradyot Ranjan
ff8939e5ab
gh-114811: Change '\*' to '*' in warnings.rst ( #114819 )
...
Regression in 3.12.
2024-01-31 20:48:39 -05:00
Aidan Holm
a79a27242f
gh-111112: Avoid potential confusion in TCP server example. ( #111113 )
...
Improve misleading TCP server docs and example.
socket.recv(), as documented by the Python reference documentation,
returns at most `bufsize` bytes, and the underlying TCP protocol means
there is no guaranteed correspondence between what is sent by the client
and what is received by the server.
This conflation could mislead readers into thinking that TCP is
datagram-based or has similar semantics, which will likely appear to
work for simple cases, but introduce difficult to reproduce bugs.
2024-01-31 16:42:38 -08:00
Bradley Reynolds
1836f674c0
Add note to sys.orig_argv clarifying the difference from sys.argv ( #114630 )
...
Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2024-01-31 13:33:28 -08:00
Skip Montanaro
7a93db4425
gh-101100: Fix class reference in library/test.rst (GH-114769)
...
The text clearly seems to be referencing `TestFuncAcceptsSequencesMixin`,
for which no target is available. Name the class properly and suppress
the dangling reference.
2024-01-31 11:33:10 +02:00
Erlend E. Aasland
c8cf5d7d14
Docs: mark up dbm.gnu.open() and dbm.ndbm.open() using param list ( #114762 )
2024-01-31 07:59:34 +01:00
Skip Montanaro
3911b42cc0
gh-101100: Fix references in csv docs (GH-114658)
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-01-30 21:54:37 +00:00
Barney Gale
fda7445ca5
GH-70303: Make pathlib.Path.glob('**') return both files and directories ( #114684 )
...
Return files and directories from `pathlib.Path.glob()` if the pattern ends
with `**`. This is more compatible with `PurePath.full_match()` and with
other glob implementations such as bash and `glob.glob()`. Users can add a
trailing slash to match only directories.
In my previous patch I added a `FutureWarning` with the intention of fixing
this in Python 3.15. Upon further reflection I think this was an
unnecessarily cautious remedy to a clear bug.
2024-01-30 19:52:53 +00:00
Terry Jan Reedy
a1332a99cf
Clarify one-item tuple ( #114745 )
...
A 'single tuple' means 'one typle, of whatever length.
Remove the unneeded and slight distracting parenthetical 'singleton' comment.
2024-01-30 18:40:54 +00:00
Pablo Galindo Salgado
39d102c2ee
gh-113744: Add a new IncompleteInputError exception to improve incomplete input detection in the codeop module ( #113745 )
...
Signed-off-by: Pablo Galindo <pablogsal@gmail.com>
2024-01-30 16:21:30 +00:00
Hugo van Kemenade
4287e8608b
gh-109975: Copyedit "What's New in Python 3.13" ( #114401 )
...
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2024-01-30 17:12:11 +02:00
Serhiy Storchaka
ea30a28c3e
gh-113732: Fix support of QUOTE_NOTNULL and QUOTE_STRINGS in csv.reader (GH-113738)
2024-01-30 14:21:12 +02:00
Hugo van Kemenade
3996cbdd33
Set hosted_on for Read the Docs builds ( #114697 )
2024-01-29 14:24:21 -07:00
Steven Ward
2c089b09ac
gh-112240: Add option to calendar module CLI to specify the weekday to start each week (GH-112241)
2024-01-29 16:58:21 +00:00
Serhiy Storchaka
39c766b579
Fix more references to datetime and time classes (GH-114717)
...
They could be confused with references to datetime and time modules.
2024-01-29 18:20:13 +02:00
Soumendra Ganguly
e351ca3c20
gh-85984: Add POSIX pseudo-terminal functions. (GH-102413)
...
Signed-off-by: Soumendra Ganguly <soumendraganguly@gmail.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2024-01-29 16:10:28 +00:00
Skip Montanaro
e8b8f5e9c2
gh-101100: Fix datetime reference warnings (GH-114661)
...
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2024-01-29 16:43:44 +02:00
Hugo van Kemenade
b7a12ab214
gh-101100: Fix Sphinx warnings in whatsnew/2.2.rst ( #112366 )
...
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2024-01-29 13:12:19 +00:00
Nikita Sobolev
97fb2480e4
gh-101100: Fix sphinx warnings in Doc/c-api/memoryview.rst (GH-114669)
2024-01-29 11:56:11 +02:00
Shantanu
3b86891fd6
gh-110893: Improve the documentation for __future__ module ( #114642 )
...
nedbat took issue with the phrasing "real module". I'm actually fine
with that phrasing, but I do think the `__future__` page should be clear
about the way in which the `__future__` module is special. (Yes, there
was a footnote linking to the future statements part of the reference,
but there should be upfront discussion).
I'm sympathetic to nedbat's claim that no one really cares about
`__future__._Feature`, so I've moved the interesting table up to the
top.
2024-01-29 01:37:28 -08:00
Stanley
d7d0d13cd3
gh-89159: Add some TarFile attribute types (GH-114520)
...
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
2024-01-29 09:19:22 +00:00
Hugo van Kemenade
3bb6912d88
gh-100734: Add 'Notable change in 3.11.x' to whatsnew/3.11.rst ( #114657 )
...
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2024-01-28 20:28:25 +00:00
Bhushan Mohanraj
d00fbed68f
Fix indentation in __post_init__ documentation. (gh-114666)
2024-01-28 15:10:32 -05:00
Skip Montanaro
5ecfd750b4
Correction Skip Montanaro's email address ( #114677 )
2024-01-28 14:51:25 +00:00
Nikita Sobolev
a384b20c0c
gh-101100: Fix sphinx warnings in reference/import.rst ( #114646 )
2024-01-27 07:30:21 -07:00
Hugo van Kemenade
b6623d61d4
gh-101100: Fix Sphinx warnings in whatsnew/3.11.rst and related ( #114531 )
2024-01-27 06:06:59 -07:00
Nikita Sobolev
6a8944acb6
gh-101100: Fix sphinx warnings in library/email.mime.rst (GH-114635)
2024-01-27 10:45:40 +02:00
Nikita Sobolev
23fb9f0777
Fix c-api/file.rst indexes (GH-114608)
2024-01-27 10:45:07 +02:00
Sergey B Kirpichev
926881dc10
gh-113445: Amend PyObject_RichCompareBool() docs (GH-113891)
2024-01-27 09:55:33 +02:00
Barney Gale
7e31d6dea2
gh-88569: add ntpath.isreserved() ( #95486 )
...
Add `ntpath.isreserved()`, which identifies reserved pathnames such as "NUL", "AUX" and "CON".
Deprecate `pathlib.PurePath.is_reserved()`.
---------
Co-authored-by: Eryk Sun <eryksun@gmail.com>
Co-authored-by: Brett Cannon <brett@python.org>
Co-authored-by: Steve Dower <steve.dower@microsoft.com>
2024-01-26 18:14:24 +00:00