iSharkFly-Open
/
python-peps
mirror of https://github.com/python/peps.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

added Auxiliary Files section; updated URLs; updated text file description

This commit is contained in:
David Goodger 2006-03-24 03:24:04 +00:00
parent d1970bfedf
commit 663eabbe4a
1 changed files with 22 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
pep-0001.txt
View File

@ -25,9 +25,9 @@ documenting the design decisions that have gone into Python. The PEP
author is responsible for building consensus within the community and author is responsible for building consensus within the community and
documenting dissenting opinions. documenting dissenting opinions.
Because the PEPs are maintained as text files under CVS control, their Because the PEPs are maintained as text files in a versioned
revision history is the historical record of the feature proposal repository, their revision history is the historical record of the
[1]_. feature proposal [1]_.
PEP Types PEP Types
@ -229,17 +229,16 @@ PEP Formats and Templates
========================= =========================
There are two PEP formats available to authors: plaintext and There are two PEP formats available to authors: plaintext and
reStructuredText_. reStructuredText_. Both are UTF-8-encoded text files.
Plaintext PEPs are written in plain ASCII text, contain minimal Plaintext PEPs are written with minimal structural markup that adheres
structural markup, and should adhere to a rigid style. PEP 9 contains to a rigid style. PEP 9 contains a instructions and a template [3]_
a boilerplate template [3]_ you can use to get started writing your you can use to get started writing your plaintext PEP.
plaintext PEP.
ReStructuredText_ PEPs allow for rich markup that is still quite easy ReStructuredText_ PEPs allow for rich markup that is still quite easy
to read, but results in much better-looking and more functional HTML. to read, but results in much better-looking and more functional HTML.
PEP 12 contains a boilerplate template [4]_ for use with PEP 12 contains instructions and a template [4]_ for reStructuredText
reStructuredText PEPs. PEPs.
There is a Python script that converts both styles of PEPs to HTML for There is a Python script that converts both styles of PEPs to HTML for
viewing on the web [5]_. Parsing and conversion of plaintext PEPs is viewing on the web [5]_. Parsing and conversion of plaintext PEPs is
@ -326,6 +325,15 @@ Replaces header containing the number of the PEP that it rendered
obsolete. obsolete.
Auxiliary Files
===============
PEPs may include auxiliary files such as diagrams. Such files must be
named ``pep-XXXX-Y.ext``, where "XXXX" is the PEP number, "Y" is a
serial number (starting at 1), and "ext" is replaced by the actual
file extension (e.g. "png").
Reporting PEP Bugs, or Submitting PEP Updates Reporting PEP Bugs, or Submitting PEP Updates
============================================= =============================================
@ -387,18 +395,18 @@ References and Footnotes
http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/python/python/nondist/peps/ http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/python/python/nondist/peps/
.. [2] PEP 2, Procedure for Adding New Modules, Faassen .. [2] PEP 2, Procedure for Adding New Modules, Faassen
(http://www.python.org/peps/pep-0002.html) (http://www.python.org/dev/peps/pep-0002)
.. [3] PEP 9, Sample Plaintext PEP Template, Warsaw .. [3] PEP 9, Sample Plaintext PEP Template, Warsaw
(http://www.python.org/peps/pep-0009.html) (http://www.python.org/dev/peps/pep-0009)
.. [4] PEP 12, Sample reStructuredText PEP Template, Goodger, Warsaw .. [4] PEP 12, Sample reStructuredText PEP Template, Goodger, Warsaw
(http://www.python.org/peps/pep-0012.html) (http://www.python.org/dev/peps/pep-0012)
.. [5] The script referred to here is pep2html.py, which lives in the .. [5] The script referred to here is pep2html.py, which lives in the
same directory in the CVS tree as the PEPs themselves. Try same directory in the CVS tree as the PEPs themselves. Try
``pep2html.py --help`` for details. The URL for viewing PEPs on ``pep2html.py --help`` for details. The URL for viewing PEPs on
the web is http://www.python.org/peps/. the web is http://www.python.org/dev/peps/.
.. _patch manager: .. _patch manager:
http://sourceforge.net/tracker/?group_id=5470&atid=305470 http://sourceforge.net/tracker/?group_id=5470&atid=305470