On Tue, Jun 30, 2009 at 11:11 PM, Nick Coghlan<ncogh...@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 _______________________________________________ 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