[Python-checkins] peps: Update to latest metadata 1.3 draft

[nick.coghlan]

http://hg.python.org/peps/rev/547555402269
changeset:   4508:547555402269
user:        Nick Coghlan <ncoghlan at gmail.com>
date:        Sun Sep 09 01:53:56 2012 +1000
summary:
  Update to latest metadata 1.3 draft

files:
  pep-0426.txt |  27 +++++++++++++++------------
  1 files changed, 15 insertions(+), 12 deletions(-)


diff --git a/pep-0426.txt b/pep-0426.txt
--- a/pep-0426.txt
+++ b/pep-0426.txt
@@ -31,9 +31,10 @@
 Metadata Files
 ==============
 
-The syntax defined in this PEP is for use with Python distribution metadata
-files. This file format is a single set of RFC-822 headers parseable by
-the ``rfc822`` or ``email`` modules.  The field names listed in the
+The syntax defined in this PEP is for use with Python distribution
+metadata files. The file format is a simple UTF-8 encoded Key: value
+format with no line length parsable by the ``email`` module with an
+appropriate ``email.policy.Policy()``.  The field names listed in the
 `Fields`_ section are used as the header names.
 
 There are two standard locations for these metadata files:
@@ -51,8 +52,9 @@
 Encoding
 ========
 
-Keys must be ASCII.  Values are expected to be displayed as UTF-8,
-but should otherwise be treated as opaque bytes.
+Metadata 1.3 files are UTF-8, with the restriction that keys must be
+ASCII. Parsers should be aware that older versions of the Metadata
+specification do not specify an encoding.
 
 Fields
 ======
@@ -435,9 +437,10 @@
 Provides-Extra (multiple use)
 :::::::::::::::::::::::::::::
 
-A string containing the name of an optional feature. Must be a valid Python
-identifier. May be used to make a dependency conditional on whether the
-optional feature has been requested.
+A string containing the name of an optional feature. Must be printable
+ASCII, not containing whitespace, comma (,), or square brackets [].
+May be used to make a dependency conditional on whether the optional
+feature has been requested.
 
 Example::
 
@@ -475,13 +478,13 @@
 Extension (multiple-use)
 ::::::::::::::::::::::::
 
-An ASCII string, not containing whitespace or the - character, that
+An ASCII string, not containing whitespace or the / character, that
 indicates the presence of extended metadata. Additional tags defined by
-the extension should be of the form string-Name::
+the extension should be of the form string/Name::
 
     Extension: Chili
-    Chili-Type: Poblano
-    Chili-Heat: Mild
+    Chili/Type: Poblano
+    Chili/Heat: Mild
 
 
 Version Specifiers

-- 
Repository URL: http://hg.python.org/peps