Skip to content

Commit 5f42184

Browse files
[3.13] Prefer "similar" over "equivalent" in tutorial (pythonGH-125343) (pythonGH-125372)
Prefer "similar" over "equivalent" in tutorial (pythonGH-125343) In the datastructures tutorial doc, some operations are described as "equivalent to" others. This has led to some user-confusion -- at least in the Discourse forums -- about cases in which the operations differ. This change doesn't systematically eliminate the word "equivalent" from the tutorial. It just substitutes "similar to" in several cases in which "equivalent to" could mislead users into expecting exact equivalence. (cherry picked from commit 4a2282b) Co-authored-by: Stephen Rosen <[email protected]>
1 parent 9304416 commit 5f42184

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

Doc/tutorial/datastructures.rst

+4-4
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,13 @@ objects:
1919
.. method:: list.append(x)
2020
:noindex:
2121

22-
Add an item to the end of the list. Equivalent to ``a[len(a):] = [x]``.
22+
Add an item to the end of the list. Similar to ``a[len(a):] = [x]``.
2323

2424

2525
.. method:: list.extend(iterable)
2626
:noindex:
2727

28-
Extend the list by appending all the items from the iterable. Equivalent to
28+
Extend the list by appending all the items from the iterable. Similar to
2929
``a[len(a):] = iterable``.
3030

3131

@@ -56,7 +56,7 @@ objects:
5656
.. method:: list.clear()
5757
:noindex:
5858

59-
Remove all items from the list. Equivalent to ``del a[:]``.
59+
Remove all items from the list. Similar to ``del a[:]``.
6060

6161

6262
.. method:: list.index(x[, start[, end]])
@@ -93,7 +93,7 @@ objects:
9393
.. method:: list.copy()
9494
:noindex:
9595

96-
Return a shallow copy of the list. Equivalent to ``a[:]``.
96+
Return a shallow copy of the list. Similar to ``a[:]``.
9797

9898

9999
An example that uses most of the list methods::

0 commit comments

Comments
 (0)