aboutsummaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorMiles Bader2007-01-01 03:21:06 +0000
committerMiles Bader2007-01-01 03:21:06 +0000
commit4c34eeeee5886d14f3e60b77fb563cb549c8896f (patch)
treeaf17010f0864173dd6416585f08d686377791412 /man
parent76acf92ebe73e35528c5966a21328305ba7b5aef (diff)
parentdb6292445840e2795f35ebad62a14314fc3c7c21 (diff)
downloademacs-4c34eeeee5886d14f3e60b77fb563cb549c8896f.tar.gz
emacs-4c34eeeee5886d14f3e60b77fb563cb549c8896f.zip
Merge from emacs--devo--0
Patches applied: * emacs--devo--0 (patch 563-582) - Update from CVS - Merge from gnus--rel--5.10 * gnus--rel--5.10 (patch 177-185) - Merge from emacs--devo--0 - Update from CVS Revision: emacs@sv.gnu.org/emacs--unicode--0--patch-158
Diffstat (limited to 'man')
-rw-r--r--man/ChangeLog153
-rw-r--r--man/abbrevs.texi4
-rw-r--r--man/calc.texi3
-rw-r--r--man/calendar.texi33
-rw-r--r--man/cl.texi6
-rw-r--r--man/emacs.texi8
-rw-r--r--man/frames.texi88
-rw-r--r--man/gnus.texi112
-rw-r--r--man/killing.texi39
-rw-r--r--man/major.texi22
-rw-r--r--man/mark.texi2
-rw-r--r--man/msdog.texi42
-rw-r--r--man/pgg.texi21
-rw-r--r--man/programs.texi51
-rw-r--r--man/search.texi7
-rw-r--r--man/tramp.texi20
-rw-r--r--man/trampver.texi4
-rw-r--r--man/xresources.texi11
18 files changed, 481 insertions, 145 deletions
diff --git a/man/ChangeLog b/man/ChangeLog
index 09eb469c53f..3e6fb6d8164 100644
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,156 @@
12006-12-31 Kim F. Storm <storm@cua.dk>
2
3 * major.texi (Choosing Modes): Document auto-mode-case-fond.
4
52006-12-30 Kim F. Storm <storm@cua.dk>
6
7 * killing.texi (CUA Bindings): Fix typo.
8
9 * xresources.texi (Table of Resources): Mention grow-only value for
10 auto-resize-tool-bars.
11
122006-12-30 Michael Albinus <michael.albinus@gmx.de>
13
14 Sync with Tramp 2.0.55.
15
16 * trampver.texi: Update release number.
17
182006-12-29 Reiner Steib <Reiner.Steib@gmx.de>
19
20 * gnus.texi (Customizing Articles): Add index entries for all
21 gnus-treat-* variables.
22
232006-12-29 Jouni K. Sepp,Ad(Bnen <jks@iki.fi>
24
25 * gnus.texi (IMAP): Fix incorrect explanation of
26 nnimap-search-uids-not-since-is-evil in documentation for
27 nnimap-expunge-search-string.
28
292006-12-27 Reiner Steib <Reiner.Steib@gmx.de>
30
31 * gnus.texi (ifile spam filtering): Rename spam-ifile-database-path to
32 spam-ifile-database.
33
342006-12-26 Reiner Steib <Reiner.Steib@gmx.de>
35
36 * gnus.texi (Spam Package Configuration Examples): Don't encourage to
37 rebind C-s.
38
392006-12-26 Jouni K. Sepp,Ad(Bnen <jks@iki.fi>
40
41 * gnus.texi (Group Parameters, Group Maintenance, Topic Commands)
42 (Mail Group Commands, Expiring Mail, IMAP): Add index entries for
43 "expiring mail".
44 (IMAP): Document nnimap-search-uids-not-since-is-evil and
45 nnimap-nov-is-evil.
46
472006-12-27 Eli Zaretskii <eliz@gnu.org>
48
49 * msdog.texi (Windows Keyboard): Mention widespread Windows bindings,
50 and how to get them back.
51
522006-12-26 Richard Stallman <rms@gnu.org>
53
54 * calendar.texi (Holidays): Holiday listing is based on current
55 practice, but DST is not.
56
572006-12-25 Richard Stallman <rms@gnu.org>
58
59 * emacs.texi (Top): Update subnode menus.
60
61 * mark.texi (Transient Mark): Fix xref.
62
63 * killing.texi (Graphical Kill): Node deleted.
64 (Killing): Add xref to Cut and Paste.
65 (CUA Bindings): Update xref.
66
67 * frames.texi (Cut and Paste): New section to hold other nodes.
68 (Mouse Commands): Node demoted.
69 (Cut/Paste Other App): Split out from Mouse Commands.
70 (Word and Line Mouse): Likewise.
71 (Secondary Selection, Clipboard): Nodes demoted.
72
732006-12-25 Kevin Ryde <user42@zip.com.au>
74
75 * cl.texi (Sorting Sequences): In sort*, add a little cautionary note
76 about the key procedure being used heavily.
77
782006-12-24 Chong Yidong <cyd@stupidchicken.com>
79
80 * pgg.texi (Caching passphrase): Default for pgg-gpg-use-agent changed
81 to t.
82 (Prerequisites): Add explanation about gpg-agent.
83
842006-12-24 Kevin Ryde <user42@zip.com.au>
85
86 * calendar.texi (Holidays): US daylight savings begins second Sunday
87 in March for 2007 onwards.
88 (Daylight Savings): Show new US default daylight savings rules, 2nd
89 Sun in Mar to 1st Sun in Nov, now in cal-dst.el.
90
912006-12-23 Chong Yidong <cyd@stupidchicken.com>
92
93 * calendar.texi (Scroll Calendar): < and > are switched.
94
952006-12-23 Kevin Rodgers <ihs_4664@yahoo.com>
96
97 * killing.texi (Deletion): Describe M-\ prefix argument.
98
992006-12-23 Richard Stallman <rms@gnu.org>
100
101 * search.texi (Regexp Search): Explain why forward and reverse regexp
102 search are not mirror images.
103
1042006-12-22 Kevin Ryde <user42@zip.com.au>
105
106 * cl.texi (Sorting Sequences): Typo in sort*, example showed plain
107 "sort" instead of "sort*".
108
1092006-12-19 Richard Stallman <rms@gnu.org>
110
111 * calc.texi (History and Acknowledgements): Recognize that Emacs
112 now does have floating point.
113
1142006-12-19 Kim F. Storm <storm@cua.dk>
115
116 * major.texi (Choosing Modes): Describe match-function elements for
117 magic-mode-alist.
118
1192006-12-19 Michael Albinus <michael.albinus@gmx.de>
120
121 * tramp.texi (External transfer methods): Describe new method `scpc'.
122
1232006-12-18 Eli Zaretskii <eliz@gnu.org>
124
125 * msdog.texi (Windows Keyboard): Add a footnote about "Windows" keys
126 peculiarities.
127
1282006-12-18 Richard Stallman <rms@gnu.org>
129
130 * abbrevs.texi (Editing Abbrevs): Fix previous change.
131
1322006-12-17 Sascha Wilde <wilde@sha-bang.de>
133
134 * pgg.texi: Added short note on gpg-agent to the introduction.
135
1362006-12-17 Alan Mackenzie <acm@muc.de>
137
138 * programs.texi (Left Margin Paren): Remove the bit which says
139 that CC Mode sets open-paren-in-column-0-is-defun-start to nil.
140 Discuss some of the issues of setting this option to nil.
141
1422006-12-17 Glenn Morris <rgm@gnu.org>
143
144 * abbrevs.texi (Editing Abbrevs): Mention system abbrevs.
145
1462006-12-16 Eli Zaretskii <eliz@gnu.org>
147
148 * msdog.texi (Windows Keyboard): Clarify `w32-recognize-altgr' effect.
149 (Windows Files): `w32-get-true-file-attributes' is only relevant for
150 NTFS volumes.
151 (ls in Lisp): `links' in `ls-lisp-verbosity' is only relevant to NTFS
152 volumes.
153
12006-12-15 Eli Zaretskii <eliz@gnu.org> 1542006-12-15 Eli Zaretskii <eliz@gnu.org>
2 155
3 * text.texi (HTML Mode): Fix "C-c TAB". 156 * text.texi (HTML Mode): Fix "C-c TAB".
diff --git a/man/abbrevs.texi b/man/abbrevs.texi
index 0283b332976..bea460a9a61 100644
--- a/man/abbrevs.texi
+++ b/man/abbrevs.texi
@@ -255,6 +255,10 @@ keeps track of this to help you see which abbrevs you actually use, so
255that you can eliminate those that you don't use often. The string at 255that you can eliminate those that you don't use often. The string at
256the end of the line is the expansion. 256the end of the line is the expansion.
257 257
258 Some abbrevs are marked with @samp{(sys)}. These ``system'' abbrevs
259(@pxref{Abbrevs,,, elisp, The Emacs Lisp Reference Manual}) are
260pre-defined by various modes, and are not saved to your abbrev file.
261
258@findex edit-abbrevs 262@findex edit-abbrevs
259@kindex C-c C-c @r{(Edit Abbrevs)} 263@kindex C-c C-c @r{(Edit Abbrevs)}
260 @kbd{M-x edit-abbrevs} allows you to add, change or kill abbrev 264 @kbd{M-x edit-abbrevs} allows you to add, change or kill abbrev
diff --git a/man/calc.texi b/man/calc.texi
index 6f3082fb776..d38becd46d9 100644
--- a/man/calc.texi
+++ b/man/calc.texi
@@ -1539,7 +1539,8 @@ To make a long story short, Emacs Lisp turned out to be a distressingly
1539solid implementation of Lisp, and the humble task of calculating 1539solid implementation of Lisp, and the humble task of calculating
1540turned out to be more open-ended than one might have expected. 1540turned out to be more open-ended than one might have expected.
1541 1541
1542Emacs Lisp doesn't have built-in floating point math, so it had to be 1542Emacs Lisp didn't have built-in floating point math (now it does), so
1543this had to be
1543simulated in software. In fact, Emacs integers will only comfortably 1544simulated in software. In fact, Emacs integers will only comfortably
1544fit six decimal digits or so---not enough for a decent calculator. So 1545fit six decimal digits or so---not enough for a decent calculator. So
1545I had to write my own high-precision integer code as well, and once I had 1546I had to write my own high-precision integer code as well, and once I had
diff --git a/man/calendar.texi b/man/calendar.texi
index 8b66cb6113e..45aec25be9b 100644
--- a/man/calendar.texi
+++ b/man/calendar.texi
@@ -240,9 +240,9 @@ the months on it. Scrolling the calendar means moving the strip
240horizontally, so that new months become visible in the window. 240horizontally, so that new months become visible in the window.
241 241
242@table @kbd 242@table @kbd
243@item <
244Scroll calendar one month forward (@code{scroll-calendar-left}).
245@item > 243@item >
244Scroll calendar one month forward (@code{scroll-calendar-left}).
245@item <
246Scroll calendar one month backward (@code{scroll-calendar-right}). 246Scroll calendar one month backward (@code{scroll-calendar-right}).
247@item C-v 247@item C-v
248@itemx @key{NEXT} 248@itemx @key{NEXT}
@@ -254,16 +254,15 @@ Scroll calendar three months backward
254(@code{scroll-calendar-right-three-months}). 254(@code{scroll-calendar-right-three-months}).
255@end table 255@end table
256 256
257@kindex < @r{(Calendar mode)}
258@findex scroll-calendar-left
259@kindex > @r{(Calendar mode)} 257@kindex > @r{(Calendar mode)}
258@findex scroll-calendar-left
259@kindex < @r{(Calendar mode)}
260@findex scroll-calendar-right 260@findex scroll-calendar-right
261 The most basic calendar scroll commands scroll by one month at a 261 The most basic calendar scroll commands scroll by one month at a
262time. This means that there are two months of overlap between the 262time. This means that there are two months of overlap between the
263display before the command and the display after. @kbd{<} scrolls 263display before the command and the display after. @kbd{>} scrolls the
264the calendar contents one month to the left; that is, it moves the 264calendar contents one month forward in time. @kbd{<} scrolls the
265display forward in time. @kbd{>} scrolls the contents to the 265contents one month backwards in time.
266right, which moves backwards in time.
267 266
268@kindex C-v @r{(Calendar mode)} 267@kindex C-v @r{(Calendar mode)}
269@findex scroll-calendar-left-three-months 268@findex scroll-calendar-left-three-months
@@ -527,12 +526,8 @@ categories of holidays. You can use this command even if you don't have
527a calendar window. 526a calendar window.
528 527
529 The dates used by Emacs for holidays are based on @emph{current 528 The dates used by Emacs for holidays are based on @emph{current
530practice}, not historical fact. Historically, for instance, the start 529practice}, not historical fact. For example Veteran's Day began in
531of daylight savings time and even its existence have varied from year to 5301919, but is shown in earlier years.
532year, but present United States law mandates that daylight savings time
533begins on the first Sunday in April. When the daylight savings rules
534are set up for the United States, Emacs always uses the present
535definition, even though it is wrong for some prior years.
536 531
537@node Sunrise/Sunset 532@node Sunrise/Sunset
538@section Times of Sunrise and Sunset 533@section Times of Sunrise and Sunset
@@ -1593,14 +1588,14 @@ day in the solar and lunar calculations.
1593 The values for Cambridge, Massachusetts are as follows: 1588 The values for Cambridge, Massachusetts are as follows:
1594 1589
1595@example 1590@example
1596(calendar-nth-named-day 1 0 4 year) 1591(calendar-nth-named-day 2 0 3 year)
1597(calendar-nth-named-day -1 0 10 year) 1592(calendar-nth-named-day 1 0 11 year)
1598@end example 1593@end example
1599 1594
1600@noindent 1595@noindent
1601That is, the first 0th day (Sunday) of the fourth month (April) in 1596That is, the second 0th day (Sunday) of the third month (March) in
1602the year specified by @code{year}, and the last Sunday of the tenth month 1597the year specified by @code{year}, and the first Sunday of the eleventh month
1603(October) of that year. If daylight savings time were 1598(November) of that year. If daylight savings time were
1604changed to start on October 1, you would set 1599changed to start on October 1, you would set
1605@code{calendar-daylight-savings-starts} to this: 1600@code{calendar-daylight-savings-starts} to this:
1606 1601
diff --git a/man/cl.texi b/man/cl.texi
index 051aa18e02c..2c357f5fec6 100644
--- a/man/cl.texi
+++ b/man/cl.texi
@@ -4086,13 +4086,15 @@ accepts a @code{:key} argument which is used to preprocess data
4086fed to the @var{predicate} function. For example, 4086fed to the @var{predicate} function. For example,
4087 4087
4088@example 4088@example
4089(setq data (sort data 'string-lessp :key 'downcase)) 4089(setq data (sort* data 'string-lessp :key 'downcase))
4090@end example 4090@end example
4091 4091
4092@noindent 4092@noindent
4093sorts @var{data}, a sequence of strings, into increasing alphabetical 4093sorts @var{data}, a sequence of strings, into increasing alphabetical
4094order without regard to case. A @code{:key} function of @code{car} 4094order without regard to case. A @code{:key} function of @code{car}
4095would be useful for sorting association lists. 4095would be useful for sorting association lists. It should only be a
4096simple accessor though, it's used heavily in the current
4097implementation.
4096 4098
4097The @code{sort*} function is destructive; it sorts lists by actually 4099The @code{sort*} function is destructive; it sorts lists by actually
4098rearranging the @code{cdr} pointers in suitable fashion. 4100rearranging the @code{cdr} pointers in suitable fashion.
diff --git a/man/emacs.texi b/man/emacs.texi
index 76b77f38f8b..d8bb5e8d5dc 100644
--- a/man/emacs.texi
+++ b/man/emacs.texi
@@ -5,7 +5,7 @@
5 5
6@c The edition number appears in several places in this file 6@c The edition number appears in several places in this file
7@set EDITION Sixteenth 7@set EDITION Sixteenth
8@set EMACSVER 22.0.91 8@set EMACSVER 22.0.92
9 9
10@copying 10@copying
11This is the @value{EDITION} edition of the @cite{GNU Emacs Manual}, 11This is the @value{EDITION} edition of the @cite{GNU Emacs Manual},
@@ -297,8 +297,6 @@ Killing and Moving Text
297* Killing by Lines:: How to kill entire lines of text at one time. 297* Killing by Lines:: How to kill entire lines of text at one time.
298* Other Kill Commands:: Commands to kill large regions of text and 298* Other Kill Commands:: Commands to kill large regions of text and
299 syntactic units such as words and sentences. 299 syntactic units such as words and sentences.
300* Graphical Kill:: The kill ring on graphical displays:
301 yanking between applications.
302* CUA Bindings:: Using @kbd{C-x}, @kbd{C-c}, @kbd{C-v} for copy 300* CUA Bindings:: Using @kbd{C-x}, @kbd{C-c}, @kbd{C-v} for copy
303 and paste, with enhanced rectangle support. 301 and paste, with enhanced rectangle support.
304 302
@@ -441,9 +439,7 @@ Multiple Windows
441 439
442Frames and X Windows 440Frames and X Windows
443 441
444* Mouse Commands:: Moving, cutting, and pasting, with the mouse. 442* Cut and Paste:: Mouse commands for cut and paste.
445* Secondary Selection:: Cutting without altering point and mark.
446* Clipboard:: Using the clipboard for selections.
447* Mouse References:: Using the mouse to select an item from a list. 443* Mouse References:: Using the mouse to select an item from a list.
448* Menu Mouse Clicks:: Mouse clicks that bring up menus. 444* Menu Mouse Clicks:: Mouse clicks that bring up menus.
449* Mode Line Mouse:: Mouse clicks on the mode line. 445* Mode Line Mouse:: Mouse clicks on the mode line.
diff --git a/man/frames.texi b/man/frames.texi
index f3191014434..7d8fdbfd0ce 100644
--- a/man/frames.texi
+++ b/man/frames.texi
@@ -34,11 +34,8 @@ so that you can use many of the features described in this chapter.
34@xref{MS-DOS Mouse}. 34@xref{MS-DOS Mouse}.
35@end ifnottex 35@end ifnottex
36 36
37
38@menu 37@menu
39* Mouse Commands:: Moving, cutting, and pasting, with the mouse. 38* Cut and Paste:: Mouse commands for cut and paste.
40* Secondary Selection:: Cutting without altering point and mark.
41* Clipboard:: Using the clipboard for selections.
42* Mouse References:: Using the mouse to select an item from a list. 39* Mouse References:: Using the mouse to select an item from a list.
43* Menu Mouse Clicks:: Mouse clicks that bring up menus. 40* Menu Mouse Clicks:: Mouse clicks that bring up menus.
44* Mode Line Mouse:: Mouse clicks on the mode line. 41* Mode Line Mouse:: Mouse clicks on the mode line.
@@ -60,8 +57,22 @@ so that you can use many of the features described in this chapter.
60* Text-Only Mouse:: Using the mouse in text-only terminals. 57* Text-Only Mouse:: Using the mouse in text-only terminals.
61@end menu 58@end menu
62 59
60@node Cut and Paste
61@section Killing and Yanking on Graphical Displays
62
63 This section describes facilities for selecting a region, killing,
64and yanking using the mouse.
65
66@menu
67* Mouse Commands:: Moving, cutting, and pasting, with the mouse.
68* Cut/Paste Other App:: Transfering text between Emacs and other apps.
69* Word and Line Mouse:: Mouse commands for selecting whole words or lines.
70* Secondary Selection:: Cutting without altering point and mark.
71* Clipboard:: Using the clipboard for selections.
72@end menu
73
63@node Mouse Commands 74@node Mouse Commands
64@section Mouse Commands for Editing 75@subsection Mouse Commands for Editing
65@cindex mouse buttons (what they do) 76@cindex mouse buttons (what they do)
66 77
67 The mouse commands for selecting and copying a region are mostly 78 The mouse commands for selecting and copying a region are mostly
@@ -154,27 +165,6 @@ entire words or lines.
154 165
155If you use @kbd{Mouse-3} a second time consecutively, at the same place, 166If you use @kbd{Mouse-3} a second time consecutively, at the same place,
156that kills the region already selected. 167that kills the region already selected.
157
158@item Double-Mouse-1
159This key sets the region around the word which you click on. If you
160click on a character with ``symbol'' syntax (such as underscore, in C
161mode), it sets the region around the symbol surrounding that character.
162
163If you click on a character with open-parenthesis or close-parenthesis
164syntax, it sets the region around the parenthetical grouping
165which that character starts or ends. If you click on a character with
166string-delimiter syntax (such as a singlequote or doublequote in C), it
167sets the region around the string constant (using heuristics to figure
168out whether that character is the beginning or the end of it).
169
170@item Double-Drag-Mouse-1
171This key selects a region made up of the words you drag across.
172
173@item Triple-Mouse-1
174This key sets the region around the line you click on.
175
176@item Triple-Drag-Mouse-1
177This key selects a region made up of the lines you drag across.
178@end table 168@end table
179 169
180 The simplest way to kill text with the mouse is to press @kbd{Mouse-1} 170 The simplest way to kill text with the mouse is to press @kbd{Mouse-1}
@@ -191,6 +181,20 @@ point. Then it does not matter where you click, or even which of the
191frame's windows you click on. The default value is @code{nil}. This 181frame's windows you click on. The default value is @code{nil}. This
192variable also affects yanking the secondary selection. 182variable also affects yanking the secondary selection.
193 183
184@cindex Delete Selection mode
185@cindex mode, Delete Selection
186@findex delete-selection-mode
187 Many graphical applications follow the convention that insertion while text
188is selected deletes the selected text. You can make Emacs behave this
189way by enabling Delete Selection mode---with @kbd{M-x
190delete-selection-mode} or using Custom. Another effect of this mode
191is that @key{DEL}, @kbd{C-d} and some other keys, when a selection
192exists, will kill the whole selection. It also enables Transient Mark
193mode (@pxref{Transient Mark}).
194
195@node Cut/Paste Other App
196@subsection Cut and Paste with Other Window Applications
197
194@cindex cutting 198@cindex cutting
195@cindex pasting 199@cindex pasting
196@cindex X cutting and pasting 200@cindex X cutting and pasting
@@ -224,8 +228,36 @@ to yank, the kill ring contents are used.
224system for selections, use @kbd{C-x @key{RET} x} or @kbd{C-x @key{RET} 228system for selections, use @kbd{C-x @key{RET} x} or @kbd{C-x @key{RET}
225X}. @xref{Communication Coding}. 229X}. @xref{Communication Coding}.
226 230
231@node Word and Line Mouse
232@subsection Mouse Commands for Words and Lines
233
234 These variants of @kbd{Mouse-1} select entire words or lines at a time.
235
236@table @kbd
237@item Double-Mouse-1
238This key sets the region around the word which you click on. If you
239click on a character with ``symbol'' syntax (such as underscore, in C
240mode), it sets the region around the symbol surrounding that character.
241
242If you click on a character with open-parenthesis or close-parenthesis
243syntax, it sets the region around the parenthetical grouping
244which that character starts or ends. If you click on a character with
245string-delimiter syntax (such as a singlequote or doublequote in C), it
246sets the region around the string constant (using heuristics to figure
247out whether that character is the beginning or the end of it).
248
249@item Double-Drag-Mouse-1
250This key selects a region made up of the words you drag across.
251
252@item Triple-Mouse-1
253This key sets the region around the line you click on.
254
255@item Triple-Drag-Mouse-1
256This key selects a region made up of the lines you drag across.
257@end table
258
227@node Secondary Selection 259@node Secondary Selection
228@section Secondary Selection 260@subsection Secondary Selection
229@cindex secondary selection 261@cindex secondary selection
230 262
231 The @dfn{secondary selection} is another way of selecting text using 263 The @dfn{secondary selection} is another way of selecting text using
@@ -280,7 +312,7 @@ yanks at point. Then it does not matter precisely where you click; all
280that matters is which window you click on. @xref{Mouse Commands}. 312that matters is which window you click on. @xref{Mouse Commands}.
281 313
282@node Clipboard 314@node Clipboard
283@section Using the Clipboard 315@subsection Using the Clipboard
284@cindex clipboard 316@cindex clipboard
285@vindex x-select-enable-clipboard 317@vindex x-select-enable-clipboard
286@findex menu-bar-enable-clipboard 318@findex menu-bar-enable-clipboard
diff --git a/man/gnus.texi b/man/gnus.texi
index 7a83ea66a97..ea959671c06 100644
--- a/man/gnus.texi
+++ b/man/gnus.texi
@@ -2810,6 +2810,7 @@ doesn't accept articles.
2810 2810
2811@item auto-expire 2811@item auto-expire
2812@cindex auto-expire 2812@cindex auto-expire
2813@cindex expiring mail
2813If the group parameter has an element that looks like @code{(auto-expire 2814If the group parameter has an element that looks like @code{(auto-expire
2814. t)}, all articles read will be marked as expirable. For an 2815. t)}, all articles read will be marked as expirable. For an
2815alternative approach, @pxref{Expiring Mail}. 2816alternative approach, @pxref{Expiring Mail}.
@@ -2818,6 +2819,7 @@ See also @code{gnus-auto-expirable-newsgroups}.
2818 2819
2819@item total-expire 2820@item total-expire
2820@cindex total-expire 2821@cindex total-expire
2822@cindex expiring mail
2821If the group parameter has an element that looks like 2823If the group parameter has an element that looks like
2822@code{(total-expire . t)}, all read articles will be put through the 2824@code{(total-expire . t)}, all read articles will be put through the
2823expiry process, even if they are not marked as expirable. Use with 2825expiry process, even if they are not marked as expirable. Use with
@@ -3407,6 +3409,7 @@ zombies.
3407@item C-c C-x 3409@item C-c C-x
3408@kindex C-c C-x (Group) 3410@kindex C-c C-x (Group)
3409@findex gnus-group-expire-articles 3411@findex gnus-group-expire-articles
3412@cindex expiring mail
3410Run all expirable articles in the current group through the expiry 3413Run all expirable articles in the current group through the expiry
3411process (if any) (@code{gnus-group-expire-articles}). That is, delete 3414process (if any) (@code{gnus-group-expire-articles}). That is, delete
3412all expirable articles in the group that have been around for a while. 3415all expirable articles in the group that have been around for a while.
@@ -3415,6 +3418,7 @@ all expirable articles in the group that have been around for a while.
3415@item C-c C-M-x 3418@item C-c C-M-x
3416@kindex C-c C-M-x (Group) 3419@kindex C-c C-M-x (Group)
3417@findex gnus-group-expire-all-groups 3420@findex gnus-group-expire-all-groups
3421@cindex expiring mail
3418Run all expirable articles in all groups through the expiry process 3422Run all expirable articles in all groups through the expiry process
3419(@code{gnus-group-expire-all-groups}). 3423(@code{gnus-group-expire-all-groups}).
3420 3424
@@ -3775,6 +3779,7 @@ sub-topics unless given a prefix.
3775@item C-c C-x 3779@item C-c C-x
3776@kindex C-c C-x (Topic) 3780@kindex C-c C-x (Topic)
3777@findex gnus-topic-expire-articles 3781@findex gnus-topic-expire-articles
3782@cindex expiring mail
3778Run all expirable articles in the current group or topic through the 3783Run all expirable articles in the current group or topic through the
3779expiry process (if any) 3784expiry process (if any)
3780(@code{gnus-topic-expire-articles}). (@pxref{Expiring Mail}). 3785(@code{gnus-topic-expire-articles}). (@pxref{Expiring Mail}).
@@ -10060,6 +10065,7 @@ process/prefix convention (@pxref{Process/Prefix}).
10060@item B e 10065@item B e
10061@kindex B e (Summary) 10066@kindex B e (Summary)
10062@findex gnus-summary-expire-articles 10067@findex gnus-summary-expire-articles
10068@cindex expiring mail
10063Run all expirable articles in the current group through the expiry 10069Run all expirable articles in the current group through the expiry
10064process (@code{gnus-summary-expire-articles}). That is, delete all 10070process (@code{gnus-summary-expire-articles}). That is, delete all
10065expirable articles in the group that have been around for a while. 10071expirable articles in the group that have been around for a while.
@@ -10068,6 +10074,7 @@ expirable articles in the group that have been around for a while.
10068@item B C-M-e 10074@item B C-M-e
10069@kindex B C-M-e (Summary) 10075@kindex B C-M-e (Summary)
10070@findex gnus-summary-expire-articles-now 10076@findex gnus-summary-expire-articles-now
10077@cindex expiring mail
10071Delete all the expirable articles in the group 10078Delete all the expirable articles in the group
10072(@code{gnus-summary-expire-articles-now}). This means that @strong{all} 10079(@code{gnus-summary-expire-articles-now}). This means that @strong{all}
10073articles eligible for expiry in the current group will 10080articles eligible for expiry in the current group will
@@ -11216,42 +11223,66 @@ group. Values in parenthesis are suggested sensible values. Others are
11216possible but those listed are probably sufficient for most people. 11223possible but those listed are probably sufficient for most people.
11217 11224
11218@table @code 11225@table @code
11226@vindex gnus-treat-buttonize
11219@item gnus-treat-buttonize (t, integer) 11227@item gnus-treat-buttonize (t, integer)
11228@vindex gnus-treat-buttonize-head
11220@item gnus-treat-buttonize-head (head) 11229@item gnus-treat-buttonize-head (head)
11221 11230
11222@xref{Article Buttons}. 11231@xref{Article Buttons}.
11223 11232
11233@vindex gnus-treat-capitalize-sentences
11224@item gnus-treat-capitalize-sentences (t, integer) 11234@item gnus-treat-capitalize-sentences (t, integer)
11235@vindex gnus-treat-overstrike
11225@item gnus-treat-overstrike (t, integer) 11236@item gnus-treat-overstrike (t, integer)
11237@vindex gnus-treat-strip-cr
11226@item gnus-treat-strip-cr (t, integer) 11238@item gnus-treat-strip-cr (t, integer)
11239@vindex gnus-treat-strip-headers-in-body
11227@item gnus-treat-strip-headers-in-body (t, integer) 11240@item gnus-treat-strip-headers-in-body (t, integer)
11241@vindex gnus-treat-strip-leading-blank-lines
11228@item gnus-treat-strip-leading-blank-lines (t, integer) 11242@item gnus-treat-strip-leading-blank-lines (t, integer)
11243@vindex gnus-treat-strip-multiple-blank-lines
11229@item gnus-treat-strip-multiple-blank-lines (t, integer) 11244@item gnus-treat-strip-multiple-blank-lines (t, integer)
11245@vindex gnus-treat-strip-pem
11230@item gnus-treat-strip-pem (t, last, integer) 11246@item gnus-treat-strip-pem (t, last, integer)
11247@vindex gnus-treat-strip-trailing-blank-lines
11231@item gnus-treat-strip-trailing-blank-lines (t, last, integer) 11248@item gnus-treat-strip-trailing-blank-lines (t, last, integer)
11249@vindex gnus-treat-unsplit-urls
11232@item gnus-treat-unsplit-urls (t, integer) 11250@item gnus-treat-unsplit-urls (t, integer)
11251@vindex gnus-treat-wash-html
11233@item gnus-treat-wash-html (t, integer) 11252@item gnus-treat-wash-html (t, integer)
11234 11253
11235@xref{Article Washing}. 11254@xref{Article Washing}.
11236 11255
11256@vindex gnus-treat-date-english
11237@item gnus-treat-date-english (head) 11257@item gnus-treat-date-english (head)
11258@vindex gnus-treat-date-iso8601
11238@item gnus-treat-date-iso8601 (head) 11259@item gnus-treat-date-iso8601 (head)
11260@vindex gnus-treat-date-lapsed
11239@item gnus-treat-date-lapsed (head) 11261@item gnus-treat-date-lapsed (head)
11262@vindex gnus-treat-date-local
11240@item gnus-treat-date-local (head) 11263@item gnus-treat-date-local (head)
11264@vindex gnus-treat-date-original
11241@item gnus-treat-date-original (head) 11265@item gnus-treat-date-original (head)
11266@vindex gnus-treat-date-user-defined
11242@item gnus-treat-date-user-defined (head) 11267@item gnus-treat-date-user-defined (head)
11268@vindex gnus-treat-date-ut
11243@item gnus-treat-date-ut (head) 11269@item gnus-treat-date-ut (head)
11244 11270
11245@xref{Article Date}. 11271@xref{Article Date}.
11246 11272
11273@vindex gnus-treat-from-picon
11247@item gnus-treat-from-picon (head) 11274@item gnus-treat-from-picon (head)
11275@vindex gnus-treat-mail-picon
11248@item gnus-treat-mail-picon (head) 11276@item gnus-treat-mail-picon (head)
11277@vindex gnus-treat-newsgroups-picon
11249@item gnus-treat-newsgroups-picon (head) 11278@item gnus-treat-newsgroups-picon (head)
11250 11279
11251@xref{Picons}. 11280@xref{Picons}.
11252 11281
11282@vindex gnus-treat-display-smileys
11253@item gnus-treat-display-smileys (t, integer) 11283@item gnus-treat-display-smileys (t, integer)
11254 11284
11285@vindex gnus-treat-body-boundary
11255@item gnus-treat-body-boundary (head) 11286@item gnus-treat-body-boundary (head)
11256 11287
11257@vindex gnus-body-boundary-delimiter 11288@vindex gnus-body-boundary-delimiter
@@ -11260,40 +11291,62 @@ is controlled by @code{gnus-body-boundary-delimiter}.
11260 11291
11261@xref{Smileys}. 11292@xref{Smileys}.
11262 11293
11294@vindex gnus-treat-display-x-face
11263@item gnus-treat-display-x-face (head) 11295@item gnus-treat-display-x-face (head)
11264 11296
11265@xref{X-Face}. 11297@xref{X-Face}.
11266 11298
11299@vindex gnus-treat-display-face
11267@item gnus-treat-display-face (head) 11300@item gnus-treat-display-face (head)
11268 11301
11269@xref{Face}. 11302@xref{Face}.
11270 11303
11304@vindex gnus-treat-emphasize
11271@item gnus-treat-emphasize (t, head, integer) 11305@item gnus-treat-emphasize (t, head, integer)
11306@vindex gnus-treat-fill-article
11272@item gnus-treat-fill-article (t, integer) 11307@item gnus-treat-fill-article (t, integer)
11308@vindex gnus-treat-fill-long-lines
11273@item gnus-treat-fill-long-lines (t, integer) 11309@item gnus-treat-fill-long-lines (t, integer)
11310@vindex gnus-treat-hide-boring-headers
11274@item gnus-treat-hide-boring-headers (head) 11311@item gnus-treat-hide-boring-headers (head)
11312@vindex gnus-treat-hide-citation
11275@item gnus-treat-hide-citation (t, integer) 11313@item gnus-treat-hide-citation (t, integer)
11314@vindex gnus-treat-hide-citation-maybe
11276@item gnus-treat-hide-citation-maybe (t, integer) 11315@item gnus-treat-hide-citation-maybe (t, integer)
11316@vindex gnus-treat-hide-headers
11277@item gnus-treat-hide-headers (head) 11317@item gnus-treat-hide-headers (head)
11318@vindex gnus-treat-hide-signature
11278@item gnus-treat-hide-signature (t, last) 11319@item gnus-treat-hide-signature (t, last)
11320@vindex gnus-treat-strip-banner
11279@item gnus-treat-strip-banner (t, last) 11321@item gnus-treat-strip-banner (t, last)
11322@vindex gnus-treat-strip-list-identifiers
11280@item gnus-treat-strip-list-identifiers (head) 11323@item gnus-treat-strip-list-identifiers (head)
11281 11324
11282@xref{Article Hiding}. 11325@xref{Article Hiding}.
11283 11326
11327@vindex gnus-treat-highlight-citation
11284@item gnus-treat-highlight-citation (t, integer) 11328@item gnus-treat-highlight-citation (t, integer)
11329@vindex gnus-treat-highlight-headers
11285@item gnus-treat-highlight-headers (head) 11330@item gnus-treat-highlight-headers (head)
11331@vindex gnus-treat-highlight-signature
11286@item gnus-treat-highlight-signature (t, last, integer) 11332@item gnus-treat-highlight-signature (t, last, integer)
11287 11333
11288@xref{Article Highlighting}. 11334@xref{Article Highlighting}.
11289 11335
11336@vindex gnus-treat-play-sounds
11290@item gnus-treat-play-sounds 11337@item gnus-treat-play-sounds
11338@vindex gnus-treat-translate
11291@item gnus-treat-translate 11339@item gnus-treat-translate
11340@vindex gnus-treat-x-pgp-sig
11292@item gnus-treat-x-pgp-sig (head) 11341@item gnus-treat-x-pgp-sig (head)
11293 11342
11343@vindex gnus-treat-unfold-headers
11294@item gnus-treat-unfold-headers (head) 11344@item gnus-treat-unfold-headers (head)
11345@vindex gnus-treat-fold-headers
11295@item gnus-treat-fold-headers (head) 11346@item gnus-treat-fold-headers (head)
11347@vindex gnus-treat-fold-newsgroups
11296@item gnus-treat-fold-newsgroups (head) 11348@item gnus-treat-fold-newsgroups (head)
11349@vindex gnus-treat-leading-whitespace
11297@item gnus-treat-leading-whitespace (head) 11350@item gnus-treat-leading-whitespace (head)
11298 11351
11299@xref{Article Header}. 11352@xref{Article Header}.
@@ -14511,6 +14564,7 @@ using the new mail back end.
14511@node Expiring Mail 14564@node Expiring Mail
14512@subsection Expiring Mail 14565@subsection Expiring Mail
14513@cindex article expiry 14566@cindex article expiry
14567@cindex expiring mail
14514 14568
14515Traditional mail readers have a tendency to remove mail articles when 14569Traditional mail readers have a tendency to remove mail articles when
14516you mark them as read, in some way. Gnus takes a fundamentally 14570you mark them as read, in some way. Gnus takes a fundamentally
@@ -16454,6 +16508,7 @@ as ticked for other users.
16454@item nnimap-expunge-search-string 16508@item nnimap-expunge-search-string
16455@cindex expunging 16509@cindex expunging
16456@vindex nnimap-expunge-search-string 16510@vindex nnimap-expunge-search-string
16511@cindex expiring @acronym{IMAP} mail
16457 16512
16458This variable contain the @acronym{IMAP} search command sent to server when 16513This variable contain the @acronym{IMAP} search command sent to server when
16459searching for articles eligible for expiring. The default is 16514searching for articles eligible for expiring. The default is
@@ -16465,6 +16520,10 @@ Probably the only useful value to change this to is
16465messages instead of the internal article date. See section 6.4.4 of 16520messages instead of the internal article date. See section 6.4.4 of
16466RFC 2060 for more information on valid strings. 16521RFC 2060 for more information on valid strings.
16467 16522
16523However, if @code{nnimap-search-uids-not-since-is-evil}
16524is true, this variable has no effect since the search logic
16525is reversed, as described below.
16526
16468@item nnimap-authinfo-file 16527@item nnimap-authinfo-file
16469@vindex nnimap-authinfo-file 16528@vindex nnimap-authinfo-file
16470 16529
@@ -16490,6 +16549,47 @@ Unselect mailboxes before looking for new mail in them. Some servers
16490seem to need this under some circumstances; it was reported that 16549seem to need this under some circumstances; it was reported that
16491Courier 1.7.1 did. 16550Courier 1.7.1 did.
16492 16551
16552@item nnimap-nov-is-evil
16553@vindex nnimap-nov-is-evil
16554@cindex Courier @acronym{IMAP} server
16555@cindex @acronym{NOV}
16556
16557Never generate or use a local @acronym{NOV} database. Defaults to the
16558value of @code{gnus-agent}.
16559
16560Using a @acronym{NOV} database usually makes header fetching much
16561faster, but it uses the @code{UID SEARCH UID} command, which is very
16562slow on some servers (notably some versions of Courier). Since the Gnus
16563Agent caches the information in the @acronym{NOV} database without using
16564the slow command, this variable defaults to true if the Agent is in use,
16565and false otherwise.
16566
16567@item nnimap-search-uids-not-since-is-evil
16568@vindex nnimap-search-uids-not-since-is-evil
16569@cindex Courier @acronym{IMAP} server
16570@cindex expiring @acronym{IMAP} mail
16571
16572Avoid the @code{UID SEARCH UID @var{message numbers} NOT SINCE
16573@var{date}} command, which is slow on some @acronym{IMAP} servers
16574(notably, some versions of Courier). Instead, use @code{UID SEARCH SINCE
16575@var{date}} and prune the list of expirable articles within Gnus.
16576
16577When Gnus expires your mail (@pxref{Expiring Mail}), it starts with a
16578list of expirable articles and asks the IMAP server questions like ``Of
16579these articles, which ones are older than a week?'' While this seems
16580like a perfectly reasonable question, some IMAP servers take a long time
16581to answer it, since they seemingly go looking into every old article to
16582see if it is one of the expirable ones. Curiously, the question ``Of
16583@emph{all} articles, which ones are newer than a week?'' seems to be
16584much faster to answer, so setting this variable causes Gnus to ask this
16585question and figure out the answer to the real question itself.
16586
16587This problem can really sneak up on you: when you first configure Gnus,
16588everything works fine, but once you accumulate a couple thousand
16589messages, you start cursing Gnus for being so slow. On the other hand,
16590if you get a lot of email within a week, setting this variable will
16591cause a lot of network traffic between Gnus and the IMAP server.
16592
16493@end table 16593@end table
16494 16594
16495@menu 16595@menu
@@ -16677,7 +16777,7 @@ splitting function that analyzes the body to split the article.
16677 16777
16678@node Expiring in IMAP 16778@node Expiring in IMAP
16679@subsection Expiring in IMAP 16779@subsection Expiring in IMAP
16680@cindex expiring imap mail 16780@cindex expiring @acronym{IMAP} mail
16681 16781
16682Even though @code{nnimap} is not a proper @code{nnmail} derived back 16782Even though @code{nnimap} is not a proper @code{nnmail} derived back
16683end, it supports most features in regular expiring (@pxref{Expiring 16783end, it supports most features in regular expiring (@pxref{Expiring
@@ -16696,6 +16796,9 @@ you to view client specific flags on the message. It also means that
16696your server must support permanent storage of client specific flags on 16796your server must support permanent storage of client specific flags on
16697messages. Most do, fortunately. 16797messages. Most do, fortunately.
16698 16798
16799If expiring @acronym{IMAP} mail seems very slow, try setting the server
16800variable @code{nnimap-search-uids-not-since-is-evil}.
16801
16699@table @code 16802@table @code
16700 16803
16701@item nnmail-expiry-wait 16804@item nnmail-expiry-wait
@@ -18605,7 +18708,7 @@ sense if you are using a nntp or nnimap back end.
18605@findex gnus-agent-expire-group 18708@findex gnus-agent-expire-group
18606@cindex agent expiry 18709@cindex agent expiry
18607@cindex Gnus agent expiry 18710@cindex Gnus agent expiry
18608@cindex expiry 18711@cindex expiry, in Gnus agent
18609 18712
18610The Agent back end, @code{nnagent}, doesn't handle expiry. Well, at 18713The Agent back end, @code{nnagent}, doesn't handle expiry. Well, at
18611least it doesn't handle it like other back ends. Instead, there are 18714least it doesn't handle it like other back ends. Instead, there are
@@ -23324,9 +23427,6 @@ From Ted Zlatanov <tzz@@lifelogs.com>.
23324(gnus-registry-initialize) 23427(gnus-registry-initialize)
23325(spam-initialize) 23428(spam-initialize)
23326 23429
23327;; @r{I like @kbd{C-s} for marking spam}
23328(define-key gnus-summary-mode-map "\C-s" 'gnus-summary-mark-as-spam)
23329
23330(setq 23430(setq
23331 spam-log-to-registry t ; @r{for spam autodetection} 23431 spam-log-to-registry t ; @r{for spam autodetection}
23332 spam-use-BBDB t 23432 spam-use-BBDB t
@@ -23898,7 +23998,7 @@ The actual string used is irrelevant, but you probably want to leave
23898the default value of @samp{spam}. 23998the default value of @samp{spam}.
23899@end defvar 23999@end defvar
23900 24000
23901@defvar spam-ifile-database-path 24001@defvar spam-ifile-database
23902 24002
23903This is the filename for the ifile database. It is not specified by 24003This is the filename for the ifile database. It is not specified by
23904default, so ifile will use its own default database name. 24004default, so ifile will use its own default database name.
diff --git a/man/killing.texi b/man/killing.texi
index 4be77e2d6f8..396a76328aa 100644
--- a/man/killing.texi
+++ b/man/killing.texi
@@ -56,14 +56,14 @@ an error message when this happens. But if you set the variable
56@code{kill-read-only-ok} to a non-@code{nil} value, they just print a 56@code{kill-read-only-ok} to a non-@code{nil} value, they just print a
57message in the echo area to explain why the text has not been erased. 57message in the echo area to explain why the text has not been erased.
58 58
59 You can also use the mouse to kill and yank. @xref{Cut and Paste}.
60
59@menu 61@menu
60* Deletion:: Commands for deleting small amounts of text and 62* Deletion:: Commands for deleting small amounts of text and
61 blank areas. 63 blank areas.
62* Killing by Lines:: How to kill entire lines of text at one time. 64* Killing by Lines:: How to kill entire lines of text at one time.
63* Other Kill Commands:: Commands to kill large regions of text and 65* Other Kill Commands:: Commands to kill large regions of text and
64 syntactic units such as words and sentences. 66 syntactic units such as words and sentences.
65* Graphical Kill:: The kill ring on graphical displays:
66 yanking between applications.
67@end menu 67@end menu
68 68
69@need 1500 69@need 1500
@@ -148,10 +148,11 @@ enters Help instead, see @ref{DEL Does Not Delete}.
148 The other delete commands are those which delete only whitespace 148 The other delete commands are those which delete only whitespace
149characters: spaces, tabs and newlines. @kbd{M-\} 149characters: spaces, tabs and newlines. @kbd{M-\}
150(@code{delete-horizontal-space}) deletes all the spaces and tab 150(@code{delete-horizontal-space}) deletes all the spaces and tab
151characters before and after point. @kbd{M-@key{SPC}} 151characters before and after point. (With a prefix argument, it
152deletes them before point, but not after.) @kbd{M-@key{SPC}}
152(@code{just-one-space}) does likewise but leaves a single space after 153(@code{just-one-space}) does likewise but leaves a single space after
153point, regardless of the number of spaces that existed previously (even 154point, regardless of the number of spaces that existed previously
154if there were none before). With a numeric argument @var{n}, it 155(even if there were none before). With a numeric argument @var{n}, it
155leaves @var{n} spaces after point. 156leaves @var{n} spaces after point.
156 157
157 @kbd{C-x C-o} (@code{delete-blank-lines}) deletes all blank lines 158 @kbd{C-x C-o} (@code{delete-blank-lines}) deletes all blank lines
@@ -250,28 +251,6 @@ and @kbd{M-d} (@pxref{Words}); balanced expressions, with @kbd{C-M-k}
250(@pxref{Expressions}); and sentences, with @kbd{C-x @key{DEL}} and 251(@pxref{Expressions}); and sentences, with @kbd{C-x @key{DEL}} and
251@kbd{M-k} (@pxref{Sentences}).@refill 252@kbd{M-k} (@pxref{Sentences}).@refill
252 253
253@node Graphical Kill
254@subsection Killing on Graphical Displays
255
256 On graphical displays with window systems, the most recent kill done
257in Emacs is also the primary selection, if it is more recent than any
258selection you made in another program. This means that the paste
259commands of other window-based applications copy the text that you
260killed in Emacs. In addition, Emacs yank commands treat other
261applications' selections as part of the kill ring, so you can yank
262them into Emacs.
263
264@cindex Delete Selection mode
265@cindex mode, Delete Selection
266@findex delete-selection-mode
267 Many graphical applications follow the convention that insertion while text
268is selected deletes the selected text. You can make Emacs behave this
269way by enabling Delete Selection mode---with @kbd{M-x
270delete-selection-mode} or using Custom. Another effect of this mode
271is that @key{DEL}, @kbd{C-d} and some other keys, when a selection
272exists, will kill the whole selection. It also enables Transient Mark
273mode (@pxref{Transient Mark}).
274
275@node Yanking, Accumulating Text, Killing, Top 254@node Yanking, Accumulating Text, Killing, Top
276@section Yanking 255@section Yanking
277@cindex moving text 256@cindex moving text
@@ -668,14 +647,14 @@ applications. @kbd{C-x} means cut (kill), @kbd{C-c} copy, @kbd{C-v}
668paste (yank), and @kbd{C-z} undo. Standard Emacs commands like 647paste (yank), and @kbd{C-z} undo. Standard Emacs commands like
669@kbd{C-x C-c} still work, because @kbd{C-x} and @kbd{C-c} only take 648@kbd{C-x C-c} still work, because @kbd{C-x} and @kbd{C-c} only take
670effect when the mark is active (and the region is highlighted). 649effect when the mark is active (and the region is highlighted).
671However, if you don't want to override these bindings Emacs at all, set 650However, if you don't want to override these bindings in Emacs at all,
672@code{cua-enable-cua-keys} to @code{nil}. 651set @code{cua-enable-cua-keys} to @code{nil}.
673 652
674 In CUA mode, using @kbd{Shift} together with the movement keys 653 In CUA mode, using @kbd{Shift} together with the movement keys
675activates and highlights the region over which they move. The 654activates and highlights the region over which they move. The
676standard (unshifted) movement keys deactivate the mark, and typed text 655standard (unshifted) movement keys deactivate the mark, and typed text
677replaces the active region as in Delete-Selection mode 656replaces the active region as in Delete-Selection mode
678(@pxref{Graphical Kill}). 657(@pxref{Mouse Commands}).
679 658
680 To enter an Emacs command like @kbd{C-x C-f} while the mark is 659 To enter an Emacs command like @kbd{C-x C-f} while the mark is
681active, use one of the following methods: either hold @kbd{Shift} 660active, use one of the following methods: either hold @kbd{Shift}
diff --git a/man/major.texi b/man/major.texi
index d1f3fbaeebf..fe9416aacde 100644
--- a/man/major.texi
+++ b/man/major.texi
@@ -102,17 +102,21 @@ the element has the form @code{(@var{regexp} @var{mode-function}
102@vindex magic-mode-alist 102@vindex magic-mode-alist
103 Sometimes the major mode is determined from the way the file's text 103 Sometimes the major mode is determined from the way the file's text
104begins. The variable @code{magic-mode-alist} controls this. Its value 104begins. The variable @code{magic-mode-alist} controls this. Its value
105is a list of elements of this form: 105is a list of elements of these forms:
106 106
107@example 107@example
108(@var{regexp} . @var{mode-function}) 108(@var{regexp} . @var{mode-function})
109(@var{match-function} . @var{mode-function})
109@end example 110@end example
110 111
111@noindent 112@noindent
112This looks like an element of @code{auto-mode-alist}, but it doesn't work 113The first form looks like an element of @code{auto-mode-alist}, but it
113the same: this @var{regexp} is matched against the text at the start 114doesn't work the same: this @var{regexp} is matched against the text
114of the buffer, not against the file name. @code{magic-mode-alist} 115at the start of the buffer, not against the file name. Likewise, the
115takes priority over @code{auto-mode-alist}. 116second form calls @var{match-function} at the beginning of the buffer,
117and if the function returns non-@code{nil}, the @var{mode-function} is
118called. @code{magic-mode-alist} takes priority over
119@code{auto-mode-alist}.
116 120
117 You can specify the major mode to use for editing a certain file by 121 You can specify the major mode to use for editing a certain file by
118special text in the first nonblank line of the file. The 122special text in the first nonblank line of the file. The
@@ -144,6 +148,14 @@ which allows you to specify local variables as well, like this:
144@noindent 148@noindent
145@xref{File Variables}, for more information about this. 149@xref{File Variables}, for more information about this.
146 150
151@vindex auto-mode-case-fold
152 On systems with case-insensitive file names, only a single
153case-insensitive search through the @code{auto-mode-alist} is made.
154On other systems, Emacs normally performs a single case-sensitive
155search through the alist, but if you set this variable to a
156non-@code{nil} value, Emacs will perform a second case-insensitive
157search if the first search fails.
158
147@vindex interpreter-mode-alist 159@vindex interpreter-mode-alist
148 When a file's contents begin with @samp{#!}, it can serve as an 160 When a file's contents begin with @samp{#!}, it can serve as an
149executable shell command, which works by running an interpreter named on 161executable shell command, which works by running an interpreter named on
diff --git a/man/mark.texi b/man/mark.texi
index e39800ab1b5..7cba4f0d004 100644
--- a/man/mark.texi
+++ b/man/mark.texi
@@ -192,7 +192,7 @@ region active again by typing @kbd{C-x C-x}.
192 192
193@item 193@item
194If Delete Selection mode is also enabled, some commands delete the 194If Delete Selection mode is also enabled, some commands delete the
195region when used while the mark is active. @xref{Graphical Kill}. 195region when used while the mark is active. @xref{Mouse Commands}.
196 196
197@item 197@item
198Quitting with @kbd{C-g} deactivates the mark. 198Quitting with @kbd{C-g} deactivates the mark.
diff --git a/man/msdog.texi b/man/msdog.texi
index d92929ea04e..69126dca207 100644
--- a/man/msdog.texi
+++ b/man/msdog.texi
@@ -173,9 +173,9 @@ default ignores letter-case in file names during completion.
173@vindex w32-get-true-file-attributes 173@vindex w32-get-true-file-attributes
174 If the variable @code{w32-get-true-file-attributes} is 174 If the variable @code{w32-get-true-file-attributes} is
175non-@code{nil} (the default), Emacs tries to determine the accurate 175non-@code{nil} (the default), Emacs tries to determine the accurate
176link counts for files. This option is only useful on the NT family of 176link counts for files. This option is only useful on NTFS volumes,
177Windows (2K/XP/2K3), and it considerably slows down Dired and other 177and it considerably slows down Dired and other features, so use it
178features, so use it only on fast machines. 178only on fast machines.
179 179
180@node ls in Lisp 180@node ls in Lisp
181@section Emulation of @code{ls} on MS-Windows 181@section Emulation of @code{ls} on MS-Windows
@@ -234,10 +234,11 @@ that @file{ls-lisp.el} displays. The value should be a list that
234contains one or more of the symbols @code{links}, @code{uid}, and 234contains one or more of the symbols @code{links}, @code{uid}, and
235@code{gid}. @code{links} means display the count of different file 235@code{gid}. @code{links} means display the count of different file
236names that are associated with (a.k.a.@: @dfn{links to}) the file's 236names that are associated with (a.k.a.@: @dfn{links to}) the file's
237data. @code{uid} means display the numerical identifier of the user 237data; this is only useful on NTFS volumes. @code{uid} means display
238who owns the file. @code{gid} means display the numerical identifier 238the numerical identifier of the user who owns the file. @code{gid}
239of the file owner's group. The default value is @code{(links uid gid)} 239means display the numerical identifier of the file owner's group. The
240i.e.@: all the 3 optional attributes are displayed. 240default value is @code{(links uid gid)} i.e.@: all the 3 optional
241attributes are displayed.
241 242
242@vindex ls-lisp-emulation 243@vindex ls-lisp-emulation
243 The variable @code{ls-lisp-emulation} controls the flavour of the 244 The variable @code{ls-lisp-emulation} controls the flavour of the
@@ -332,6 +333,13 @@ directory, whereas @file{.emacs} does not.
332 This section describes the Windows-specific features related to 333 This section describes the Windows-specific features related to
333keyboard input in Emacs. 334keyboard input in Emacs.
334 335
336@cindex MS-Windows keyboard shortcuts
337 Many key combinations (known as ``keyboard shortcuts'') that are in
338widespread use in MS-Windows programs are taken by various Emacs
339features. Examples include @kbd{C-C}, @kbd{C-X}, @kbd{C-Z},
340@kbd{C-A}, and @kbd{W-SPC}. You can get some of them back by turning
341on CUA Mode (@pxref{CUA Bindings}).
342
335@kindex F10 @r{(MS-Windows)} 343@kindex F10 @r{(MS-Windows)}
336@cindex menu bar access using keyboard @r{(MS-Windows)} 344@cindex menu bar access using keyboard @r{(MS-Windows)}
337 The @key{F10} key on Windows activates the menu bar in a way that 345 The @key{F10} key on Windows activates the menu bar in a way that
@@ -420,16 +428,24 @@ keys are passed to Windows or swallowed by Emacs. If the value is
420otherwise it is passed to Windows. The default is @code{t} for both 428otherwise it is passed to Windows. The default is @code{t} for both
421of these variables. Passing each of these keys to Windows produces 429of these variables. Passing each of these keys to Windows produces
422its normal effect: for example, @kbd{@key{Lwindow}} opens the 430its normal effect: for example, @kbd{@key{Lwindow}} opens the
423@code{Start} menu, etc. 431@code{Start} menu, etc.@footnote{
432Some combinations of the ``Windows'' keys with other keys are caught
433by Windows at low level in a way that Emacs currently cannot prevent.
434For example, @kbd{@key{Lwindow} r} always pops up the Windows
435@samp{Run} dialog. Customizing the value of
436@code{w32-phantom-key-code} might help in some cases, though.}
424 437
425@vindex w32-recognize-altgr 438@vindex w32-recognize-altgr
426@kindex AltGr @r{(MS-Windows)} 439@kindex AltGr @r{(MS-Windows)}
427@cindex AltGr key (MS-Windows) 440@cindex AltGr key (MS-Windows)
428 The variable @code{w32-recognize-altgr} controls whether the right 441 The variable @code{w32-recognize-altgr} controls whether the
429@key{Alt} and left @key{Ctrl} keys are recognized as the @key{AltGr} 442@key{AltGr} key (if it exists on your keyboard), or its equivalent,
430key. The default is @code{t}, which means these keys produce 443the combination of the right @key{Alt} and left @key{Ctrl} keys
431@code{AltGr}; setting them to @code{nil} causes these keys to be 444pressed together, is recognized as the @key{AltGr} key. The default
432interpreted normally (as the respective modifiers). 445is @code{t}, which means these keys produce @code{AltGr}; setting it
446to @code{nil} causes @key{AltGr} or the equivalent key combination to
447be interpreted as the combination of @key{CTRL} and @key{META}
448modifiers.
433@end ifnottex 449@end ifnottex
434 450
435@node Windows Mouse 451@node Windows Mouse
diff --git a/man/pgg.texi b/man/pgg.texi
index 23bcd5cbb1e..af97ddec45d 100644
--- a/man/pgg.texi
+++ b/man/pgg.texi
@@ -74,10 +74,19 @@ PGG requires at least one implementation of privacy guard system.
74This document assumes that you have already obtained and installed them 74This document assumes that you have already obtained and installed them
75and that you are familiar with its basic functions. 75and that you are familiar with its basic functions.
76 76
77By default, PGG uses GnuPG, but Pretty Good Privacy version 2 or version 77By default, PGG uses GnuPG. If you are new to such a system, I
785 are also supported. If you are new to such a system, I recommend that 78recommend that you should look over the GNU Privacy Handbook (GPH)
79you should look over the GNU Privacy Handbook (GPH) which is available 79which is available at @uref{http://www.gnupg.org/documentation/}.
80at @uref{http://www.gnupg.org/gph/}. 80
81When using GnuPG, we recommend the use of the @code{gpg-agent}
82program, which is distributed with versions 2.0 and later of GnuPG.
83This is a daemon to manage private keys independently from any
84protocol, and provides the most secure way to input and cache your
85passphrases (@pxref{Caching passphrase}). By default, PGG will
86attempt to use @code{gpg-agent} if it is running. @xref{Invoking
87GPG-AGENT,,,gnupg,Using the GNU Privacy Guard}.
88
89PGG also supports Pretty Good Privacy version 2 or version 5.
81 90
82@node How to use 91@node How to use
83@chapter How to use 92@chapter How to use
@@ -238,8 +247,8 @@ Elapsed time for expiration in seconds.
238When using GnuPG (gpg) as PGP scheme you can use @code{gpg-agent} for 247When using GnuPG (gpg) as PGP scheme you can use @code{gpg-agent} for
239caching@footnote{Actually @code{gpg-agent} does not cache passphrases 248caching@footnote{Actually @code{gpg-agent} does not cache passphrases
240but private keys. On the other hand, from a users point of view this 249but private keys. On the other hand, from a users point of view this
241technical difference isn't visible.}. If non-@code{nil} try to use a 250technical difference isn't visible.}. It defaults to @code{t}.
242running @code{gpg-agent}. It defaults to @code{nil}. 251Setting this to @code{nil} is not recommended.
243@end defvar 252@end defvar
244 253
245@node Default user identity 254@node Default user identity
diff --git a/man/programs.texi b/man/programs.texi
index fb85e470f86..200c787cf08 100644
--- a/man/programs.texi
+++ b/man/programs.texi
@@ -156,23 +156,11 @@ from Lisp, but in Emacs we use it for all languages.
156@cindex open-parenthesis in leftmost column 156@cindex open-parenthesis in leftmost column
157@cindex ( in leftmost column 157@cindex ( in leftmost column
158 Emacs assumes by default that any opening delimiter found at the 158 Emacs assumes by default that any opening delimiter found at the
159left margin is the start of a top-level definition, or defun. You can 159left margin is the start of a top-level definition, or defun.
160override this default by setting this user option: 160Therefore, @strong{don't put an opening delimiter at the left margin
161 161unless it should have that significance}. For instance, never put an
162@defvar open-paren-in-column-0-is-defun-start
163If this user option is set to @code{t} (the default), opening
164parentheses or braces at column zero always start defuns. When it's
165@code{nil}, defuns are found by searching for parens or braces at the
166outermost level. Some major modes, including C and related modes, set
167@code{open-paren-in-column-0-is-defun-start} buffer-locally to
168@code{nil}
169@end defvar
170
171 In modes where @code{open-paren-in-column-0-is-defun-start} is
172@code{t}, @strong{don't put an opening delimiter at the left margin
173unless it is a defun start}. For instance, never put an
174open-parenthesis at the left margin in a Lisp file unless it is the 162open-parenthesis at the left margin in a Lisp file unless it is the
175start of a top-level list. 163start of a top-level list.
176 164
177 If you don't follow this convention, not only will you have trouble 165 If you don't follow this convention, not only will you have trouble
178when you explicitly use the commands for motion by defuns; other 166when you explicitly use the commands for motion by defuns; other
@@ -182,10 +170,10 @@ mode (@pxref{Font Lock}).
182 170
183 The most likely problem case is when you want an opening delimiter 171 The most likely problem case is when you want an opening delimiter
184at the start of a line inside a string. To avoid trouble, put an 172at the start of a line inside a string. To avoid trouble, put an
185escape character (@samp{\}, in Emacs Lisp, @samp{/} in some other Lisp 173escape character (@samp{\}, in C and Emacs Lisp, @samp{/} in some
186dialects) before the opening delimiter. This will not affect the 174other Lisp dialects) before the opening delimiter. This will not
187contents of the string, but will prevent that opening delimiter from 175affect the contents of the string, but will prevent that opening
188starting a defun. Here's an example: 176delimiter from starting a defun. Here's an example:
189 177
190@example 178@example
191 (insert "Foo: 179 (insert "Foo:
@@ -197,6 +185,25 @@ starting a defun. Here's an example:
197highlights confusing opening delimiters (those that ought to be 185highlights confusing opening delimiters (those that ought to be
198quoted) in bold red. 186quoted) in bold red.
199 187
188If you need to override this convention, you can so by setting this
189user option:
190
191@defvar open-paren-in-column-0-is-defun-start
192If this user option is set to @code{t} (the default), opening
193parentheses or braces at column zero always start defuns. When it's
194@code{nil}, defuns are found by searching for parens or braces at the
195outermost level.
196@end defvar
197
198 Usually, you shouldn't need to set
199@code{open-paren-in-column-0-is-defun-start} to @code{nil}. However,
200if your buffer contains parentheses or braces in column zero which
201don't start defuns and this confuses Emacs, it sometimes helps to set
202the option to @code{nil}. Be aware, though, that this will make
203scrolling and display in large buffers quite sluggish, and that
204parentheses and braces must be correctly matched throughout the buffer
205for it to work properly.
206
200 In the earliest days, the original Emacs found defuns by moving 207 In the earliest days, the original Emacs found defuns by moving
201upward a level of parentheses or braces until there were no more 208upward a level of parentheses or braces until there were no more
202levels to go up. This always required scanning all the way back to 209levels to go up. This always required scanning all the way back to
@@ -1557,10 +1564,10 @@ preprocessor commands.
1557@table @kbd 1564@table @kbd
1558@item C-c C-@key{DEL} 1565@item C-c C-@key{DEL}
1559@itemx C-c @key{DEL} 1566@itemx C-c @key{DEL}
1560@findex c-hungry-backspace 1567@findex c-hungry-delete-backwards
1561@kindex C-c C-@key{DEL} (C Mode) 1568@kindex C-c C-@key{DEL} (C Mode)
1562@kindex C-c @key{DEL} (C Mode) 1569@kindex C-c @key{DEL} (C Mode)
1563@code{c-hungry-backspace}---Delete the entire block of whitespace 1570@code{c-hungry-delete-backwards}---Delete the entire block of whitespace
1564preceding point. 1571preceding point.
1565 1572
1566@item C-c C-d 1573@item C-c C-d
diff --git a/man/search.texi b/man/search.texi
index 67b61aeac07..532d58fb9d8 100644
--- a/man/search.texi
+++ b/man/search.texi
@@ -488,6 +488,13 @@ search can make the cursor move back and start again. For example, if
488you have searched for @samp{foo} and you add @samp{\|bar}, the cursor 488you have searched for @samp{foo} and you add @samp{\|bar}, the cursor
489backs up in case the first @samp{bar} precedes the first @samp{foo}. 489backs up in case the first @samp{bar} precedes the first @samp{foo}.
490 490
491 Forward and backward regexp search are not symmetrical, because
492regexp matching in Emacs always operates forward, starting with the
493beginning of the regexp. Thus, forward regexp search scans forward,
494trying a forward match at each possible starting position. Backward
495regexp search scans backward, trying a forward match at each possible
496starting position. These search methods are not mirror images.
497
491@findex re-search-forward 498@findex re-search-forward
492@findex re-search-backward 499@findex re-search-backward
493 Nonincremental search for a regexp is done by the functions 500 Nonincremental search for a regexp is done by the functions
diff --git a/man/tramp.texi b/man/tramp.texi
index 48d13b67ee3..4a09e2daa3c 100644
--- a/man/tramp.texi
+++ b/man/tramp.texi
@@ -832,6 +832,26 @@ to not print any shell prompt, which confuses @value{tramp} mightily.
832This method supports the @samp{-p} hack. 832This method supports the @samp{-p} hack.
833 833
834 834
835@item @option{scpc} --- @command{ssh} and @command{scp}
836@cindex method scpx
837@cindex scpx method
838@cindex scp (with scpx method)
839@cindex ssh (with scpx method)
840
841Newer versions of @option{ssh} (for example OpenSSH 4) offer an option
842@option{ControlMaster}. This allows @option{scp} to reuse an existing
843@option{ssh} channel, which increases performance.
844
845Before you use this method, you shall check whether your @option{ssh}
846implementation does support this option. Try from the command line
847
848@example
849ssh localhost -o ControlMaster=yes
850@end example
851
852This method supports the @samp{-p} hack.
853
854
835@item @option{pscp} --- @command{plink} and @command{pscp} 855@item @option{pscp} --- @command{plink} and @command{pscp}
836@cindex method pscp 856@cindex method pscp
837@cindex pscp method 857@cindex pscp method
diff --git a/man/trampver.texi b/man/trampver.texi
index bf220f4b195..a7777b00c79 100644
--- a/man/trampver.texi
+++ b/man/trampver.texi
@@ -4,12 +4,12 @@
4@c In the Tramp CVS, the version number is auto-frobbed from 4@c In the Tramp CVS, the version number is auto-frobbed from
5@c configure.ac, so you should edit that file and run 5@c configure.ac, so you should edit that file and run
6@c "autoconf && ./configure" to change the version number. 6@c "autoconf && ./configure" to change the version number.
7@set trampver 2.0.54 7@set trampver 2.0.55
8 8
9@c Other flags from configuration 9@c Other flags from configuration
10@set prefix /usr/local 10@set prefix /usr/local
11@set lispdir /usr/local/share/emacs/site-lisp 11@set lispdir /usr/local/share/emacs/site-lisp
12@set infodir /usr/local/info 12@set infodir /usr/local/share/info
13 13
14@c Formatting of the tramp program name consistent. 14@c Formatting of the tramp program name consistent.
15@set tramp @sc{tramp} 15@set tramp @sc{tramp}
diff --git a/man/xresources.texi b/man/xresources.texi
index e9233df25d5..142b1bc70a0 100644
--- a/man/xresources.texi
+++ b/man/xresources.texi
@@ -11,7 +11,7 @@ can customize some of the same aspects using the system registry.
11@xref{MS-Windows Registry}. Likewise, Emacs on MacOS Carbon emulates X 11@xref{MS-Windows Registry}. Likewise, Emacs on MacOS Carbon emulates X
12resources using the Preferences system. @xref{Mac Environment Variables}. 12resources using the Preferences system. @xref{Mac Environment Variables}.
13 13
14 When Emacs is built using an ``X toolkit'', such as Lucid or 14 When Emacs is built using an ``X toolkit'', such as Lucid or
15LessTif, you need to use X resources to customize the appearance of 15LessTif, you need to use X resources to customize the appearance of
16the widgets, including the menu-bar, scroll-bar, and dialog boxes. 16the widgets, including the menu-bar, scroll-bar, and dialog boxes.
17This is because the libraries that implement these don't provide for 17This is because the libraries that implement these don't provide for
@@ -73,7 +73,7 @@ and their particular meanings. Case distinctions are significant in
73these names. Each resource specification in @file{~/.Xdefaults} 73these names. Each resource specification in @file{~/.Xdefaults}
74states the name of the program and the name of the resource. For 74states the name of the program and the name of the resource. For
75Emacs, the program name is @samp{Emacs}. It looks like this: 75Emacs, the program name is @samp{Emacs}. It looks like this:
76 76
77@example 77@example
78Emacs.borderWidth: 2 78Emacs.borderWidth: 2
79@end example 79@end example
@@ -321,6 +321,9 @@ Number of lines to reserve for the tool bar. A zero value suppresses
321the tool bar. If the value is non-zero and 321the tool bar. If the value is non-zero and
322@code{auto-resize-tool-bars} is non-@code{nil}, the tool bar's size 322@code{auto-resize-tool-bars} is non-@code{nil}, the tool bar's size
323will be changed automatically so that all tool bar items are visible. 323will be changed automatically so that all tool bar items are visible.
324 If the value of @code{auto-resize-tool-bars} is @code{grow-only},
325the tool bar expands automatically, but does not contract automatically.
326To contract the tool bar, you must redraw the frame by entering @kbd{C-l}.
324 327
325@item @code{useXIM} (class @code{UseXIM}) 328@item @code{useXIM} (class @code{UseXIM})
326@cindex XIM 329@cindex XIM
@@ -438,7 +441,7 @@ Emacs.pane.menubar.font: 8x16
438 441
439@noindent 442@noindent
440Resources for @emph{non-menubar} toolkit pop-up menus have 443Resources for @emph{non-menubar} toolkit pop-up menus have
441@samp{menu*} instead of @samp{pane.menubar}. For example, to specify 444@samp{menu*} instead of @samp{pane.menubar}. For example, to specify
442the font @samp{8x16} for the pop-up menu items, write this: 445the font @samp{8x16} for the pop-up menu items, write this:
443 446
444@example 447@example
@@ -701,7 +704,7 @@ the menubar and the scroll bar in Emacs we use:
701widget "Emacs.pane.menubar" style "my_style" 704widget "Emacs.pane.menubar" style "my_style"
702widget "Emacs.pane.emacs.verticalScrollBar" style "my_style" 705widget "Emacs.pane.emacs.verticalScrollBar" style "my_style"
703@end smallexample 706@end smallexample
704 707
705But to avoid having to type it all, wildcards are often used. @samp{*} 708But to avoid having to type it all, wildcards are often used. @samp{*}
706matches zero or more characters and @samp{?} matches one character. So "*" 709matches zero or more characters and @samp{?} matches one character. So "*"
707matches all widgets. 710matches all widgets.