[issue10072] ftplib documentation is unclear

2010-10-12 Thread Rafe H. Kettler
New submission from Rafe H. Kettler : I think that the documentation for ftplib is a bit too concise and assumes that the reader in an expert in the protocol when the point of the module is to abstract out such details. For example, for the error documentation, the exceptions are only explaine

[issue10072] ftplib documentation is unclear

2010-10-12 Thread Antoine Pitrou
Changes by Antoine Pitrou : -- nosy: +giampaolo.rodola ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://m

[issue10072] ftplib documentation is unclear

2010-10-12 Thread Giampaolo Rodola'
Giampaolo Rodola' added the comment: A patch would be great. -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue10072] ftplib documentation is unclear

2010-10-12 Thread Rafe Kettler
Rafe Kettler added the comment: I've drafted up a patch. For those of you who don't want to read the diff, it changes all references to FTP reply codes with short explanations of what they do. Also, in the docs for retrlines() and nlst() the commands LIST, NLST, and MLSD are explained. Attac

[issue10072] ftplib documentation is unclear

2010-10-12 Thread Rafe Kettler
Changes by Rafe Kettler : -- keywords: +patch Added file: http://bugs.python.org/file19202/ftplib-patch.diff ___ Python tracker ___ __

[issue10072] ftplib documentation is unclear

2010-10-12 Thread Rafe Kettler
Changes by Rafe Kettler : Removed file: http://bugs.python.org/file19201/ftplib-patch.rst ___ Python tracker ___ ___ Python-bugs-list mailing

[issue10072] ftplib documentation is unclear

2010-10-12 Thread Rafe Kettler
Changes by Rafe Kettler : Added file: http://bugs.python.org/file19203/ftplib-patch.txt ___ Python tracker ___ ___ Python-bugs-list mailing li

[issue10072] ftplib documentation is unclear

2010-10-12 Thread Éric Araujo
Éric Araujo added the comment: Looks good to me. Before committing, spaces after full stops should be doubled. -- nosy: +eric.araujo ___ Python tracker ___

[issue10072] ftplib documentation is unclear

2010-10-12 Thread Rafe Kettler
Changes by Rafe Kettler : Removed file: http://bugs.python.org/file19203/ftplib-patch.txt ___ Python tracker ___ ___ Python-bugs-list mailing

[issue10072] ftplib documentation is unclear

2010-10-12 Thread Rafe Kettler
Rafe Kettler added the comment: Double spaced after the sentence ending periods. -- Added file: http://bugs.python.org/file19204/ftplib-patch.txt ___ Python tracker ___

[issue10072] ftplib documentation is unclear

2010-10-15 Thread Georg Brandl
Georg Brandl added the comment: Committed after review in r85548. Thanks! -- nosy: +georg.brandl resolution: -> accepted status: open -> closed ___ Python tracker ___