Commits

Daniel Holth committed 50e8ea1

Metadata 1.3: only "Metadata-Version", "Name", "Version", and "Summary" are required.

  • Participants
  • Parent commits 74868fe

Comments (0)

Files changed (1)

File pep-0426.txt

 This section specifies the names and semantics of each of the
 supported metadata fields.
 
-Fields marked with "(Multiple use)" may be specified multiple
-times in a single metadata file.  Other fields may only occur
-once in a metadata file.  Fields marked with "(optional)" are
-not required to appear in a valid metadata file; all other
-fields must be present.  The fields may appear in any order within
+Fields marked with "(optional)" may occur 0 or 1 times.  Fields marked
+with "(multiple use)" may be specified 0, 1 or more times in a single
+metadata file.  Only "Metadata-Version", "Name", "Version", and "Summary"
+must appear exactly once.  The fields may appear in any order within
 the file.
 
 Metadata-Version
     Version: 1.0a2
 
 
+Summary
+:::::::
+
+A one-line summary of what the distribution does.
+
+Example::
+
+    Summary: A module for collecting votes from beagles.
+
+
 Platform (multiple use)
 :::::::::::::::::::::::
 
     Supported-Platform: i386-win32-2791
 
 
-Summary
-:::::::
-
-A one-line summary of what the distribution does.
-
-Example::
-
-    Summary: A module for collecting votes from beagles.
-
-
 Description (optional, deprecated)
 ::::::::::::::::::::::::::::::::::
 
 the markup they use.
 
 Since a line separator immediately followed by another line separator
-indicates the end of the headers section, any line separator must be
-suffixed by whitespace to indicate continuation.
+indicates the end of the headers section, any line separators in the
+description must be suffixed by whitespace to indicate continuation.
 
 Since Metadata 1.3 the recommended place for the description is in the
 payload section of the document, after the last header.  The description
-needs no special formatting when included in the payload.
+does not need to be reformatted when it is included in the payload.
+
 
 Keywords (optional)
 :::::::::::::::::::
     Home-page: http://www.example.com/~cschultz/bvote/
 
 
-Download-URL
-::::::::::::
+Download-URL (optional)
+:::::::::::::::::::::::
 
 A string containing the URL from which this version of the distribution
 can be downloaded.  (This means that the URL can't be something like
     Obsoletes-Dist: OtherProject (<3.0)
 
 
-Requires-Python
-:::::::::::::::
+Requires-Python (optional)
+::::::::::::::::::::::::::
 
 This field specifies the Python version(s) that the distribution is
 guaranteed to be compatible with.
 
 * Added `extra` to environment markers.
 
+* Most fields are now optional.
+
 * Changed fields:
 
   - Requires-Dist