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>Inserting Letter - 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-Message.html#Editing-Message" title="Editing Message">
<link rel="next" href="Inserting-Messages.html#Inserting-Messages" title="Inserting Messages">
<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="Inserting-Letter"></a>
Next: <a rel="next" accesskey="n" href="Inserting-Messages.html#Inserting-Messages">Inserting Messages</a>,
Previous: <a rel="previous" accesskey="p" href="Editing-Message.html#Editing-Message">Editing Message</a>,
Up: <a rel="up" accesskey="u" href="Editing-Drafts.html#Editing-Drafts">Editing Drafts</a>
<hr>
</div>
<h3 class="section">9.2 Inserting Letter to Which You're Replying</h3>
<p><a name="index-inserting-messages-1308"></a><a name="index-replying-to-messages-1309"></a><a name="index-yanking-messages-1310"></a><a name="index-mh_002dyank_002dcur_002dmsg-1311"></a><a name="index-C_002dc-C_002dy-1312"></a><a name="index-mh_002dins_002dbuf_002dprefix-1313"></a>
It is often useful to insert a snippet of text from a letter that
someone mailed to provide some context for your reply. The command
<kbd>C-c C-y</kbd> (<code>mh-yank-cur-msg</code>) does this by adding an
attribution, yanking a portion of text from the message to which
you're replying, and inserting <code>mh-ins-buf-prefix</code> (`<samp><span class="samp">> </span></samp>')
before each line.
<pre class="smallexample"> Michael W Thelen <thelenm@stop.mail-abuse.org> wrote:
> 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><a name="index-mh_002dextract_002dfrom_002dattribution_002dverb-1314"></a>
The attribution consists of the sender's name and email address
followed by the content of the option
<code>mh-extract-from-attribution-verb</code>. This option can be set to
`<samp><span class="samp">wrote:</span></samp>', `<samp><span class="samp">a crit:</span></samp>', and `<samp><span class="samp">schrieb:</span></samp>'. You can also use
the `<samp><span class="samp">Custom String</span></samp>' menu item to enter your own verb.
<p><a name="index-mail_002dcitation_002dhook-1315"></a><a name="index-mh_002dins_002dbuf_002dprefix-1316"></a><a name="index-mh_002dyank_002dbehavior-1317"></a>
The prefix <code>"> "</code> is the default setting for the option
<code>mh-ins-buf-prefix</code>. I suggest that you not modify this option
since it is used by many mailers and news readers: messages are far
easier to read if several included messages have all been indented by
the same string. This prefix is not inserted if you use one of the
supercite flavors of <code>mh-yank-behavior</code> or you have added a
<code>mail-citation-hook</code> as described below.
<p><a name="index-mh_002ddelete_002dyanked_002dmsg_002dwindow_002dflag-1318"></a>
You can also turn on the <code>mh-delete-yanked-msg-window-flag</code>
option to delete the window containing the original message after
yanking it to make more room on your screen for your reply.
<p><a name="index-Emacs_002c-packages_002c-supercite-1319"></a><a name="index-supercite-package-1320"></a><a name="index-r-1321"></a><a name="index-mail_002dcitation_002dhook-1322"></a><a name="index-mh_002dyank_002dbehavior-1323"></a>
You can control how the message to which you are replying is yanked
into your reply using <code>mh-yank-behavior</code>. To include the entire
message, including the entire header, use `<samp><span class="samp">Body and
Header</span></samp>'<a rel="footnote" href="#fn-1" name="fnd-1"><sup>1</sup></a><a rel="footnote" href="#fn-2" name="fnd-2"><sup>2</sup></a>.
Use `<samp><span class="samp">Body</span></samp>' to yank just the body without the header. To yank only
the portion of the message following the point, set this option to
`<samp><span class="samp">Below Point</span></samp>'.
<p>Choose `<samp><span class="samp">Invoke supercite</span></samp>'<a rel="footnote" href="#fn-3" name="fnd-3"><sup>3</sup></a> to pass the entire message and header through supercite.
<p><a name="index-mh_002dextract_002dfrom_002dattribution_002dverb-1324"></a>
If the `<samp><span class="samp">Body With Attribution</span></samp>' setting is used, then the message
minus the header is yanked and a simple attribution line is added at
the top using the value of the option
<code>mh-extract-from-attribution-verb</code>. This is the default.
<p><a name="index-C_002dc-C_002dy-1325"></a><a name="index-mh_002ddelete_002dyanked_002dmsg_002dwindow_002dflag-1326"></a>
If the `<samp><span class="samp">Invoke supercite</span></samp>' or `<samp><span class="samp">Body With Attribution</span></samp>'
settings are used, the `<samp><span class="samp">-noformat</span></samp>' argument is passed to the
<samp><span class="command">repl</span></samp> program to override a `<samp><span class="samp">-filter</span></samp>' or `<samp><span class="samp">-format</span></samp>'
argument. These settings also have `<samp><span class="samp">Automatically</span></samp>' variants that
perform the action automatically when you reply so that you don't need
to use <kbd>C-c C-y</kbd> at all. Note that this automatic action is only
performed if the show buffer matches the message being replied to.
People who use the automatic variants tend to turn on the option
<code>mh-delete-yanked-msg-window-flag</code> as well so that the show
window is never displayed.
<p><a name="index-mh_002dyank_002dbehavior-1327"></a>
If the show buffer has a region, the option <code>mh-yank-behavior</code> is
ignored unless its value is one of `<samp><span class="samp">Attribution</span></samp>' variants in
which case the attribution is added to the yanked region.
<p><a name="index-trivial_002dcite-1328"></a><a name="index-mail_002dcitation_002dhook-1329"></a><a name="index-mh_002dins_002dbuf_002dprefix-1330"></a><a name="index-mh_002dyank_002dbehavior-1331"></a>
If this isn't enough, you can gain full control over the appearance of
the included text by setting <code>mail-citation-hook</code> to a function
that modifies it. This hook is ignored if the option
<code>mh-yank-behavior</code> is set to one of the supercite flavors.
Otherwise, this option controls how much of the message is passed to
the hook. The function can find the citation between point and mark
and it should leave point and mark around the modified citation text
for the next hook function. The standard prefix
<code>mh-ins-buf-prefix</code> is not added if this hook is set.
<p><a name="index-Emacs_002c-packages_002c-trivial_002dcite-1332"></a><a name="index-trivial_002dcite-package-1333"></a><a name="index-mh_002dyank_002dbehavior-1334"></a>
For example, if you use the hook function
<a href="http://shasta.cs.uiuc.edu/~lrclause/tc.html"><code>trivial-cite</code></a> (which is NOT part of Emacs), set
<code>mh-yank-behavior</code> to `<samp><span class="samp">Body and Header</span></samp>'.
<div class="footnote">
<hr>
<h4>Footnotes</h4><p class="footnote"><small>[<a name="fn-1" href="#fnd-1">1</a>]</small> If you'd rather have the header cleaned up, use
<kbd>C-u r</kbd> instead of <kbd>r</kbd> when replying
(see <a href="Replying.html#Replying">Replying</a>).</p>
<p class="footnote"><small>[<a name="fn-2" href="#fnd-2">2</a>]</small> In the past you would use this setting
and set <code>mail-citation-hook</code> to `<samp><span class="samp">supercite</span></samp>', but this usage
is now deprecated in favor of the `<samp><span class="samp">Invoke supercite</span></samp>' setting.</p>
<p class="footnote"><small>[<a name="fn-3" href="#fnd-3">3</a>]</small> <em>Supercite</em> is a
full-bodied, full-featured, citation package that comes standard with
Emacs.</p>
<p><hr></div>
</body></html>
|
