/[gentoo]/xml/htdocs/proj/en/glep/glep-0043.html
Gentoo

Diff of /xml/htdocs/proj/en/glep/glep-0043.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.2 Revision 1.4
6PEP, see http://www.python.org/peps/pep-0001.html for instructions and links 6PEP, see http://www.python.org/peps/pep-0001.html for instructions and links
7to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE! 7to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE!
8--> 8-->
9<head> 9<head>
10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11 <meta name="generator" content="Docutils 0.3.9: http://docutils.sourceforge.net/" /> 11 <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
12 <title>GLEP 43 -- GLEP File Hosting</title> 12 <title>GLEP 43 -- GLEP File Hosting</title>
13 <link rel="stylesheet" href="tools/glep.css" type="text/css" /> 13 <style type="text/css">
14
15/*
16:Author: David Goodger
17:Contact: goodger@users.sourceforge.net
18:date: $Date: 2007/01/25 03:26:26 $
19:version: $Revision: 1.4 $
20:copyright: This stylesheet has been placed in the public domain.
21
22Default cascading style sheet for the PEP HTML output of Docutils.
23*/
24
25.first {
26 margin-top: 0 }
27
28.last {
29 margin-bottom: 0 }
30
31.navigation {
32 width: 100% ;
33 background: #cc99ff ;
34 margin-top: 0px ;
35 margin-bottom: 0px }
36
37.navigation .navicon {
38 width: 150px ;
39 height: 35px }
40
41.navigation .textlinks {
42 padding-left: 1em ;
43 text-align: left }
44
45.navigation td, .navigation th {
46 padding-left: 0em ;
47 padding-right: 0em ;
48 vertical-align: middle }
49
50.rfc2822 {
51 margin-top: 0.5em ;
52 margin-left: 0.5em ;
53 margin-right: 0.5em ;
54 margin-bottom: 0em }
55
56.rfc2822 td {
57 text-align: left }
58
59.rfc2822 th.field-name {
60 text-align: right ;
61 font-family: sans-serif ;
62 padding-right: 0.5em ;
63 font-weight: bold ;
64 margin-bottom: 0em }
65
66a.toc-backref {
67 text-decoration: none ;
68 color: black }
69
70body {
71 margin: 0px ;
72 margin-bottom: 1em ;
73 padding: 0px }
74
75dd {
76 margin-bottom: 0.5em }
77
78div.section {
79 margin-left: 1em ;
80 margin-right: 1em ;
81 margin-bottom: 1.5em }
82
83div.section div.section {
84 margin-left: 0em ;
85 margin-right: 0em ;
86 margin-top: 1.5em }
87
88div.abstract {
89 margin: 2em 5em }
90
91div.abstract p.topic-title {
92 font-weight: bold ;
93 text-align: center }
94
95div.attention, div.caution, div.danger, div.error, div.hint,
96div.important, div.note, div.tip, div.warning {
97 margin: 2em ;
98 border: medium outset ;
99 padding: 1em }
100
101div.attention p.admonition-title, div.caution p.admonition-title,
102div.danger p.admonition-title, div.error p.admonition-title,
103div.warning p.admonition-title {
104 color: red ;
105 font-weight: bold ;
106 font-family: sans-serif }
107
108div.hint p.admonition-title, div.important p.admonition-title,
109div.note p.admonition-title, div.tip p.admonition-title {
110 font-weight: bold ;
111 font-family: sans-serif }
112
113div.figure {
114 margin-left: 2em }
115
116div.footer, div.header {
117 font-size: smaller }
118
119div.footer {
120 margin-left: 1em ;
121 margin-right: 1em }
122
123div.system-messages {
124 margin: 5em }
125
126div.system-messages h1 {
127 color: red }
128
129div.system-message {
130 border: medium outset ;
131 padding: 1em }
132
133div.system-message p.system-message-title {
134 color: red ;
135 font-weight: bold }
136
137div.topic {
138 margin: 2em }
139
140h1 {
141 font-family: sans-serif ;
142 font-size: large }
143
144h2 {
145 font-family: sans-serif ;
146 font-size: medium }
147
148h3 {
149 font-family: sans-serif ;
150 font-size: small }
151
152h4 {
153 font-family: sans-serif ;
154 font-style: italic ;
155 font-size: small }
156
157h5 {
158 font-family: sans-serif;
159 font-size: x-small }
160
161h6 {
162 font-family: sans-serif;
163 font-style: italic ;
164 font-size: x-small }
165
166.section hr {
167 width: 75% }
168
169ol.simple, ul.simple {
170 margin-bottom: 1em }
171
172ol.arabic {
173 list-style: decimal }
174
175ol.loweralpha {
176 list-style: lower-alpha }
177
178ol.upperalpha {
179 list-style: upper-alpha }
180
181ol.lowerroman {
182 list-style: lower-roman }
183
184ol.upperroman {
185 list-style: upper-roman }
186
187p.caption {
188 font-style: italic }
189
190p.credits {
191 font-style: italic ;
192 font-size: smaller }
193
194p.label {
195 white-space: nowrap }
196
197p.topic-title {
198 font-family: sans-serif ;
199 font-weight: bold }
200
201pre.line-block {
202 font-family: serif ;
203 font-size: 100% }
204
205pre.literal-block, pre.doctest-block {
206 margin-left: 2em ;
207 margin-right: 2em ;
208 background-color: #eeeeee }
209
210span.classifier {
211 font-family: sans-serif ;
212 font-style: oblique }
213
214span.classifier-delimiter {
215 font-family: sans-serif ;
216 font-weight: bold }
217
218span.interpreted {
219 font-family: sans-serif }
220
221span.option-argument {
222 font-style: italic }
223
224span.pre {
225 white-space: pre }
226
227span.problematic {
228 color: red }
229
230table {
231 margin-top: 0.5em ;
232 margin-bottom: 0.5em }
233
234td, th {
235 padding-left: 0.5em ;
236 padding-right: 0.5em ;
237 vertical-align: top }
238
239td.num {
240 text-align: right }
241
242th.field-name {
243 font-weight: bold ;
244 text-align: left ;
245 white-space: nowrap }
246
247h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt {
248 font-size: 100% }
249
250tt {
251 background-color: #eeeeee }
252
253ul.auto-toc {
254 list-style-type: none }
255
256</style>
14</head> 257</head>
15<body bgcolor="white"> 258<body bgcolor="white">
16<table class="navigation" cellpadding="0" cellspacing="0" 259<table class="navigation" cellpadding="0" cellspacing="0"
17 width="100%" border="0"> 260 width="100%" border="0">
18<tr><td class="navicon" width="150" height="35"> 261<tr><td class="navicon" width="150" height="35">
19<a href="http://www.gentoo.org/" title="Gentoo Linux Home Page"> 262<a href="http://www.gentoo.org/" title="Gentoo Linux Home Page">
20<img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]" 263<img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]"
21 border="0" width="150" height="35" /></a></td> 264 border="0" width="150" height="35" /></a></td>
22<td class="textlinks" align="left"> 265<td class="textlinks" align="left">
23[<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>] 266[<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>] 267[<b><a href="http://www.gentoo.org/proj/en/glep/">GLEP Index</a></b>]
25[<b><a href="./glep-0043.txt">GLEP Source</a></b>] 268[<b><a href="http://www.gentoo.org/proj/en/glep/glep-0043.txt">GLEP Source</a></b>]
26</td></tr></table> 269</td></tr></table>
27<table class="rfc2822 docutils field-list" frame="void" rules="none"> 270<table class="rfc2822 docutils field-list" frame="void" rules="none">
28<col class="field-name" /> 271<col class="field-name" />
29<col class="field-body" /> 272<col class="field-body" />
30<tbody valign="top"> 273<tbody valign="top">
34</tr> 277</tr>
35<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.2</td> 278<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.2</td>
36</tr> 279</tr>
37<tr class="field"><th class="field-name">Author:</th><td class="field-body">Ciaran McCreesh &lt;ciaranm&#32;&#97;t&#32;gentoo.org&gt;</td> 280<tr class="field"><th class="field-name">Author:</th><td class="field-body">Ciaran McCreesh &lt;ciaranm&#32;&#97;t&#32;gentoo.org&gt;</td>
38</tr> 281</tr>
39<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs/xml/htdocs/proj/en/glep/glep-0043.txt?cvsroot=gentoo">2005/11/13 17:16:16</a></td> 282<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/proj/en/glep/glep-0043.txt?cvsroot=gentoo">2005/11/13 17:16:16</a></td>
40</tr> 283</tr>
41<tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td> 284<tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td>
42</tr> 285</tr>
43<tr class="field"><th class="field-name">Type:</th><td class="field-body">Informational</td> 286<tr class="field"><th class="field-name">Type:</th><td class="field-body">Informational</td>
44</tr> 287</tr>
45<tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="http://www.python.org/peps/glep-0012.html">text/x-rst</a></td> 288<tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0002.html">text/x-rst</a></td>
46</tr> 289</tr>
47<tr class="field"><th class="field-name">Created:</th><td class="field-body">7-Nov-2005</td> 290<tr class="field"><th class="field-name">Created:</th><td class="field-body">7-Nov-2005</td>
48</tr> 291</tr>
49<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">7-Nov-2005</td> 292<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">7-Nov-2005</td>
50</tr> 293</tr>
51</tbody> 294</tbody>
52</table> 295</table>
53<hr /> 296<hr />
54<div class="contents topic" id="contents"> 297<div class="contents topic">
55<p class="topic-title first"><a name="contents">Contents</a></p> 298<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
56<ul class="simple"> 299<ul class="simple">
57<li><a class="reference" href="#abstract" id="id2" name="id2">Abstract</a></li> 300<li><a class="reference" href="#abstract" id="id2" name="id2">Abstract</a></li>
58<li><a class="reference" href="#status" id="id3" name="id3">Status</a></li> 301<li><a class="reference" href="#status" id="id3" name="id3">Status</a></li>
59<li><a class="reference" href="#motivation" id="id4" name="id4">Motivation</a></li> 302<li><a class="reference" href="#motivation" id="id4" name="id4">Motivation</a></li>
60<li><a class="reference" href="#specification" id="id5" name="id5">Specification</a><ul> 303<li><a class="reference" href="#specification" id="id5" name="id5">Specification</a><ul>
64<li><a class="reference" href="#backwards-compatibility" id="id7" name="id7">Backwards Compatibility</a></li> 307<li><a class="reference" href="#backwards-compatibility" id="id7" name="id7">Backwards Compatibility</a></li>
65<li><a class="reference" href="#references" id="id8" name="id8">References</a></li> 308<li><a class="reference" href="#references" id="id8" name="id8">References</a></li>
66<li><a class="reference" href="#copyright" id="id9" name="id9">Copyright</a></li> 309<li><a class="reference" href="#copyright" id="id9" name="id9">Copyright</a></li>
67</ul> 310</ul>
68</div> 311</div>
69<div class="section" id="abstract"> 312<div class="section">
70<h1><a class="toc-backref" href="#id2" name="abstract">Abstract</a></h1> 313<h1><a class="toc-backref" href="#id2" id="abstract" name="abstract">Abstract</a></h1>
71<p>This GLEP proposes the creation of a reliable hosting location for data (e.g. 314<p>This GLEP proposes the creation of a reliable hosting location for data (e.g.
72sample code) associated with GLEPs.</p> 315sample code) associated with GLEPs.</p>
73</div> 316</div>
74<div class="section" id="status"> 317<div class="section">
75<h1><a class="toc-backref" href="#id3" name="status">Status</a></h1> 318<h1><a class="toc-backref" href="#id3" id="status" name="status">Status</a></h1>
76<p>This GLEP has been approved by the GLEP editor and marked Final on 319<p>This GLEP has been approved by the GLEP editor and marked Final on
7713 Nov. 2005.</p> 32013 Nov. 2005.</p>
78</div> 321</div>
79<div class="section" id="motivation"> 322<div class="section">
80<h1><a class="toc-backref" href="#id4" name="motivation">Motivation</a></h1> 323<h1><a class="toc-backref" href="#id4" id="motivation" name="motivation">Motivation</a></h1>
81<p>Some GLEPs come with non-trivial example files or code which are part of the 324<p>Some GLEPs come with non-trivial example files or code which are part of the
82specification. There are two methods which have been used to handle this 325specification. There are two methods which have been used to handle this
83previously:</p> 326previously:</p>
84<ul class="simple"> 327<ul class="simple">
85<li>Include the code inline in the GLEP using a code (<tt class="docutils literal"><span class="pre">::</span></tt>) segment. This is 328<li>Include the code inline in the GLEP using a code (<tt class="docutils literal"><span class="pre">::</span></tt>) segment. This is
95<p class="last">The hosting proposed is for files related to the <strong>proposal</strong> 338<p class="last">The hosting proposed is for files related to the <strong>proposal</strong>
96(e.g. example code which clarifies part of the specification), not a full 339(e.g. example code which clarifies part of the specification), not a full
97implementation of the proposal.</p> 340implementation of the proposal.</p>
98</div> 341</div>
99</div> 342</div>
100<div class="section" id="specification"> 343<div class="section">
101<h1><a class="toc-backref" href="#id5" name="specification">Specification</a></h1> 344<h1><a class="toc-backref" href="#id5" id="specification" name="specification">Specification</a></h1>
102<p>Once a GLEP number has been allocated, developers (or the GLEP editors) may 345<p>Once a GLEP number has been allocated, developers (or the GLEP editors) may
103create a directory in CVS named <tt class="docutils literal"><span class="pre">glep-xxxx-extras/</span></tt> (where <tt class="docutils literal"><span class="pre">xxxx</span></tt> is the 346create a directory in CVS named <tt class="docutils literal"><span class="pre">glep-xxxx-extras/</span></tt> (where <tt class="docutils literal"><span class="pre">xxxx</span></tt> is the
104GLEP's number) under the main GLEP directory. This directory may be used by 347GLEP's number) under the main GLEP directory. This directory may be used by
105files which are part of the proposal.</p> 348files which are part of the proposal.</p>
106<p>Any hyperlinks to files inside this directory should use relative paths. This 349<p>Any hyperlinks to files inside this directory should use relative paths. This
107prevents breakages in the case of directory structure changes.</p> 350prevents breakages in the case of directory structure changes.</p>
108<p>GLEPs which use this directory may include an 'Example Files' heading with a 351<p>GLEPs which use this directory may include an 'Example Files' heading with a
109list of links to the associated files.</p> 352list of links to the associated files.</p>
110<div class="section" id="example"> 353<div class="section">
111<h2><a class="toc-backref" href="#id6" name="example">Example</a></h2> 354<h2><a class="toc-backref" href="#id6" id="example" name="example">Example</a></h2>
112<p>Consider the following GLEP segment, which has been taken from a draft of 355<p>Consider the following GLEP segment, which has been taken from a draft of
113GLEP 42 <a class="footnote-reference" href="#glep-42" id="id1" name="id1">[1]</a>:</p> 356GLEP 42 <a class="footnote-reference" href="#glep-42" id="id1" name="id1">[1]</a>:</p>
114<pre class="literal-block"> 357<pre class="literal-block">
115Example News Item 358Example News Item
116''''''''''''''''' 359'''''''''''''''''
148`news-mailer.bash &lt;glep-0042-extras/news-mailer.bash&gt;`_ 391`news-mailer.bash &lt;glep-0042-extras/news-mailer.bash&gt;`_
149 A ``bash`` script which delivers news items via email. 392 A ``bash`` script which delivers news items via email.
150</pre> 393</pre>
151</div> 394</div>
152</div> 395</div>
153<div class="section" id="backwards-compatibility"> 396<div class="section">
154<h1><a class="toc-backref" href="#id7" name="backwards-compatibility">Backwards Compatibility</a></h1> 397<h1><a class="toc-backref" href="#id7" id="backwards-compatibility" name="backwards-compatibility">Backwards Compatibility</a></h1>
155<p>Not an issue.</p> 398<p>Not an issue.</p>
156</div> 399</div>
157<div class="section" id="references"> 400<div class="section">
158<h1><a class="toc-backref" href="#id8" name="references">References</a></h1> 401<h1><a class="toc-backref" href="#id8" id="references" name="references">References</a></h1>
159<table class="docutils footnote" frame="void" id="glep-42" rules="none"> 402<table class="docutils footnote" frame="void" id="glep-42" rules="none">
160<colgroup><col class="label" /><col /></colgroup> 403<colgroup><col class="label" /><col /></colgroup>
161<tbody valign="top"> 404<tbody valign="top">
162<tr><td class="label"><a class="fn-backref" href="#id1" name="glep-42">[1]</a></td><td>GLEP 42: Critical news reporting, Ciaran McCreesh, 405<tr><td class="label"><a class="fn-backref" href="#id1" name="glep-42">[1]</a></td><td>GLEP 42: Critical news reporting, Ciaran McCreesh,
163<a class="reference" href="http://www.gentoo.org/proj/en/glep/glep-0042.html">http://www.gentoo.org/proj/en/glep/glep-0042.html</a></td></tr> 406<a class="reference" href="http://www.gentoo.org/proj/en/glep/glep-0042.html">http://www.gentoo.org/proj/en/glep/glep-0042.html</a></td></tr>
164</tbody> 407</tbody>
165</table> 408</table>
166</div> 409</div>
167<div class="section" id="copyright"> 410<div class="section">
168<h1><a class="toc-backref" href="#id9" name="copyright">Copyright</a></h1> 411<h1><a class="toc-backref" href="#id9" id="copyright" name="copyright">Copyright</a></h1>
169<p>This document has been placed in the public domain.</p> 412<p>This document has been placed in the public domain.</p>
170<!-- vim: set tw=80 fileencoding=utf-8 spell spelllang=en et : --> 413<!-- vim: set tw=80 fileencoding=utf-8 spell spelllang=en et : -->
171</div> 414</div>
172 415
173</div> 416</div>
174<div class="footer"> 417<div class="footer">
175<hr class="footer" /> 418<hr class="footer" />
176<a class="reference" href="glep-0043.txt">View document source</a>. 419<a class="reference" href="glep-0043.txt">View document source</a>.
177Generated on: 2005-11-13 17:16 UTC. 420Generated on: 2006-10-10 20:23 UTC.
178Generated 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. 421Generated 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.
179 422
180</div> 423</div>
181</body> 424</body>
182</html> 425</html>

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.4

  ViewVC Help
Powered by ViewVC 1.1.20