Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread Toshio Kuratomi
On Wed, Dec 05, 2012 at 02:46:11AM -0500, Donald Stufft wrote: > On Wednesday, December 5, 2012 at 2:13 AM, PJ Eby wrote: > > On Mon, Dec 3, 2012 at 2:43 PM, Daniel Holth wrote: > > How to use Obsoletes: > > The author of B decides A is obsolete. > > A releases an e

[Python-Dev] slightly misleading Popen.poll() docs

2012-12-05 Thread Chris Withers
Hi All, Would anyone object to me making a change to the docs for 2.6, 2.7 and 3.x to clarify the following: http://docs.python.org/3/library/subprocess.html#subprocess.Popen.poll A couple of my colleagues have ended up writing code like this: proc = Popen(['some', 'thing']) code = proc.poll

Re: [Python-Dev] slightly misleading Popen.poll() docs

2012-12-05 Thread Antoine Pitrou
Le Wed, 05 Dec 2012 16:08:46 +, Chris Withers a écrit : > Hi All, > > Would anyone object to me making a change to the docs for 2.6, 2.7 > and 3.x to clarify the following: > > http://docs.python.org/3/library/subprocess.html#subprocess.Popen.poll The doc looks clear to me. poll() returns t

Re: [Python-Dev] slightly misleading Popen.poll() docs

2012-12-05 Thread Chris Withers
On 05/12/2012 16:34, Antoine Pitrou wrote: http://docs.python.org/3/library/subprocess.html#subprocess.Popen.poll The doc looks clear to me. poll() returns the returncode attribute which is described thusly: "A None value indicates that the process hasn’t terminated yet." Therefore, I don't u

Re: [Python-Dev] slightly misleading Popen.poll() docs

2012-12-05 Thread Steven D'Aprano
On 06/12/12 03:08, Chris Withers wrote: I'd like to change the docs for poll() to say: """ Check if child process has terminated. If it has, the returncode attribute will be set and that value will be returned. If it has not, None will be returned and the returncode attribute will remain None.

Re: [Python-Dev] slightly misleading Popen.poll() docs

2012-12-05 Thread Antoine Pitrou
On Thu, 06 Dec 2012 04:15:08 +1100 Steven D'Aprano wrote: > On 06/12/12 03:08, Chris Withers wrote: > > > I'd like to change the docs for poll() to say: > > > > """ > > Check if child process has terminated. > > If it has, the returncode attribute will be set and that value will be > > returned.

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread PJ Eby
On Wed, Dec 5, 2012 at 2:46 AM, Donald Stufft wrote: > There's nothing preventing an installer from, during it's attempt to > install B, see it Obsoletes A, looking at what depends on A and > warning the user what is going to happen and prompt it. Unless the user wrote those things that depend on

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread Daniel Holth
On Wed, Dec 5, 2012 at 4:10 PM, PJ Eby wrote: > On Wed, Dec 5, 2012 at 2:46 AM, Donald Stufft > wrote: > > There's nothing preventing an installer from, during it's attempt to > > install B, see it Obsoletes A, looking at what depends on A and > > warning the user what is going to happen and pro

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread Donald Stufft
On Wednesday, December 5, 2012 at 4:10 PM, PJ Eby wrote: > My point is that this can only work if the "obsoleting" is effectively > just a rename, in which case the field should be "renames", or better > still, "renamed-to" on the originating package. Arguing over Obsoletes vs Renames is a massive

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread Barry Warsaw
On Dec 05, 2012, at 04:10 PM, PJ Eby wrote: >While it's certainly desirable to not invent wheels, it's important to >understand that the Python community does not work the same way as a >Linux distribution. We are not a single organization shipping a >fully-functional and configured machine, we a

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread Barry Warsaw
On Dec 05, 2012, at 06:07 PM, Donald Stufft wrote: >If you're installing B you've prescribed trust to that author. If you don't >trust the author then why are you installing (and then executing) code >they wrote. What you installed Z, but B got installed because it was a dependency three levels

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread Donald Stufft
On Wednesday, December 5, 2012 at 6:18 PM, Barry Warsaw wrote: > On Dec 05, 2012, at 06:07 PM, Donald Stufft wrote: > > > If you're installing B you've prescribed trust to that author. If you don't > > trust the author then why are you installing (and then executing) code > > they wrote. > > >

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread PJ Eby
On Wed, Dec 5, 2012 at 5:30 PM, Daniel Holth wrote: > My desire is to invent the useful "wheel" binary package format in a > reasonable and limited amount of time by making changes to Metadata 1.2 and > implementing the new metadata format and wheel in distribute and pip. Help > me out by allowing

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread PJ Eby
On Wed, Dec 5, 2012 at 6:07 PM, Donald Stufft wrote: > Arguing over Obsoletes vs Renames is a massive bikeshedding argument. And is entirely beside the point. The substantive question is whether it's Obsoletes or Obsoleted-By - i.e., which side is it declared on. > So it's a bad example. Hardly

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread Stephen J. Turnbull
I understand the PEP author's frustration with continued discussion, but I think this subthread on Obsoletes vs. Obsoleted-By is not mere bikeshedding on names. It matters *which package* presents the information. Donald Stufft writes: > On Wednesday, December 5, 2012 at 6:18 PM, Barry Warsaw w

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread MRAB
On 2012-12-06 02:12, Stephen J. Turnbull wrote: I understand the PEP author's frustration with continued discussion, but I think this subthread on Obsoletes vs. Obsoleted-By is not mere bikeshedding on names. It matters *which package* presents the information. Donald Stufft writes: > On Wed

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread Daniel Holth
Makes sense. How about calling it Replacement. 0 or 1? Replacement (optional) :: Indicates that this project is no longer being developed. The named project provides a drop-in replacement. A version declaration may be supplied and must follow the rules described in `Version

Re: [Python-Dev] slightly misleading Popen.poll() docs

2012-12-05 Thread Nick Coghlan
On Thu, Dec 6, 2012 at 4:55 AM, Antoine Pitrou wrote: > On Thu, 06 Dec 2012 04:15:08 +1100 > Steven D'Aprano wrote: > > Possibly because it is 4am here, I had to read this three times to > understand it. > > How is this instead? > > > > """ > > Check if child process has terminated. Returns None

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread Nick Coghlan
On Thu, Dec 6, 2012 at 8:30 AM, Daniel Holth wrote: > My desire is to invent the useful "wheel" binary package format in a > reasonable and limited amount of time by making changes to Metadata 1.2 and > implementing the new metadata format and wheel in distribute and pip. Help > me out by allowin

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread Terry Reedy
On 12/5/2012 10:12 PM, Daniel Holth wrote: Makes sense. How about calling it Replacement. 0 or 1? Replacement (optional) :: Indicates that this project is no longer being developed. The named project provides a drop-in replacement. A version declaration may be supplied and

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread Nick Coghlan
On Thu, Dec 6, 2012 at 1:12 PM, Daniel Holth wrote: > Makes sense. How about calling it Replacement. 0 or 1? > Hah, you'd think I'd have learned by now to finish reading a thread before replying. It will be nice to get this addressed along with the other changes :) (FWIW, Conflicts and Obsolete

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread Nick Coghlan
On Thu, Dec 6, 2012 at 2:54 PM, Nick Coghlan wrote: > On Thu, Dec 6, 2012 at 1:12 PM, Daniel Holth wrote: > >> Makes sense. How about calling it Replacement. 0 or 1? >> > > Hah, you'd think I'd have learned by now to finish reading a thread before > replying. It will be nice to get this addresse

Re: [Python-Dev] Keyword meanings [was: Accept just PEP-0426]

2012-12-05 Thread Toshio Kuratomi
On Wed, Dec 05, 2012 at 07:34:41PM -0500, PJ Eby wrote: > On Wed, Dec 5, 2012 at 6:07 PM, Donald Stufft wrote: > > Nobody has actually proposed a better one, outside of package renaming > -- and that example featured an author who could just as easily have > used an obsoleted-by field. > How abo