File: Editing-Message.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 (168 lines) | stat: -rw-r--r-- 12,225 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
161
162
163
164
165
166
167
168
<html lang="en">
<head>
<title>Editing Message - 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="Editing-Drafts.html#Editing-Drafts" title="Editing Drafts">
<link rel="prev" href="Editing-Drafts.html#Editing-Drafts" title="Editing Drafts">
<link rel="next" href="Inserting-Letter.html#Inserting-Letter" title="Inserting Letter">
<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="Editing-Message"></a>
Next:&nbsp;<a rel="next" accesskey="n" href="Inserting-Letter.html#Inserting-Letter">Inserting Letter</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Editing-Drafts.html#Editing-Drafts">Editing Drafts</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Editing-Drafts.html#Editing-Drafts">Editing Drafts</a>
<hr>
</div>

<h3 class="section">9.1 Editing the Message</h3>

<p><a name="index-g_t_0040samp_007bBcc_003a_007d-header-field-1251"></a><a name="index-g_t_0040samp_007bCc_003a_007d-header-field-1252"></a><a name="index-g_t_0040samp_007bDcc_003a_007d-header-field-1253"></a><a name="index-g_t_0040samp_007bFrom_003a_007d-header-field-1254"></a><a name="index-g_t_0040samp_007bMail_002dFollowup_002dTo_003a_007d-header-field-1255"></a><a name="index-g_t_0040samp_007bMail_002dReply_002dTo_003a_007d-header-field-1256"></a><a name="index-g_t_0040samp_007bReply_002dTo_003a_007d-header-field-1257"></a><a name="index-g_t_0040samp_007bSubject_003a_007d-header-field-1258"></a><a name="index-g_t_0040samp_007bTo_003a_007d-header-field-1259"></a><a name="index-editing-header-1260"></a><a name="index-header-field_002c-_0040samp_007bBcc_003a_007d-1261"></a><a name="index-header-field_002c-_0040samp_007bCc_003a_007d-1262"></a><a name="index-header-field_002c-_0040samp_007bDcc_003a_007d-1263"></a><a name="index-header-field_002c-_0040samp_007bFrom_003a_007d-1264"></a><a name="index-header-field_002c-_0040samp_007bMail_002dFollowup_002dTo_003a_007d-1265"></a><a name="index-header-field_002c-_0040samp_007bMail_002dReply_002dTo_003a_007d-1266"></a><a name="index-header-field_002c-_0040samp_007bReply_002dTo_003a_007d-1267"></a><a name="index-header-field_002c-_0040samp_007bSubject_003a_007d-1268"></a><a name="index-header-field_002c-_0040samp_007bTo_003a_007d-1269"></a><a name="index-mh_002dto_002dfield-1270"></a><a name="index-C_002dc-C_002df-C_002dt-1271"></a><a name="index-C_002dc-C_002df-t-1272"></a>
Because the header is part of the message, you can edit the header
fields as you wish. However, several convenience commands exist to
help you create and edit them. For example, the command <kbd>C-c C-f
C-t</kbd> (<code>mh-to-field</code>; alternatively, <kbd>C-c C-f t</kbd>) moves the
cursor to the `<samp><span class="samp">To:</span></samp>' header field, creating it if necessary. The
commands for moving to the `<samp><span class="samp">Cc:</span></samp>', `<samp><span class="samp">Subject:</span></samp>', `<samp><span class="samp">From:</span></samp>',
`<samp><span class="samp">Reply-To:</span></samp>', `<samp><span class="samp">Mail-Reply-To:</span></samp>', `<samp><span class="samp">Mail-Followup-To</span></samp>',
`<samp><span class="samp">Bcc:</span></samp>', and `<samp><span class="samp">Dcc:</span></samp>' header fields are similar.

   <p><a name="index-mh_002dto_002dfcc-1273"></a><a name="index-C_002dc-C_002df-C_002df-1274"></a><a name="index-C_002dc-C_002df-f-1275"></a>
One command behaves differently from the others, namely, <kbd>C-c C-f
C-f</kbd> (<code>mh-to-fcc</code>; alternatively, <kbd>C-c C-f f</kbd>). This command
will prompt you for the folder name in which to file a copy of the
draft. See <a href="Folder-Selection.html#Folder-Selection">Folder Selection</a>.

   <p><a name="index-indent_002drelative-1276"></a><a name="index-mh_002dletter_002dnext_002dheader_002dfield_002dor_002dindent-1277"></a><a name="index-mh_002dletter_002dprevious_002dheader_002dfield-1278"></a><a name="index-g_t_0040key_007bTAB_007d-1279"></a><a name="index-S_002d_0040key_007bTAB_007d-1280"></a><a name="index-mh_002dcompose_002dskipped_002dheader_002dfields-1281"></a><a name="index-mh_002dletter_002dheader_002dfield-1282"></a>
Within the header of the message, the command<br> &lt;TAB&gt;
(<code>mh-letter-next-header-field-or-indent</code>) moves between fields
that are highlighted with the face <code>mh-letter-header-field</code>,
skipping those fields listed in
<code>mh-compose-skipped-header-fields</code>. After the last field, this
command then moves point to the message body before cycling back to
the first field. If point is already past the first line of the
message body, then this command indents by calling
<code>indent-relative</code> with the given prefix argument. The command
<kbd>S-&lt;TAB&gt;</kbd> (<code>mh-letter-previous-header-field</code>) moves
backwards between the fields and cycles to the body of the message
after the first field. Unlike the command &lt;TAB&gt;, it will always
take point to the last field from anywhere in the body.

   <p><a name="index-alias-completion-1283"></a><a name="index-completion-1284"></a><a name="index-spell-check-1285"></a><a name="index-ispell_002dcomplete_002dword-1286"></a><a name="index-mh_002dletter_002dcomplete-1287"></a><a name="index-mh_002dletter_002dcomplete_002dor_002dspace-1288"></a><a name="index-mh_002dletter_002dconfirm_002daddress-1289"></a><a name="index-g_t_002c-_0028comma_0029-1290"></a><a name="index-g_t_0040key_007bSPC_007d-1291"></a><a name="index-M_002d_0040key_007bTAB_007d-1292"></a><a name="index-mh_002dalias_002dflash_002don_002dcomma-1293"></a><a name="index-mh_002dcompose_002dspace_002ddoes_002dcompletion_002dflag-1294"></a><a name="index-mh_002dletter_002dcomplete_002dfunction-1295"></a>
If the field contains addresses (for example, `<samp><span class="samp">To:</span></samp>' or
`<samp><span class="samp">Cc:</span></samp>') or folders (for example, `<samp><span class="samp">Fcc:</span></samp>') then the command
<kbd>M-&lt;TAB&gt;</kbd> (<code>mh-letter-complete</code>) will provide alias
completion (see <a href="Aliases.html#Aliases">Aliases</a>). In the body of the message,
<kbd>M-&lt;TAB&gt;</kbd> runs <code>mh-letter-complete-function</code> instead,
which is set to `<samp><span class="samp">'ispell-complete-word</span></samp>' by default. The command
<kbd>M-&lt;TAB&gt;</kbd> (<code>mh-letter-complete</code>) takes a prefix argument
that is passed to the <code>mh-letter-complete-function</code>. In addition,
turn on the option <code>mh-compose-space-does-completion-flag</code> to use
the command &lt;SPC&gt; (<code>mh-letter-complete-or-space</code>) to perform
completion in the header as well; use a prefix argument to specify
more than one space. Addresses are separated by a comma; when you
press the comma, the command <code>mh-letter-confirm-address</code> flashes
the alias expansion in the minibuffer if
<code>mh-alias-flash-on-comma</code> is turned on.

<!-- XXX Document the replacement for the inaccessible 'long argument. -->
<p><a name="index-mh_002dletter_002dtoggle_002dheader_002dfield_002ddisplay-1296"></a><a name="index-C_002dc-C_002dt-1297"></a>
Use the command <kbd>C-c C-t</kbd>
<code>mh-letter-toggle-header-field-display</code> to display truncated
header fields. This command is a toggle so entering it again will hide
the field. This command takes a prefix argument: if negative then the
field is hidden, if positive then the field is displayed (for example,
<kbd>C-u C-c C-t</kbd>).

   <p>Be sure to leave a row of dashes or a blank line between the header
and the body of the message.

   <p><a name="index-mh_002dletter_002dfill_002dcolumn-1298"></a>
The body of the message is edited as you would edit any Emacs buffer
although there are a few commands and options to assist you. You can
change the fill column in MH-Letter mode with the option
<code>mh-letter-fill-column</code>. By default, this option is 72 to allow
others to quote your message without line wrapping.

   <p><a name="index-filling-paragraphs-1299"></a><a name="index-paragraphs_002c-filling-1300"></a><a name="index-fill_002dparagraph-1301"></a><a name="index-M_002dq-1302"></a><a name="index-mh_002dins_002dbuf_002dprefix-1303"></a>
You'll often include messages that were sent from user agents that
haven't yet realized that paragraphs consist of more than a single
line. This makes for long lines that wrap in an ugly fashion. You'll
find that <kbd>M-q</kbd> (<code>fill-paragraph</code>) works well even on these
quoted messages, even if they are nested, just as long as all of the
quotes match the value of <code>mh-ins-buf-prefix</code> (see <a href="Inserting-Letter.html#Inserting-Letter">Inserting Letter</a>). For example, let's assume you have the following in your
draft:

<pre class="smallexample">     &gt; Hopefully this gives you an idea of what I'm currently doing. I'm \
     not sure yet whether I'm completely satisfied with my setup, but    \
     it's worked okay for me so far.
</pre>
   <p>Running <kbd>M-q</kbd> on this paragraph produces:

<pre class="smallexample">     &gt; Hopefully this gives you an idea of what I'm currently doing. I'm not
     &gt; sure yet whether I'm completely satisfied with my setup, but it's
     &gt; worked okay for me so far.
</pre>
   <p><a name="index-mh_002dopen_002dline-1304"></a><a name="index-open_002dline-1305"></a><a name="index-C_002dc-C_002do-1306"></a><a name="index-C_002do-1307"></a>
The command <kbd>C-c C-o</kbd> (<code>mh-open-line</code>) is similar to the
command <kbd>C-o</kbd> (<code>open-line</code>) in that it inserts a newline
after point. It differs in that it also inserts the right number of
quoting characters and spaces so that the next line begins in the same
column as it was. This is useful when breaking up paragraphs in
replies. For example, if this command was used when point was after
the first period in the paragraph above, the result would be this:

<pre class="smallexample">     &gt; Hopefully this gives you an idea of what I'm currently doing.
     
     &gt;                                                               I'm not
     &gt; sure yet whether I'm completely satisfied with my setup, but it's
     &gt; worked okay for me so far.
</pre>
   </body></html>