[issue10403] Use "member" consistently

[Senthil Kumaran]

Changes by Senthil Kumaran :


--
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Roundup Robot]

Roundup Robot  added the comment:

New changeset 3935a1fb1db2 by Senthil Kumaran in branch '2.7':
merge from 3.2 - Issue10403  - datetime module documentation changes based on 
review.
http://hg.python.org/cpython/rev/3935a1fb1db2

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Roundup Robot]

Roundup Robot  added the comment:

New changeset 05f0ffe4e0b3 by Senthil Kumaran in branch '3.2':
Fix Issue10403 - datetime documentation clarification based on review in the 
reitveld by Alexendar belopolsky.
http://hg.python.org/cpython/rev/05f0ffe4e0b3

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Senthil Kumaran]

Senthil Kumaran  added the comment:

Hello Eric, I missed noticing Alexander's comments in the reitveld, I looked 
only at tracker then. I see that some of them can be addressed. Like using 
members (components) of the field, instead of attributes when it is not an 
attribute. Shall correct it. Thanks.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Ezio Melotti]

Changes by Ezio Melotti :


--
nosy: +ezio.melotti

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Éric Araujo]

Changes by Éric Araujo :


--
status: closed -> open

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Eric Snow]

Changes by Eric Snow :


--
nosy: +ericsnow

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Éric Araujo]

Éric Araujo  added the comment:

Senthil, I’m not sure you read Alexander’s reply on Rietveld before committing.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Roundup Robot]

Roundup Robot  added the comment:

New changeset b8f5da066782 by Senthil Kumaran in branch '2.7':
Fix closes issue10403 - Let's not use members anymore.
http://hg.python.org/cpython/rev/b8f5da066782

--
resolution:  -> fixed
stage: needs patch -> committed/rejected
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Roundup Robot]

Roundup Robot  added the comment:

New changeset d442c313536b by Senthil Kumaran in branch '3.2':
issue10403 - Let's not use members anymore. Use 'attribute' where it denotes 
attribute and 'methods' where it denotes methods. Context should clarify usage.
http://hg.python.org/cpython/rev/d442c313536b

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Roundup Robot]

Roundup Robot  added the comment:

New changeset d442c313536b by Senthil Kumaran in branch '3.2':
issue10403 - Let's not use members anymore. Use 'attribute' where it denotes 
attribute and 'methods' where it denotes methods. Context should clarify usage.
http://hg.python.org/cpython/rev/d442c313536b

--
nosy: +python-dev

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Éric Araujo]

Éric Araujo  added the comment:

I’m not -1 on using “attributes” to denote methods, since they *are* and it’s 
not difficult to understand, and I’m not opposed either to using “attributes” 
to replace “members” (i.e. attributes that are not methods.)

For those wanting to see the raging debate: 
http://mail.python.org/pipermail/python-dev/2011-June/112020.html

:)

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Senthil Kumaran]

Senthil Kumaran  added the comment:

Yes, I agree with you. Good Suggestion. Thanks!

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Antoine Pitrou]

Antoine Pitrou  added the comment:

So I'm -1 on using "attributes" to denote methods. It will actively confuse 
non-expert users. If you want to ditch "members", please consider using the 
more explicit phrase "attributes and methods".

--
nosy: +pitrou

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Éric Araujo]

Éric Araujo  added the comment:

Alexander, could you comment on the review page about datetime.rst changes?

--
nosy: +belopolsky

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Adam Woodbeck]

Changes by Adam Woodbeck :


Added file: http://bugs.python.org/file22438/issue10403_v3.patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Adam Woodbeck]

Adam Woodbeck  added the comment:

I was always under the impression attributes and methods were mutually 
exclusive.  I've corrected the patch as requested.

--
Added file: http://bugs.python.org/file22436/issue10403_v2.patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Éric Araujo]

Éric Araujo  added the comment:

> I used "methods and attribute" in io.rst because BufferedIOBase
> included one attribute and several methods.  My terminology may be
> off, but I felt this was the correct replacement of "members."

Nearly :)  See in the first message:
> "Members and methods" should just be "attributes".

--
nosy: +eric.araujo

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Adam Woodbeck]

Adam Woodbeck  added the comment:

I grepped the documentation in the cpython repository and replaced all mentions 
of "member(s)" with "attribute(s)" where I felt appropriate.  I left mentions 
of "members" related to structs or any C documentation alone as I'm less 
confident of their terminology (I'm new around here).

I used "methods and attribute" in io.rst because BufferedIOBase included one 
attribute and several methods.  My terminology may be off, but I felt this was 
the correct replacement of "members."

Please review the patch and critique it as necessary.

--
keywords: +patch
Added file: http://bugs.python.org/file22422/issue10403.patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Adam Woodbeck]

Changes by Adam Woodbeck :


--
nosy: +adam.woodbeck

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Senthil Kumaran]

Changes by Senthil Kumaran :


--
stage:  -> needs patch
type:  -> behavior
versions: +Python 2.7, Python 3.1, Python 3.2

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Senthil Kumaran]

Senthil Kumaran  added the comment:

It is 'attributes' instead of term 'members'. The term 'method' when it denotes 
methods can be left as such.

--
assignee: d...@python -> orsenthil
nosy: +orsenthil

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Raymond Hettinger]

Raymond Hettinger  added the comment:

> "Members and methods" should just be "attributes".

+1 

That substitution should be made almost everywhere.

Individual slot variable are still called members though
and their type is a member_descriptor.  And the C API
still has a tp_members entry.  Otherwise, it looks like
the term member is out-of-date.

--
nosy: +rhettinger

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Fred L. Drake, Jr.]

Changes by Fred L. Drake, Jr. :


--
keywords: +easy

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10403] Use "member" consistently

[Fred L. Drake, Jr.]

New submission from Fred L. Drake, Jr. :

Some portions of the documentation are using the term "member" to mean "data 
attribute".  This appears to be an aberration at this time, but occurrences 
should be identified and corrected, and "Documenting Python" updated to note 
correct usage.

Example use:

http://docs.python.org/dev/py3k/library/xmlrpc.client.html#fault-objects

http://docs.python.org/dev/py3k/library/urllib.request.html#basehandler-objects
(paragraph starting "The following members and methods should")

"Members and methods" should just be "attributes".

--
assignee: d...@python
components: Documentation
messages: 121110
nosy: d...@python, fdrake
priority: normal
severity: normal
status: open
title: Use "member" consistently

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com