Bugs item #1119439, was opened at 2005-02-09 11:17
Message generated for change (Comment added) made by montanaro
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: A.M. Kuchling (akuchling)
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: Skip Montanaro (montanaro)
Date: 2005-04-20 15:04
Message:
Logged In: YES
user_id=44345
(Last comment crossed paths with change to akuchling -
restoring)
----------------------------------------------------------------------
Comment By: Skip Montanaro (montanaro)
Date: 2005-04-20 14:22
Message:
Logged In: YES
user_id=44345
In the absence of some other place to track this or a better
category ("website"?) this seems as good a place as any
to record the request. If we decide it's not a bug (advising
people to use old solutions is not obviously a bug), then sure,
close with "won't fix" or "invalid". Let's not simply lose the
request though.
----------------------------------------------------------------------
Comment By: Raymond Hettinger (rhettinger)
Date: 2005-04-20 14:12
Message:
Logged In: YES
user_id=80475
Andrew, do you have a preference as to whether this is kept
on SF or done through pydotorg?
----------------------------------------------------------------------
Comment By: Terry J. Reedy (tjreedy)
Date: 2005-04-20 13: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 07: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 03: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 22:31
Message:
Logged In: YES
user_id=81797
I've submitted this to the [EMAIL PROTECTED] 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 16: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 [EMAIL PROTECTED] and/or
[EMAIL PROTECTED]
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
_______________________________________________
Python-bugs-list mailing list
Unsubscribe:
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
