-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathmep-0003.html
264 lines (212 loc) · 11 KB
/
mep-0003.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd">
<html>
<!--
This HTML is auto-generated. DO NOT EDIT THIS FILE! If you are writing a new
MEP, see http://www.python.org/meps/mep-0001.html for instructions and links
to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE!
-->
<head>
<title>MEP 3 -- Sample Plaintext MEP Template</title>
<link rel="STYLESHEET" href="style.css" type="text/css" />
</head>
<body bgcolor="white">
<table class="navigation" cellpadding="0" cellspacing="0"
width="100%%" border="0">
<tr><td class="navicon" width="107" height="47">
<a href="http://www.mozart-oz.org/" title="Mozart/Oz Home Page">
<img src="mozart-logo.gif" alt="[Mozart/Oz]"
border="0" width="107" height="47" /></a></td>
<td class="textlinks" align="left">
[<b><a href="http://www.mozart-oz.org/">Mozart/Oz Home</a></b>]
[<b><a href="mep-0000.html">MEP Index</a></b>]
[<b><a href="mep-0003.txt">MEP Source</a></b>]
</td></tr></table>
<div class="header">
<table border="0">
<tr><th>MEP: </th><td>3</td></tr>
<tr><th>Title: </th><td>Sample Plaintext MEP Template</td></tr>
<tr><th>Version: </th><td>$Revision$</td></tr>
<tr><th>Last-Modified: </th><td><a href="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/python/python/nondist/meps/mep-0003.txt">$Date$</a> </td></tr>
<tr><th>Author: </th><td>Denys Duchier <denys.duchier at mozart-oz.org>, Barry A. Warsaw <barry at python.org></td></tr>
<tr><th>Status: </th><td>Active</td></tr>
<tr><th>Type: </th><td>Informational</td></tr>
<tr><th>Content-Type: </th><td><a href="mep-0003.html">text/plain</a> </td></tr>
<tr><th>Created: </th><td>14-Aug-2001</td></tr>
<tr><th>Post-History: </th><td></td></tr>
</table>
</div>
<hr />
<div class="content">
<h3>Abstract</h3>
<pre>
This MEP provides a boilerplate or sample template for creating
your own plaintext MEPs. In conjunction with the content
guidelines in <a href="mep-0001.html">MEP 1</a> [1], this should make it easy for you to
conform your own MEPs to the format outlined below.
Note: if you are reading this MEP via the web, you should first
grab the plaintext source of this MEP in order to complete the
steps below. DO NOT USE THE HTML FILE AS YOUR TEMPLATE!
To get the source this (or any) MEP, look at the top of the html
page and click on the link titled "MEP Source".
If you would prefer to use lightweight markup in your MEP, please
see <a href="mep-0012.html">MEP 12</a>, "Sample reStructuredText MEP Template" [2].
</pre>
<h3>Rationale</h3>
<pre>
MEP submissions come in a wide variety of forms, not all adhering
to the format guidelines set forth below. Use this template, in
conjunction with the content guidelines in <a href="mep-0001.html">MEP 1</a>, to ensure that
your MEP submission won't get automatically rejected because of
form.
</pre>
<h3>How to Use This Template</h3>
<pre>
To use this template you must first decide whether your MEP is
going to be an Informational or Standards Track MEP. Most MEPs
are Standards Track because they propose a new feature for the
Python language or standard library. When in doubt, read <a href="mep-0001.html">MEP 1</a>
for details or contact the MEP editors <[email protected]>.
Once you've decided which type of MEP yours is going to be, follow
the directions below.
- Make a copy of this file (.txt file, not HTML!) and perform the
following edits.
- Replace the "MEP: 9" header with "MEP: XXX" since you don't yet
have a MEP number assignment.
- Change the Title header to the title of your MEP.
- Leave the Version and Last-Modified headers alone; we'll take
care of those when we check your MEP into CVS.
- Change the Author header to include your name, and optionally
your email address. Be sure to follow the format carefully:
your name must appear first, and it must not be contained in
parentheses. Your email address may appear second (or it can be
omitted) and if it appears, it must appear in angle brackets.
It is okay to obfuscate your email address.
- If there is a mailing list for discussion of your new feature,
add a Discussions-To header right after the Author header. You
should not add a Discussions-To header if the mailing list to be
used is either [email protected] or [email protected],
or if discussions should be sent to you directly. Most
Informational MEPs don't have a Discussions-To header.
- Change the Status header to "Draft".
- For Standards Track MEPs, change the Type header to "Standards
Track".
- For Informational MEPs, change the Type header to
"Informational".
- For Standards Track MEPs, if your feature depends on the
acceptance of some other currently in-development MEP, add a
Requires header right after the Type header. The value should
be the MEP number of the MEP yours depends on. Don't add this
header if your dependent feature is described in a Final MEP.
- Change the Created header to today's date. Be sure to follow
the format carefully: it must be in dd-mmm-yyyy format, where
the mmm is the 3 English letter month abbreviation, e.g. one of
Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec.
- For Standards Track MEPs, after the Created header, add a
Python-Version header and set the value to the next planned
version of Python, i.e. the one your new feature will hopefully
make its first appearance in. Do not use an alpha or beta
release designation here. Thus, if the last version of Python
was 2.2 alpha 1 and you're hoping to get your new feature into
Python 2.2, set the header to:
Python-Version: 2.2
- Leave Post-History alone for now; you'll add dates to this
header each time you post your MEP to [email protected] or
[email protected]. E.g. if you posted your MEP to the lists
on August 14, 2001 and September 3, 2001, the Post-History
header would look like:
Post-History: 14-Aug-2001, 03-Sept-2001
You must manually add new dates and check them in. If you don't
have check-in privileges, send your changes to the MEP editor.
- Add a Replaces header if your MEP obsoletes an earlier MEP. The
value of this header is the number of the MEP that your new MEP
is replacing. Only add this header if the older MEP is in
"final" form, i.e. is either Accepted, Final, or Rejected. You
aren't replacing an older open MEP if you're submitting a
competing idea.
- Now write your Abstract, Rationale, and other content for your
MEP, replacing all this gobbledygook with your own text. Be sure
to adhere to the format guidelines below, specifically on the
prohibition of tab characters and the indentation requirements.
- Update your References and Copyright section. Usually you'll
place your MEP into the public domain, in which case just leave
the "Copyright" section alone. Alternatively, you can use the
Open Publication License[3], but public domain is still strongly
preferred.
- Leave the little Emacs turd at the end of this file alone,
including the formfeed character ("^L", or \f).
- Send your MEP submission to the MEP editors ([email protected]),
along with $100k in unmarked pennies. (Just kidding, I wanted
to see if you were still awake. :)
</pre>
<h3>Plaintext MEP Formatting Requirements</h3>
<pre>
MEP headings must begin in column zero and the initial letter of
each word must be capitalized as in book titles. Acronyms should
be in all capitals. The body of each section must be indented 4
spaces. Code samples inside body sections should be indented a
further 4 spaces, and other indentation can be used as required to
make the text readable. You must use two blank lines between the
last line of a section's body and the next section heading.
You must adhere to the Emacs convention of adding two spaces at
the end of every sentence. You should fill your paragraphs to
column 70, but under no circumstances should your lines extend
past column 79. If your code samples spill over column 79, you
should rewrite them.
Tab characters must never appear in the document at all. A MEP
should include the standard Emacs stanza included by example at
the bottom of this MEP.
When referencing an external web page in the body of a MEP, you
should include the title of the page in the text, with a
footnote reference to the URL. Do not include the URL in the body
text of the MEP. E.g.
Refer to the Python Language web site [1] for more details.
...
[1] <a href="http://www.python.org">http://www.python.org</a>
When referring to another MEP, include the MEP number in the body
text, such as "<a href="mep-0001.html">MEP 1</a>". The title may optionally appear. Add a
footnote reference, a number in square brackets. The footnote
body should include the MEP's title and author. It may optionally
include the explicit URL on a separate line, but only in the
References section. Note that the pep2html.py script will
calculate URLs automatically. For example:
...
Refer to <a href="mep-0001.html">MEP 1</a> [7] for more information about MEP style
...
References
[7] <a href="mep-0001.html">MEP 1</a>, MEP Purpose and Guidelines, Warsaw, Hylton
<a href="http://www.python.org/peps/pep-0001.html">http://www.python.org/peps/pep-0001.html</a>
If you decide to provide an explicit URL for a MEP, please use
this as the URL template:
<a href="http://www.python.org/peps/pep-xxxx.html">http://www.python.org/peps/pep-xxxx.html</a>
MEP numbers in URLs must be padded with zeros from the left, so as
to be exactly 4 characters wide, however MEP numbers in the text
are never padded.
</pre>
<h3>References</h3>
<pre>
[1] <a href="mep-0001.html">MEP 1</a>, MEP Purpose and Guidelines, Duchier
<a href="http://www.mozart-oz.org/meps/mep-0001.html">http://www.mozart-oz.org/meps/mep-0001.html</a>
[2] <a href="mep-0002.html">MEP 2</a>, Sample reStructuredText MEP Template, Duchier
<a href="http://www.mozart-oz.org/meps/mep-0001.html">http://www.mozart-oz.org/meps/mep-0001.html</a>
[3] <a href="http://www.opencontent.org/openpub/">http://www.opencontent.org/openpub/</a>
</pre>
<h3>Copyright</h3>
<pre>
This document has been placed in the public domain.
</pre>
<h3>Votes</h3>
<pre>
Raphaël Collet []
Denys Duchier []
Seif Haridi []
Torbjörn Lager []
Konstantin Popov []
Camilo Rueda []
Christian Schulte []
Gert Smolka []
Peter Van Roy []
</pre>
</div>
</body>
</html>