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

Diff of /xml/htdocs/proj/en/glep/glep-0032.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.3: http://docutils.sourceforge.net/" /> 7 <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
12 <title>GLEP 32 -- Maildir Location</title> 8 <title>GLEP 32 -- Maildir Location</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-0032.txt">GLEP Source</a></b>] 21[<b><a href="http://www.gentoo.org/proj/en/glep/glep-0032.txt">GLEP Source</a></b>]
26</td></tr></table> 22</td></tr></table>
27<div class="document">
28<table class="rfc2822 field-list" frame="void" rules="none"> 23<table class="rfc2822 docutils field-list" frame="void" rules="none">
29<col class="field-name" /> 24<col class="field-name" />
30<col class="field-body" /> 25<col class="field-body" />
31<tbody valign="top"> 26<tbody valign="top">
32<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">32</td> 27<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">32</td>
33</tr> 28</tr>
34<tr class="field"><th class="field-name">Title:</th><td class="field-body">Maildir Location</td> 29<tr class="field"><th class="field-name">Title:</th><td class="field-body">Maildir Location</td>
35</tr> 30</tr>
36<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.1</td> 31<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.2</td>
37</tr> 32</tr>
38<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-0032.txt?cvsroot=gentoo">2004/11/03 23:38:05</a></td> 33<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-0032.txt?cvsroot=gentoo">2007/04/21 03:13:16</a></td>
39</tr> 34</tr>
40<tr class="field"><th class="field-name">Author:</th><td class="field-body">Georgi Georgiev &lt;chutz&#32;&#97;t&#32;gg3.net&gt;</td> 35<tr class="field"><th class="field-name">Author:</th><td class="field-body">Georgi Georgiev &lt;chutz&#32;&#97;t&#32;gg3.net&gt;</td>
41</tr> 36</tr>
42<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">Deferred</td>
43</tr> 38</tr>
44<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td> 39<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
45</tr> 40</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> 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>
47</tr> 42</tr>
48<tr class="field"><th class="field-name">Created:</th><td class="field-body">03-Nov-2004</td> 43<tr class="field"><th class="field-name">Created:</th><td class="field-body">03-Nov-2004</td>
49</tr> 44</tr>
50<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">03-Nov-2004</td> 45<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">03-Nov-2004</td>
51</tr> 46</tr>
52</tbody> 47</tbody>
53</table> 48</table>
54<hr /> 49<hr />
55<div class="contents topic" id="contents"> 50<div class="contents topic">
56<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>
57<ul class="simple"> 52<ul class="simple">
58<li><a class="reference" href="#abstract" id="id4" name="id4">Abstract</a></li> 53<li><a class="reference" href="#abstract" id="id4" name="id4">Abstract</a></li>
59<li><a class="reference" href="#motivation" id="id5" name="id5">Motivation</a></li> 54<li><a class="reference" href="#motivation" id="id5" name="id5">Motivation</a></li>
60<li><a class="reference" href="#rationale" id="id6" name="id6">Rationale</a></li> 55<li><a class="reference" href="#rationale" id="id6" name="id6">Rationale</a></li>
61<li><a class="reference" href="#implementation" id="id7" name="id7">Implementation</a><ul> 56<li><a class="reference" href="#implementation" id="id7" name="id7">Implementation</a><ul>
67<li><a class="reference" href="#backwards-compatibility" id="id11" name="id11">Backwards Compatibility</a></li> 62<li><a class="reference" href="#backwards-compatibility" id="id11" name="id11">Backwards Compatibility</a></li>
68<li><a class="reference" href="#references" id="id12" name="id12">References</a></li> 63<li><a class="reference" href="#references" id="id12" name="id12">References</a></li>
69<li><a class="reference" href="#copyright" id="id13" name="id13">Copyright</a></li> 64<li><a class="reference" href="#copyright" id="id13" name="id13">Copyright</a></li>
70</ul> 65</ul>
71</div> 66</div>
72<div class="section" id="abstract"> 67<div class="section">
73<h1><a class="toc-backref" href="#id4" name="abstract">Abstract</a></h1> 68<h1><a class="toc-backref" href="#id4" id="abstract" name="abstract">Abstract</a></h1>
74<p>Ebuilds that install mail delivery agents often need to know the default 69<p>Ebuilds that install mail delivery agents often need to know the default
75location of users' mailbox. When the mailbox is of a maildir type, there is no 70location of users' mailbox. When the mailbox is of a maildir type, there is no
76set standard what the name of the directory should be. The most popular 71set standard what the name of the directory should be. The most popular
77extensions are &quot;Maildir&quot;, &quot;.Maildir&quot; and Gentoo has adopted its own &quot;.maildir&quot; 72extensions are &quot;Maildir&quot;, &quot;.Maildir&quot; and Gentoo has adopted its own &quot;.maildir&quot;
78name.</p> 73name.</p>
79<p>This GLEP proposes a user-definable maildir location.</p> 74<p>This GLEP proposes a user-definable maildir location.</p>
80</div> 75</div>
81<div class="section" id="motivation"> 76<div class="section">
82<h1><a class="toc-backref" href="#id5" name="motivation">Motivation</a></h1> 77<h1><a class="toc-backref" href="#id5" id="motivation" name="motivation">Motivation</a></h1>
83<p>To provide the means to change the default location of a maildir, that is 78<p>To provide the means to change the default location of a maildir, that is
84currently hardcoded in ebuilds.</p> 79currently hardcoded in ebuilds.</p>
85<p>The &quot;.maildir&quot; name is not adequate for most situations.</p> 80<p>The &quot;.maildir&quot; name is not adequate for most situations.</p>
86<ul class="simple"> 81<ul class="simple">
87<li>&quot;Maildir&quot; is the defacto standard name for maildir mailboxes.</li> 82<li>&quot;Maildir&quot; is the defacto standard name for maildir mailboxes.</li>
91dedicated for e-mail delivery is not a plus.</li> 86dedicated for e-mail delivery is not a plus.</li>
92<li>All postfix and qmail related documentation gives &quot;Maildir&quot; as an example 87<li>All postfix and qmail related documentation gives &quot;Maildir&quot; as an example
93name.</li> 88name.</li>
94</ul> 89</ul>
95</div> 90</div>
96<div class="section" id="rationale"> 91<div class="section">
97<h1><a class="toc-backref" href="#id6" name="rationale">Rationale</a></h1> 92<h1><a class="toc-backref" href="#id6" id="rationale" name="rationale">Rationale</a></h1>
98<p>The following comments were made in a discussion <a class="footnote-reference" href="#bugreport" id="id1" name="id1">[1]</a> on the Gentoo 93<p>The following comments were made in a discussion <a class="footnote-reference" href="#bugreport" id="id1" name="id1">[1]</a> on the Gentoo
99bugzilla</p> 94bugzilla</p>
100<ul class="simple"> 95<ul class="simple">
101<li>The default location should be specified in <tt class="literal"><span class="pre">rc.conf</span></tt></li> 96<li>The default location should be specified in <tt class="docutils literal"><span class="pre">rc.conf</span></tt></li>
102<li>Preventing users from shooting themselves in the foot is not an issue</li> 97<li>Preventing users from shooting themselves in the foot is not an issue</li>
103</ul> 98</ul>
104</div> 99</div>
105<div class="section" id="implementation"> 100<div class="section">
106<h1><a class="toc-backref" href="#id7" name="implementation">Implementation</a></h1> 101<h1><a class="toc-backref" href="#id7" id="implementation" name="implementation">Implementation</a></h1>
107<p>A <tt class="literal"><span class="pre">maildir.eclass</span></tt> has been submitted to Bug 52076 <a class="footnote-reference" href="#bugreport" id="id2" name="id2">[1]</a>.</p> 102<p>A <tt class="docutils literal"><span class="pre">maildir.eclass</span></tt> has been submitted to Bug 52076 <a class="footnote-reference" href="#bugreport" id="id2" name="id2">[1]</a>.</p>
108<p>Patches that implement features similar to this GLEP have already been 103<p>Patches that implement features similar to this GLEP have already been
109submitted to Bug 52076 <a class="footnote-reference" href="#bugreport" id="id3" name="id3">[1]</a>.</p> 104submitted to Bug 52076 <a class="footnote-reference" href="#bugreport" id="id3" name="id3">[1]</a>.</p>
110<div class="section" id="maildir-variable"> 105<div class="section">
111<h2><a class="toc-backref" href="#id8" name="maildir-variable">MAILDIR variable</a></h2> 106<h2><a class="toc-backref" href="#id8" id="maildir-variable" name="maildir-variable">MAILDIR variable</a></h2>
112<p>The default location for maildir delivery is specified by the <tt class="literal"><span class="pre">$MAILDIR</span></tt> 107<p>The default location for maildir delivery is specified by the <tt class="docutils literal"><span class="pre">$MAILDIR</span></tt>
113variable. This variable is specified in <tt class="literal"><span class="pre">rc.conf</span></tt>.</p> 108variable. This variable is specified in <tt class="docutils literal"><span class="pre">rc.conf</span></tt>.</p>
114</div> 109</div>
115<div class="section" id="maildir-eclass"> 110<div class="section">
116<h2><a class="toc-backref" href="#id9" name="maildir-eclass">maildir.eclass</a></h2> 111<h2><a class="toc-backref" href="#id9" id="maildir-eclass" name="maildir-eclass">maildir.eclass</a></h2>
117<p>This eclass exports a <tt class="literal"><span class="pre">$MAILDIR</span></tt> variable to the ebuilds that inherit it. If 112<p>This eclass exports a <tt class="docutils literal"><span class="pre">$MAILDIR</span></tt> variable to the ebuilds that inherit it. If
118<tt class="literal"><span class="pre">$MAILDIR</span></tt> has not been specified in <tt class="literal"><span class="pre">rc.conf</span></tt> the eclass exports 113<tt class="docutils literal"><span class="pre">$MAILDIR</span></tt> has not been specified in <tt class="docutils literal"><span class="pre">rc.conf</span></tt> the eclass exports
119<tt class="literal"><span class="pre">MAILDIR=.maildir</span></tt> for backwards compatibility reasons.</p> 114<tt class="docutils literal"><span class="pre">MAILDIR=.maildir</span></tt> for backwards compatibility reasons.</p>
120</div> 115</div>
121<div class="section" id="patching-ebuilds"> 116<div class="section">
122<h2><a class="toc-backref" href="#id10" name="patching-ebuilds">Patching ebuilds</a></h2> 117<h2><a class="toc-backref" href="#id10" id="patching-ebuilds" name="patching-ebuilds">Patching ebuilds</a></h2>
123<p>Since most ebuilds that currently need to know what the maildir delivery 118<p>Since most ebuilds that currently need to know what the maildir delivery
124location is already take the default <tt class="literal"><span class="pre">.maildir</span></tt> location into account when 119location is already take the default <tt class="docutils literal"><span class="pre">.maildir</span></tt> location into account when
125installing, modifying ebuilds to implement this GLEP is as simple as 120installing, modifying ebuilds to implement this GLEP is as simple as
126inheriting the <tt class="literal"><span class="pre">maildir.eclass</span></tt> and substituting <tt class="literal"><span class="pre">.maildir</span></tt> in the ebuild 121inheriting the <tt class="docutils literal"><span class="pre">maildir.eclass</span></tt> and substituting <tt class="docutils literal"><span class="pre">.maildir</span></tt> in the ebuild
127with the <tt class="literal"><span class="pre">$MAILDIR</span></tt> variable. Care should be taken, to also modify any 122with the <tt class="docutils literal"><span class="pre">$MAILDIR</span></tt> variable. Care should be taken, to also modify any
128patches or scripts that are used by the ebuild, that already have <tt class="literal"><span class="pre">.maildir</span></tt> 123patches or scripts that are used by the ebuild, that already have <tt class="docutils literal"><span class="pre">.maildir</span></tt>
129hardcoded (vpopmail, exim).</p> 124hardcoded (vpopmail, exim).</p>
130</div> 125</div>
131</div> 126</div>
132<div class="section" id="backwards-compatibility"> 127<div class="section">
133<h1><a class="toc-backref" href="#id11" name="backwards-compatibility">Backwards Compatibility</a></h1> 128<h1><a class="toc-backref" href="#id11" id="backwards-compatibility" name="backwards-compatibility">Backwards Compatibility</a></h1>
134<p>The default location is &quot;.maildir&quot;, unless it is overridden. This way, there 129<p>The default location is &quot;.maildir&quot;, unless it is overridden. This way, there
135would be no backwards compatibility issues.</p> 130would be no backwards compatibility issues.</p>
136</div> 131</div>
137<div class="section" id="references"> 132<div class="section">
138<h1><a class="toc-backref" href="#id12" name="references">References</a></h1> 133<h1><a class="toc-backref" href="#id12" id="references" name="references">References</a></h1>
139<table class="footnote" frame="void" id="bugreport" rules="none"> 134<table class="docutils footnote" frame="void" id="bugreport" rules="none">
140<colgroup><col class="label" /><col /></colgroup> 135<colgroup><col class="label" /><col /></colgroup>
141<tbody valign="top"> 136<tbody valign="top">
142<tr><td class="label"><a name="bugreport">[1]</a></td><td><em>(<a class="fn-backref" href="#id1">1</a>, <a class="fn-backref" href="#id2">2</a>, <a class="fn-backref" href="#id3">3</a>)</em> Bug 52076 (<a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=52076">http://bugs.gentoo.org/show_bug.cgi?id=52076</a>)</td></tr> 137<tr><td class="label"><a name="bugreport">[1]</a></td><td><em>(<a class="fn-backref" href="#id1">1</a>, <a class="fn-backref" href="#id2">2</a>, <a class="fn-backref" href="#id3">3</a>)</em> Bug 52076 (<a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=52076">http://bugs.gentoo.org/show_bug.cgi?id=52076</a>)</td></tr>
143</tbody> 138</tbody>
144</table> 139</table>
145</div> 140</div>
146<div class="section" id="copyright"> 141<div class="section">
147<h1><a class="toc-backref" href="#id13" name="copyright">Copyright</a></h1> 142<h1><a class="toc-backref" href="#id13" id="copyright" name="copyright">Copyright</a></h1>
148<p>This document has been placed in the public domain.</p> 143<p>This document has been placed in the public domain.</p>
149</div> 144</div>
145
150</div> 146</div>
147<div class="footer">
148<hr class="footer" />
149<a class="reference" href="glep-0032.txt">View document source</a>.
150Generated on: 2007-10-13 13:39 UTC.
151Generated 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.
151 152
152<hr class="footer" />
153<div class="footer">
154<a class="reference" href="glep-0032.txt">View document source</a>.
155Generated on: 2004-11-03 23:31 UTC.
156Generated 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.
157</div> 153</div>
158</body> 154</body>
159</html> 155</html>
160 156

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

  ViewVC Help
Powered by ViewVC 1.1.20