This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: very minor doc bug in 'listsort.txt'
Type: Stage:
Components: Documentation Versions: Python 2.4
process
Status: closed Resolution: wont fix
Dependencies: Superseder:
Assigned To: Nosy List: gyrof, rhettinger, terry.reedy, tim.peters
Priority: normal Keywords:

Created on 2005-03-30 15:42 by gyrof, last changed 2022-04-11 14:56 by admin. This issue is now closed.

Messages (6)
msg24823 - (view) Author: gyrof (gyrof) Date: 2005-03-30 15:42
Tim Peter's explanation of 'timsort' in the file
'listsort.txt' is just excellent. 
I would recommend, however, that all occurrences of
'data is' be replaced by 'data are'.

Just a minor nit.

-gyro
msg24824 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2005-03-30 19:06
Logged In: YES 
user_id=593130

While I agree that 'data are' when 'data' is used in isolation, I can 
see combinations such as 'list data' being equivalent to 'dataset', 
which 'is'.  So I would have to see examples of context to be sure 
I agreed with your recommendation.

In any case, listsort.txt is an optional implementation note and not 
part of the official reference docs (and not accessible that I know 
of via docs.python.org).  Hence, a fix, even if agreed to, would 
have very low priority unless Tim or a doc maven got 'bugged' by 
it.  Are you willing to make a revised file and a diff that would 
verify that only appropriate changes were made?
msg24825 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2005-03-30 20:46
Logged In: YES 
user_id=80475

Sorry.  Am closing this to eliminate noise from the tracker.
 The grammar nit arguable and inconsequential (because it is
not in the main documentation and is readable as-ias).
msg24826 - (view) Author: gyrof (gyrof) Date: 2005-03-30 21:51
Logged In: YES 
user_id=1249584

It is a very minor issue, but the change is not arguable
from the perspective of correct English grammar.

If I submit a diff, will it (eventually) be reviewed or applied?

-gyro
msg24827 - (view) Author: Tim Peters (tim.peters) * (Python committer) Date: 2005-03-30 22:01
Logged In: YES 
user_id=31435

I mentally replaced "data is" by "data are", and disliked how 
it read then.  So, no, I won't apply such a patch.  English 
grammar changes over time to match what careful English 
speakers actually use, so I'll view this is a crusade to stamp 
out effete elitism -- "data are" my ass <wink>.
msg24828 - (view) Author: gyrof (gyrof) Date: 2005-03-30 22:24
Logged In: YES 
user_id=1249584

Fair enough. I should have known that Mr. Peters would have
considered this already. 

Just-trying-to-make-Python-docs-more-appealing-to-pedants-like-me'ly
yours,
gyro
History
Date User Action Args
2022-04-11 14:56:10adminsetgithub: 41778
2005-03-30 15:42:25gyrofcreate