Commit Graph

11220 Commits

Author SHA1 Message Date
Miss Islington (bot) a41b51d2ea
gh-95273: Improve sqlite3 class descriptions (GH-95379)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit e003b64f40)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2022-07-29 03:00:29 -07:00
Miss Islington (bot) 2278dc7442
gh-95273: Condense sqlite3 executescript example (GH-95383) (#95419)
(cherry picked from commit e9c8de669d)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2022-07-29 10:44:29 +02:00
Miss Islington (bot) f59a5c5363
gh-95273: Move sqlite3 executemany examples from reference to tutorial (GH-95351)
(cherry picked from commit f0bf7956e6)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2022-07-29 00:48:55 -07:00
Miss Islington (bot) 5632c98f4a
Improve documentation for adding datetime and timedelta (gh-95403) (gh-95409)
(cherry picked from commit 6e44bf9558)

Co-authored-by: BenjaminHelyer <91896754+BenjaminHelyer@users.noreply.github.com>

Co-authored-by: BenjaminHelyer <91896754+BenjaminHelyer@users.noreply.github.com>
2022-07-28 20:15:24 -04:00
Miss Islington (bot) 196523f32b
gh-86128: Add warning to ThreadPoolExecutor docs about atexit behaviour (GH-94008)
(cherry picked from commit 7df2f4d787)

Co-authored-by: [object Object] <lucas.wiman@gmail.com>
2022-07-28 15:48:19 -07:00
Miss Islington (bot) dcb6fa8099
Docs: Fix refs & tweak wording in sqlite3 'Using shortcut methods' (#95358)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit ea269b9a38)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-28 12:32:20 +02:00
Erlend Egeberg Aasland 2ef7a72682
[3.10] gh-95273: Normalise sqlite3 reference wording (GH-95274) (#95330)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>.
(cherry picked from commit 2361908a9d)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2022-07-27 15:42:59 +02:00
Miss Islington (bot) 7e7a570818
gh-94630: Fixup sqlite3 argument spec docs for connection execute* methods (GH-95319)
(cherry picked from commit 2b37395612)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-27 05:54:14 -07:00
Miss Islington (bot) 321b8bbf0f
gh-94635: Add sqlite3 'Introduction' and 'Tutorial' doc headings (GH-95269)
(cherry picked from commit 2e35a13e46)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-26 22:49:29 -07:00
Erlend Egeberg Aasland a4fd732155
[3.10] gh-95235: Add explicit parameter list to some sqlite3 methods (GH-95240) (#95268)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>.
(cherry picked from commit 5012bedc7c)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-26 10:12:50 +02:00
Miss Islington (bot) 0418d9f2f3
gh-95235: Document undocumented parameters in sqlite3 functions and methods (GH-95236)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit ac6a94c669)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-25 09:55:46 -07:00
Miss Islington (bot) e50a63ed18
Closes gh-95133: docs, fix indentation level in TestCase.assertLogs example (GH-95134)
(cherry picked from commit 2a9c227ac1)

Co-authored-by: Alexandru Mărășteanu <alexei@users.noreply.github.com>
2022-07-22 09:45:58 -07:00
Miss Islington (bot) 02f1cac282
gh-81040: Improve sqlite3.Cursor.rowcount docs (GH-94940)
(cherry picked from commit f9b3706df6)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-22 00:41:56 -07:00
Miss Islington (bot) 95ae29d508
Fix incorrect double indent in ast doc (GH-94976)
Warning directive indent was 4 rather than 3 spaces.
(cherry picked from commit a25a803c4c)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2022-07-18 10:33:47 -07:00
Miss Islington (bot) a923eb47c2
In ast doc, update 'below' to 'above' (GH-94967)
The included asdl file was moved from 'below' to 'above' in 3.9.
(cherry picked from commit 7b617be4ab)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2022-07-18 09:45:09 -07:00
Miss Islington (bot) 6654392587
Add additional pointers to pathlib's mapping to os.path functions (GH-94828)
* Add additional pointers to pathlib's mapping to os.path functions

os.path.splitext has a somewhat quirky signature since it mixes the path and filename components but I wanted the documentation to mention `PurePath.stem` as the natural counterpart to `PurePath.suffix` for the common use of `os.path.splitext` to turn "file.py" into "file" and "py".

Technically this could have some discussion of how to handle the parent directory hierarchy but that seems a bit out of keeping with the spirit of this table so I omitted mentioning `PurePath.parents` here.

* Update Doc/library/pathlib.rst

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit 3789c63577)

Co-authored-by: Chris Adams <chris@improbable.org>
2022-07-15 15:16:45 -07:00
Miss Islington (bot) c5bf768a53
[3.10] [doc] Update cookbook example and add information about queue types. (GH-94854) (GH-94872)
(cherry picked from commit dc54193095)
2022-07-15 08:18:30 +01:00
Miss Islington (bot) 1cf0305ba5
Docs: fix typo in sqlite3.rst (GH-94798)
Colum -> Column
(cherry picked from commit 9ea72e9d8d)

Co-authored-by: Ikko Ashimine <eltociear@gmail.com>
2022-07-14 14:58:14 -07:00
Miss Islington (bot) 30015de723
GH-77265: Document NaN handling in statistics functions that sort or count (GH-94676) (#94725) 2022-07-10 12:36:01 -05:00
Miss Islington (bot) da4912885f
Use mdash-es consistently in the library docs index (GH-92762)
(cherry picked from commit efb20a97c4)

Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>
2022-07-08 07:50:56 -07:00
Erlend Egeberg Aasland 691d26a17f
[3.10] gh-94622: Add more references to the sqlite3 types anchor (GH-94623). (#94679)
(cherry picked from commit e5b841a403)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-08 02:50:12 +02:00
Erlend Egeberg Aasland 797745e749
[3.10] gh-94321: Document sqlite3.PrepareProtocol (GH-94620) (#94671)
(cherry picked from commit fb6dccae34)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-08 01:44:09 +02:00
Guy Yagev 860aefaeca
gh-92743: Remove copyright sign next to "Raymond Hettinger" (#94665)
Closes GH-92743
2022-07-07 14:31:39 -07:00
Erlend Egeberg Aasland 663aa6e7d9
[3.10] gh-94628: Add explicit parameter list to sqlite3.connect docs (GH-94629) (#94646)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>.
(cherry picked from commit 3eb2b9634f)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-07 10:46:29 +02:00
Miss Islington (bot) 7f45ae859a
gh-94630: Update sqlite3 docs with positional-only and keyword-only symbols (GH-94631)
(cherry picked from commit 94988603f3)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-06 16:21:05 -07:00
Miss Islington (bot) 7e3b6affa0
gh-94017: Improve clarity of sqlite3 transaction handling docs (GH-94320)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit 760b8cf0c8)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2022-07-06 14:07:36 -07:00
Łukasz Langa fd34bfe484
[3.10] gh-91330: Tests and docs for dataclass descriptor-typed fields (GH-94424) (GH-94577)
Co-authored-by: Erik De Bonte <erikd@microsoft.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit 5f319308a8)
2022-07-05 20:45:02 +02:00
Vinay Sajip 3287e45847
[3.10] bpo-46755: Don't log stack info twice in QueueHandler (GH-31355) (GH-94565)
Co-authored-by: Erik Montnemery <erik@montnemery.com>
2022-07-05 16:04:29 +01:00
Łukasz Langa 6e47020d31
[3.10] Docs: remove redundant "adverb-adjective" hyphens from compound modifiers (GH-94551) (GH-94558)
Discussion: https://discuss.python.org/t/slight-grammar-fix-throughout-adverbs-dont-need-hyphen/17021
(cherry picked from commit 3440d197a5)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2022-07-05 14:30:37 +02:00
Vinay Sajip 817414321c
[3.10] Update logging documentation: change cross-reference and add webapp r… (GH-94542) 2022-07-04 09:10:13 +01:00
Miss Islington (bot) d793ebc11d
IDLE doc: Tweek RESTART and Windows console start (GH-94530)
(cherry picked from commit 39c29f753e)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2022-07-03 10:39:20 -07:00
Miss Islington (bot) cf1732619a
gh-81054: Document that SimpleHTTPRequestHandler follows symbolic links (GH-94416) (GH-94493)
(cherry picked from commit 80aaeabb8b)

Co-authored-by: Sam Ezeh <sam.z.ezeh@gmail.com>
2022-07-01 18:41:40 +02:00
Miss Islington (bot) e55cd03c15
Update code sample when importing modules in queue doc (GH-94244) (GH-94491)
In the queue documentation, the code snippet shows the import to be not PEP 8 compliant.

Since people typically copy-paste from such code samples, I think it's important to show best-practices here.
(cherry picked from commit ad55147c1d)

Co-authored-by: Mariatta Wijaya <Mariatta@users.noreply.github.com>
2022-07-01 18:15:06 +02:00
Miss Islington (bot) b8544e18e6
multiprocessing.spawn doc: Capitalize the p in "Python" (gh-94462)
(cherry picked from commit 62bb7a3b50)

Co-authored-by: Mariatta Wijaya <Mariatta@users.noreply.github.com>
2022-06-30 11:22:58 -07:00
Miss Islington (bot) d915ed2978
xml.dom.minidom docs: fix typo (GH-93437)
(cherry picked from commit 639e35108b)

Co-authored-by: Jean-Christophe Helary <jean.christophe.helary@traduction-libre.org>
2022-06-30 10:16:06 -07:00
Miss Islington (bot) e721da5d39
gh-89038: [doc] update dis.findlinestarts documentation for changes related to PEP-626 (GH-94247) (GH-94449)
(cherry picked from commit d68f2d27bb)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
2022-06-30 16:39:48 +01:00
Miss Islington (bot) 2bf974ec84
[3.10] bpo-92336: [doc] clarify that the dfile is read by the traceback display code (GH-94409) (GH-94429)
(cherry picked from commit 68fb03249f)


Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>

Automerge-Triggered-By: GH:iritkatriel
2022-06-29 13:54:44 -07:00
Miss Islington (bot) eb7d354817
[3.10] gh-82006: IDLE doc improvements (GH-94349) (GH-94358)
0. Update text start and stop conditions.
1. Title-case sections but not subsections.
2. Edit Shell Window sections: title, execute, restart.
(cherry picked from commit e6391e08bf)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2022-06-28 12:50:58 +02:00
Miss Islington (bot) 5f3b45a7f4
gh-70474: [doc] fix wording of GET_ANEXT doc (GH-94048)
(cherry picked from commit 9af6b75298)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
2022-06-25 15:52:06 -07:00
Erlend Egeberg Aasland deb4d0457f
[3.10] gh-90016: Reword sqlite3 adapter/converter docs (GH-93095) (#94273)
Also add adapters and converter recipes.

Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com.
(cherry picked from commit bd3c1c187e)
2022-06-25 22:55:38 +02:00
Miss Islington (bot) 64892c5e36
Docs: Remove `Provides [...]` from `multiprocessing.shared_memory` description (GH-92761)
(cherry picked from commit a91ffcf3fa)

Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>
2022-06-24 10:16:54 -07:00
Miss Islington (bot) e51a22b6f6
gh-74696: Do not change the current working directory in shutil.make_archive() if possible (GH-93160) (GH-94106)
It is no longer changed when create a zip or tar archive.

It is still changed for custom archivers registered with shutil.register_archive_format()
if root_dir is not None.

Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit fda4b2f063)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2022-06-22 11:18:37 +02:00
Miss Islington (bot) ad2e9f97c2
bpo-30535: [doc] state that sys.meta_path is not empty by default (GH-94098) (GH-94100)
Co-authored-by: Windson yang <wiwindson@outlook.com>
(cherry picked from commit 6575841266)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
2022-06-21 23:05:08 +01:00
Łukasz Langa 9ab245f8ca
[3.10] gh-93675: Fix typos in `Doc/` (GH-93676) (GH-94080)
Closes GH-93675
(cherry picked from commit 830513754d)

Co-authored-by: luzpaz <luzpaz@users.noreply.github.com>
2022-06-21 21:39:08 +02:00
Łukasz Langa 38fdff9274
[3.10] gh-93851: Fix all broken links in Doc/ (GH-93853) (GH-94078)
(cherry picked from commit f62ff97f31)

Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>
2022-06-21 21:37:09 +02:00
Miss Islington (bot) 223fde359a
gh-86986: Drop compatibility support for Sphinx 2 (GH-93737)
* Revert "bpo-42843: Keep Sphinx 1.8 and Sphinx 2 compatibility (GH-24282)"

This reverts commit 5c1f15b4b1

* Revert "bpo-42579: Make workaround for various versions of Sphinx more robust (GH-23662)"

This reverts commit b63a620014.
(cherry picked from commit 0efe3a1636)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2022-06-21 10:51:23 -07:00
Miss Islington (bot) cdf3689aa5
gh-61162: Clarify sqlite3 connection context manager docs (GH-93890)
Explicitly note that transactions are only closed if there is an open
transation at `__exit__`, and that transactions are not implicitly
opened during `__enter__`.

Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>

Automerge-Triggered-By: GH:erlend-aasland
(cherry picked from commit 8e08978141)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-06-19 13:25:55 -07:00
Erlend Egeberg Aasland c4440e6bc0
[3.10] gh-93925: Improve clarity of sqlite3 commit/rollback, and close docs (GH-93926) (#94011)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>.
(cherry picked from commit 6446592c89)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2022-06-19 21:43:03 +02:00
Kumar Aditya 5163a25354
gh-91877: Fix WriteTransport.get_write_buffer_{limits,size} docs (#92338) (#93805)
- Amend docs for WriteTransport.get_write_buffer_limits
- Add docs for WriteTransport.get_write_buffer_size

Co-authored-by: Sanket Shanbhag <TechieBoy@users.noreply.github.com>
2022-06-16 18:19:17 +02:00
Miss Islington (bot) e929dae42a
gh-93857: Fix broken audit-event targets in sqlite3 docs (GH-93859)
Corrected targets for the following audit-events:

- sqlite3.enable_load_extension => sqlite3.Connection.enable_load_extension
- sqlite3.load_extension => sqlite3.Connection.load_extension
(cherry picked from commit ce4d11f98b)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-06-15 07:24:50 -07:00