[Python-Dev] PEP 376

[Tarek Ziadé]

On Tue, Jun 30, 2009 at 11:11 PM, Nick Coghlan<ncoghlan at gmail.com> wrote:
>>
>>
>> previous formats will not be supported but that won't break anything
>> of course since the new APIs will work only over the distribution
>> installed with the new version of distutils.
>
> To address PJE's question in the PEP, it may be worth expanding on this
> in the backwards compatibility section explaining how the new distutils
> metadata system avoids getting confused by the old pre-standardisation
> installation formats (e.g. it may be that the directory names and/or
> filenames all deliberately differ from current approaches precisely so
> they can coexist without interfering with each other)
>

I'll work on making it clearer,

> Also, I find the following paragraph (near the start of the section
> linked above) confusing:
>
> [PEP 376]
>> Notice that this change is based on the standard proposed by
>> EggFormats, although this standard proposes two ways to install
>> files:
>>
>> * A self-contained directory that can be zipped or left unzipped and
>> contains the distribution files and the .egg-info directory.
>> * A distinct .egg-info directory located in the site-packages directory.
>
> This is unclear as to what "this standard" is referring to (since the
> PEP itself is proposing a standard, but the sentence is also referring
> to the existing EggFormats de facto standard). If the PEP only supports
> the latter of the two options (which appears to be the case) it should
> say so explicitly.

ok

>
> Another minor nit from the same section:
>
> [PEP 376]
>> Any '-' characters are currently replaced with '_'.
>
> This should say something like "Any '-' characters other than the one in
> 'egg-info' and the one separating the name from the version number are
> included in the replacement of non-alphanumeric characters with '_'"

ok

>
> Other questions/comments:
>
> - What is a "local absolute path"? Absolute path I understand, relative
> path I understand, but "local absolute" is a novel term to me.

local means that the "/" separator that is used in the RECORD file for example,
no matter what platform you are on, is translated using the local separator
(/ or \)

I'll make it clearer,

Regards
Tarek