diff options
author | 2017-09-14 23:14:39 +0200 | |
---|---|---|
committer | 2017-10-09 12:08:51 +0200 | |
commit | c6fe2071a2e83be2203196ad7f9459941821a034 (patch) | |
tree | d81e1d9898c05917e05203af9803b581dff0d915 /glep-0032.rst | |
parent | glep-0045: Mark Final since GLEP 1 now uses ISO 8601 dates (diff) | |
download | glep-c6fe2071a2e83be2203196ad7f9459941821a034.tar.gz glep-c6fe2071a2e83be2203196ad7f9459941821a034.tar.bz2 glep-c6fe2071a2e83be2203196ad7f9459941821a034.zip |
Rename all GLEPs to .rst
Diffstat (limited to 'glep-0032.rst')
-rw-r--r-- | glep-0032.rst | 101 |
1 files changed, 101 insertions, 0 deletions
diff --git a/glep-0032.rst b/glep-0032.rst new file mode 100644 index 0000000..490b4e4 --- /dev/null +++ b/glep-0032.rst @@ -0,0 +1,101 @@ +GLEP: 32 +Title: Maildir Location +Version: $Revision$ +Last-Modified: $Date$ +Author: Georgi Georgiev <chutz@gg3.net> +Status: Deferred +Type: Standards Track +Content-Type: text/x-rst +Created: 03-Nov-2004 +Post-History: 03-Nov-2004 + + +Abstract +======== + +Ebuilds that install mail delivery agents often need to know the default +location of users' mailbox. When the mailbox is of a maildir type, there is no +set standard what the name of the directory should be. The most popular +extensions are "Maildir", ".Maildir" and Gentoo has adopted its own ".maildir" +name. + +This GLEP proposes a user-definable maildir location. + +Motivation +========== + +To provide the means to change the default location of a maildir, that is +currently hardcoded in ebuilds. + +The ".maildir" name is not adequate for most situations. + +- "Maildir" is the defacto standard name for maildir mailboxes. + +- People transferring e-mail configuration from other systems prefer to keep + the original naming conventions. + +- In a virtual hosting environment, having a hidden file in a directory + dedicated for e-mail delivery is not a plus. + +- All postfix and qmail related documentation gives "Maildir" as an example + name. + +Rationale +========= + +The following comments were made in a discussion [#bugreport]_ on the Gentoo +bugzilla + +- The default location should be specified in ``rc.conf`` + +- Preventing users from shooting themselves in the foot is not an issue + +Implementation +============== + +A ``maildir.eclass`` has been submitted to Bug 52076 [#bugreport]_. + +Patches that implement features similar to this GLEP have already been +submitted to Bug 52076 [#bugreport]_. + +MAILDIR variable +---------------- + +The default location for maildir delivery is specified by the ``$MAILDIR`` +variable. This variable is specified in ``rc.conf``. + +maildir.eclass +-------------- + +This eclass exports a ``$MAILDIR`` variable to the ebuilds that inherit it. If +``$MAILDIR`` has not been specified in ``rc.conf`` the eclass exports +``MAILDIR=.maildir`` for backwards compatibility reasons. + +Patching ebuilds +---------------- + +Since most ebuilds that currently need to know what the maildir delivery +location is already take the default ``.maildir`` location into account when +installing, modifying ebuilds to implement this GLEP is as simple as +inheriting the ``maildir.eclass`` and substituting ``.maildir`` in the ebuild +with the ``$MAILDIR`` variable. Care should be taken, to also modify any +patches or scripts that are used by the ebuild, that already have ``.maildir`` +hardcoded (vpopmail, exim). + +Backwards Compatibility +======================= + +The default location is ".maildir", unless it is overridden. This way, there +would be no backwards compatibility issues. + +References +========== + +.. [#bugreport] Bug 52076 (http://bugs.gentoo.org/show_bug.cgi?id=52076) + +Copyright +========= + +This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 +Unported License. To view a copy of this license, visit +http://creativecommons.org/licenses/by-sa/3.0/. |