Repository navigation
[sqlite3] remove "non-standard" from docstrings #91034
Description
Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.
Show more details
GitHub fields:
assignee = None
closed_at = None
created_at = <Date 2022-02-28.10:50:28.210>
labels = ['3.11']
title = '[sqlite3] remove "non-standard" from docstrings'
updated_at = <Date 2022-03-08.15:31:12.521>
user = 'https://github.com/erlend-aasland'bugs.python.org fields:
activity = <Date 2022-03-08.15:31:12.521>
actor = 'miss-islington'
assignee = 'none'
closed = False
closed_date = None
closer = None
components = []
creation = <Date 2022-02-28.10:50:28.210>
creator = 'erlendaasland'
dependencies = []
files = []
hgrepos = []
issue_num = 46878
keywords = ['patch']
message_count = 5.0
messages = ['414186', '414203', '414720', '414759', '414760']
nosy_count = 3.0
nosy_names = ['JelleZijlstra', 'miss-islington', 'erlendaasland']
pr_nums = ['31612', '31753', '31754']
priority = 'normal'
resolution = None
stage = 'patch review'
status = 'open'
superseder = None
type = None
url = 'https://bugs.python.org/issue46878'
versions = ['Python 3.11']
Activity
erlend-aasland commentedon Feb 28, 2022
Several sqlite3 methods are "marked" as non-standard in their docstrings. This is an historic artefact which (I assume) implies that a method is not a part of the DB-API defined by PEP-249. Questions regarding the "non-standard" strings arise from time to time, as the meaning is not immediately obvious.
The question surfaced in a code review in October 20211, and again in a more recent PR2.
Suggesting to purge "non-standard" from all docstrings once and for all to avoid more confusion.
Footnotes
https://github.com/python/cpython/pull/28463#discussion_r724371832 ↩
https://github.com/python/cpython/pull/26728#discussion_r815523101 ↩
JelleZijlstra commentedon Feb 28, 2022
As one of the people confused by this wording, I agree with dropping it. There is no documentation that I can find that explains what "non-standard" means.
I'll leave the PR for some time though in case others have objections.
JelleZijlstra commentedon Mar 8, 2022
New changeset 4d95fa1 by Erlend Egeberg Aasland in branch 'main':
bpo-46878: Purge 'non-standard' from sqlite3 docstrings (GH-31612)
4d95fa1
miss-islington commentedon Mar 8, 2022
New changeset f3d3b2d by Erlend Egeberg Aasland in branch '3.10':
[3.10] bpo-46878: Purge 'non-standard' from sqlite3 docstrings (GH-31612) (GH-31753)
f3d3b2d
miss-islington commentedon Mar 8, 2022
New changeset 653ca6c by Erlend Egeberg Aasland in branch '3.9':
[3.9] bpo-46878: Purge 'non-standard' from sqlite3 docstrings (GH-31612) (GH-31754)
653ca6c