Skip to content

Commit fa8b9c1

Browse files
miss-islingtonsobolevnhugovkAlexWaygood
authored
[3.11] gh-101100: Fix sphinx warnings in uuid.rst (GH-108805) (#108808)
(cherry picked from commit 21da498) Co-authored-by: Nikita Sobolev <[email protected]> Co-authored-by: Hugo van Kemenade <[email protected]> Co-authored-by: Alex Waygood <[email protected]>
1 parent fc114a7 commit fa8b9c1

File tree

2 files changed

+30
-22
lines changed

2 files changed

+30
-22
lines changed

Doc/library/uuid.rst

+30-21
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ random UUID.
2222
Depending on support from the underlying platform, :func:`uuid1` may or may
2323
not return a "safe" UUID. A safe UUID is one which is generated using
2424
synchronization methods that ensure no two processes can obtain the same
25-
UUID. All instances of :class:`UUID` have an :attr:`is_safe` attribute
25+
UUID. All instances of :class:`UUID` have an :attr:`~UUID.is_safe` attribute
2626
which relays any information about the UUID's safety, using this enumeration:
2727

2828
.. class:: SafeUUID
@@ -95,25 +95,34 @@ which relays any information about the UUID's safety, using this enumeration:
9595
A tuple of the six integer fields of the UUID, which are also available as six
9696
individual attributes and two derived attributes:
9797

98-
+------------------------------+-------------------------------+
99-
| Field | Meaning |
100-
+==============================+===============================+
101-
| :attr:`time_low` | the first 32 bits of the UUID |
102-
+------------------------------+-------------------------------+
103-
| :attr:`time_mid` | the next 16 bits of the UUID |
104-
+------------------------------+-------------------------------+
105-
| :attr:`time_hi_version` | the next 16 bits of the UUID |
106-
+------------------------------+-------------------------------+
107-
| :attr:`clock_seq_hi_variant` | the next 8 bits of the UUID |
108-
+------------------------------+-------------------------------+
109-
| :attr:`clock_seq_low` | the next 8 bits of the UUID |
110-
+------------------------------+-------------------------------+
111-
| :attr:`node` | the last 48 bits of the UUID |
112-
+------------------------------+-------------------------------+
113-
| :attr:`time` | the 60-bit timestamp |
114-
+------------------------------+-------------------------------+
115-
| :attr:`clock_seq` | the 14-bit sequence number |
116-
+------------------------------+-------------------------------+
98+
.. list-table::
99+
100+
* - Field
101+
- Meaning
102+
103+
* - .. attribute:: UUID.time_low
104+
- The first 32 bits of the UUID.
105+
106+
* - .. attribute:: UUID.time_mid
107+
- The next 16 bits of the UUID.
108+
109+
* - .. attribute:: UUID.time_hi_version
110+
- The next 16 bits of the UUID.
111+
112+
* - .. attribute:: UUID.clock_seq_hi_variant
113+
- The next 8 bits of the UUID.
114+
115+
* - .. attribute:: UUID.clock_seq_low
116+
- The next 8 bits of the UUID.
117+
118+
* - .. attribute:: UUID.node
119+
- The last 48 bits of the UUID.
120+
121+
* - .. attribute:: UUID.time
122+
- The 60-bit timestamp.
123+
124+
* - .. attribute:: UUID.clock_seq
125+
- The 14-bit sequence number.
117126

118127

119128
.. attribute:: UUID.hex
@@ -231,7 +240,7 @@ The :mod:`uuid` module defines the following namespace identifiers for use with
231240
text output format.
232241

233242
The :mod:`uuid` module defines the following constants for the possible values
234-
of the :attr:`variant` attribute:
243+
of the :attr:`~UUID.variant` attribute:
235244

236245

237246
.. data:: RESERVED_NCS

Doc/tools/.nitignore

-1
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,6 @@ Doc/library/unittest.mock.rst
138138
Doc/library/unittest.rst
139139
Doc/library/urllib.parse.rst
140140
Doc/library/urllib.request.rst
141-
Doc/library/uuid.rst
142141
Doc/library/weakref.rst
143142
Doc/library/wsgiref.rst
144143
Doc/library/xml.dom.minidom.rst

0 commit comments

Comments
 (0)