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

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

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

Revision 1.3 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.3: http://docutils.sourceforge.net/" /> 11 <meta name="generator" content="Docutils 0.3.9: http://docutils.sourceforge.net/" />
12 <title>GLEP 31 -- Character Sets for Portage Tree Items</title> 12 <title>GLEP 31 -- Character Sets for Portage Tree Items</title>
13 <link rel="stylesheet" href="tools/glep.css" type="text/css" /> 13 <link rel="stylesheet" href="tools/glep.css" type="text/css" />
14</head> 14</head>
15<body bgcolor="white"> 15<body bgcolor="white">
16<table class="navigation" cellpadding="0" cellspacing="0" 16<table class="navigation" cellpadding="0" cellspacing="0"
… …
22<td class="textlinks" align="left"> 22<td class="textlinks" align="left">
23[<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>] 23[<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>] 24[<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>]
25[<b><a href="./glep-0031.txt">GLEP Source</a></b>] 25[<b><a href="./glep-0031.txt">GLEP Source</a></b>]
26</td></tr></table> 26</td></tr></table>
27<div class="document">
28<table class="rfc2822 field-list" frame="void" rules="none"> 27<table class="rfc2822 docutils field-list" frame="void" rules="none">
29<col class="field-name" /> 28<col class="field-name" />
30<col class="field-body" /> 29<col class="field-body" />
31<tbody valign="top"> 30<tbody valign="top">
32<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">31</td> 31<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">31</td>
33</tr> 32</tr>
34<tr class="field"><th class="field-name">Title:</th><td class="field-body">Character Sets for Portage Tree Items</td> 33<tr class="field"><th class="field-name">Title:</th><td class="field-body">Character Sets for Portage Tree Items</td>
35</tr> 34</tr>
36<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.3</td> 35<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.4</td>
37</tr> 36</tr>
38<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> 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>
39</tr> 38</tr>
40<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-0031.txt?cvsroot=gentoo">2004/11/11 21:38:05</a></td> 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-0031.txt?cvsroot=gentoo">2005/10/30 21:35:50</a></td>
41</tr> 40</tr>
42<tr class="field"><th class="field-name">Status:</th><td class="field-body">Approved</td> 41<tr class="field"><th class="field-name">Status:</th><td class="field-body">Approved</td>
43</tr> 42</tr>
44<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td> 43<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
45</tr> 44</tr>
46<tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0012.html">text/x-rst</a></td> 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>
47</tr> 46</tr>
48<tr class="field"><th class="field-name">Created:</th><td class="field-body">27-October-2004</td> 47<tr class="field"><th class="field-name">Created:</th><td class="field-body">27-Oct-2004</td>
49</tr> 48</tr>
50<tr class="field"><th class="field-name">Post-Date:</th><td class="field-body">28-October-2004, 1-November-2004, 11-November-2004</td> 49<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">28-Oct-2004, 1-Nov-2004, 11-Nov-2004</td>
51</tr> 50</tr>
52</tbody> 51</tbody>
53</table> 52</table>
54<hr /> 53<hr />
55<div class="contents topic" id="contents"> 54<div class="contents topic" id="contents">
… …
129</div> 128</div>
130<div class="section" id="backwards-compatibility"> 129<div class="section" id="backwards-compatibility">
131<h1><a class="toc-backref" href="#id17" name="backwards-compatibility">Backwards Compatibility</a></h1> 130<h1><a class="toc-backref" href="#id17" name="backwards-compatibility">Backwards Compatibility</a></h1>
132<p>The existing tree uses a mixture of encodings. It would be straightforward 131<p>The existing tree uses a mixture of encodings. It would be straightforward
133to fix existing ChangeLogs and metadata files to use UTF-8.</p> 132to fix existing ChangeLogs and metadata files to use UTF-8.</p>
134<p>The <tt class="literal"><span class="pre">echangelog</span></tt> tool is character-set agnostic. In order to properly 133<p>The <tt class="docutils literal"><span class="pre">echangelog</span></tt> tool is character-set agnostic. In order to properly
135enter UTF-8, developers would have to switch to a UTF-8 shell session. 134enter UTF-8, developers would have to switch to a UTF-8 shell session.
136This only applies if the developer is entering new text which uses 'fancy' 135This only applies if the developer is entering new text which uses 'fancy'
137characters -- existing characters are not mangled.</p> 136characters -- existing characters are not mangled.</p>
138<p>Certain text editors are incapable of handling UTF-8 cleanly. However, 137<p>Certain text editors are incapable of handling UTF-8 cleanly. However,
139since the <tt class="literal"><span class="pre">echangelog</span></tt> tool is generally the correct way to generate 138since the <tt class="docutils literal"><span class="pre">echangelog</span></tt> tool is generally the correct way to generate
140ChangeLog entries, this should not be a major problem. Generating 139ChangeLog entries, this should not be a major problem. Generating
141metadata.xml files correctly in these editors could become problematic. 140metadata.xml files correctly in these editors could become problematic.
142The <tt class="literal"><span class="pre">vim</span></tt> and <tt class="literal"><span class="pre">emacs</span></tt> editors, which appear to be most widely used, 141The <tt class="docutils literal"><span class="pre">vim</span></tt> and <tt class="docutils literal"><span class="pre">emacs</span></tt> editors, which appear to be most widely used,
143are both capable of handling UTF-8 cleanly -- for vim, this could be 142are both capable of handling UTF-8 cleanly -- for vim, this could be
144configured automatically via the <tt class="literal"><span class="pre">gentoo-syntax</span></tt> (<a class="footnote-reference" href="#id8" id="id4" name="id4">[4]</a>) package.</p> 143configured automatically via the <tt class="docutils literal"><span class="pre">gentoo-syntax</span></tt> (<a class="footnote-reference" href="#id8" id="id4" name="id4">[4]</a>) package.</p>
145</div> 144</div>
146<div class="section" id="references"> 145<div class="section" id="references">
147<h1><a class="toc-backref" href="#id18" name="references">References</a></h1> 146<h1><a class="toc-backref" href="#id18" name="references">References</a></h1>
148<table class="footnote" frame="void" id="id5" rules="none"> 147<table class="docutils footnote" frame="void" id="id5" rules="none">
149<colgroup><col class="label" /><col /></colgroup> 148<colgroup><col class="label" /><col /></colgroup>
150<tbody valign="top"> 149<tbody valign="top">
151<tr><td class="label"><a class="fn-backref" href="#id1" name="id5">[1]</a></td><td><a class="reference" href="http://www.faqs.org/rfcs/rfc3629.html">RFC 3629</a>: UTF-8, a transformation format of ISO 10646 150<tr><td class="label"><a class="fn-backref" href="#id1" name="id5">[1]</a></td><td><a class="reference" href="http://www.faqs.org/rfcs/rfc3629.html">RFC 3629</a>: UTF-8, a transformation format of ISO 10646
152<a class="reference" href="http://www.ietf.org/rfc/rfc3629.txt">http://www.ietf.org/rfc/rfc3629.txt</a></td></tr> 151<a class="reference" href="http://www.ietf.org/rfc/rfc3629.txt">http://www.ietf.org/rfc/rfc3629.txt</a></td></tr>
153</tbody> 152</tbody>
154</table> 153</table>
155<table class="footnote" frame="void" id="id6" rules="none"> 154<table class="docutils footnote" frame="void" id="id6" rules="none">
156<colgroup><col class="label" /><col /></colgroup> 155<colgroup><col class="label" /><col /></colgroup>
157<tbody valign="top"> 156<tbody valign="top">
158<tr><td class="label"><a class="fn-backref" href="#id2" name="id6">[2]</a></td><td>ISO/IEC 10646 (Universal Multiple-Octet Coded Character Set)</td></tr> 157<tr><td class="label"><a class="fn-backref" href="#id2" name="id6">[2]</a></td><td>ISO/IEC 10646 (Universal Multiple-Octet Coded Character Set)</td></tr>
159</tbody> 158</tbody>
160</table> 159</table>
161<table class="footnote" frame="void" id="id7" rules="none"> 160<table class="docutils footnote" frame="void" id="id7" rules="none">
162<colgroup><col class="label" /><col /></colgroup> 161<colgroup><col class="label" /><col /></colgroup>
163<tbody valign="top"> 162<tbody valign="top">
164<tr><td class="label"><a class="fn-backref" href="#id3" name="id7">[3]</a></td><td>ISO/IEC 8859 (8-bit single-byte coded graphic character sets)</td></tr> 163<tr><td class="label"><a class="fn-backref" href="#id3" name="id7">[3]</a></td><td>ISO/IEC 8859 (8-bit single-byte coded graphic character sets)</td></tr>
165</tbody> 164</tbody>
166</table> 165</table>
167<table class="footnote" frame="void" id="id8" rules="none"> 166<table class="docutils footnote" frame="void" id="id8" rules="none">
168<colgroup><col class="label" /><col /></colgroup> 167<colgroup><col class="label" /><col /></colgroup>
169<tbody valign="top"> 168<tbody valign="top">
170<tr><td class="label"><a class="fn-backref" href="#id4" name="id8">[4]</a></td><td>The app-vim/gentoo-syntax package, 169<tr><td class="label"><a class="fn-backref" href="#id4" name="id8">[4]</a></td><td>The app-vim/gentoo-syntax package,
171<a class="reference" href="https://developer.berlios.de/projects/gentoo-syntax/">https://developer.berlios.de/projects/gentoo-syntax/</a></td></tr> 170<a class="reference" href="https://developer.berlios.de/projects/gentoo-syntax/">https://developer.berlios.de/projects/gentoo-syntax/</a></td></tr>
172</tbody> 171</tbody>
173</table> 172</table>
174</div> 173</div>
175<div class="section" id="copyright"> 174<div class="section" id="copyright">
176<h1><a class="toc-backref" href="#id19" name="copyright">Copyright</a></h1> 175<h1><a class="toc-backref" href="#id19" name="copyright">Copyright</a></h1>
177<p>This document has been placed in the public domain.</p> 176<p>This document has been placed in the public domain.</p>
178<blockquote>
179vim: set tw=74 fileencoding=utf-8 :</blockquote> 177<!-- vim: set tw=74 fileencoding=utf-8 : -->
180</div>
181</div> 178</div>
182 179
180</div>
181<div class="footer">
183<hr class="footer" /> 182<hr class="footer" />
184<div class="footer">
185<a class="reference" href="glep-0031.txt">View document source</a>. 183<a class="reference" href="glep-0031.txt">View document source</a>.
186Generated on: 2004-11-11 21:31 UTC. 184Generated on: 2005-11-07 22:15 UTC.
187Generated 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. 185Generated 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.
186
188</div> 187</div>
189</body> 188</body>
190</html> 189</html>
191 190
Legend:
Removed from v.1.3  
changed lines
  Added in v.1.4
  ViewVC Help
Powered by ViewVC 1.1.13