/[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.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">
… …
34</tr> 30</tr>
35<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.2</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">2005/11/13 17:16:16</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>
58<li><a class="reference" href="#status" id="id3" name="id3">Status</a></li> 54<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> 55<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> 56<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> 60<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> 61<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> 62<li><a class="reference" href="#copyright" id="id9" name="id9">Copyright</a></li>
67</ul> 63</ul>
68</div> 64</div>
69<div class="section" id="abstract"> 65<div class="section">
70<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>
71<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.
72sample code) associated with GLEPs.</p> 68sample code) associated with GLEPs.</p>
73</div> 69</div>
74<div class="section" id="status"> 70<div class="section">
75<h1><a class="toc-backref" href="#id3" name="status">Status</a></h1> 71<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 72<p>This GLEP has been approved by the GLEP editor and marked Final on
7713 Nov. 2005.</p> 7313 Nov. 2005.</p>
78</div> 74</div>
79<div class="section" id="motivation"> 75<div class="section">
80<h1><a class="toc-backref" href="#id4" name="motivation">Motivation</a></h1> 76<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 77<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 78specification. There are two methods which have been used to handle this
83previously:</p> 79previously:</p>
84<ul class="simple"> 80<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 81<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> 91<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 92(e.g. example code which clarifies part of the specification), not a full
97implementation of the proposal.</p> 93implementation of the proposal.</p>
98</div> 94</div>
99</div> 95</div>
100<div class="section" id="specification"> 96<div class="section">
101<h1><a class="toc-backref" href="#id5" name="specification">Specification</a></h1> 97<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 98<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 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
104GLEP'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
105files which are part of the proposal.</p> 101files which are part of the proposal.</p>
106<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
107prevents breakages in the case of directory structure changes.</p> 103prevents breakages in the case of directory structure changes.</p>
108<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
109list of links to the associated files.</p> 105list of links to the associated files.</p>
110<div class="section" id="example"> 106<div class="section">
111<h2><a class="toc-backref" href="#id6" name="example">Example</a></h2> 107<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 108<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> 109GLEP 42 <a class="footnote-reference" href="#glep-42" id="id1" name="id1">[1]</a>:</p>
114<pre class="literal-block"> 110<pre class="literal-block">
115Example News Item 111Example News Item
116''''''''''''''''' 112'''''''''''''''''
… …
148`news-mailer.bash &lt;glep-0042-extras/news-mailer.bash&gt;`_ 144`news-mailer.bash &lt;glep-0042-extras/news-mailer.bash&gt;`_
149 A ``bash`` script which delivers news items via email. 145 A ``bash`` script which delivers news items via email.
150</pre> 146</pre>
151</div> 147</div>
152</div> 148</div>
153<div class="section" id="backwards-compatibility"> 149<div class="section">
154<h1><a class="toc-backref" href="#id7" 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>
155<p>Not an issue.</p> 151<p>Not an issue.</p>
156</div> 152</div>
157<div class="section" id="references"> 153<div class="section">
158<h1><a class="toc-backref" href="#id8" name="references">References</a></h1> 154<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"> 155<table class="docutils footnote" frame="void" id="glep-42" rules="none">
160<colgroup><col class="label" /><col /></colgroup> 156<colgroup><col class="label" /><col /></colgroup>
161<tbody valign="top"> 157<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, 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,
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> 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>
164</tbody> 160</tbody>
165</table> 161</table>
166</div> 162</div>
167<div class="section" id="copyright"> 163<div class="section">
168<h1><a class="toc-backref" href="#id9" name="copyright">Copyright</a></h1> 164<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> 165<p>This document has been placed in the public domain.</p>
170<!-- vim: set tw=80 fileencoding=utf-8 spell spelllang=en et : --> 166<!-- vim: set tw=80 fileencoding=utf-8 spell spelllang=en et : -->
171</div> 167</div>
172 168
173</div> 169</div>
174<div class="footer"> 170<div class="footer">
175<hr class="footer" /> 171<hr class="footer" />
176<a class="reference" href="glep-0043.txt">View document source</a>. 172<a class="reference" href="glep-0043.txt">View document source</a>.
177Generated on: 2005-11-13 17:16 UTC. 173Generated on: 2007-10-13 13:39 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. 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.
179 175
180</div> 176</div>
181</body> 177</body>
182</html> 178</html>
Legend:
Removed from v.1.2  
changed lines
  Added in v.1.5
  ViewVC Help
Powered by ViewVC 1.1.13