1 |
I don't know what the proper procedure for accepting a GLEP is, so does |
2 |
anyone have anything to comment on here? |
3 |
|
4 |
I know the wording in the GLEP is not very smooth, but I always hated |
5 |
literature classes. |
6 |
|
7 |
http://www.gentoo.org/proj/en/glep/glep-0032.html |
8 |
|
9 |
GLEP: 32 |
10 |
Title: Maildir Location |
11 |
Version: $Revision: 1.1 $ |
12 |
Last-Modified: $Date: 2004/11/03 23:38:05 $ |
13 |
Author: Georgi Georgiev <chutz@×××.net> |
14 |
Status: Draft |
15 |
Type: Standards Track |
16 |
Content-Type: text/x-rst |
17 |
Created: 03-Nov-2004 |
18 |
Post-History: 03-Nov-2004 |
19 |
|
20 |
Abstract |
21 |
======== |
22 |
|
23 |
Ebuilds that install mail delivery agents often need to know the default |
24 |
location of users' mailbox. When the mailbox is of a maildir type, there is no |
25 |
set standard what the name of the directory should be. The most popular |
26 |
extensions are "Maildir", ".Maildir" and Gentoo has adopted its own ".maildir" |
27 |
name. |
28 |
|
29 |
This GLEP proposes a user-definable maildir location. |
30 |
|
31 |
Motivation |
32 |
========== |
33 |
|
34 |
To provide the means to change the default location of a maildir, that is |
35 |
currently hardcoded in ebuilds. |
36 |
|
37 |
The ".maildir" name is not adequate for most situations. |
38 |
|
39 |
- "Maildir" is the defacto standard name for maildir mailboxes. |
40 |
|
41 |
- People transferring e-mail configuration from other systems prefer to keep |
42 |
the original naming conventions. |
43 |
|
44 |
- In a virtual hosting environment, having a hidden file in a directory |
45 |
dedicated for e-mail delivery is not a plus. |
46 |
|
47 |
- All postfix and qmail related documentation gives "Maildir" as an example |
48 |
name. |
49 |
|
50 |
Rationale |
51 |
========= |
52 |
|
53 |
The following comments were made in a discussion [#bugreport]_ on the Gentoo |
54 |
bugzilla |
55 |
|
56 |
- The default location should be specified in ``rc.conf`` |
57 |
|
58 |
- Preventing users from shooting themselves in the foot is not an issue |
59 |
|
60 |
Implementation |
61 |
============== |
62 |
|
63 |
A ``maildir.eclass`` has been submitted to Bug 52076 [#bugreport]_. |
64 |
|
65 |
Patches that implement features similar to this GLEP have already been |
66 |
submitted to Bug 52076 [#bugreport]_. |
67 |
|
68 |
MAILDIR variable |
69 |
---------------- |
70 |
|
71 |
The default location for maildir delivery is specified by the ``$MAILDIR`` |
72 |
variable. This variable is specified in ``rc.conf``. |
73 |
|
74 |
maildir.eclass |
75 |
-------------- |
76 |
|
77 |
This eclass exports a ``$MAILDIR`` variable to the ebuilds that inherit it. If |
78 |
``$MAILDIR`` has not been specified in ``rc.conf`` the eclass exports |
79 |
``MAILDIR=.maildir`` for backwards compatibility reasons. |
80 |
|
81 |
Patching ebuilds |
82 |
---------------- |
83 |
|
84 |
Since most ebuilds that currently need to know what the maildir delivery |
85 |
location is already take the default ``.maildir`` location into account when |
86 |
installing, modifying ebuilds to implement this GLEP is as simple as |
87 |
inheriting the ``maildir.eclass`` and substituting ``.maildir`` in the ebuild |
88 |
with the ``$MAILDIR`` variable. Care should be taken, to also modify any |
89 |
patches or scripts that are used by the ebuild, that already have ``.maildir`` |
90 |
hardcoded (vpopmail, exim). |
91 |
|
92 |
Backwards Compatibility |
93 |
======================= |
94 |
|
95 |
The default location is ".maildir", unless it is overridden. This way, there |
96 |
would be no backwards compatibility issues. |
97 |
|
98 |
References |
99 |
========== |
100 |
|
101 |
.. [#bugreport] Bug 52076 (http://bugs.gentoo.org/show_bug.cgi?id=52076) |
102 |
|
103 |
Copyright |
104 |
========= |
105 |
|
106 |
This document has been placed in the public domain. |
107 |
|
108 |
-- |
109 |
*> Georgi Georgiev *> In West Union, Ohio, No married man can go *> |
110 |
<* chutz@×××.net <* flying without his spouse along at any <* |
111 |
*> +81(90)6266-1163 *> time, unless he has been married for more *> |
112 |
<* ------------------- <* than 12 months. <* |