/[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.1 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">
31<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">43</td> 274<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">43</td>
32</tr> 275</tr>
33<tr class="field"><th class="field-name">Title:</th><td class="field-body">GLEP File Hosting</td> 276<tr class="field"><th class="field-name">Title:</th><td class="field-body">GLEP File Hosting</td>
34</tr> 277</tr>
35<tr class="field"><th class="field-name">Version:</th><td class="field-body">$Revision: 1.1 $</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">$Date: 2005/11/07 21:55:08 $</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>
301<li><a class="reference" href="#status" id="id3" name="id3">Status</a></li>
58<li><a class="reference" href="#motivation" id="id3" name="id3">Motivation</a></li> 302<li><a class="reference" href="#motivation" id="id4" name="id4">Motivation</a></li>
59<li><a class="reference" href="#specification" id="id4" name="id4">Specification</a><ul> 303<li><a class="reference" href="#specification" id="id5" name="id5">Specification</a><ul>
60<li><a class="reference" href="#example" id="id5" name="id5">Example</a></li> 304<li><a class="reference" href="#example" id="id6" name="id6">Example</a></li>
61</ul> 305</ul>
62</li> 306</li>
63<li><a class="reference" href="#backwards-compatibility" id="id6" name="id6">Backwards Compatibility</a></li> 307<li><a class="reference" href="#backwards-compatibility" id="id7" name="id7">Backwards Compatibility</a></li>
64<li><a class="reference" href="#references" id="id7" name="id7">References</a></li> 308<li><a class="reference" href="#references" id="id8" name="id8">References</a></li>
65<li><a class="reference" href="#copyright" id="id8" name="id8">Copyright</a></li> 309<li><a class="reference" href="#copyright" id="id9" name="id9">Copyright</a></li>
66</ul> 310</ul>
67</div> 311</div>
68<div class="section" id="abstract"> 312<div class="section">
69<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>
70<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.
71sample code) associated with GLEPs.</p> 315sample code) associated with GLEPs.</p>
72</div> 316</div>
73<div class="section" id="motivation"> 317<div class="section">
318<h1><a class="toc-backref" href="#id3" id="status" name="status">Status</a></h1>
319<p>This GLEP has been approved by the GLEP editor and marked Final on
32013 Nov. 2005.</p>
321</div>
322<div class="section">
74<h1><a class="toc-backref" href="#id3" name="motivation">Motivation</a></h1> 323<h1><a class="toc-backref" href="#id4" id="motivation" name="motivation">Motivation</a></h1>
75<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
76specification. There are two methods which have been used to handle this 325specification. There are two methods which have been used to handle this
77previously:</p> 326previously:</p>
78<ul class="simple"> 327<ul class="simple">
79<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
89<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>
90(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
91implementation of the proposal.</p> 340implementation of the proposal.</p>
92</div> 341</div>
93</div> 342</div>
94<div class="section" id="specification"> 343<div class="section">
95<h1><a class="toc-backref" href="#id4" name="specification">Specification</a></h1> 344<h1><a class="toc-backref" href="#id5" id="specification" name="specification">Specification</a></h1>
96<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
97create 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
98GLEP'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
99files which are part of the proposal.</p> 348files which are part of the proposal.</p>
100<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
101prevents breakages in the case of directory structure changes.</p> 350prevents breakages in the case of directory structure changes.</p>
102<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
103list of links to the associated files.</p> 352list of links to the associated files.</p>
104<div class="section" id="example"> 353<div class="section">
105<h2><a class="toc-backref" href="#id5" name="example">Example</a></h2> 354<h2><a class="toc-backref" href="#id6" id="example" name="example">Example</a></h2>
106<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
107GLEP 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>
108<pre class="literal-block"> 357<pre class="literal-block">
109Example News Item 358Example News Item
110''''''''''''''''' 359'''''''''''''''''
142`news-mailer.bash &lt;glep-0042-extras/news-mailer.bash&gt;`_ 391`news-mailer.bash &lt;glep-0042-extras/news-mailer.bash&gt;`_
143 A ``bash`` script which delivers news items via email. 392 A ``bash`` script which delivers news items via email.
144</pre> 393</pre>
145</div> 394</div>
146</div> 395</div>
147<div class="section" id="backwards-compatibility"> 396<div class="section">
148<h1><a class="toc-backref" href="#id6" 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>
149<p>Not an issue.</p> 398<p>Not an issue.</p>
150</div> 399</div>
151<div class="section" id="references"> 400<div class="section">
152<h1><a class="toc-backref" href="#id7" name="references">References</a></h1> 401<h1><a class="toc-backref" href="#id8" id="references" name="references">References</a></h1>
153<table class="docutils footnote" frame="void" id="glep-42" rules="none"> 402<table class="docutils footnote" frame="void" id="glep-42" rules="none">
154<colgroup><col class="label" /><col /></colgroup> 403<colgroup><col class="label" /><col /></colgroup>
155<tbody valign="top"> 404<tbody valign="top">
156<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,
157<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>
158</tbody> 407</tbody>
159</table> 408</table>
160</div> 409</div>
161<div class="section" id="copyright"> 410<div class="section">
162<h1><a class="toc-backref" href="#id8" name="copyright">Copyright</a></h1> 411<h1><a class="toc-backref" href="#id9" id="copyright" name="copyright">Copyright</a></h1>
163<p>This document has been placed in the public domain.</p> 412<p>This document has been placed in the public domain.</p>
164<!-- vim: set tw=80 fileencoding=utf-8 spell spelllang=en et : --> 413<!-- vim: set tw=80 fileencoding=utf-8 spell spelllang=en et : -->
165</div> 414</div>
166 415
167</div> 416</div>
168<div class="footer"> 417<div class="footer">
169<hr class="footer" /> 418<hr class="footer" />
170<a class="reference" href="glep-0043.txt">View document source</a>. 419<a class="reference" href="glep-0043.txt">View document source</a>.
171Generated on: 2005-11-07 21:53 UTC. 420Generated on: 2006-10-10 20:23 UTC.
172Generated 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.
173 422
174</div> 423</div>
175</body> 424</body>
176</html> 425</html>

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

  ViewVC Help
Powered by ViewVC 1.1.20