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: general corrections to 2.2.2 refman, p.1
Type: Stage:
Components: Documentation Versions: Python 2.2
process
Status: closed Resolution:
Dependencies: Superseder:
Assigned To: rhettinger Nosy List: aleax, fdrake, rhettinger
Priority: normal Keywords: patch

Created on 2002-11-07 08:39 by aleax, last changed 2022-04-10 16:05 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
ref22_p1.patch aleax, 2002-11-07 08:39 corrections to 2.2.2 refman, first part
ref22_p1a.patch aleax, 2002-11-16 23:16 updated corrections to 2.2.2 refman, first part
Messages (4)
msg41585 - (view) Author: Alex Martelli (aleax) * (Python committer) Date: 2002-11-07 08:39
as per email exchanges with F. Drake, here's a first part of 
suggested corrections to the 2.2.2 reference manual, mostly 
to make it reflect a bit better the way Python currently works.
msg41586 - (view) Author: Fred Drake (fdrake) (Python committer) Date: 2002-11-13 20:07
Logged In: YES 
user_id=3066

Alex, a few nits:

- In the first chunk, I suspect you meant "triple-quoted
string literal", not "raw string literal".

- "e.g." and "i.e." should be avoided with great prejudice.
 I've been removing them from the rest of the documentation
as I've had time.

- "\C" and "\C{}" should both be replaced with just "C"
whenever found.

- When you refer to the "C or Java implementation", realize
that the Java implementation is more deterministic; Java
ints are 32 bits, period, IIRC.

- There is not __iterkeys__(), only iterkeys().

I have not tried applying the patch to test formatting.

Ok, it sounds like a lot of things, but they're all rather
small.  Your patch really helps; thanks!

If you can make these changes and post an updated patch, it
shouldn't take long to get it committed.  I've marked the
patch "pending" since I'm waiting for changes.
msg41587 - (view) Author: Alex Martelli (aleax) * (Python committer) Date: 2002-11-16 23:16
Logged In: YES 
user_id=60314

OK, corrected my mistakes and nuked all \C, e.g. and i.e. from 
chapters 2, 3, 6 (the chapters affected by the patch).
msg41588 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2003-01-19 13:12
Logged In: YES 
user_id=80475

Reviewed diff, fixed markup, add Py2.3 features, clipped a 
couple more \C{}, removed more i.e. and e.g.  and applied 
to Python2.3 with a note to backport.

See ref2.tex 1.47, ref3.tex 1.97, and ref6.tex 1.61.
History
Date User Action Args
2022-04-10 16:05:49adminsetgithub: 37432
2002-11-07 08:39:41aleaxcreate