File: Folder-Selection.html

package info (click to toggle)
mh-e 8.0.3-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 8,976 kB
  • ctags: 4,351
  • sloc: lisp: 18,183; makefile: 459; sh: 97
file content (121 lines) | stat: -rw-r--r-- 6,296 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
<html lang="en">
<head>
<title>Folder Selection - The MH-E Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="The MH-E Manual">
<meta name="generator" content="makeinfo 4.8">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Using-This-Manual.html#Using-This-Manual" title="Using This Manual">
<link rel="prev" href="Ranges.html#Ranges" title="Ranges">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This is version 8.0.3 of `The MH-E
Manual', last updated 2006-11-12.

Copyright (C) 1995, 2001, 2002, 2003, 2005, 2006 Free
Software Foundation, Inc.

     The MH-E manual is free documentation; you can redistribute it
     and/or modify it under the terms of either:

       a. the GNU Free Documentation License, Version 1.2 or any later
          version published by the Free Software Foundation; with no
          Invariant Sections, no Front-Cover Texts, and no Back-Cover
          Texts.

       b. the GNU General Public License as published by the Free
          Software Foundation; either version 2, or (at your option)
          any later version.
     The MH-E manual is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
     General Public License or GNU Free Documentation License for more
     details.

     The GNU General Public License and the GNU Free Documentation
     License appear as appendices to this document. You may also
     request copies by writing to the Free Software Foundation, Inc.,
     51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
   -->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
  pre.display { font-family:inherit }
  pre.format  { font-family:inherit }
  pre.smalldisplay { font-family:inherit; font-size:smaller }
  pre.smallformat  { font-family:inherit; font-size:smaller }
  pre.smallexample { font-size:smaller }
  pre.smalllisp    { font-size:smaller }
  span.sc    { font-variant:small-caps }
  span.roman { font-family:serif; font-weight:normal; } 
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
--></style>
</head>
<body>
<div class="node">
<p>
<a name="Folder-Selection"></a>
Previous:&nbsp;<a rel="previous" accesskey="p" href="Ranges.html#Ranges">Ranges</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Using-This-Manual.html#Using-This-Manual">Using This Manual</a>
<hr>
</div>

<h3 class="section">4.3 Folder Selection</h3>

<p><a name="index-completion_002c-folders-244"></a><a name="index-folders_002c-completion-245"></a><a name="index-folders_002c-selecting-246"></a>
When you choose a folder in MH-E via a command such as <kbd>o</kbd>
(<code>mh-refile-msg</code>), completion is used to enter the folder
(see the section
<a href="http://www.gnu.org/software/emacs/manual/html_node/Completion.html">Completion</a> in <cite>The GNU Emacs Manual</cite>). 
In addition, MH-E has several ways of choosing a suitable default so
that the folder can often be selected with a single &lt;RET&gt; key.

   <p><a name="index-customization-group_002c-_0040samp_007bmh_002dfolder_002dselection_007d-247"></a><a name="index-g_t_0040samp_007bmh_002dfolder_002dselection_007d-customization-group-248"></a>
The `<samp><span class="samp">mh-folder-selection</span></samp>' customization group contains some
options which are used to help with this.

     <dl>
<dt><code>mh-default-folder-for-message-function</code><a name="index-mh_002ddefault_002dfolder_002dfor_002dmessage_002dfunction-249"></a><dd>Function to select a default folder for refiling or `<samp><span class="samp">Fcc:</span></samp>'
(default: <code>nil</code>). 
<!--  -->
<br><dt><code>mh-default-folder-list</code><a name="index-mh_002ddefault_002dfolder_002dlist-250"></a><dd>List of addresses and folders (default: <code>nil</code>). 
<!--  -->
<br><dt><code>mh-default-folder-must-exist-flag</code><a name="index-mh_002ddefault_002dfolder_002dmust_002dexist_002dflag-251"></a><dd>On means guessed folder name must exist to be used (default:
`<samp><span class="samp">on</span></samp>'). 
<!--  -->
<br><dt><code>mh-default-folder-prefix</code><a name="index-mh_002ddefault_002dfolder_002dprefix-252"></a><dd>Prefix used for folder names generated from aliases (default: <code>""</code>). 
</dl>

   <p><a name="index-mh_002ddefault_002dfolder_002dfor_002dmessage_002dfunction-253"></a>
You can set the option <code>mh-default-folder-for-message-function</code>
to a function that provides a default folder for the message to be
refiled. When this function is called, the current buffer contains the
message being refiled and point is at the start of the message. This
function should return the default folder as a string with a leading
`<samp><span class="samp">+</span></samp>' sign. It can also return <code>nil</code> so that the last folder
name is used as the default, or an empty string to suppress the
default entirely.

   <p>Otherwise, the name of the destination folder is derived from the
sender as follows:

     <ol type=1 start=1>
<a name="index-mh_002ddefault_002dfolder_002dlist-254"></a><li>The folder name associated with the first address found in the list
<code>mh-default-folder-list</code> is used. Each element in this list
contains a `<samp><span class="samp">Check Recipient</span></samp>' item. If this item is turned on,
then the address is checked against the recipient instead of the
sender. This is useful for mailing lists. 
<!--  -->
<a name="index-mh_002ddefault_002dfolder_002dprefix-255"></a><li>An alias prefixed by <code>mh-default-folder-prefix</code> corresponding to
the address is used. The prefix is used to prevent clutter in your
mail directory. See <a href="Aliases.html#Aliases">Aliases</a>.
        </ol>

   <p><a name="index-mh_002ddefault_002dfolder_002dmust_002dexist_002dflag-256"></a>
If the derived folder does not exist, and
<code>mh-default-folder-must-exist-flag</code> is <code>t</code>, then the last
folder name used is suggested. This is useful if you get mail from
various people for whom you have an alias, but file them all in the
same project folder.

   </body></html>