Add Richard Jones's edits
This commit is contained in:
parent
0443981205
commit
de78ffe201
98
pep-0314.txt
98
pep-0314.txt
|
@ -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
|
||||||
|
|
Loading…
Reference in New Issue