--- xml/htdocs/proj/en/glep/glep-0032.html 2004/11/03 23:38:53 1.1 +++ xml/htdocs/proj/en/glep/glep-0032.html 2006/10/10 20:25:14 1.2 @@ -8,9 +8,252 @@ --> - + GLEP 32 -- Maildir Location - + -
- +
@@ -35,7 +277,7 @@ - + @@ -43,7 +285,7 @@ - + @@ -52,8 +294,8 @@
Version:1.1
Last-Modified:2004/11/03 23:38:05
Last-Modified:2004/11/03 23:38:05
Author:Georgi Georgiev <chutz at gg3.net>
Type:Standards Track
Content-Type:text/x-rst
Content-Type:text/x-rst
Created:03-Nov-2004

-
-

Contents

+
+

Contents

-
-

Abstract

+
+

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 @@ -78,8 +320,8 @@ name.

This GLEP proposes a user-definable maildir location.

-
-

Motivation

+
+

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.

@@ -93,67 +335,68 @@ name.
-
-

Rationale

+
+

Rationale

The following comments were made in a discussion [1] on the Gentoo bugzilla

    -
  • The default location should be specified in rc.conf
  • +
  • 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 [1].

+
+

Implementation

+

A maildir.eclass has been submitted to Bug 52076 [1].

Patches that implement features similar to this GLEP have already been submitted to Bug 52076 [1].

-
-

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.

+
+

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

+
+

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 +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 +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

+
+

Backwards Compatibility

The default location is ".maildir", unless it is overridden. This way, there would be no backwards compatibility issues.

- - - +