Add Richard Jones's edits

This commit is contained in:
Andrew M. Kuchling 2005-02-03 02:27:01 +00:00
parent 0443981205
commit de78ffe201
1 changed files with 21 additions and 77 deletions

View File

@ -81,15 +81,13 @@ Fields
Platform (multiple use) Platform (multiple use)
A comma-separated list of platform specifications, summarizing A comma-separated list of platform specifications, summarizing
the operating systems supported by the package. The major the operating systems supported by the package which are not
supported platforms are listed below, but this list is listed in the "Operating System" Trove classifiers. See
necessarily incomplete. "Classifier" below.
POSIX, MacOS, Windows, BeOS, PalmOS.
Example: Example:
Platform: POSIX, Windows Platform: ObscureUnix, RareDOS
Supported-Platform (multiple use) Supported-Platform (multiple use)
@ -183,53 +181,15 @@ Fields
License License
A string selected from a short list of choices, specifying the Text indicating the license covering the package where the license
license covering the package. Some licenses result in the is not a selection from the "License" Trove classifiers. See
software being freely redistributable, so packagers and "Classifier" below.
resellers can automatically know that they're free to
redistribute the software. Other licenses will require
a careful reading by a human to determine how the software can be
repackaged and resold.
The choices are:
Artistic, BSD, DFSG, GNU GPL, GNU LGPL, "MIT",
Mozilla PL, "public domain", Python, Qt PL, Zope PL, unknown,
nocommercial, nosell, nosource, shareware, other
Definitions of some of the licenses are:
DFSG The license conforms to the Debian Free Software
Guidelines, but does not use one of the other
DFSG conforming licenses listed here.
More information is available at:
http://www.debian.org/social_contract#guidelines
Python Python 1.6 or higher license. Version 1.5.2 and
earlier are under the MIT license.
public domain Software is public domain, not copyrighted.
unknown Status is not known
nocommercial Free private use but commercial use not permitted
nosell Free use but distribution for profit by arrangement
nosource Freely distributable but no source code
shareware Payment is requested if software is used
other General category for other non-DFSG licenses
Some of these licenses can be interpreted to mean the software is
freely redistributable. The list of redistributable licenses is:
Artistic, BSD, DFSG, GNU GPL, GNU LGPL, "MIT",
Mozilla PL, "public domain", Python, Qt PL, Zope PL,
nosource, shareware
Note that being redistributable does not mean a package
qualifies as free software, 'nosource' and 'shareware' being
examples.
Example: Example:
License: MIT License: This software may only be obtained by sending the
author a postcard, and then the user promises not
to redistribute it.
Classifier (multiple use) Classifier (multiple use)
@ -244,14 +204,13 @@ Fields
Requires (multiple use) Requires (multiple use)
Each entry contains a string describing some other component or Each entry contains a string describing some other module or
module required by this package. package required by this package.
The format of a requirement string is simple: an arbitrary The format of a requirement string is simple: an module or
sequence of characters, optionally followed by a version package name, optionally followed by a version declaration within
declaration within parentheses. Leading and trailing whitespace parentheses. Leading and trailing whitespace are ignored, and
are ignored, and whitespace within the string is normalized to a whitespace within the string is normalized to a single space.
single space.
A version declaration is a series of conditional operators and A version declaration is a series of conditional operators and
version numbers, separated by commas. Conditional operators version numbers, separated by commas. Conditional operators
@ -266,7 +225,7 @@ Fields
the string ">1.0, !=1.3.4, <2.0" is a legal version declaration. the string ">1.0, !=1.3.4, <2.0" is a legal version declaration.
All of the following are possible requirement strings: "rfc822", All of the following are possible requirement strings: "rfc822",
"zlib (>=1.1.4)", "XML parser". "zlib (>=1.1.4)", "zope".
There's no canonical list of what strings should be used; the There's no canonical list of what strings should be used; the
Python community is left to choose its own standards. Python community is left to choose its own standards.
@ -277,11 +236,11 @@ Fields
Requires: sys Requires: sys
Requires: zlib Requires: zlib
Requires: pyexpat (>1.0) Requires: pyexpat (>1.0)
Requires: DB-API 2.0 module Requires: psycopg
Provides (multiple use) Provides (multiple use)
Each entry contains a string describing a component or Each entry contains a string describing a package or
module that will be provided by this package once it is module that will be provided by this package once it is
installed. These strings should match the ones used in installed. These strings should match the ones used in
Requirements fields. Version declarations cannot be supplied; Requirements fields. Version declarations cannot be supplied;
@ -296,7 +255,7 @@ Fields
Obsoletes (multiple use) Obsoletes (multiple use)
Each entry contains a string describing a component or module Each entry contains a string describing a package or module
that this package renders obsolete, meaning that the two packages that this package renders obsolete, meaning that the two packages
should not be installed at the same time. Version declarations should not be installed at the same time. Version declarations
can be supplied. can be supplied.
@ -310,20 +269,6 @@ Fields
Obsoletes: Gorgon Obsoletes: Gorgon
Conflicts (multiple use)
Each entry contains a string describing a component or module
that conflicts with this package, meaning that the two packages
should not be installed at the same time. Version declarations
can be supplied.
Conflict resolution probably isn't very important for Python
programs, because few extensions will cause problems for other
extensions, unless they happen to be using the same package
name. This field name is being defined here for future use.
Conflicts: Gorgon
Summary of Differences From PEP 241 Summary of Differences From PEP 241
@ -336,8 +281,7 @@ Summary of Differences From PEP 241
Open issues Open issues
With the addition of the 'Classifiers' field, should the Platform None.
and License fields be removed?
Acknowledgements Acknowledgements