[Patches] [ python-Patches-634866 ] general corrections to 2.2.2 refman, p.1

noreply@sourceforge.net noreply@sourceforge.net
Wed, 13 Nov 2002 12:07:50 -0800


Patches item #634866, was opened at 2002-11-07 03:39
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=305470&aid=634866&group_id=5470

Category: Documentation
Group: Python 2.2.x
>Status: Pending
Resolution: None
Priority: 5
Submitted By: Alex Martelli (aleax)
Assigned to: Fred L. Drake, Jr. (fdrake)
Summary: general corrections to 2.2.2 refman, p.1

Initial Comment:
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.


----------------------------------------------------------------------

>Comment By: Fred L. Drake, Jr. (fdrake)
Date: 2002-11-13 15:07

Message:
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.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=305470&aid=634866&group_id=5470