File: Miscellaneous-Commands-and-Options.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 (160 lines) | stat: -rw-r--r-- 8,471 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
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
<html lang="en">
<head>
<title>Miscellaneous Commands and Options - 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="Reading-Mail.html#Reading-Mail" title="Reading Mail">
<link rel="prev" href="Navigating.html#Navigating" title="Navigating">
<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="Miscellaneous-Commands-and-Options"></a>
Previous:&nbsp;<a rel="previous" accesskey="p" href="Navigating.html#Navigating">Navigating</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Reading-Mail.html#Reading-Mail">Reading Mail</a>
<hr>
</div>

<h3 class="section">6.9 Miscellaneous Commands and Options</h3>

<p>This section contains a few more miscellaneous commands and options.

   <p><a name="index-editing-message-747"></a><a name="index-mh_002dmodify-748"></a><a name="index-M-749"></a>
There are times when you need to edit a message. For example, you may
need to fix a broken Content-Type header field. You can do this with
the command <kbd>M</kbd> (<code>mh-modify</code>). It displays the raw message in
an editable buffer. When you are done editing, save and kill the
buffer as you would any other.

   <p><a name="index-mh_002dkill_002dfolder-750"></a><a name="index-mh_002dpack_002dfolder-751"></a><a name="index-mh_002ddo_002dnot_002dconfirm_002dflag-752"></a>
Commands such as <code>mh-pack-folder</code> prompt to confirm whether to
process outstanding moves and deletes or not before continuing. 
Turning on the option <code>mh-do-not-confirm-flag</code> means that these
actions will be performed&mdash;which is usually desired but cannot be
retracted&mdash;without question<a rel="footnote" href="#fn-1" name="fnd-1"><sup>1</sup></a>.

   <p><a name="index-MH_002dFolder-mode-753"></a><a name="index-modes_002c-MH_002dFolder-754"></a><a name="index-mh_002dsummary_002dheight-755"></a>
The option <code>mh-summary-height</code> controls the number of scan lines
displayed in the MH-Folder window, including the mode line. The
default value of this option is `<samp><span class="samp">Automatic</span></samp>' which means that the
MH-Folder buffer will maintain the same proportional size if the frame
is resized. If you'd prefer a fixed height, then choose the
`<samp><span class="samp">Fixed Size</span></samp>' option and enter the number of lines you'd like to
see.

   <p><a name="index-mh_002dbury_002dshow_002dbuffer_002dflag-756"></a>
Normally the buffer for displaying messages is buried at the bottom at
the buffer stack. You may wish to disable this feature by turning off
the option <code>mh-bury-show-buffer-flag</code>. One advantage of not
burying the show buffer is that one can delete the show buffer more
easily in an electric buffer list because of its proximity to its
associated MH-Folder buffer. Try running <kbd>M-x
electric-buffer-list</kbd> to see what I mean.

   <p><a name="index-g_t_0040file_007b_002eemacs_007d-757"></a><a name="index-files_002c-_0040file_007b_002eemacs_007d-758"></a><a name="index-reading-mail-759"></a>
Before we leave this section, I'll include a function that I use as a
front end to MH-E<a rel="footnote" href="#fn-2" name="fnd-2"><sup>2</sup></a>. It toggles between your
working window configuration, which may be quite involved&mdash;windows
filled with source, compilation output, man pages, and other
documentation&mdash;and your MH-E window configuration. Like the rest of
the customization described in this section, simply add the following
code to <samp><span class="file">~/.emacs</span></samp>.

   <p><a name="index-mh_002drmail_002c-example-760"></a>
<pre class="smalllisp">     (defvar my-mh-screen-saved nil
       "Set to non-<code>nil</code> when MH-E window configuration shown.")
     (defvar my-normal-screen nil "Normal window configuration.")
     (defvar my-mh-screen nil "MH-E window configuration.")
     
     (defun my-mh-rmail (&amp;optional arg)
       "Toggle between MH-E and normal screen configurations.
     With non-<code>nil</code> or prefix argument, <i>inc</i> mailbox as well
     when going into mail."
       (interactive "P")                 ; <span class="roman">user callable function, P=prefix arg</span>
       (setq my-mh-screen-saved          ; <span class="roman">save state</span>
             (cond
              ;; <span class="roman">Bring up MH-E screen if arg or normal window configuration.</span>
              ;; <span class="roman">If arg or +inbox buffer doesn't exist, run mh-rmail.</span>
              ((or arg (null my-mh-screen-saved))
               (setq my-normal-screen (current-window-configuration))
               (if (or arg (null (get-buffer "+inbox")))
                   (mh-rmail)
                 (set-window-configuration my-mh-screen))
               t)                        ; <span class="roman">set my-mh-screen-saved to </span><code>t</code>
              ;; <span class="roman">Otherwise, save MH-E screen and restore normal screen.</span>
              (t
               (setq my-mh-screen (current-window-configuration))
               (set-window-configuration my-normal-screen)
               nil))))                   ; <span class="roman">set my-mh-screen-saved to nil</span>
     
     (global-set-key "\C-x\r" 'my-mh-rmail)  ;<span class="roman"> call with C-x &lt;RET&gt;</span>
     
     <i>Starting MH-E</i>
</pre>
   <p>If you type an argument (<kbd>C-u</kbd>) or if <code>my-mh-screen-saved</code> is
<code>nil</code> (meaning a non-MH-E window configuration), the current
window configuration is saved, either the `<samp><span class="samp">+inbox</span></samp>' buffer is
displayed or <code>mh-rmail</code> is run, and the MH-E window configuration
is shown. Otherwise, the MH-E window configuration is saved and the
original configuration is displayed.

   <div class="footnote">
<hr>
<h4>Footnotes</h4><p class="footnote"><small>[<a name="fn-1" href="#fnd-1">1</a>]</small> In previous versions of MH-E,
this option suppressed the confirmation in <code>mh-kill-folder</code>. 
Since this kept most users from setting this option,
<code>mh-kill-folder</code> was modified in version 6.0 to always ask for
confirmation subject to <code>mh-kill-folder-suppress-prompt-hook</code>. 
See <a href="Folders.html#Folders">Folders</a>.</p>

   <p class="footnote"><small>[<a name="fn-2" href="#fnd-2">2</a>]</small> Stephen Gildea's favorite binding is
<kbd>(global-set-key "\C-cr" 'mh-rmail)</kbd>.</p>

   <p><hr></div>

   </body></html>