=?utf-8?q?[issue3565]_array_documentation, =09method_names_not_3.0_compliant?=

2008-08-16 Thread Martin v. Löwis

Martin v. Löwis [EMAIL PROTECTED] added the comment:

 2. Rename tostring and fromstring methods to tobytes and
 frombytes. I think this is quite important as the value being returned
 can no longer be described as a string.

I'm not a native speaker (of English), but my understanding is that the
noun string, in itself, can very well be used to describe this type:
the result is a byte string, as opposed to a character string.
Merriam-Webster's seems to agree; meaning 5b(2) is a sequence of like
items (as bits, characters, or words)

--
nosy: +loewis
title: array documentation, method names not 3.0 compliant - array 
documentation,  method names not 3.0 compliant

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue3565
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



=?utf-8?q?[issue3565]_array_documentation, =09method_names_not_3.0_compliant?=

2008-08-16 Thread Matt Giuca

Matt Giuca [EMAIL PROTECTED] added the comment:

 I'm not a native speaker (of English), but my understanding is that the
 noun string, in itself, can very well be used to describe this type:
 the result is a byte string, as opposed to a character string.
 Merriam-Webster's seems to agree; meaning 5b(2) is a sequence of like
 items (as bits, characters, or words)

Ah yes, that's quite right (and computer science literature will
strongly support that claim as well).

However the word string, unqualified, and in Python 3.0 terminology
(as described in PEP 358) now refers only to the str type (formerly
known as unicode), so it is very confusing to have a method tostring
which returns a bytes object.

For array to become a good Py3k citizen, I'd strongly argue that
tostring/fromstring should be renamed to tobytes/frombytes. I'm
currently writing a patch for that - it looks like there's very minimal
damage.

However as a separate issue, I think the documentation update should be
approved first.

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue3565
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com