[issue12185] Decimal documentation lists "first" and "second" arguments, should be "self" and "other"

2011-05-28 Thread Adam Woodbeck

Changes by Adam Woodbeck :


--
nosy: +adam.woodbeck

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



[issue11699] Doc for optparse.OptionParser.get_option_group is wrong

2011-05-28 Thread Adam Woodbeck

Changes by Adam Woodbeck :


--
nosy: +adam.woodbeck

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



[issue11644] Cross-link 2to3 documentation, what’s new and pyporting howto

2011-05-28 Thread Adam Woodbeck

Changes by Adam Woodbeck :


--
nosy: +adam.woodbeck

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



[issue11203] gzip doc is behind

2011-05-28 Thread Adam Woodbeck

Changes by Adam Woodbeck :


--
nosy: +adam.woodbeck

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



[issue11785] email subpackages documentation problems

2011-05-28 Thread Adam Woodbeck

Changes by Adam Woodbeck :


--
nosy: +adam.woodbeck

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



[issue12185] Decimal documentation lists "first" and "second" arguments, should be "self" and "other"

2011-05-29 Thread Adam Woodbeck

Adam Woodbeck  added the comment:

I propose:

object.copy_sign(other)

Return a copy of *object* with the sign set to be the same as the sign of 
*other*.

This format is most familiar to me.  But like Ezio wrote, all other methods 
referring to first and second operands would need to updated to refer to 
*object* and *other*, respectively.

--

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



[issue12185] Decimal documentation lists "first" and "second" arguments, should be "self" and "other"

2011-05-29 Thread Adam Woodbeck

Adam Woodbeck  added the comment:

Or rather:

object.copy_sign(other)

Return a copy of *object* with the sign set to be that of *other*.

--

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



[issue12185] Decimal documentation lists "first" and "second" arguments, should be "self" and "other"

2011-05-29 Thread Adam Woodbeck

Adam Woodbeck  added the comment:

Sorry guys.  I'm new at this.  After reviewing this thread, Terry's suggestion 
makes the most sense to me.

--

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




[issue12185] Decimal documentation lists "first" and "second" arguments, should be "self" and "other"

2011-06-03 Thread Adam Woodbeck

Adam Woodbeck  added the comment:

Hi Francisco,

I finally found time to create a patch for this issue.  I was just saving the 
patch I wrote as your update arrived in my inbox.  I've included my patch for 
good measure.  It's better to have two proposed patches than none at all in my 
opinion.

Adam

--
Added file: http://bugs.python.org/file9/issue_12185-ajw.patch

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



[issue12278] Core mentorship mention in the devguide

2011-06-07 Thread Adam Woodbeck

New submission from Adam Woodbeck :

Jesse requested the devguide be updated to include a mention of the Python 
Mentors site.  The attached patch is my rough draft.

--
components: Devguide
files: help.rst.patch
keywords: patch
messages: 137807
nosy: adam.woodbeck, ncoghlan
priority: normal
severity: normal
status: open
title: Core mentorship mention in the devguide
Added file: http://bugs.python.org/file22271/help.rst.patch

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



[issue12278] Core mentorship mention in the devguide

2011-06-07 Thread Adam Woodbeck

Adam Woodbeck  added the comment:

Éric, good point.  I'll propose different wording when I have an opportunity 
later today.  In the mean time, I'm certainly open to suggestions, especially 
as I get my feet wet.

So you would also prefer a mention of the python-ideas and python-dev mailing 
lists, where the former is primarily for suggesting new development ideas, and 
the latter is for core language discussion.  Correct?

--

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



[issue12369] Revised core mentorship section of help.rst

2011-06-19 Thread Adam Woodbeck

New submission from Adam Woodbeck :

Here is the latest update to the devguide's help.rst for your consideration.  
It includes Nick's tweaks to what I originally submitted.

--
components: Devguide
files: help.rst.patch
keywords: patch
messages: 138668
nosy: adam.woodbeck, ncoghlan
priority: normal
severity: normal
status: open
title: Revised core mentorship section of help.rst
versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4
Added file: http://bugs.python.org/file22410/help.rst.patch

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



[issue10403] Use "member" consistently

2011-06-21 Thread Adam Woodbeck

Changes by Adam Woodbeck :


--
nosy: +adam.woodbeck

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



[issue10403] Use "member" consistently

2011-06-21 Thread 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 
<http://bugs.python.org/issue10403>
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue10403] Use "member" consistently

2011-06-24 Thread 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 
<http://bugs.python.org/issue10403>
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue10403] Use "member" consistently

2011-06-24 Thread Adam Woodbeck

Changes by Adam Woodbeck :


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

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



[issue10608] Add a section to Windows FAQ explaining os.symlink

2011-07-05 Thread Adam Woodbeck

Changes by Adam Woodbeck :


--
nosy: +adam.woodbeck

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



[issue10503] os.getuid() documentation should be clear on what kind of uid it is referring

2011-07-21 Thread Adam Woodbeck

Changes by Adam Woodbeck :


--
nosy: +adam.woodbeck

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



[issue12436] Provide reference to detailed installation instructions

2011-07-21 Thread Adam Woodbeck

Changes by Adam Woodbeck :


--
nosy: +adam.woodbeck

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



[issue12436] Provide reference to detailed installation instructions

2011-07-22 Thread Adam Woodbeck

Adam Woodbeck  added the comment:

So what we're looking for is comprehensive HOWTOs for installing and running 
Python on Windows, OSX and Linux to be added to 
http://docs.python.org/howto/index.html?

--

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



[issue12409] Moving "Documenting Python" to Devguide

2011-08-30 Thread Adam Woodbeck

Changes by Adam Woodbeck :


--
nosy: +adam.woodbeck

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



[issue11176] give more meaningful argument names in argparse documentation

2011-08-30 Thread Adam Woodbeck

Changes by Adam Woodbeck :


--
nosy: +adam.woodbeck

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