Skip to content

Commit 989dd35

Browse files
zklausencukou
andcommitted
Add better attribute specification to docs
Co-authored-by: Petr Viktorin <[email protected]>
1 parent 65672f3 commit 989dd35

File tree

1 file changed

+13
-1
lines changed

1 file changed

+13
-1
lines changed

Doc/library/sys.rst

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,19 @@ always available. Unless explicitly noted otherwise, all variables are read-only
1414
.. data:: abi_info
1515

1616
An object containing information about the ABI of the currently running
17-
Python interpreter. The following attributes are available in cpython:
17+
Python interpreter.
18+
It should include information that affect the CPython ABI in ways that require
19+
a specific build of the interpreter chosen from variants that can co-exist on
20+
a single machine. For example, it does not encode the base OS (Linux or
21+
Windows), but does include pointer size since some systems support both 32-
22+
and 64- builds. The available entries are the same on all platforms; e.g.
23+
pointer_size is available even on 64-bit-only architectures.
24+
25+
New entries should be added when needed for a supported platform, or (for
26+
enabling an unsupported one) by core dev consensus. Entries should be removed
27+
following :pep:`387`.
28+
29+
The following attributes are available in cpython:
1830

1931
*pointer_bits* is the width of pointers in bits, as an integer, equivalent
2032
to ``8 * sizeof(void *)``, i.e. usually ``32`` or ``64``.

0 commit comments

Comments
 (0)