* Changed name from "Sample PEP Template" to "Sample Plaintext PEP
Template", and edited throughout to differentiate the choices:
- Added "plaintext" where appropriate to make the context clear.
- "Style" -> "format".
- Referred to PEP 1 as "content guidelines", not "style" guidelines.
* Added a "Content-Type: text/plain" header to be explicit.
* Added a reference to the alternative format available in
reStructuredText PEPs.
* Combined "How to Use This Template for Standard Track PEPs" and "How
to Use This Template for Informational PEPs" into one "How to Use
This Template" section. In addition to the duplication, there were
several errors and inconsistencies between the two source sections.
Conditionals have been added as appropriate.
* Clarified the discussion of the Replaces header as per discussions.
* Added "Plaintext PEP Formatting Requirements", moved from PEP 1's
"PEP Formatting Requirements".
- Removed the paragraph beginning "A PEP must contain a Copyright
section" as redundant; already covered in "How to Use This
Template".
- Minor edits.
* Minor edits, including:
- Fixed typos.
- Removed colons from header field names (e.g., "the Author
header").
(Some additional minor edits by Barry).
* Changed the "PEP Template" section to "PEP Formats and Templates",
in which plaintext and reStructuredText PEPs are described.
* Added "PEP Header Preamble" heading, for the RFC 2822 header
description.
- Rearranged some descriptions to match the header order.
- Removed the colons from header field names (e.g., "the Author
header").
- Added a description of the Content-Type header.
* Moved the plaintext-PEP-specific "PEP Formatting Requirements"
section to PEP 9. PEP 1 now deals only with content, not format.
* Minor edits, including:
- Capitalized "Standards Track" and "Informational" throughout.
- In "it's not like such decisions can be reversed", "can" should be
"can't"; fixed.
Mention %X (same treatment as %x).
Insert new stage B0, which gives warnings about e.g. 0xffffffff
without semantic changes. Move the proposed deployment of subsequent
stages up by one minor revision.
Retrieving a buffer from an object puts this in a locked state, and a
releasebuffer function must be called to unlock the object again.
Added releasefixedbuffer function slot, and renamed the
get...fixedbuffer functions to acquire...fixedbuffer functions.
Renamed the flag from Py_TPFLAG_HAVE_GETFIXEDBUFFER to
Py_TPFLAG_HAVE_FIXEDBUFFER. (Is the 'fixed buffer' name still useful,
or should we use 'static buffer' instead?)
Added posting date (was posted to c.l.p and python-dev).
and give Scott Gilert credit for it.
Change the author line to the new style.
Small other changes.
Barry, can you run pep2html on it, and change the PEP index to the new
name?
format of the Author: header to be "Random J. User <address@dom.ain>"
Update PEP 1 style guidelines.
Updated PEP 9 template.
Updated PEP 0 as an example.
fixfile(): Modify the Author: and Discussions-To: header handling for
the new required format. Since this uses Python 2.2's email package,
it should normalize either old style or new style addresses to the new
style for the web page.
Barry Warsaw
Guido van Rossum
Martin v. Löwis
Michael W. Hudson
Thomas Heller
Walter Dörwald
Neal Norwitz
Marc-André Lemburg
Ka-Ping Yee