[ python-Bugs-1119439 ] Python Programming FAQ should be updated for Python 2.4

[SourceForge.net]

Bugs item #1119439, was opened at 2005-02-09 12:17
Message generated for change (Comment added) made by tjreedy
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1119439&group_id=5470

Category: Documentation
Group: Python 2.4
Status: Open
Resolution: None
Priority: 5
Submitted By: Michael Hoffman (hoffmanm)
Assigned to: Skip Montanaro (montanaro)
Summary: Python Programming FAQ should be updated for Python 2.4

Initial Comment:
For example:

* "1.4.3 How do I iterate over a sequence in reverse
order?" should use reversed()
* "1.4.4   How do you remove duplicates from a list?"
should use set()
* "1.5.2   I want to do a complicated sort: can you do
a Schwartzian Transform in Python?" should use sort(key=)
* section 1.6 should use new-style classes

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

>Comment By: Terry J. Reedy (tjreedy)
Date: 2005-04-20 14:55

Message:
Logged In: YES 
user_id=593130

MH: by "a set of specific patches (in text form)" I meant an ascii 
text file with each item indicating a specific slice or location in 
the existing doc (possibly by quotation) and a suggested new text 
to insert.  The site/doc maintainers have said that this is enough: 
if they agree with the new text, they will add the latex markup and 
produce the 'real patch'.  Judging from your writing here, you 
seem quite capable of producing literate (ascii-text) sentences.

SM: I currently disagree with this being reopened.  1) The items 
may need updating (like much library code) but this does not 
make them wrong (buggy).  2) The "Programmer's FAQ' is not 
part of the official doc defining the language and implementation 
nor, last I knew, is it part of the distribution.  To me, it is one of 
hundred's of supplementary web pages, including the PEPs, 
some at python.org and some elsewhere. 3) the site gives its own 
address, not here, for submitting suggestions, like this, for 
improvememt.

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

Comment By: Skip Montanaro (montanaro)
Date: 2005-04-20 08:59

Message:
Logged In: YES 
user_id=44345

Let's leave this open.  It is a documentation bug/feature,
so I think it was
submitted to the correct place.

Skip


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

Comment By: Michael Hoffman (hoffmanm)
Date: 2005-04-20 04:06

Message:
Logged In: YES 
user_id=987664

That does not seem inappropriate. I unfortunately do not
have time to do a real patch at this point. But this might
be an excellent way for someone on comp.lang.python to help out.

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

Comment By: Sean Reifschneider (jafo)
Date: 2005-04-19 23:31

Message:
Logged In: YES 
user_id=81797

I've submitted this to the webmaster at python.org list for
pursual.  Michael Hoffman: If you can make a patch of the
suggested changes, to help the process along.  I'm
considering it closed here, please let me know if you think
is inappropriate?

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

Comment By: Terry J. Reedy (tjreedy)
Date: 2005-02-16 17:49

Message:
Logged In: YES 
user_id=593130

I believe the FAQs are only maintained at www.python.org 
and not at SourceForge.  If so, you should email your 
comments to webmaster at python.org and/or 
docs at python.org.

I strongly urge you to work your comments up into a set of 
specific patches (in text form).  In other words, give a 
specific suggested text to replace or augment the old one.  
Since there is no paid editor, this will make changes much 
easier and therefore more likely sooner.

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

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