/[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.5
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
5This HTML is auto-generated. DO NOT EDIT THIS FILE! If you are writing a new
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!
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.9: http://docutils.sourceforge.net/" /> 7 <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
12 <title>GLEP 43 -- GLEP File Hosting</title> 8 <title>GLEP 43 -- GLEP File Hosting</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"
20<img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]" 16<img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]"
21 border="0" width="150" height="35" /></a></td> 17 border="0" width="150" height="35" /></a></td>
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="./glep-0043.txt">GLEP Source</a></b>] 21[<b><a href="http://www.gentoo.org/proj/en/glep/glep-0043.txt">GLEP Source</a></b>]
26</td></tr></table> 22</td></tr></table>
27<table class="rfc2822 docutils field-list" frame="void" rules="none"> 23<table class="rfc2822 docutils field-list" frame="void" rules="none">
28<col class="field-name" /> 24<col class="field-name" />
29<col class="field-body" /> 25<col class="field-body" />
30<tbody valign="top"> 26<tbody valign="top">
31<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">43</td> 27<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">43</td>
32</tr> 28</tr>
33<tr class="field"><th class="field-name">Title:</th><td class="field-body">GLEP File Hosting</td> 29<tr class="field"><th class="field-name">Title:</th><td class="field-body">GLEP File Hosting</td>
34</tr> 30</tr>
35<tr class="field"><th class="field-name">Version:</th><td class="field-body">$Revision: 1.1 $</td> 31<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.2</td>
36</tr> 32</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> 33<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> 34</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> 35<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> 36</tr>
41<tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td> 37<tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td>
42</tr> 38</tr>
43<tr class="field"><th class="field-name">Type:</th><td class="field-body">Informational</td> 39<tr class="field"><th class="field-name">Type:</th><td class="field-body">Informational</td>
44</tr> 40</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> 41<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> 42</tr>
47<tr class="field"><th class="field-name">Created:</th><td class="field-body">7-Nov-2005</td> 43<tr class="field"><th class="field-name">Created:</th><td class="field-body">7-Nov-2005</td>
48</tr> 44</tr>
49<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">7-Nov-2005</td> 45<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">7-Nov-2005</td>
50</tr> 46</tr>
51</tbody> 47</tbody>
52</table> 48</table>
53<hr /> 49<hr />
54<div class="contents topic" id="contents"> 50<div class="contents topic">
55<p class="topic-title first"><a name="contents">Contents</a></p> 51<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
56<ul class="simple"> 52<ul class="simple">
57<li><a class="reference" href="#abstract" id="id2" name="id2">Abstract</a></li> 53<li><a class="reference" href="#abstract" id="id2" name="id2">Abstract</a></li>
54<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> 55<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> 56<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> 57<li><a class="reference" href="#example" id="id6" name="id6">Example</a></li>
61</ul> 58</ul>
62</li> 59</li>
63<li><a class="reference" href="#backwards-compatibility" id="id6" name="id6">Backwards Compatibility</a></li> 60<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> 61<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> 62<li><a class="reference" href="#copyright" id="id9" name="id9">Copyright</a></li>
66</ul> 63</ul>
67</div> 64</div>
68<div class="section" id="abstract"> 65<div class="section">
69<h1><a class="toc-backref" href="#id2" name="abstract">Abstract</a></h1> 66<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. 67<p>This GLEP proposes the creation of a reliable hosting location for data (e.g.
71sample code) associated with GLEPs.</p> 68sample code) associated with GLEPs.</p>
72</div> 69</div>
73<div class="section" id="motivation"> 70<div class="section">
71<h1><a class="toc-backref" href="#id3" id="status" name="status">Status</a></h1>
72<p>This GLEP has been approved by the GLEP editor and marked Final on
7313 Nov. 2005.</p>
74</div>
75<div class="section">
74<h1><a class="toc-backref" href="#id3" name="motivation">Motivation</a></h1> 76<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 77<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 78specification. There are two methods which have been used to handle this
77previously:</p> 79previously:</p>
78<ul class="simple"> 80<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 81<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> 91<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 92(e.g. example code which clarifies part of the specification), not a full
91implementation of the proposal.</p> 93implementation of the proposal.</p>
92</div> 94</div>
93</div> 95</div>
94<div class="section" id="specification"> 96<div class="section">
95<h1><a class="toc-backref" href="#id4" name="specification">Specification</a></h1> 97<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 98<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 99create 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 100GLEP's number) under the main GLEP directory. This directory may be used by
99files which are part of the proposal.</p> 101files which are part of the proposal.</p>
100<p>Any hyperlinks to files inside this directory should use relative paths. This 102<p>Any hyperlinks to files inside this directory should use relative paths. This
101prevents breakages in the case of directory structure changes.</p> 103prevents breakages in the case of directory structure changes.</p>
102<p>GLEPs which use this directory may include an 'Example Files' heading with a 104<p>GLEPs which use this directory may include an 'Example Files' heading with a
103list of links to the associated files.</p> 105list of links to the associated files.</p>
104<div class="section" id="example"> 106<div class="section">
105<h2><a class="toc-backref" href="#id5" name="example">Example</a></h2> 107<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 108<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> 109GLEP 42 <a class="footnote-reference" href="#glep-42" id="id1" name="id1">[1]</a>:</p>
108<pre class="literal-block"> 110<pre class="literal-block">
109Example News Item 111Example News Item
110''''''''''''''''' 112'''''''''''''''''
142`news-mailer.bash &lt;glep-0042-extras/news-mailer.bash&gt;`_ 144`news-mailer.bash &lt;glep-0042-extras/news-mailer.bash&gt;`_
143 A ``bash`` script which delivers news items via email. 145 A ``bash`` script which delivers news items via email.
144</pre> 146</pre>
145</div> 147</div>
146</div> 148</div>
147<div class="section" id="backwards-compatibility"> 149<div class="section">
148<h1><a class="toc-backref" href="#id6" name="backwards-compatibility">Backwards Compatibility</a></h1> 150<h1><a class="toc-backref" href="#id7" id="backwards-compatibility" name="backwards-compatibility">Backwards Compatibility</a></h1>
149<p>Not an issue.</p> 151<p>Not an issue.</p>
150</div> 152</div>
151<div class="section" id="references"> 153<div class="section">
152<h1><a class="toc-backref" href="#id7" name="references">References</a></h1> 154<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"> 155<table class="docutils footnote" frame="void" id="glep-42" rules="none">
154<colgroup><col class="label" /><col /></colgroup> 156<colgroup><col class="label" /><col /></colgroup>
155<tbody valign="top"> 157<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, 158<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> 159<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> 160</tbody>
159</table> 161</table>
160</div> 162</div>
161<div class="section" id="copyright"> 163<div class="section">
162<h1><a class="toc-backref" href="#id8" name="copyright">Copyright</a></h1> 164<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> 165<p>This document has been placed in the public domain.</p>
164<!-- vim: set tw=80 fileencoding=utf-8 spell spelllang=en et : --> 166<!-- vim: set tw=80 fileencoding=utf-8 spell spelllang=en et : -->
165</div> 167</div>
166 168
167</div> 169</div>
168<div class="footer"> 170<div class="footer">
169<hr class="footer" /> 171<hr class="footer" />
170<a class="reference" href="glep-0043.txt">View document source</a>. 172<a class="reference" href="glep-0043.txt">View document source</a>.
171Generated on: 2005-11-07 21:53 UTC. 173Generated on: 2007-10-13 13:39 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. 174Generated 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 175
174</div> 176</div>
175</body> 177</body>
176</html> 178</html>

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

  ViewVC Help
Powered by ViewVC 1.1.20