| 1 | <?xml version="1.0" encoding="utf-8" ?> |
1 | <?xml version="1.0" encoding="utf-8" ?> |
| 2 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
2 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| 3 | <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
3 | <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
| 4 | <!-- |
4 | |
| 5 | This HTML is auto-generated. DO NOT EDIT THIS FILE! If you are writing a new |
|
|
| 6 | PEP, see http://www.python.org/peps/pep-0001.html for instructions and links |
|
|
| 7 | to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE! |
|
|
| 8 | --> |
|
|
| 9 | <head> |
5 | <head> |
| 10 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
6 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
| 11 | <meta name="generator" content="Docutils 0.3.0: http://docutils.sourceforge.net/" /> |
7 | <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" /> |
| 12 | <title>GLEP 2 -- Sample ReStructuredText GLEP Template</title> |
8 | <title>GLEP 2 -- Sample ReStructuredText GLEP Template</title> |
| 13 | <link rel="stylesheet" href="tools/glep.css" type="text/css" /> |
9 | <link rel="stylesheet" href="tools/glep.css" type="text/css" /> |
| 14 | </head> |
10 | </head> |
| 15 | <body bgcolor="white"> |
11 | <body bgcolor="white"> |
| 16 | <table class="navigation" cellpadding="0" cellspacing="0" |
12 | <table class="navigation" cellpadding="0" cellspacing="0" |
| … | |
… | |
| 22 | <td class="textlinks" align="left"> |
18 | <td class="textlinks" align="left"> |
| 23 | [<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>] |
19 | [<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>] |
| 24 | [<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>] |
20 | [<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>] |
| 25 | [<b><a href="http://www.gentoo.org/proj/en/glep/glep-0002.txt">GLEP Source</a></b>] |
21 | [<b><a href="http://www.gentoo.org/proj/en/glep/glep-0002.txt">GLEP Source</a></b>] |
| 26 | </td></tr></table> |
22 | </td></tr></table> |
| 27 | <div class="document"> |
|
|
| 28 | <table class="rfc2822 field-list" frame="void" rules="none"> |
23 | <table class="rfc2822 docutils field-list" frame="void" rules="none"> |
| 29 | <col class="field-name" /> |
24 | <col class="field-name" /> |
| 30 | <col class="field-body" /> |
25 | <col class="field-body" /> |
| 31 | <tbody valign="top"> |
26 | <tbody valign="top"> |
| 32 | <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">2</td> |
27 | <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">2</td> |
| 33 | </tr> |
28 | </tr> |
| … | |
… | |
| 50 | <tr class="field"><th class="field-name">Post-History:</th><td class="field-body">2-Jun-2003</td> |
45 | <tr class="field"><th class="field-name">Post-History:</th><td class="field-body">2-Jun-2003</td> |
| 51 | </tr> |
46 | </tr> |
| 52 | </tbody> |
47 | </tbody> |
| 53 | </table> |
48 | </table> |
| 54 | <hr /> |
49 | <hr /> |
| 55 | <div class="contents topic" id="contents"> |
50 | <div class="contents topic"> |
| 56 | <p class="topic-title"><a name="contents">Contents</a></p> |
51 | <p class="topic-title first"><a id="contents" name="contents">Contents</a></p> |
| 57 | <ul class="simple"> |
52 | <ul class="simple"> |
| 58 | <li><a class="reference" href="#credits" id="id23" name="id23">Credits</a></li> |
53 | <li><a class="reference" href="#credits" id="id23" name="id23">Credits</a></li> |
| 59 | <li><a class="reference" href="#abstract" id="id24" name="id24">Abstract</a></li> |
54 | <li><a class="reference" href="#abstract" id="id24" name="id24">Abstract</a></li> |
| 60 | <li><a class="reference" href="#motivation" id="id25" name="id25">Motivation</a></li> |
55 | <li><a class="reference" href="#motivation" id="id25" name="id25">Motivation</a></li> |
| 61 | <li><a class="reference" href="#rationale" id="id26" name="id26">Rationale</a></li> |
56 | <li><a class="reference" href="#rationale" id="id26" name="id26">Rationale</a></li> |
| … | |
… | |
| 81 | <li><a class="reference" href="#resources" id="id44" name="id44">Resources</a></li> |
76 | <li><a class="reference" href="#resources" id="id44" name="id44">Resources</a></li> |
| 82 | <li><a class="reference" href="#references" id="id45" name="id45">References</a></li> |
77 | <li><a class="reference" href="#references" id="id45" name="id45">References</a></li> |
| 83 | <li><a class="reference" href="#copyright" id="id46" name="id46">Copyright</a></li> |
78 | <li><a class="reference" href="#copyright" id="id46" name="id46">Copyright</a></li> |
| 84 | </ul> |
79 | </ul> |
| 85 | </div> |
80 | </div> |
| 86 | <div class="section" id="credits"> |
81 | <div class="section"> |
| 87 | <h1><a class="toc-backref" href="#id23" name="credits">Credits</a></h1> |
82 | <h1><a class="toc-backref" href="#id23" id="credits" name="credits">Credits</a></h1> |
| 88 | <p>The text of this GLEP was, to a significant extent, stolen from Python's |
83 | <p>The text of this GLEP was, to a significant extent, stolen from Python's |
| 89 | <a class="footnote-reference" href="#python" id="id1" name="id1">[1]</a> PEP-0012 <a class="footnote-reference" href="#pep12" id="id2" name="id2">[2]</a> by David Goodger and Barry A. Warsaw.</p> |
84 | <a class="footnote-reference" href="#python" id="id1" name="id1">[1]</a> PEP-0012 <a class="footnote-reference" href="#pep12" id="id2" name="id2">[2]</a> by David Goodger and Barry A. Warsaw.</p> |
| 90 | </div> |
85 | </div> |
| 91 | <div class="section" id="abstract"> |
86 | <div class="section"> |
| 92 | <h1><a class="toc-backref" href="#id24" name="abstract">Abstract</a></h1> |
87 | <h1><a class="toc-backref" href="#id24" id="abstract" name="abstract">Abstract</a></h1> |
| 93 | <p>This GLEP provides a boilerplate or sample template for creating your own |
88 | <p>This GLEP provides a boilerplate or sample template for creating your own |
| 94 | reStructuredText GLEPs. In conjunction with the content guidelines in GLEP 1 |
89 | reStructuredText GLEPs. In conjunction with the content guidelines in GLEP 1 |
| 95 | <a class="footnote-reference" href="#glep1" id="id3" name="id3">[3]</a>, this should make it easy for you to conform your own GLEPs to the |
90 | <a class="footnote-reference" href="#glep1" id="id3" name="id3">[3]</a>, this should make it easy for you to conform your own GLEPs to the |
| 96 | format outlined below.</p> |
91 | format outlined below.</p> |
| 97 | <p>Note: if you are reading this GLEP via the web, you should first grab the text |
92 | <p>Note: if you are reading this GLEP via the web, you should first grab the text |
| 98 | (reStructuredText) source of this GLEP in order to complete the steps below. |
93 | (reStructuredText) source of this GLEP in order to complete the steps below. |
| 99 | <strong>DO NOT USE THE HTML FILE AS YOUR TEMPLATE!</strong></p> |
94 | <strong>DO NOT USE THE HTML FILE AS YOUR TEMPLATE!</strong></p> |
| 100 | <p>To get the source of this (or any) GLEP, look at the top of the HTML page and |
95 | <p>To get the source of this (or any) GLEP, look at the top of the HTML page and |
| 101 | click on the link titled "GLEP Source".</p> |
96 | click on the link titled "GLEP Source".</p> |
| 102 | </div> |
97 | </div> |
| 103 | <div class="section" id="motivation"> |
98 | <div class="section"> |
| 104 | <h1><a class="toc-backref" href="#id25" name="motivation">Motivation</a></h1> |
99 | <h1><a class="toc-backref" href="#id25" id="motivation" name="motivation">Motivation</a></h1> |
| 105 | <p>Provide adequate motivation here. In this particular case, we need to provide |
100 | <p>Provide adequate motivation here. In this particular case, we need to provide |
| 106 | people with the information necessary to submit GLEPs in the proper form.</p> |
101 | people with the information necessary to submit GLEPs in the proper form.</p> |
| 107 | </div> |
102 | </div> |
| 108 | <div class="section" id="rationale"> |
103 | <div class="section"> |
| 109 | <h1><a class="toc-backref" href="#id26" name="rationale">Rationale</a></h1> |
104 | <h1><a class="toc-backref" href="#id26" id="rationale" name="rationale">Rationale</a></h1> |
| 110 | <p>GLEP submissions come in a wide variety of forms, not all adhering to the |
105 | <p>GLEP submissions come in a wide variety of forms, not all adhering to the |
| 111 | format guidelines set forth below. Use this template, in conjunction with the |
106 | format guidelines set forth below. Use this template, in conjunction with the |
| 112 | format guidelines below, to ensure that your GLEP submission won't get |
107 | format guidelines below, to ensure that your GLEP submission won't get |
| 113 | automatically rejected because of form.</p> |
108 | automatically rejected because of form.</p> |
| 114 | <p>ReStructuredText is used to allow GLEP authors more functionality and |
109 | <p>ReStructuredText is used to allow GLEP authors more functionality and |
| 115 | expressivity, while maintaining easy readability in the source text. The |
110 | expressivity, while maintaining easy readability in the source text. The |
| 116 | processed HTML form makes the functionality accessible to readers: live |
111 | processed HTML form makes the functionality accessible to readers: live |
| 117 | hyperlinks, styled text, tables, images, and automatic tables of contents, |
112 | hyperlinks, styled text, tables, images, and automatic tables of contents, |
| 118 | among other advantages.</p> |
113 | among other advantages.</p> |
| 119 | </div> |
114 | </div> |
| 120 | <div class="section" id="backwards-compatibility"> |
115 | <div class="section"> |
| 121 | <h1><a class="toc-backref" href="#id27" name="backwards-compatibility">Backwards Compatibility</a></h1> |
116 | <h1><a class="toc-backref" href="#id27" id="backwards-compatibility" name="backwards-compatibility">Backwards Compatibility</a></h1> |
| 122 | <p>Not a problem for this GLEP. This section should be included <em>even</em> when it |
117 | <p>Not a problem for this GLEP. This section should be included <em>even</em> when it |
| 123 | is only to state that there are no backwards compatibility issues.</p> |
118 | is only to state that there are no backwards compatibility issues.</p> |
| 124 | </div> |
119 | </div> |
| 125 | <div class="section" id="how-to-use-this-template"> |
120 | <div class="section"> |
| 126 | <h1><a class="toc-backref" href="#id28" name="how-to-use-this-template">How to Use This Template</a></h1> |
121 | <h1><a class="toc-backref" href="#id28" id="how-to-use-this-template" name="how-to-use-this-template">How to Use This Template</a></h1> |
| 127 | <p>To use this template you must first decide whether your GLEP is going to be an |
122 | <p>To use this template you must first decide whether your GLEP is going to be an |
| 128 | Informational or Standards Track GLEP. Most GLEPs are Standards Track because |
123 | Informational or Standards Track GLEP. Most GLEPs are Standards Track because |
| 129 | they propose new functionality for some aspect of Gentoo Linux. When in |
124 | they propose new functionality for some aspect of Gentoo Linux. When in |
| 130 | doubt, read GLEP 1 for details or contact the GLEP editors <<a class="reference" href="mailto:glep@gentoo.org">glep@gentoo.org</a>>.</p> |
125 | doubt, read GLEP 1 for details or contact the GLEP editors <<a class="reference" href="mailto:glep@gentoo.org">glep@gentoo.org</a>>.</p> |
| 131 | <p>Once you've decided which type of GLEP yours is going to be, follow the |
126 | <p>Once you've decided which type of GLEP yours is going to be, follow the |
| 132 | directions below.</p> |
127 | directions below.</p> |
| 133 | <ul> |
128 | <ul> |
| 134 | <li><p class="first">Make a copy of this file (<tt class="literal"><span class="pre">.txt</span></tt> file, <strong>not</strong> HTML!) and perform |
129 | <li><p class="first">Make a copy of this file (<tt class="docutils literal"><span class="pre">.txt</span></tt> file, <strong>not</strong> HTML!) and perform |
| 135 | the following edits.</p> |
130 | the following edits.</p> |
| 136 | </li> |
131 | </li> |
| 137 | <li><p class="first">Replace the "GLEP: 2" header with "GLEP: XXX" since you don't yet have |
132 | <li><p class="first">Replace the "GLEP: 2" header with "GLEP: XXX" since you don't yet have |
| 138 | a GLEP number assignment.</p> |
133 | a GLEP number assignment.</p> |
| 139 | </li> |
134 | </li> |
| … | |
… | |
| 147 | appear first, and it must not be contained in parentheses. Your email |
142 | appear first, and it must not be contained in parentheses. Your email |
| 148 | address may appear second (or it can be omitted) and if it appears, it must |
143 | address may appear second (or it can be omitted) and if it appears, it must |
| 149 | appear in angle brackets. Your e-mail address |
144 | appear in angle brackets. Your e-mail address |
| 150 | here will e automatically obfuscated.</p> |
145 | here will e automatically obfuscated.</p> |
| 151 | </li> |
146 | </li> |
| 152 | <li><p class="first">If there is a forum thread or a mailing list for discussion |
147 | <li><p class="first">If there is a forum thread or a mailing list for discussion |
| 153 | of your new feature, add a Discussions-To header right after the Author |
148 | of your new feature, add a Discussions-To header right after the Author |
| 154 | header. You should not add a Discussions-To header if the mailing list to |
149 | header. You should not add a Discussions-To header if the mailing list to |
| 155 | be used is <a class="reference" href="mailto:gentoo-dev@gentoo.org">gentoo-dev@gentoo.org</a>, or if discussions should be sent to you |
150 | be used is <a class="reference" href="mailto:gentoo-dev@gentoo.org">gentoo-dev@gentoo.org</a>, or if discussions should be sent to you |
| 156 | directly. Most Informational GLEPs don't have a Discussions-To header.</p> |
151 | directly. Most Informational GLEPs don't have a Discussions-To header.</p> |
| 157 | </li> |
152 | </li> |
| … | |
… | |
| 167 | after the Type header. The value should be the GLEP number of the GLEP |
162 | after the Type header. The value should be the GLEP number of the GLEP |
| 168 | yours depends on. Don't add this header if your dependent feature is |
163 | yours depends on. Don't add this header if your dependent feature is |
| 169 | described in a Final GLEP.</p> |
164 | described in a Final GLEP.</p> |
| 170 | </li> |
165 | </li> |
| 171 | <li><p class="first">Change the Created header to today's date. Be sure to follow the |
166 | <li><p class="first">Change the Created header to today's date. Be sure to follow the |
| 172 | format carefully: it must be in <tt class="literal"><span class="pre">dd-mmm-yyyy</span></tt> format, where the <tt class="literal"><span class="pre">mmm</span></tt> is |
167 | format carefully: it must be in <tt class="docutils literal"><span class="pre">dd-mmm-yyyy</span></tt> format, where the <tt class="docutils literal"><span class="pre">mmm</span></tt> is |
| 173 | the 3 English letter month abbreviation, i.e. one of Jan, Feb, Mar, Apr, |
168 | the 3 English letter month abbreviation, i.e. one of Jan, Feb, Mar, Apr, |
| 174 | May, Jun, Jul, Aug, Sep, Oct, Nov, Dec.</p> |
169 | May, Jun, Jul, Aug, Sep, Oct, Nov, Dec.</p> |
| 175 | </li> |
170 | </li> |
| 176 | <li><p class="first">Leave Post-History alone for now; you'll add dates to this header |
171 | <li><p class="first">Leave Post-History alone for now; you'll add dates to this header |
| 177 | each time you post your GLEP to <a class="reference" href="mailto:gentoo-dev@gentoo.org">gentoo-dev@gentoo.org</a>. If you posted your |
172 | each time you post your GLEP to <a class="reference" href="mailto:gentoo-dev@gentoo.org">gentoo-dev@gentoo.org</a>. If you posted your |
| … | |
… | |
| 200 | </li> |
195 | </li> |
| 201 | <li><p class="first">Send your GLEP submission to the GLEP editors at <a class="reference" href="mailto:glep@gentoo.org">glep@gentoo.org</a>.</p> |
196 | <li><p class="first">Send your GLEP submission to the GLEP editors at <a class="reference" href="mailto:glep@gentoo.org">glep@gentoo.org</a>.</p> |
| 202 | </li> |
197 | </li> |
| 203 | </ul> |
198 | </ul> |
| 204 | </div> |
199 | </div> |
| 205 | <div class="section" id="restructuredtext-glep-formatting-requirements"> |
200 | <div class="section"> |
| 206 | <h1><a class="toc-backref" href="#id29" name="restructuredtext-glep-formatting-requirements">ReStructuredText GLEP Formatting Requirements</a></h1> |
201 | <h1><a class="toc-backref" href="#id29" id="restructuredtext-glep-formatting-requirements" name="restructuredtext-glep-formatting-requirements">ReStructuredText GLEP Formatting Requirements</a></h1> |
| 207 | <p>The following is a GLEP-specific summary of reStructuredText syntax. For the |
202 | <p>The following is a GLEP-specific summary of reStructuredText syntax. For the |
| 208 | sake of simplicity and brevity, much detail is omitted. For more detail, see |
203 | sake of simplicity and brevity, much detail is omitted. For more detail, see |
| 209 | <a class="reference" href="#resources">Resources</a> below. <a class="reference" href="#literal-blocks">Literal blocks</a> (in which no markup processing is done) |
204 | <a class="reference" href="#resources">Resources</a> below. <a class="reference" href="#literal-blocks">Literal blocks</a> (in which no markup processing is done) |
| 210 | are used for examples throughout, to illustrate the plaintext markup.</p> |
205 | are used for examples throughout, to illustrate the plaintext markup.</p> |
| 211 | <div class="section" id="general"> |
206 | <div class="section"> |
| 212 | <h2><a class="toc-backref" href="#id30" name="general">General</a></h2> |
207 | <h2><a class="toc-backref" href="#id30" id="general" name="general">General</a></h2> |
| 213 | <p>You must adhere to the convention of adding two spaces at the end of every |
208 | <p>You must adhere to the convention of adding two spaces at the end of every |
| 214 | sentence. You should fill your paragraphs to column 70, but under no |
209 | sentence. You should fill your paragraphs to column 70, but under no |
| 215 | circumstances should your lines extend past column 79. If your code samples |
210 | circumstances should your lines extend past column 79. If your code samples |
| 216 | spill over column 79, you should rewrite them.</p> |
211 | spill over column 79, you should rewrite them.</p> |
| 217 | </div> |
212 | </div> |
| 218 | <div class="section" id="section-headings"> |
213 | <div class="section"> |
| 219 | <h2><a class="toc-backref" href="#id31" name="section-headings">Section Headings</a></h2> |
214 | <h2><a class="toc-backref" href="#id31" id="section-headings" name="section-headings">Section Headings</a></h2> |
| 220 | <p>GLEP headings must begin in column zero and the initial letter of each word |
215 | <p>GLEP headings must begin in column zero and the initial letter of each word |
| 221 | must be capitalized as in book titles. Acronyms should be in all capitals. |
216 | must be capitalized as in book titles. Acronyms should be in all capitals. |
| 222 | Section titles must be adorned with an underline, a single repeated |
217 | Section titles must be adorned with an underline, a single repeated |
| 223 | punctuation character, which begins in column zero and must extend at least as |
218 | punctuation character, which begins in column zero and must extend at least as |
| 224 | far as the right edge of the title text (4 characters minimum). First-level |
219 | far as the right edge of the title text (4 characters minimum). First-level |
| … | |
… | |
| 262 | heading, a single blank line in-between is sufficient.</p> |
257 | heading, a single blank line in-between is sufficient.</p> |
| 263 | <p>The body of each section is not normally indented, although some constructs do |
258 | <p>The body of each section is not normally indented, although some constructs do |
| 264 | use indentation, as described below. Blank lines are used to separate |
259 | use indentation, as described below. Blank lines are used to separate |
| 265 | constructs.</p> |
260 | constructs.</p> |
| 266 | </div> |
261 | </div> |
| 267 | <div class="section" id="paragraphs"> |
262 | <div class="section"> |
| 268 | <h2><a class="toc-backref" href="#id32" name="paragraphs">Paragraphs</a></h2> |
263 | <h2><a class="toc-backref" href="#id32" id="paragraphs" name="paragraphs">Paragraphs</a></h2> |
| 269 | <p>Paragraphs are left-aligned text blocks separated by blank lines. Paragraphs |
264 | <p>Paragraphs are left-aligned text blocks separated by blank lines. Paragraphs |
| 270 | are not indented unless they are part of an indented construct (such as a |
265 | are not indented unless they are part of an indented construct (such as a |
| 271 | block quote or a list item).</p> |
266 | block quote or a list item).</p> |
| 272 | </div> |
267 | </div> |
| 273 | <div class="section" id="inline-markup"> |
268 | <div class="section"> |
| 274 | <h2><a class="toc-backref" href="#id33" name="inline-markup">Inline Markup</a></h2> |
269 | <h2><a class="toc-backref" href="#id33" id="inline-markup" name="inline-markup">Inline Markup</a></h2> |
| 275 | <p>Portions of text within paragraphs and other text blocks may be |
270 | <p>Portions of text within paragraphs and other text blocks may be |
| 276 | styled. For example:</p> |
271 | styled. For example:</p> |
| 277 | <pre class="literal-block"> |
272 | <pre class="literal-block"> |
| 278 | Text may be marked as *emphasized* (single asterisk markup, |
273 | Text may be marked as *emphasized* (single asterisk markup, |
| 279 | typically shown in italics) or **strongly emphasized** (double |
274 | typically shown in italics) or **strongly emphasized** (double |
| … | |
… | |
| 281 | backquotes) are typically rendered in a monospaced typeface. No |
276 | backquotes) are typically rendered in a monospaced typeface. No |
| 282 | further markup recognition is done within the double backquotes, |
277 | further markup recognition is done within the double backquotes, |
| 283 | so they're safe for any kind of code snippets. |
278 | so they're safe for any kind of code snippets. |
| 284 | </pre> |
279 | </pre> |
| 285 | </div> |
280 | </div> |
| 286 | <div class="section" id="block-quotes"> |
281 | <div class="section"> |
| 287 | <h2><a class="toc-backref" href="#id34" name="block-quotes">Block Quotes</a></h2> |
282 | <h2><a class="toc-backref" href="#id34" id="block-quotes" name="block-quotes">Block Quotes</a></h2> |
| 288 | <p>Block quotes consist of indented body elements. For example:</p> |
283 | <p>Block quotes consist of indented body elements. For example:</p> |
| 289 | <pre class="literal-block"> |
284 | <pre class="literal-block"> |
| 290 | This is a paragraph. |
285 | This is a paragraph. |
| 291 | |
286 | |
| 292 | This is a block quote. |
287 | This is a block quote. |
| … | |
… | |
| 295 | </pre> |
290 | </pre> |
| 296 | <p>Block quotes are used to quote extended passages from other sources. |
291 | <p>Block quotes are used to quote extended passages from other sources. |
| 297 | Block quotes may be nested inside other body elements. Use a 4-space tab |
292 | Block quotes may be nested inside other body elements. Use a 4-space tab |
| 298 | per indent level.</p> |
293 | per indent level.</p> |
| 299 | </div> |
294 | </div> |
| 300 | <div class="section" id="literal-blocks"> |
295 | <div class="section"> |
| 301 | <h2><a class="toc-backref" href="#id35" name="literal-blocks">Literal Blocks</a></h2> |
296 | <h2><a class="toc-backref" href="#id35" id="literal-blocks" name="literal-blocks">Literal Blocks</a></h2> |
| 302 | <!-- In the text below, double backquotes are used to denote inline |
297 | <!-- In the text below, double backquotes are used to denote inline |
| 303 | literals. "``::``" is written so that the colons will appear in a |
298 | literals. "``::``" is written so that the colons will appear in a |
| 304 | monospaced font; the backquotes (``) are markup, not part of the |
299 | monospaced font; the backquotes (``) are markup, not part of the |
| 305 | text. See "Inline Markup" above. |
300 | text. See "Inline Markup" above. |
| 306 | |
301 | |
| 307 | By the way, this is a comment, described in "Comments" below. --> |
302 | By the way, this is a comment, described in "Comments" below. --> |
| 308 | <p>Literal blocks are used for code samples or preformatted ASCII art. To |
303 | <p>Literal blocks are used for code samples or preformatted ASCII art. To |
| 309 | indicate a literal block, preface the indented text block with |
304 | indicate a literal block, preface the indented text block with |
| 310 | "<tt class="literal"><span class="pre">::</span></tt>" (two colons). The literal block continues until the end of |
305 | "<tt class="docutils literal"><span class="pre">::</span></tt>" (two colons). The literal block continues until the end of |
| 311 | the indentation. Indent the text block by a tab. For example:</p> |
306 | the indentation. Indent the text block by a tab. For example:</p> |
| 312 | <pre class="literal-block"> |
307 | <pre class="literal-block"> |
| 313 | This is a typical paragraph. A literal block follows. |
308 | This is a typical paragraph. A literal block follows. |
| 314 | |
309 | |
| 315 | :: |
310 | :: |
| … | |
… | |
| 317 | for a in [5,4,3,2,1]: # this is program code, shown as-is |
312 | for a in [5,4,3,2,1]: # this is program code, shown as-is |
| 318 | print a |
313 | print a |
| 319 | print "it's..." |
314 | print "it's..." |
| 320 | # a literal block continues until the indentation ends |
315 | # a literal block continues until the indentation ends |
| 321 | </pre> |
316 | </pre> |
| 322 | <p>The paragraph containing only "<tt class="literal"><span class="pre">::</span></tt>" will be completely removed from |
317 | <p>The paragraph containing only "<tt class="docutils literal"><span class="pre">::</span></tt>" will be completely removed from |
| 323 | the output; no empty paragraph will remain. "<tt class="literal"><span class="pre">::</span></tt>" is also |
318 | the output; no empty paragraph will remain. "<tt class="docutils literal"><span class="pre">::</span></tt>" is also |
| 324 | recognized at the end of any paragraph. If immediately preceded by |
319 | recognized at the end of any paragraph. If immediately preceded by |
| 325 | whitespace, both colons will be removed from the output. When text |
320 | whitespace, both colons will be removed from the output. When text |
| 326 | immediately precedes the "<tt class="literal"><span class="pre">::</span></tt>", <em>one</em> colon will be removed from |
321 | immediately precedes the "<tt class="docutils literal"><span class="pre">::</span></tt>", <em>one</em> colon will be removed from |
| 327 | the output, leaving only one colon visible (i.e., "<tt class="literal"><span class="pre">::</span></tt>" will be |
322 | the output, leaving only one colon visible (i.e., "<tt class="docutils literal"><span class="pre">::</span></tt>" will be |
| 328 | replaced by "<tt class="literal"><span class="pre">:</span></tt>"). For example, one colon will remain visible |
323 | replaced by "<tt class="docutils literal"><span class="pre">:</span></tt>"). For example, one colon will remain visible |
| 329 | here:</p> |
324 | here:</p> |
| 330 | <pre class="literal-block"> |
325 | <pre class="literal-block"> |
| 331 | Paragraph:: |
326 | Paragraph:: |
| 332 | |
327 | |
| 333 | Literal block |
328 | Literal block |
| 334 | </pre> |
329 | </pre> |
| 335 | </div> |
330 | </div> |
| 336 | <div class="section" id="lists"> |
331 | <div class="section"> |
| 337 | <h2><a class="toc-backref" href="#id36" name="lists">Lists</a></h2> |
332 | <h2><a class="toc-backref" href="#id36" id="lists" name="lists">Lists</a></h2> |
| 338 | <p>Bullet list items begin with one of "-", "*", or "+" (hyphen, |
333 | <p>Bullet list items begin with one of "-", "*", or "+" (hyphen, |
| 339 | asterisk, or plus sign), followed by whitespace and the list item |
334 | asterisk, or plus sign), followed by whitespace and the list item |
| 340 | body. List item bodies must be left-aligned and indented relative to |
335 | body. List item bodies must be left-aligned and indented relative to |
| 341 | the bullet; the text immediately after the bullet determines the |
336 | the bullet; the text immediately after the bullet determines the |
| 342 | indentation. For example:</p> |
337 | indentation. For example:</p> |
| … | |
… | |
| 388 | The term is a one-line phrase, and the definition is one |
383 | The term is a one-line phrase, and the definition is one |
| 389 | or more paragraphs or body elements, indented relative to |
384 | or more paragraphs or body elements, indented relative to |
| 390 | the term. |
385 | the term. |
| 391 | </pre> |
386 | </pre> |
| 392 | </div> |
387 | </div> |
| 393 | <div class="section" id="tables"> |
388 | <div class="section"> |
| 394 | <h2><a class="toc-backref" href="#id37" name="tables">Tables</a></h2> |
389 | <h2><a class="toc-backref" href="#id37" id="tables" name="tables">Tables</a></h2> |
| 395 | <p>Simple tables are easy and compact:</p> |
390 | <p>Simple tables are easy and compact:</p> |
| 396 | <pre class="literal-block"> |
391 | <pre class="literal-block"> |
| 397 | ===== ===== ======= |
392 | ===== ===== ======= |
| 398 | A B A and B |
393 | A B A and B |
| 399 | ===== ===== ======= |
394 | ===== ===== ======= |
| … | |
… | |
| 433 | - Second item in bullet |
428 | - Second item in bullet |
| 434 | list (row 3, column 2). |
429 | list (row 3, column 2). |
| 435 | ===== ========================= |
430 | ===== ========================= |
| 436 | </pre> |
431 | </pre> |
| 437 | </div> |
432 | </div> |
| 438 | <div class="section" id="hyperlinks"> |
433 | <div class="section"> |
| 439 | <h2><a class="toc-backref" href="#id38" name="hyperlinks">Hyperlinks</a></h2> |
434 | <h2><a class="toc-backref" href="#id38" id="hyperlinks" name="hyperlinks">Hyperlinks</a></h2> |
| 440 | <p>When referencing an external web page in the body of a GLEP, you should |
435 | <p>When referencing an external web page in the body of a GLEP, you should |
| 441 | include the title of the page in the text, with either an inline |
436 | include the title of the page in the text, with either an inline |
| 442 | hyperlink reference to the URL or a footnote reference (see |
437 | hyperlink reference to the URL or a footnote reference (see |
| 443 | <a class="reference" href="#footnotes">Footnotes</a> below). Do not include the URL in the body text of the |
438 | <a class="reference" href="#footnotes">Footnotes</a> below). Do not include the URL in the body text of the |
| 444 | GLEP.</p> |
439 | GLEP.</p> |
| … | |
… | |
| 473 | automatically at the end of the References section of the GLEP, along |
468 | automatically at the end of the References section of the GLEP, along |
| 474 | with footnote references linking the reference text to the footnotes.</p> |
469 | with footnote references linking the reference text to the footnotes.</p> |
| 475 | <p>Text of the form "GLEP x" or "RFC x" (where "x" is a number) will be |
470 | <p>Text of the form "GLEP x" or "RFC x" (where "x" is a number) will be |
| 476 | linked automatically to the appropriate URLs.</p> |
471 | linked automatically to the appropriate URLs.</p> |
| 477 | </div> |
472 | </div> |
| 478 | <div class="section" id="footnotes"> |
473 | <div class="section"> |
| 479 | <h2><a class="toc-backref" href="#id39" name="footnotes">Footnotes</a></h2> |
474 | <h2><a class="toc-backref" href="#id39" id="footnotes" name="footnotes">Footnotes</a></h2> |
| 480 | <p>Footnote references consist of a left square bracket, a number, a |
475 | <p>Footnote references consist of a left square bracket, a number, a |
| 481 | right square bracket, and a trailing underscore:</p> |
476 | right square bracket, and a trailing underscore:</p> |
| 482 | <pre class="literal-block"> |
477 | <pre class="literal-block"> |
| 483 | This sentence ends with a footnote reference [1]_. |
478 | This sentence ends with a footnote reference [1]_. |
| 484 | </pre> |
479 | </pre> |
| … | |
… | |
| 528 | </pre> |
523 | </pre> |
| 529 | <p>Footnotes and footnote references will be numbered automatically, and |
524 | <p>Footnotes and footnote references will be numbered automatically, and |
| 530 | the numbers will always match. Once a GLEP is finalized, auto-numbered |
525 | the numbers will always match. Once a GLEP is finalized, auto-numbered |
| 531 | labels should be replaced by numbers for simplicity.</p> |
526 | labels should be replaced by numbers for simplicity.</p> |
| 532 | </div> |
527 | </div> |
| 533 | <div class="section" id="images"> |
528 | <div class="section"> |
| 534 | <h2><a class="toc-backref" href="#id40" name="images">Images</a></h2> |
529 | <h2><a class="toc-backref" href="#id40" id="images" name="images">Images</a></h2> |
| 535 | <p>If your GLEP contains a diagram, you may include it in the processed |
530 | <p>If your GLEP contains a diagram, you may include it in the processed |
| 536 | output using the "image" directive:</p> |
531 | output using the "image" directive:</p> |
| 537 | <pre class="literal-block"> |
532 | <pre class="literal-block"> |
| 538 | .. image:: diagram.png |
533 | .. image:: diagram.png |
| 539 | </pre> |
534 | </pre> |
| … | |
… | |
| 541 | .tiff, etc.</p> |
536 | .tiff, etc.</p> |
| 542 | <p>Since this image will not be visible to readers of the GLEP in source |
537 | <p>Since this image will not be visible to readers of the GLEP in source |
| 543 | text form, you should consider including a description or ASCII art |
538 | text form, you should consider including a description or ASCII art |
| 544 | alternative, using a comment (below).</p> |
539 | alternative, using a comment (below).</p> |
| 545 | </div> |
540 | </div> |
| 546 | <div class="section" id="comments"> |
541 | <div class="section"> |
| 547 | <h2><a class="toc-backref" href="#id41" name="comments">Comments</a></h2> |
542 | <h2><a class="toc-backref" href="#id41" id="comments" name="comments">Comments</a></h2> |
| 548 | <p>A comment block is an indented block of arbitrary text immediately |
543 | <p>A comment block is an indented block of arbitrary text immediately |
| 549 | following an explicit markup start: two periods and whitespace. Leave |
544 | following an explicit markup start: two periods and whitespace. Leave |
| 550 | the ".." on a line by itself to ensure that the comment is not |
545 | the ".." on a line by itself to ensure that the comment is not |
| 551 | misinterpreted as another explicit markup construct. Comments are not |
546 | misinterpreted as another explicit markup construct. Comments are not |
| 552 | visible in the processed document. For the benefit of those reading |
547 | visible in the processed document. For the benefit of those reading |
| … | |
… | |
| 558 | .. |
553 | .. |
| 559 | Data flows from the input module, through the "black box" |
554 | Data flows from the input module, through the "black box" |
| 560 | module, and finally into (and through) the output module. |
555 | module, and finally into (and through) the output module. |
| 561 | </pre> |
556 | </pre> |
| 562 | </div> |
557 | </div> |
| 563 | <div class="section" id="escaping-mechanism"> |
558 | <div class="section"> |
| 564 | <h2><a class="toc-backref" href="#id42" name="escaping-mechanism">Escaping Mechanism</a></h2> |
559 | <h2><a class="toc-backref" href="#id42" id="escaping-mechanism" name="escaping-mechanism">Escaping Mechanism</a></h2> |
| 565 | <p>reStructuredText uses backslashes ("<tt class="literal"><span class="pre">\</span></tt>") to override the special |
560 | <p>reStructuredText uses backslashes ("<tt class="docutils literal"><span class="pre">\</span></tt>") to override the special |
| 566 | meaning given to markup characters and get the literal characters |
561 | meaning given to markup characters and get the literal characters |
| 567 | themselves. To get a literal backslash, use an escaped backslash |
562 | themselves. To get a literal backslash, use an escaped backslash |
| 568 | ("<tt class="literal"><span class="pre">\\</span></tt>"). There are two contexts in which backslashes have no |
563 | ("<tt class="docutils literal"><span class="pre">\\</span></tt>"). There are two contexts in which backslashes have no |
| 569 | special meaning: <a class="reference" href="#literal-blocks">literal blocks</a> and inline literals (see <a class="reference" href="#inline-markup">Inline |
564 | special meaning: <a class="reference" href="#literal-blocks">literal blocks</a> and inline literals (see <a class="reference" href="#inline-markup">Inline |
| 570 | Markup</a> above). In these contexts, no markup recognition is done, |
565 | Markup</a> above). In these contexts, no markup recognition is done, |
| 571 | and a single backslash represents a literal backslash, without having |
566 | and a single backslash represents a literal backslash, without having |
| 572 | to double up.</p> |
567 | to double up.</p> |
| 573 | <p>If you find that you need to use a backslash in your text, consider |
568 | <p>If you find that you need to use a backslash in your text, consider |
| 574 | using inline literals or a literal block instead.</p> |
569 | using inline literals or a literal block instead.</p> |
| 575 | </div> |
570 | </div> |
| 576 | </div> |
571 | </div> |
| 577 | <div class="section" id="habits-to-avoid"> |
572 | <div class="section"> |
| 578 | <h1><a class="toc-backref" href="#id43" name="habits-to-avoid">Habits to Avoid</a></h1> |
573 | <h1><a class="toc-backref" href="#id43" id="habits-to-avoid" name="habits-to-avoid">Habits to Avoid</a></h1> |
| 579 | <p>Many programmers who are familiar with TeX often write quotation marks |
574 | <p>Many programmers who are familiar with TeX often write quotation marks |
| 580 | like this:</p> |
575 | like this:</p> |
| 581 | <pre class="literal-block"> |
576 | <pre class="literal-block"> |
| 582 | `single-quoted' or ``double-quoted'' |
577 | `single-quoted' or ``double-quoted'' |
| 583 | </pre> |
578 | </pre> |
| … | |
… | |
| 587 | above), use double-backquotes:</p> |
582 | above), use double-backquotes:</p> |
| 588 | <pre class="literal-block"> |
583 | <pre class="literal-block"> |
| 589 | ``literal text: in here, anything goes!`` |
584 | ``literal text: in here, anything goes!`` |
| 590 | </pre> |
585 | </pre> |
| 591 | </div> |
586 | </div> |
| 592 | <div class="section" id="resources"> |
587 | <div class="section"> |
| 593 | <h1><a class="toc-backref" href="#id44" name="resources">Resources</a></h1> |
588 | <h1><a class="toc-backref" href="#id44" id="resources" name="resources">Resources</a></h1> |
| 594 | <p>Many other constructs and variations are possible. For more details |
589 | <p>Many other constructs and variations are possible. For more details |
| 595 | about the reStructuredText markup, in increasing order of |
590 | about the reStructuredText markup, in increasing order of |
| 596 | thoroughness, please see:</p> |
591 | thoroughness, please see:</p> |
| 597 | <ul class="simple"> |
592 | <ul class="simple"> |
| 598 | <li><a class="reference" href="http://docutils.sourceforge.net/docs/rst/quickstart.html">A ReStructuredText Primer</a> <a class="footnote-reference" href="#id17" id="id18" name="id18">[8]</a>, a gentle introduction.</li> |
593 | <li><a class="reference" href="http://docutils.sourceforge.net/docs/rst/quickstart.html">A ReStructuredText Primer</a> <a class="footnote-reference" href="#id17" id="id18" name="id18">[8]</a>, a gentle introduction.</li> |
| … | |
… | |
| 602 | <p>The processing of reStructuredText GLEPs is done using <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> <a class="footnote-reference" href="#id8" id="id9" name="id9">[4]</a>. If |
597 | <p>The processing of reStructuredText GLEPs is done using <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> <a class="footnote-reference" href="#id8" id="id9" name="id9">[4]</a>. If |
| 603 | you have a question or require assistance with reStructuredText or |
598 | you have a question or require assistance with reStructuredText or |
| 604 | Docutils, please <a class="reference" href="mailto:docutils-users@lists.sourceforge.net?subject=GLEPs">post a message</a> <a class="footnote-reference" href="#id10" id="id11" name="id11">[5]</a> to the <a class="reference" href="http://lists.sourceforge.net/lists/listinfo/docutils-users">Docutils-Users mailing |
599 | Docutils, please <a class="reference" href="mailto:docutils-users@lists.sourceforge.net?subject=GLEPs">post a message</a> <a class="footnote-reference" href="#id10" id="id11" name="id11">[5]</a> to the <a class="reference" href="http://lists.sourceforge.net/lists/listinfo/docutils-users">Docutils-Users mailing |
| 605 | list</a> <a class="footnote-reference" href="#id12" id="id13" name="id13">[6]</a>. The <a class="reference" href="http://docutils.sourceforge.net/">Docutils project web site</a> <a class="footnote-reference" href="#id8" id="id14" name="id14">[4]</a> has more information.</p> |
600 | list</a> <a class="footnote-reference" href="#id12" id="id13" name="id13">[6]</a>. The <a class="reference" href="http://docutils.sourceforge.net/">Docutils project web site</a> <a class="footnote-reference" href="#id8" id="id14" name="id14">[4]</a> has more information.</p> |
| 606 | </div> |
601 | </div> |
| 607 | <div class="section" id="references"> |
602 | <div class="section"> |
| 608 | <h1><a class="toc-backref" href="#id45" name="references">References</a></h1> |
603 | <h1><a class="toc-backref" href="#id45" id="references" name="references">References</a></h1> |
| 609 | <table class="footnote" frame="void" id="python" rules="none"> |
604 | <table class="docutils footnote" frame="void" id="python" rules="none"> |
| 610 | <colgroup><col class="label" /><col /></colgroup> |
605 | <colgroup><col class="label" /><col /></colgroup> |
| 611 | <tbody valign="top"> |
606 | <tbody valign="top"> |
| 612 | <tr><td class="label"><a class="fn-backref" href="#id1" name="python">[1]</a></td><td><a class="reference" href="http://www.python.org">http://www.python.org</a></td></tr> |
607 | <tr><td class="label"><a class="fn-backref" href="#id1" name="python">[1]</a></td><td><a class="reference" href="http://www.python.org">http://www.python.org</a></td></tr> |
| 613 | </tbody> |
608 | </tbody> |
| 614 | </table> |
609 | </table> |
| 615 | <table class="footnote" frame="void" id="pep12" rules="none"> |
610 | <table class="docutils footnote" frame="void" id="pep12" rules="none"> |
| 616 | <colgroup><col class="label" /><col /></colgroup> |
611 | <colgroup><col class="label" /><col /></colgroup> |
| 617 | <tbody valign="top"> |
612 | <tbody valign="top"> |
| 618 | <tr><td class="label"><a class="fn-backref" href="#id2" name="pep12">[2]</a></td><td><a class="reference" href="http://www.python.org/peps/pep-0012.html">http://www.python.org/peps/pep-0012.html</a></td></tr> |
613 | <tr><td class="label"><a class="fn-backref" href="#id2" name="pep12">[2]</a></td><td><a class="reference" href="http://www.python.org/peps/pep-0012.html">http://www.python.org/peps/pep-0012.html</a></td></tr> |
| 619 | </tbody> |
614 | </tbody> |
| 620 | </table> |
615 | </table> |
| 621 | <table class="footnote" frame="void" id="glep1" rules="none"> |
616 | <table class="docutils footnote" frame="void" id="glep1" rules="none"> |
| 622 | <colgroup><col class="label" /><col /></colgroup> |
617 | <colgroup><col class="label" /><col /></colgroup> |
| 623 | <tbody valign="top"> |
618 | <tbody valign="top"> |
| 624 | <tr><td class="label"><a class="fn-backref" href="#id3" name="glep1">[3]</a></td><td>GLEP 1, GLEP Purpose and Guidelines, Goodyear, |
619 | <tr><td class="label"><a class="fn-backref" href="#id3" name="glep1">[3]</a></td><td>GLEP 1, GLEP Purpose and Guidelines, Goodyear, |
| 625 | (<a class="reference" href="http://glep.gentoo.org/glep-0001.html">http://glep.gentoo.org/glep-0001.html</a>)</td></tr> |
620 | (<a class="reference" href="http://glep.gentoo.org/glep-0001.html">http://glep.gentoo.org/glep-0001.html</a>)</td></tr> |
| 626 | </tbody> |
621 | </tbody> |
| 627 | </table> |
622 | </table> |
| 628 | <table class="footnote" frame="void" id="id8" rules="none"> |
623 | <table class="docutils footnote" frame="void" id="id8" rules="none"> |
| 629 | <colgroup><col class="label" /><col /></colgroup> |
624 | <colgroup><col class="label" /><col /></colgroup> |
| 630 | <tbody valign="top"> |
625 | <tbody valign="top"> |
| 631 | <tr><td class="label"><a name="id8">[4]</a></td><td><em>(<a class="fn-backref" href="#id9">1</a>, <a class="fn-backref" href="#id14">2</a>)</em> <a class="reference" href="http://docutils.sourceforge.net/">http://docutils.sourceforge.net/</a></td></tr> |
626 | <tr><td class="label"><a name="id8">[4]</a></td><td><em>(<a class="fn-backref" href="#id9">1</a>, <a class="fn-backref" href="#id14">2</a>)</em> <a class="reference" href="http://docutils.sourceforge.net/">http://docutils.sourceforge.net/</a></td></tr> |
| 632 | </tbody> |
627 | </tbody> |
| 633 | </table> |
628 | </table> |
| 634 | <table class="footnote" frame="void" id="id10" rules="none"> |
629 | <table class="docutils footnote" frame="void" id="id10" rules="none"> |
| 635 | <colgroup><col class="label" /><col /></colgroup> |
630 | <colgroup><col class="label" /><col /></colgroup> |
| 636 | <tbody valign="top"> |
631 | <tbody valign="top"> |
| 637 | <tr><td class="label"><a class="fn-backref" href="#id11" name="id10">[5]</a></td><td><a class="reference" href="mailto:docutils-users@lists.sourceforge.net?subject=GLEPs">mailto:docutils-users@lists.sourceforge.net?subject=GLEPs</a></td></tr> |
632 | <tr><td class="label"><a class="fn-backref" href="#id11" name="id10">[5]</a></td><td><a class="reference" href="mailto:docutils-users@lists.sourceforge.net?subject=GLEPs">mailto:docutils-users@lists.sourceforge.net?subject=GLEPs</a></td></tr> |
| 638 | </tbody> |
633 | </tbody> |
| 639 | </table> |
634 | </table> |
| 640 | <table class="footnote" frame="void" id="id12" rules="none"> |
635 | <table class="docutils footnote" frame="void" id="id12" rules="none"> |
| 641 | <colgroup><col class="label" /><col /></colgroup> |
636 | <colgroup><col class="label" /><col /></colgroup> |
| 642 | <tbody valign="top"> |
637 | <tbody valign="top"> |
| 643 | <tr><td class="label"><a class="fn-backref" href="#id13" name="id12">[6]</a></td><td><a class="reference" href="http://lists.sourceforge.net/lists/listinfo/docutils-users">http://lists.sourceforge.net/lists/listinfo/docutils-users</a></td></tr> |
638 | <tr><td class="label"><a class="fn-backref" href="#id13" name="id12">[6]</a></td><td><a class="reference" href="http://lists.sourceforge.net/lists/listinfo/docutils-users">http://lists.sourceforge.net/lists/listinfo/docutils-users</a></td></tr> |
| 644 | </tbody> |
639 | </tbody> |
| 645 | </table> |
640 | </table> |
| 646 | <table class="footnote" frame="void" id="id15" rules="none"> |
641 | <table class="docutils footnote" frame="void" id="id15" rules="none"> |
| 647 | <colgroup><col class="label" /><col /></colgroup> |
642 | <colgroup><col class="label" /><col /></colgroup> |
| 648 | <tbody valign="top"> |
643 | <tbody valign="top"> |
| 649 | <tr><td class="label"><a class="fn-backref" href="#id16" name="id15">[7]</a></td><td><a class="reference" href="http://www.opencontent.org/openpub/">http://www.opencontent.org/openpub/</a></td></tr> |
644 | <tr><td class="label"><a class="fn-backref" href="#id16" name="id15">[7]</a></td><td><a class="reference" href="http://www.opencontent.org/openpub/">http://www.opencontent.org/openpub/</a></td></tr> |
| 650 | </tbody> |
645 | </tbody> |
| 651 | </table> |
646 | </table> |
| 652 | <table class="footnote" frame="void" id="id17" rules="none"> |
647 | <table class="docutils footnote" frame="void" id="id17" rules="none"> |
| 653 | <colgroup><col class="label" /><col /></colgroup> |
648 | <colgroup><col class="label" /><col /></colgroup> |
| 654 | <tbody valign="top"> |
649 | <tbody valign="top"> |
| 655 | <tr><td class="label"><a class="fn-backref" href="#id18" name="id17">[8]</a></td><td><a class="reference" href="http://docutils.sourceforge.net/docs/rst/quickstart.html">http://docutils.sourceforge.net/docs/rst/quickstart.html</a></td></tr> |
650 | <tr><td class="label"><a class="fn-backref" href="#id18" name="id17">[8]</a></td><td><a class="reference" href="http://docutils.sourceforge.net/docs/rst/quickstart.html">http://docutils.sourceforge.net/docs/rst/quickstart.html</a></td></tr> |
| 656 | </tbody> |
651 | </tbody> |
| 657 | </table> |
652 | </table> |
| 658 | <table class="footnote" frame="void" id="id19" rules="none"> |
653 | <table class="docutils footnote" frame="void" id="id19" rules="none"> |
| 659 | <colgroup><col class="label" /><col /></colgroup> |
654 | <colgroup><col class="label" /><col /></colgroup> |
| 660 | <tbody valign="top"> |
655 | <tbody valign="top"> |
| 661 | <tr><td class="label"><a class="fn-backref" href="#id20" name="id19">[9]</a></td><td><a class="reference" href="http://docutils.sourceforge.net/docs/rst/quickref.html">http://docutils.sourceforge.net/docs/rst/quickref.html</a></td></tr> |
656 | <tr><td class="label"><a class="fn-backref" href="#id20" name="id19">[9]</a></td><td><a class="reference" href="http://docutils.sourceforge.net/docs/rst/quickref.html">http://docutils.sourceforge.net/docs/rst/quickref.html</a></td></tr> |
| 662 | </tbody> |
657 | </tbody> |
| 663 | </table> |
658 | </table> |
| 664 | <table class="footnote" frame="void" id="id21" rules="none"> |
659 | <table class="docutils footnote" frame="void" id="id21" rules="none"> |
| 665 | <colgroup><col class="label" /><col /></colgroup> |
660 | <colgroup><col class="label" /><col /></colgroup> |
| 666 | <tbody valign="top"> |
661 | <tbody valign="top"> |
| 667 | <tr><td class="label"><a class="fn-backref" href="#id22" name="id21">[10]</a></td><td><a class="reference" href="http://docutils.sourceforge.net/spec/rst/reStructuredText.html">http://docutils.sourceforge.net/spec/rst/reStructuredText.html</a></td></tr> |
662 | <tr><td class="label"><a class="fn-backref" href="#id22" name="id21">[10]</a></td><td><a class="reference" href="http://docutils.sourceforge.net/spec/rst/reStructuredText.html">http://docutils.sourceforge.net/spec/rst/reStructuredText.html</a></td></tr> |
| 668 | </tbody> |
663 | </tbody> |
| 669 | </table> |
664 | </table> |
| 670 | </div> |
665 | </div> |
| 671 | <div class="section" id="copyright"> |
666 | <div class="section"> |
| 672 | <h1><a class="toc-backref" href="#id46" name="copyright">Copyright</a></h1> |
667 | <h1><a class="toc-backref" href="#id46" id="copyright" name="copyright">Copyright</a></h1> |
| 673 | <p>This document has been placed in the public domain.</p> |
668 | <p>This document has been placed in the public domain.</p> |
| 674 | </div> |
669 | </div> |
| 675 | </div> |
|
|
| 676 | |
670 | |
| 677 | <hr class="footer"/> |
671 | </div> |
| 678 | <div class="footer"> |
672 | <div class="footer"> |
|
|
673 | <hr class="footer" /> |
| 679 | <a class="reference" href="glep-0002.txt">View document source</a>. |
674 | <a class="reference" href="glep-0002.txt">View document source</a>. |
| 680 | Generated on: 2003-07-29 00:12 UTC. |
675 | Generated on: 2007-10-13 13:39 UTC. |
| 681 | Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. |
676 | Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. |
|
|
677 | |
| 682 | </div> |
678 | </div> |
| 683 | </body> |
679 | </body> |
| 684 | </html> |
680 | </html> |
| 685 | |
681 | |
Parent Directory
| 
Revision Log
| 
Patch