Re: [Python-Dev] [Python-checkins] r86745 - in python/branches/py3k: Doc/library/difflib.rst Lib/difflib.py Lib/test/test_difflib.py Misc/NEWS

2010-11-27 Thread Nick Coghlan
On Thu, Nov 25, 2010 at 4:12 PM, terry.reedy python-check...@python.org wrote:
  The :class:`SequenceMatcher` class has this constructor:


 -.. class:: SequenceMatcher(isjunk=None, a='', b='')
 +.. class:: SequenceMatcher(isjunk=None, a='', b='', autojunk=True)

    Optional argument *isjunk* must be ``None`` (the default) or a one-argument
    function that takes a sequence element and returns true if and only if the
 @@ -340,6 +349,9 @@
    The optional arguments *a* and *b* are sequences to be compared; both 
 default to
    empty strings.  The elements of both sequences must be :term:`hashable`.

 +   The optional argument *autojunk* can be used to disable the automatic junk
 +   heuristic.
 +

Catching up on checkins traffic, so a later checkin may already fix
this, but there should be a versionchanged tag in the docs to note
when the autojunk parameter was added.

Cheers,
Nick.

-- 
Nick Coghlan   |   ncogh...@gmail.com   |   Brisbane, Australia
___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] [Python-checkins] r86745 - in python/branches/py3k: Doc/library/difflib.rst Lib/difflib.py Lib/test/test_difflib.py Misc/NEWS

2010-11-27 Thread Eli Bendersky
On Sat, Nov 27, 2010 at 14:17, Nick Coghlan ncogh...@gmail.com wrote:

 On Thu, Nov 25, 2010 at 4:12 PM, terry.reedy python-check...@python.org
 wrote:
   The :class:`SequenceMatcher` class has this constructor:
 
 
  -.. class:: SequenceMatcher(isjunk=None, a='', b='')
  +.. class:: SequenceMatcher(isjunk=None, a='', b='', autojunk=True)
 
 Optional argument *isjunk* must be ``None`` (the default) or a
 one-argument
 function that takes a sequence element and returns true if and only if
 the
  @@ -340,6 +349,9 @@
 The optional arguments *a* and *b* are sequences to be compared; both
 default to
 empty strings.  The elements of both sequences must be
 :term:`hashable`.
 
  +   The optional argument *autojunk* can be used to disable the automatic
 junk
  +   heuristic.
  +

 Catching up on checkins traffic, so a later checkin may already fix
 this, but there should be a versionchanged tag in the docs to note
 when the autojunk parameter was added.


Hi Nick,

Since autojunk was added in 2.7.1 (the docs of which do indicate this is the
versionchanged tag), I think Terry may have left the tag in 3.2 out on
purpose. That said, personally I don't know what the policy is regarding
features added just in 3.2 and 2.7 (and didn't exist in 3.1) in this
respect.

Eli
___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] [Python-checkins] r86745 - in python/branches/py3k: Doc/library/difflib.rst Lib/difflib.py Lib/test/test_difflib.py Misc/NEWS

2010-11-27 Thread Michael Foord

On 27/11/2010 13:00, Eli Bendersky wrote:
On Sat, Nov 27, 2010 at 14:17, Nick Coghlan ncogh...@gmail.com 
mailto:ncogh...@gmail.com wrote:


On Thu, Nov 25, 2010 at 4:12 PM, terry.reedy
python-check...@python.org mailto:python-check...@python.org
wrote:
  The :class:`SequenceMatcher` class has this constructor:


 -.. class:: SequenceMatcher(isjunk=None, a='', b='')
 +.. class:: SequenceMatcher(isjunk=None, a='', b='', autojunk=True)

Optional argument *isjunk* must be ``None`` (the default) or
a one-argument
function that takes a sequence element and returns true if
and only if the
 @@ -340,6 +349,9 @@
The optional arguments *a* and *b* are sequences to be
compared; both default to
empty strings.  The elements of both sequences must be
:term:`hashable`.

 +   The optional argument *autojunk* can be used to disable the
automatic junk
 +   heuristic.
 +

Catching up on checkins traffic, so a later checkin may already fix
this, but there should be a versionchanged tag in the docs to note
when the autojunk parameter was added.


Hi Nick,

Since autojunk was added in 2.7.1 (the docs of which do indicate this 
is the versionchanged tag), I think Terry may have left the tag in 3.2 
out on purpose. That said, personally I don't know what the policy is 
regarding features added just in 3.2 and 2.7 (and didn't exist in 3.1) 
in this respect.


Features new in Python 3.2 that didn't exist in 3.1 should have a 
versionadded:: 3.2 tag.


Michael



Eli


___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/fuzzyman%40voidspace.org.uk



--

http://www.voidspace.org.uk/

READ CAREFULLY. By accepting and reading this email you agree,
on behalf of your employer, to release me from all obligations
and waivers arising from any and all NON-NEGOTIATED agreements,
licenses, terms-of-service, shrinkwrap, clickwrap, browsewrap,
confidentiality, non-disclosure, non-compete and acceptable use
policies (BOGUS AGREEMENTS) that I have entered into with your
employer, its partners, licensors, agents and assigns, in
perpetuity, without prejudice to my ongoing rights and privileges.
You further represent that you have the authority to release me
from any BOGUS AGREEMENTS on behalf of your employer.

___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] [Python-checkins] r86745 - in python/branches/py3k: Doc/library/difflib.rst Lib/difflib.py Lib/test/test_difflib.py Misc/NEWS

2010-11-27 Thread Nick Coghlan
On Sat, Nov 27, 2010 at 11:02 PM, Michael Foord
fuzzy...@voidspace.org.uk wrote:
 Features new in Python 3.2 that didn't exist in 3.1 should have a
 versionadded:: 3.2 tag.

As Michael said, from a docs point of view, the version flow is
independent: 2.6 - 2.7 and 3.1 - 3.2.

The issue has really only come up with this release, since there was
no intervening 2.x release between 3.0 and 3.1.

Cheers,
Nick.

-- 
Nick Coghlan   |   ncogh...@gmail.com   |   Brisbane, Australia
___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] [Python-checkins] r86745 - in python/branches/py3k: Doc/library/difflib.rst Lib/difflib.py Lib/test/test_difflib.py Misc/NEWS

2010-11-27 Thread Terry Reedy



On 11/27/2010 7:17 AM, Nick Coghlan wrote:

On Thu, Nov 25, 2010 at 4:12 PM, terry.reedypython-check...@python.org  wrote:

  The :class:`SequenceMatcher` class has this constructor:


-.. class:: SequenceMatcher(isjunk=None, a='', b='')
+.. class:: SequenceMatcher(isjunk=None, a='', b='', autojunk=True)

Optional argument *isjunk* must be ``None`` (the default) or a one-argument
function that takes a sequence element and returns true if and only if the
@@ -340,6 +349,9 @@
The optional arguments *a* and *b* are sequences to be compared; both 
default to
empty strings.  The elements of both sequences must be :term:`hashable`.

+   The optional argument *autojunk* can be used to disable the automatic junk
+   heuristic.
+


Catching up on checkins traffic, so a later checkin may already fix
this, but there should be a versionchanged tag in the docs to note
when the autojunk parameter was added.


Right. When S.C. forward-ported the 2.7 patch. he must have thought it 
not needed and I missed the difference between the diffs. Will add note 
in both places needed immediately.


Terry
___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com