aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGlenn Morris2018-02-28 09:40:40 -0800
committerGlenn Morris2018-02-28 09:40:40 -0800
commit3959892419eff45a7006deceddcc1962fdbcc1c9 (patch)
tree315d0425dad9a5b89a4c881102241fbab9f45c94
parent51537b9e4937d7853647871dc264f0be9412a9fa (diff)
parentfd5023874872dcb559cb7acdca6b019273c9de07 (diff)
downloademacs-3959892419eff45a7006deceddcc1962fdbcc1c9.tar.gz
emacs-3959892419eff45a7006deceddcc1962fdbcc1c9.zip
Merge from origin/emacs-26
fd50238 (origin/emacs-26) * doc/lispref/streams.texi (Output Variable... 769ea57 Use "GTK+" where applicable in the manual 5e69219 Document print-escape-control-characters c00fea9 Merge branch 'emacs-26' of git.savannah.gnu.org:/srv/git/emac... a2ab0d0 * doc/emacs/killing.texi (Rectangles): Don't use @key for cha... 6288c3d * lisp/emulation/viper.el: Unbreak it. bf3535e More fixes in the Emacs manual c87d04e Avoid aborts in 'md5' 9743f48 Mark keys consistently in manuals ce557a9 Remove @key{} markups from @kindex entries in manuals 71243f0 * doc/emacs/display.texi (Standard Faces): Fix markup of inde... 7a069f3 Fix @kindex entries in manuals 6218933 Fix @cindex entries in manuals 57c9f12 Merge branch 'emacs-26' of git.sv.gnu.org:/srv/git/emacs into... e415309 Fix @cindex entries in org.texi 560a23e Document reserved keys 105d085 * doc/misc/ebrowse.texi: Use @key{} for keys. Conflicts: doc/misc/tramp.texi etc/NEWS
-rw-r--r--doc/emacs/basic.texi6
-rw-r--r--doc/emacs/building.texi2
-rw-r--r--doc/emacs/custom.texi2
-rw-r--r--doc/emacs/dired.texi4
-rw-r--r--doc/emacs/display.texi40
-rw-r--r--doc/emacs/emacs.texi4
-rw-r--r--doc/emacs/files.texi4
-rw-r--r--doc/emacs/frames.texi18
-rw-r--r--doc/emacs/help.texi1
-rw-r--r--doc/emacs/killing.texi5
-rw-r--r--doc/emacs/maintaining.texi2
-rw-r--r--doc/emacs/misc.texi2
-rw-r--r--doc/emacs/msdos-xtra.texi6
-rw-r--r--doc/emacs/msdos.texi4
-rw-r--r--doc/emacs/programs.texi16
-rw-r--r--doc/emacs/search.texi10
-rw-r--r--doc/emacs/text.texi16
-rw-r--r--doc/emacs/trouble.texi4
-rw-r--r--doc/emacs/xresources.texi95
-rw-r--r--doc/lispintro/emacs-lisp-intro.texi18
-rw-r--r--doc/lispref/files.texi4
-rw-r--r--doc/lispref/streams.texi8
-rw-r--r--doc/lispref/strings.texi2
-rw-r--r--doc/lispref/text.texi2
-rw-r--r--doc/misc/calc.texi66
-rw-r--r--doc/misc/cc-mode.texi40
-rw-r--r--doc/misc/dired-x.texi2
-rw-r--r--doc/misc/ebrowse.texi6
-rw-r--r--doc/misc/ede.texi32
-rw-r--r--doc/misc/ediff.texi4
-rw-r--r--doc/misc/edt.texi4
-rw-r--r--doc/misc/efaq.texi12
-rw-r--r--doc/misc/eieio.texi6
-rw-r--r--doc/misc/emacs-mime.texi8
-rw-r--r--doc/misc/epa.texi24
-rw-r--r--doc/misc/erc.texi24
-rw-r--r--doc/misc/ert.texi10
-rw-r--r--doc/misc/eshell.texi18
-rw-r--r--doc/misc/eww.texi2
-rw-r--r--doc/misc/forms.texi24
-rw-r--r--doc/misc/gnus-faq.texi36
-rw-r--r--doc/misc/gnus-news.texi2
-rw-r--r--doc/misc/gnus.texi1551
-rw-r--r--doc/misc/htmlfontify.texi6
-rw-r--r--doc/misc/idlwave.texi8
-rw-r--r--doc/misc/ido.texi4
-rw-r--r--doc/misc/mairix-el.texi24
-rw-r--r--doc/misc/message.texi20
-rw-r--r--doc/misc/mh-e.texi164
-rw-r--r--doc/misc/newsticker.texi20
-rw-r--r--doc/misc/org.texi1033
-rw-r--r--doc/misc/pcl-cvs.texi11
-rw-r--r--doc/misc/reftex.texi2
-rw-r--r--doc/misc/sem-user.texi6
-rw-r--r--doc/misc/ses.texi16
-rw-r--r--doc/misc/sieve.texi10
-rw-r--r--doc/misc/smtpmail.texi2
-rw-r--r--doc/misc/speedbar.texi4
-rw-r--r--doc/misc/srecode.texi17
-rw-r--r--doc/misc/vhdl-mode.texi14
-rw-r--r--doc/misc/vip.texi446
-rw-r--r--doc/misc/viper.texi436
-rw-r--r--etc/NEWS.2610
-rw-r--r--lisp/emulation/viper.el2
-rw-r--r--src/fns.c3
65 files changed, 2195 insertions, 2209 deletions
diff --git a/doc/emacs/basic.texi b/doc/emacs/basic.texi
index aa91f0555e1..b9e0ce44046 100644
--- a/doc/emacs/basic.texi
+++ b/doc/emacs/basic.texi
@@ -218,14 +218,14 @@ preserves position within the line, like @kbd{C-n}.
218@item C-a 218@item C-a
219@itemx @key{Home} 219@itemx @key{Home}
220@kindex C-a 220@kindex C-a
221@kindex HOME key 221@kindex HOME
222@findex move-beginning-of-line 222@findex move-beginning-of-line
223Move to the beginning of the line (@code{move-beginning-of-line}). 223Move to the beginning of the line (@code{move-beginning-of-line}).
224 224
225@item C-e 225@item C-e
226@itemx @key{End} 226@itemx @key{End}
227@kindex C-e 227@kindex C-e
228@kindex END key 228@kindex END
229@findex move-end-of-line 229@findex move-end-of-line
230Move to the end of the line (@code{move-end-of-line}). 230Move to the end of the line (@code{move-end-of-line}).
231 231
@@ -277,7 +277,7 @@ On graphical displays, @kbd{C-@key{HOME}} does the same.
277 277
278@item M-> 278@item M->
279@kindex M-> 279@kindex M->
280@kindex C-@key{END} 280@kindex C-END
281@findex end-of-buffer 281@findex end-of-buffer
282Move to the end of the buffer (@code{end-of-buffer}). On graphical 282Move to the end of the buffer (@code{end-of-buffer}). On graphical
283displays, @kbd{C-@key{END}} does the same. 283displays, @kbd{C-@key{END}} does the same.
diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi
index 8e2fdf11370..0697e1b590d 100644
--- a/doc/emacs/building.texi
+++ b/doc/emacs/building.texi
@@ -1499,7 +1499,7 @@ Evaluate all the Emacs Lisp expressions in the buffer.
1499@ifinfo 1499@ifinfo
1500@c This uses 'colon' instead of a literal ':' because Info cannot 1500@c This uses 'colon' instead of a literal ':' because Info cannot
1501@c cope with a ':' in a menu. 1501@c cope with a ':' in a menu.
1502@kindex M-@key{colon} 1502@kindex M-colon
1503@end ifinfo 1503@end ifinfo
1504@ifnotinfo 1504@ifnotinfo
1505@kindex M-: 1505@kindex M-:
diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi
index 59cd57b1e6c..7d90c20a2a9 100644
--- a/doc/emacs/custom.texi
+++ b/doc/emacs/custom.texi
@@ -2162,7 +2162,7 @@ loading of this library, use the option @samp{--no-site-file}.
2162better to put them in @file{default.el}, so that users can more easily 2162better to put them in @file{default.el}, so that users can more easily
2163override them. 2163override them.
2164 2164
2165@cindex site-lisp directories 2165@cindex @file{site-lisp} directories
2166 You can place @file{default.el} and @file{site-start.el} in any of 2166 You can place @file{default.el} and @file{site-start.el} in any of
2167the directories which Emacs searches for Lisp libraries. The variable 2167the directories which Emacs searches for Lisp libraries. The variable
2168@code{load-path} (@pxref{Lisp Libraries}) specifies these directories. 2168@code{load-path} (@pxref{Lisp Libraries}) specifies these directories.
diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi
index 0a6228564f5..01ae91002a3 100644
--- a/doc/emacs/dired.texi
+++ b/doc/emacs/dired.texi
@@ -1370,8 +1370,8 @@ C-c}.
1370 1370
1371@node Image-Dired 1371@node Image-Dired
1372@section Viewing Image Thumbnails in Dired 1372@section Viewing Image Thumbnails in Dired
1373@cindex image-dired mode 1373@cindex @code{image-dired} mode
1374@cindex image-dired 1374@cindex @code{image-dired}
1375 1375
1376 Image-Dired is a facility for browsing image files. It provides viewing 1376 Image-Dired is a facility for browsing image files. It provides viewing
1377the images either as thumbnails or in full size, either inside Emacs 1377the images either as thumbnails or in full size, either inside Emacs
diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi
index 64a1d4b5fa0..312f70e13ba 100644
--- a/doc/emacs/display.texi
+++ b/doc/emacs/display.texi
@@ -526,7 +526,7 @@ frames as if they have a dark background, whereas a value of
526background. 526background.
527 527
528@cindex background color 528@cindex background color
529@cindex default face 529@cindex @code{default face}
530 You can customize a face to alter its attributes, and save those 530 You can customize a face to alter its attributes, and save those
531customizations for future Emacs sessions. @xref{Face Customization}, 531customizations for future Emacs sessions. @xref{Face Customization},
532for details. 532for details.
@@ -535,7 +535,7 @@ for details.
535of its attributes are specified. Its background color is also used as 535of its attributes are specified. Its background color is also used as
536the frame's background color. @xref{Colors}. 536the frame's background color. @xref{Colors}.
537 537
538@cindex cursor face 538@cindex @code{cursor} face
539 Another special face is the @code{cursor} face. On graphical 539 Another special face is the @code{cursor} face. On graphical
540displays, the background color of this face is used to draw the text 540displays, the background color of this face is used to draw the text
541cursor. None of the other attributes of this face have any effect; 541cursor. None of the other attributes of this face have any effect;
@@ -627,10 +627,10 @@ but you should not make it a variable-width font.
627@item fixed-pitch-serif 627@item fixed-pitch-serif
628This face is like @code{fixed-pitch}, except the font has serifs and 628This face is like @code{fixed-pitch}, except the font has serifs and
629looks more like traditional typewriting. 629looks more like traditional typewriting.
630@cindex variable-pitch face 630@cindex @code{variable-pitch} face
631@item variable-pitch 631@item variable-pitch
632This face forces use of a variable-width font. 632This face forces use of a variable-width font.
633@cindex shadow face 633@cindex @code{shadow} face
634@item shadow 634@item shadow
635This face is used for making the text less noticeable than the surrounding 635This face is used for making the text less noticeable than the surrounding
636ordinary text. Usually this can be achieved by using shades of gray in 636ordinary text. Usually this can be achieved by using shades of gray in
@@ -656,8 +656,8 @@ This face is used to highlight lazy matches for Isearch and Query
656Replace (matches other than the current one). 656Replace (matches other than the current one).
657@item region 657@item region
658This face is used for displaying an active region (@pxref{Mark}). 658This face is used for displaying an active region (@pxref{Mark}).
659When Emacs is built with GTK support, its colors are taken from the 659When Emacs is built with GTK+ support, its colors are taken from the
660current GTK theme. 660current GTK+ theme.
661@item secondary-selection 661@item secondary-selection
662This face is used for displaying a secondary X selection (@pxref{Secondary 662This face is used for displaying a secondary X selection (@pxref{Secondary
663Selection}). 663Selection}).
@@ -685,40 +685,40 @@ frame:
685 685
686@table @code 686@table @code
687@item mode-line 687@item mode-line
688@cindex mode-line face 688@cindex @code{mode-line} face
689@cindex faces for mode lines 689@cindex faces for mode lines
690This face is used for the mode line of the currently selected window, 690This face is used for the mode line of the currently selected window,
691and for menu bars when toolkit menus are not used. By default, it's 691and for menu bars when toolkit menus are not used. By default, it's
692drawn with shadows for a raised effect on graphical displays, and 692drawn with shadows for a raised effect on graphical displays, and
693drawn as the inverse of the default face on non-windowed terminals. 693drawn as the inverse of the default face on non-windowed terminals.
694@item mode-line-inactive 694@item mode-line-inactive
695@cindex mode-line-inactive face 695@cindex @code{mode-line-inactive} face
696Like @code{mode-line}, but used for mode lines of the windows other 696Like @code{mode-line}, but used for mode lines of the windows other
697than the selected one (if @code{mode-line-in-non-selected-windows} is 697than the selected one (if @code{mode-line-in-non-selected-windows} is
698non-@code{nil}). This face inherits from @code{mode-line}, so changes 698non-@code{nil}). This face inherits from @code{mode-line}, so changes
699in that face affect mode lines in all windows. 699in that face affect mode lines in all windows.
700@item mode-line-highlight 700@item mode-line-highlight
701@cindex mode-line-highlight face 701@cindex @code{mode-line-highlight} face
702Like @code{highlight}, but used for mouse-sensitive portions of text 702Like @code{highlight}, but used for mouse-sensitive portions of text
703on mode lines. Such portions of text typically pop up tooltips 703on mode lines. Such portions of text typically pop up tooltips
704(@pxref{Tooltips}) when the mouse pointer hovers above them. 704(@pxref{Tooltips}) when the mouse pointer hovers above them.
705@item mode-line-buffer-id 705@item mode-line-buffer-id
706@cindex mode-line-buffer-id face 706@cindex @code{mode-line-buffer-id} face
707This face is used for buffer identification parts in the mode line. 707This face is used for buffer identification parts in the mode line.
708@item header-line 708@item header-line
709@cindex header-line face 709@cindex @code{header-line} face
710Similar to @code{mode-line} for a window's header line, which appears 710Similar to @code{mode-line} for a window's header line, which appears
711at the top of a window just as the mode line appears at the bottom. 711at the top of a window just as the mode line appears at the bottom.
712Most windows do not have a header line---only some special modes, such 712Most windows do not have a header line---only some special modes, such
713Info mode, create one. 713Info mode, create one.
714@item header-line-highlight 714@item header-line-highlight
715@cindex header-line-highlight face 715@cindex @code{header-line-highlight} face
716Similar to @code{highlight} and @code{mode-line-highlight}, but used 716Similar to @code{highlight} and @code{mode-line-highlight}, but used
717for mouse-sensitive portions of text on header lines. This is a 717for mouse-sensitive portions of text on header lines. This is a
718separate face because the @code{header-line} face might be customized 718separate face because the @code{header-line} face might be customized
719in a way that does not interact well with @code{highlight}. 719in a way that does not interact well with @code{highlight}.
720@item vertical-border 720@item vertical-border
721@cindex vertical-border face 721@cindex @code{vertical-border} face
722This face is used for the vertical divider between windows on text 722This face is used for the vertical divider between windows on text
723terminals. 723terminals.
724@item minibuffer-prompt 724@item minibuffer-prompt
@@ -741,7 +741,7 @@ The @code{:background} attribute of this face specifies the color of
741the text cursor. @xref{Cursor Display}. 741the text cursor. @xref{Cursor Display}.
742@item tooltip 742@item tooltip
743This face is used for tooltip text. By default, if Emacs is built 743This face is used for tooltip text. By default, if Emacs is built
744with GTK support, tooltips are drawn via GTK and this face has no 744with GTK+ support, tooltips are drawn via GTK+ and this face has no
745effect. @xref{Tooltips}. 745effect. @xref{Tooltips}.
746@item mouse 746@item mouse
747This face determines the color of the mouse pointer. 747This face determines the color of the mouse pointer.
@@ -1177,7 +1177,7 @@ empty lines at the end of a buffer, without realizing it. In most
1177cases, this @dfn{trailing whitespace} has no effect, but sometimes it 1177cases, this @dfn{trailing whitespace} has no effect, but sometimes it
1178can be a nuisance. 1178can be a nuisance.
1179 1179
1180@cindex trailing-whitespace face 1180@cindex @code{trailing-whitespace} face
1181 You can make trailing whitespace at the end of a line visible by 1181 You can make trailing whitespace at the end of a line visible by
1182setting the buffer-local variable @code{show-trailing-whitespace} to 1182setting the buffer-local variable @code{show-trailing-whitespace} to
1183@code{t}. Then Emacs displays trailing whitespace, using the face 1183@code{t}. Then Emacs displays trailing whitespace, using the face
@@ -1508,8 +1508,8 @@ as octal escape sequences instead of caret escape sequences.
1508@cindex non-breaking space 1508@cindex non-breaking space
1509@cindex non-breaking hyphen 1509@cindex non-breaking hyphen
1510@cindex soft hyphen 1510@cindex soft hyphen
1511@cindex escape-glyph face 1511@cindex @code{escape-glyph} face
1512@cindex nobreak-space face 1512@cindex @code{nobreak-space} face
1513 Some non-@acronym{ASCII} characters have the same appearance as an 1513 Some non-@acronym{ASCII} characters have the same appearance as an
1514@acronym{ASCII} space or hyphen (minus) character. Such characters 1514@acronym{ASCII} space or hyphen (minus) character. Such characters
1515can cause problems if they are entered into a buffer without your 1515can cause problems if they are entered into a buffer without your
@@ -1531,7 +1531,7 @@ elisp, The Emacs Lisp Reference Manual}.
1531 1531
1532@cindex glyphless characters 1532@cindex glyphless characters
1533@cindex characters with no font glyphs 1533@cindex characters with no font glyphs
1534@cindex glyphless-char face 1534@cindex @code{glyphless-char} face
1535 On graphical displays, some characters may have no glyphs in any of 1535 On graphical displays, some characters may have no glyphs in any of
1536the fonts available to Emacs. These @dfn{glyphless characters} are 1536the fonts available to Emacs. These @dfn{glyphless characters} are
1537normally displayed as boxes containing the hexadecimal character code. 1537normally displayed as boxes containing the hexadecimal character code.
@@ -1546,7 +1546,7 @@ for details.
1546 1546
1547@cindex curly quotes, and terminal capabilities 1547@cindex curly quotes, and terminal capabilities
1548@cindex curved quotes, and terminal capabilities 1548@cindex curved quotes, and terminal capabilities
1549@cindex homoglyph face 1549@cindex @code{homoglyph} face
1550 1550
1551Emacs tries to determine if the curved quotes @samp{‘} and @samp{’} 1551Emacs tries to determine if the curved quotes @samp{‘} and @samp{’}
1552can be displayed on the current display. By default, if this seems to 1552can be displayed on the current display. By default, if this seems to
@@ -1801,7 +1801,7 @@ may wish to customize the variables
1801@code{display-line-numbers-width} to a large enough value, to avoid 1801@code{display-line-numbers-width} to a large enough value, to avoid
1802occasional miscalculations of space reserved for the line numbers. 1802occasional miscalculations of space reserved for the line numbers.
1803 1803
1804@cindex line-number face 1804@cindex @code{line-number} face
1805The line numbers are displayed in a special face @code{line-number}. 1805The line numbers are displayed in a special face @code{line-number}.
1806The current line number is displayed in a different face, 1806The current line number is displayed in a different face,
1807@code{line-number-current-line}, so you can make the current line's 1807@code{line-number-current-line}, so you can make the current line's
diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi
index 65affeb59fe..f917fa8e1e9 100644
--- a/doc/emacs/emacs.texi
+++ b/doc/emacs/emacs.texi
@@ -1223,8 +1223,8 @@ GTK resources
1223 1223
1224* GTK Resource Basics:: Basic usage of GTK+ resources. 1224* GTK Resource Basics:: Basic usage of GTK+ resources.
1225* GTK Widget Names:: How GTK+ widgets are named. 1225* GTK Widget Names:: How GTK+ widgets are named.
1226* GTK Names in Emacs:: GTK widgets used by Emacs. 1226* GTK Names in Emacs:: GTK+ widgets used by Emacs.
1227* GTK styles:: What can be customized in a GTK widget. 1227* GTK styles:: What can be customized in a GTK+ widget.
1228 1228
1229Emacs and macOS / GNUstep 1229Emacs and macOS / GNUstep
1230 1230
diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index bd772e9abc1..fd35096f965 100644
--- a/doc/emacs/files.texi
+++ b/doc/emacs/files.texi
@@ -281,7 +281,7 @@ files. Firstly, when Emacs is built with a suitable GUI toolkit,
281commands invoked with the mouse (by clicking on the menu bar or tool 281commands invoked with the mouse (by clicking on the menu bar or tool
282bar) use the toolkit's standard file selection dialog instead of 282bar) use the toolkit's standard file selection dialog instead of
283prompting for the file name in the minibuffer. On GNU/Linux and Unix 283prompting for the file name in the minibuffer. On GNU/Linux and Unix
284platforms, Emacs does this when built with GTK, LessTif, and Motif 284platforms, Emacs does this when built with GTK+, LessTif, and Motif
285toolkits; on MS-Windows and Mac, the GUI version does that by default. 285toolkits; on MS-Windows and Mac, the GUI version does that by default.
286For information on how to customize this, see @ref{Dialog Boxes}. 286For information on how to customize this, see @ref{Dialog Boxes}.
287 287
@@ -1857,7 +1857,7 @@ variable @code{tramp-mode} to @code{nil}. You can turn off the
1857feature in individual cases by quoting the file name with @samp{/:} 1857feature in individual cases by quoting the file name with @samp{/:}
1858(@pxref{Quoted File Names}). 1858(@pxref{Quoted File Names}).
1859 1859
1860@cindex ange-ftp 1860@cindex @code{ange-ftp}
1861 Remote file access through FTP is handled by the Ange-FTP package, which 1861 Remote file access through FTP is handled by the Ange-FTP package, which
1862is documented in the following. Remote file access through the other 1862is documented in the following. Remote file access through the other
1863methods is handled by the Tramp package, which has its own manual. 1863methods is handled by the Tramp package, which has its own manual.
diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi
index b2ec5746a0e..17f6f35a8a3 100644
--- a/doc/emacs/frames.texi
+++ b/doc/emacs/frames.texi
@@ -479,14 +479,14 @@ cycles through all the frames on your terminal.
479@findex delete-other-frames 479@findex delete-other-frames
480Delete all frames on the current terminal, except the selected one. 480Delete all frames on the current terminal, except the selected one.
481 481
482@item M-<F10> 482@item M-@key{F10}
483@kindex M-<F10> 483@kindex M-F10
484@findex toggle-frame-maximized 484@findex toggle-frame-maximized
485Toggle the maximization state of the current frame. When a frame is 485Toggle the maximization state of the current frame. When a frame is
486maximized, it fills the screen. 486maximized, it fills the screen.
487 487
488@item <F11> 488@item @key{F11>}
489@kindex <F11> 489@kindex F11
490@findex toggle-frame-fullscreen 490@findex toggle-frame-fullscreen
491Toggle full-screen mode for the current frame. (The difference 491Toggle full-screen mode for the current frame. (The difference
492between full-screen and maximized is normally that the former 492between full-screen and maximized is normally that the former
@@ -901,7 +901,7 @@ that server's selected frame.
901 901
902@node Frame Parameters 902@node Frame Parameters
903@section Frame Parameters 903@section Frame Parameters
904@cindex default-frame-alist 904@vindex default-frame-alist
905 905
906 You can control the default appearance and behavior of all frames by 906 You can control the default appearance and behavior of all frames by
907specifying a default list of @dfn{frame parameters} in the variable 907specifying a default list of @dfn{frame parameters} in the variable
@@ -925,7 +925,7 @@ default font to @samp{Monospace-10}:
925 For a list of frame parameters and their effects, see @ref{Frame 925 For a list of frame parameters and their effects, see @ref{Frame
926Parameters,,, elisp, The Emacs Lisp Reference Manual}. 926Parameters,,, elisp, The Emacs Lisp Reference Manual}.
927 927
928@cindex initial-frame-alist 928@vindex initial-frame-alist
929 You can also specify a list of frame parameters which apply to just 929 You can also specify a list of frame parameters which apply to just
930the initial frame, by customizing the variable 930the initial frame, by customizing the variable
931@code{initial-frame-alist}. 931@code{initial-frame-alist}.
@@ -999,11 +999,11 @@ end of the buffer is shown; if @code{nil}, the thumb will be at the
999bottom when the end of the buffer is shown. You cannot over-scroll 999bottom when the end of the buffer is shown. You cannot over-scroll
1000when the entire buffer is visible. 1000when the entire buffer is visible.
1001 1001
1002@cindex scroll-bar face 1002@cindex @code{scroll-bar} face
1003 The visual appearance of the scroll bars is controlled by the 1003 The visual appearance of the scroll bars is controlled by the
1004@code{scroll-bar} face. (Some toolkits, such as GTK and MS-Windows, 1004@code{scroll-bar} face. (Some toolkits, such as GTK+ and MS-Windows,
1005ignore this face; the scroll-bar appearance there can only be 1005ignore this face; the scroll-bar appearance there can only be
1006customized system-wide, for GTK @pxref{GTK resources}). 1006customized system-wide, for GTK+ @pxref{GTK resources}).
1007 1007
1008@cindex vertical border 1008@cindex vertical border
1009 On graphical frames, vertical scroll bars implicitly serve to separate 1009 On graphical frames, vertical scroll bars implicitly serve to separate
diff --git a/doc/emacs/help.texi b/doc/emacs/help.texi
index e005fe358da..a5700760d44 100644
--- a/doc/emacs/help.texi
+++ b/doc/emacs/help.texi
@@ -4,7 +4,6 @@
4@c See file emacs.texi for copying conditions. 4@c See file emacs.texi for copying conditions.
5@node Help 5@node Help
6@chapter Help 6@chapter Help
7@kindex Help
8@cindex help 7@cindex help
9@cindex self-documentation 8@cindex self-documentation
10@findex help-command 9@findex help-command
diff --git a/doc/emacs/killing.texi b/doc/emacs/killing.texi
index 19aa9077d70..4c47c8b0479 100644
--- a/doc/emacs/killing.texi
+++ b/doc/emacs/killing.texi
@@ -590,7 +590,7 @@ you can access it using the following Emacs commands:
590@table @kbd 590@table @kbd
591@findex mouse-set-secondary 591@findex mouse-set-secondary
592@kindex M-Drag-mouse-1 592@kindex M-Drag-mouse-1
593@cindex secondary-selection face 593@cindex @code{secondary-selection} face
594@item M-Drag-mouse-1 594@item M-Drag-mouse-1
595Set the secondary selection, with one end at the place where you press 595Set the secondary selection, with one end at the place where you press
596down the button, and the other end at the place where you release it 596down the button, and the other end at the place where you release it
@@ -857,7 +857,8 @@ region is active.
857 857
858Unlike the standard region, the region-rectangle can have its corners 858Unlike the standard region, the region-rectangle can have its corners
859extended past the end of buffer, or inside stretches of white space 859extended past the end of buffer, or inside stretches of white space
860that point normally cannot enter, like the TAB. 860that point normally cannot enter, like in the middle of a TAB
861character.
861 862
862@findex rectangle-exchange-point-and-mark 863@findex rectangle-exchange-point-and-mark
863@findex exchange-point-and-mark@r{, in rectangle-mark-mode} 864@findex exchange-point-and-mark@r{, in rectangle-mark-mode}
diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index 23e08a58e88..8f71b12b81f 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -628,7 +628,7 @@ they use the concept of checking out individual files.
628@node Log Buffer 628@node Log Buffer
629@subsection Features of the Log Entry Buffer 629@subsection Features of the Log Entry Buffer
630 630
631@cindex C-c C-c @r{(Log Edit mode)} 631@kindex C-c C-c @r{(Log Edit mode)}
632@findex log-edit-done 632@findex log-edit-done
633 When you tell VC to commit a change, it pops up a buffer named 633 When you tell VC to commit a change, it pops up a buffer named
634@file{*vc-log*}. In this buffer, you should write a @dfn{log entry} 634@file{*vc-log*}. In this buffer, you should write a @dfn{log entry}
diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi
index d8f202f6845..e1b8070f432 100644
--- a/doc/emacs/misc.texi
+++ b/doc/emacs/misc.texi
@@ -409,7 +409,7 @@ is needed. For OpenDocument and Microsoft Office documents, the
409@code{unoconv} tool is needed.}, and displaying those images. 409@code{unoconv} tool is needed.}, and displaying those images.
410 410
411@findex doc-view-toggle-display 411@findex doc-view-toggle-display
412@cindex doc-view-minor-mode 412@findex doc-view-minor-mode
413 When you visit a document file that can be displayed with DocView 413 When you visit a document file that can be displayed with DocView
414mode, Emacs automatically uses DocView mode @footnote{The needed 414mode, Emacs automatically uses DocView mode @footnote{The needed
415external tools for the document type must be available, and Emacs must 415external tools for the document type must be available, and Emacs must
diff --git a/doc/emacs/msdos-xtra.texi b/doc/emacs/msdos-xtra.texi
index 39d003c453c..406ebd19051 100644
--- a/doc/emacs/msdos-xtra.texi
+++ b/doc/emacs/msdos-xtra.texi
@@ -412,7 +412,7 @@ will print the region while converting it to the codepage 850 encoding.
412 412
413@node MS-DOS and MULE 413@node MS-DOS and MULE
414@subsection International Support on MS-DOS 414@subsection International Support on MS-DOS
415@cindex international support @r{(MS-DOS)} 415@cindex international support (MS-DOS)
416 416
417 Emacs on MS-DOS supports the same international character sets as it 417 Emacs on MS-DOS supports the same international character sets as it
418does on GNU, Unix and other platforms 418does on GNU, Unix and other platforms
@@ -471,7 +471,7 @@ codepage built into the display hardware.) You can specify a different
471codepage for Emacs to use by setting the variable @code{dos-codepage} in 471codepage for Emacs to use by setting the variable @code{dos-codepage} in
472your init file. 472your init file.
473 473
474@cindex language environment, automatic selection on @r{MS-DOS} 474@cindex language environment, automatic selection on MS-DOS
475 Multibyte Emacs supports only certain DOS codepages: those which can 475 Multibyte Emacs supports only certain DOS codepages: those which can
476display Far-Eastern scripts, like the Japanese codepage 932, and those 476display Far-Eastern scripts, like the Japanese codepage 932, and those
477that encode a single ISO 8859 character set. 477that encode a single ISO 8859 character set.
@@ -494,7 +494,7 @@ codes. For example, the letter @samp{@,{c}} (@samp{c} with cedilla) has
494code 231 in the standard Latin-1 character set, but the corresponding 494code 231 in the standard Latin-1 character set, but the corresponding
495DOS codepage 850 uses code 135 for this glyph.} 495DOS codepage 850 uses code 135 for this glyph.}
496 496
497@cindex mode line @r{(MS-DOS)} 497@cindex mode line (MS-DOS)
498 All the @code{cp@var{nnn}} coding systems use the letter @samp{D} 498 All the @code{cp@var{nnn}} coding systems use the letter @samp{D}
499(for ``DOS'') as their mode-line mnemonic. Since both the terminal 499(for ``DOS'') as their mode-line mnemonic. Since both the terminal
500coding system and the default coding system for file I/O are set to 500coding system and the default coding system for file I/O are set to
diff --git a/doc/emacs/msdos.texi b/doc/emacs/msdos.texi
index 2790d56e01c..b3b40d476e6 100644
--- a/doc/emacs/msdos.texi
+++ b/doc/emacs/msdos.texi
@@ -129,7 +129,7 @@ invoked---that will always give you an editor. When invoked via
129the program that invoked @command{emacsclient}. 129the program that invoked @command{emacsclient}.
130@end enumerate 130@end enumerate
131 131
132@cindex emacsclient, on MS-Windows 132@cindex @command{emacsclient}, on MS-Windows
133Note that, due to limitations of MS-Windows, Emacs cannot have both 133Note that, due to limitations of MS-Windows, Emacs cannot have both
134GUI and text-mode frames in the same session. It also cannot open 134GUI and text-mode frames in the same session. It also cannot open
135text-mode frames on more than a single @dfn{Command Prompt} window, 135text-mode frames on more than a single @dfn{Command Prompt} window,
@@ -694,7 +694,7 @@ its normal effect: for example, @kbd{@key{Lwindow}} opens the
694 694
695@vindex w32-recognize-altgr 695@vindex w32-recognize-altgr
696@kindex AltGr @r{(MS-Windows)} 696@kindex AltGr @r{(MS-Windows)}
697@cindex AltGr key (MS-Windows) 697@cindex @key{AltGr} key (MS-Windows)
698 The variable @code{w32-recognize-altgr} controls whether the 698 The variable @code{w32-recognize-altgr} controls whether the
699@key{AltGr} key (if it exists on your keyboard), or its equivalent, 699@key{AltGr} key (if it exists on your keyboard), or its equivalent,
700the combination of the right @key{Alt} and left @key{Ctrl} keys 700the combination of the right @key{Alt} and left @key{Ctrl} keys
diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi
index 042a197f9b7..74fae2a8bb5 100644
--- a/doc/emacs/programs.texi
+++ b/doc/emacs/programs.texi
@@ -1009,7 +1009,7 @@ effect as @kbd{C-u M-;} by typing @kbd{M-x comment-kill}
1009(@code{comment-dwim} actually calls @code{comment-kill} as a 1009(@code{comment-dwim} actually calls @code{comment-kill} as a
1010subroutine when it is given a prefix argument). 1010subroutine when it is given a prefix argument).
1011 1011
1012@kindex C-c C-c (C mode) 1012@kindex C-c C-c @r{(C mode)}
1013@findex comment-region 1013@findex comment-region
1014@findex uncomment-region 1014@findex uncomment-region
1015 The command @kbd{M-x comment-region} is equivalent to calling 1015 The command @kbd{M-x comment-region} is equivalent to calling
@@ -1626,7 +1626,7 @@ behind. A prefix argument acts as a repeat count. With a negative
1626argument, move backward. 1626argument, move backward.
1627 1627
1628@item M-a 1628@item M-a
1629@kindex M-a (C mode) 1629@kindex M-a @r{(C mode)}
1630@findex c-beginning-of-statement 1630@findex c-beginning-of-statement
1631Move point to the beginning of the innermost C statement 1631Move point to the beginning of the innermost C statement
1632(@code{c-beginning-of-statement}). If point is already at the beginning 1632(@code{c-beginning-of-statement}). If point is already at the beginning
@@ -1637,7 +1637,7 @@ In comments or in strings which span more than one line, this command
1637moves by sentences instead of statements. 1637moves by sentences instead of statements.
1638 1638
1639@item M-e 1639@item M-e
1640@kindex M-e (C mode) 1640@kindex M-e @r{(C mode)}
1641@findex c-end-of-statement 1641@findex c-end-of-statement
1642Move point to the end of the innermost C statement or sentence; like 1642Move point to the end of the innermost C statement or sentence; like
1643@kbd{M-a} except that it moves in the other direction 1643@kbd{M-a} except that it moves in the other direction
@@ -1702,17 +1702,17 @@ preprocessor commands.
1702@item C-c C-@key{DEL} 1702@item C-c C-@key{DEL}
1703@itemx C-c @key{DEL} 1703@itemx C-c @key{DEL}
1704@findex c-hungry-delete-backwards 1704@findex c-hungry-delete-backwards
1705@kindex C-c C-DEL (C Mode) 1705@kindex C-c C-DEL @r{(C Mode)}
1706@kindex C-c DEL (C Mode) 1706@kindex C-c DEL @r{(C Mode)}
1707Delete the entire block of whitespace preceding point (@code{c-hungry-delete-backwards}). 1707Delete the entire block of whitespace preceding point (@code{c-hungry-delete-backwards}).
1708 1708
1709@item C-c C-d 1709@item C-c C-d
1710@itemx C-c C-@key{Delete} 1710@itemx C-c C-@key{Delete}
1711@itemx C-c @key{Delete} 1711@itemx C-c @key{Delete}
1712@findex c-hungry-delete-forward 1712@findex c-hungry-delete-forward
1713@kindex C-c C-d (C Mode) 1713@kindex C-c C-d @r{(C Mode)}
1714@kindex C-c C-Delete (C Mode) 1714@kindex C-c C-Delete @r{(C Mode)}
1715@kindex C-c Delete (C Mode) 1715@kindex C-c Delete @r{(C Mode)}
1716Delete the entire block of whitespace after point (@code{c-hungry-delete-forward}). 1716Delete the entire block of whitespace after point (@code{c-hungry-delete-forward}).
1717@end table 1717@end table
1718 1718
diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi
index 9d7ff59beef..887fd982d01 100644
--- a/doc/emacs/search.texi
+++ b/doc/emacs/search.texi
@@ -92,7 +92,7 @@ the first @samp{F} previously found. After another @kbd{O}, the
92cursor moves to just after the first @samp{FOO}. 92cursor moves to just after the first @samp{FOO}.
93 93
94@cindex faces for highlighting search matches 94@cindex faces for highlighting search matches
95@cindex isearch face 95@cindex @code{isearch} face
96 At each step, Emacs highlights the @dfn{current match}---the buffer 96 At each step, Emacs highlights the @dfn{current match}---the buffer
97text that matches the search string---using the @code{isearch} face 97text that matches the search string---using the @code{isearch} face
98(@pxref{Faces}). @xref{Search Customizations}, for various options 98(@pxref{Faces}). @xref{Search Customizations}, for various options
@@ -280,7 +280,7 @@ down-casing.
280@node Error in Isearch 280@node Error in Isearch
281@subsection Errors in Incremental Search 281@subsection Errors in Incremental Search
282 282
283@cindex isearch-fail face 283@cindex @code{isearch-fail} face
284 If your string is not found at all, the echo area says @samp{Failing 284 If your string is not found at all, the echo area says @samp{Failing
285I-Search}, and the cursor moves past the place where Emacs found as 285I-Search}, and the cursor moves past the place where Emacs found as
286much of your string as it could. Thus, if you search for @samp{FOOT}, 286much of your string as it could. Thus, if you search for @samp{FOOT},
@@ -1552,8 +1552,8 @@ replacements are not added to the command history, and cannot be
1552reused. 1552reused.
1553 1553
1554@cindex faces for highlighting query replace 1554@cindex faces for highlighting query replace
1555@cindex query-replace face 1555@cindex @code{query-replace} face
1556@cindex lazy-highlight face, in replace 1556@cindex @code{lazy-highlight} face, in replace
1557@vindex query-replace-highlight 1557@vindex query-replace-highlight
1558@vindex query-replace-lazy-highlight 1558@vindex query-replace-lazy-highlight
1559@vindex query-replace-show-replacement 1559@vindex query-replace-show-replacement
@@ -1869,7 +1869,7 @@ setting the variable @code{search-highlight} to @code{nil}.
1869 1869
1870@cindex lazy highlighting customizations 1870@cindex lazy highlighting customizations
1871@vindex isearch-lazy-highlight 1871@vindex isearch-lazy-highlight
1872@cindex lazy-highlight face 1872@cindex @code{lazy-highlight} face
1873 The other matches for the search string that are visible on display 1873 The other matches for the search string that are visible on display
1874are highlighted using the @code{lazy-highlight} face. Setting the 1874are highlighted using the @code{lazy-highlight} face. Setting the
1875variable @code{isearch-lazy-highlight} to @code{nil} disables this 1875variable @code{isearch-lazy-highlight} to @code{nil} disables this
diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi
index d32bb3c7689..9ecc41e8880 100644
--- a/doc/emacs/text.texi
+++ b/doc/emacs/text.texi
@@ -1380,19 +1380,19 @@ buffer cycles the visibility of the entire outline structure, between
1380(i) showing only top-level heading lines, (ii) showing all heading 1380(i) showing only top-level heading lines, (ii) showing all heading
1381lines but no body lines, and (iii) showing everything. 1381lines but no body lines, and (iii) showing everything.
1382 1382
1383@kindex M-<up> @r{(Org Mode)} 1383@kindex M-UP @r{(Org Mode)}
1384@kindex M-<down> @r{(Org Mode)} 1384@kindex M-DOWN @r{(Org Mode)}
1385@kindex M-<left> @r{(Org Mode)} 1385@kindex M-LEFT @r{(Org Mode)}
1386@kindex M-<right> @r{(Org Mode)} 1386@kindex M-RIGHT @r{(Org Mode)}
1387@findex org-metaup 1387@findex org-metaup
1388@findex org-metadown 1388@findex org-metadown
1389@findex org-metaleft 1389@findex org-metaleft
1390@findex org-metaright 1390@findex org-metaright
1391 You can move an entire entry up or down in the buffer, including its 1391 You can move an entire entry up or down in the buffer, including its
1392body lines and subtree (if any), by typing @kbd{M-<up>} 1392body lines and subtree (if any), by typing @kbd{M-@key{UP}}
1393(@code{org-metaup}) or @kbd{M-<down>} (@code{org-metadown}) on the 1393(@code{org-metaup}) or @kbd{M-@key{DOWN}} (@code{org-metadown}) on the
1394heading line. Similarly, you can promote or demote a heading line 1394heading line. Similarly, you can promote or demote a heading line
1395with @kbd{M-<left>} (@code{org-metaleft}) and @kbd{M-<right>} 1395with @kbd{M-@key{LEFT}} (@code{org-metaleft}) and @kbd{M-@key{RIGHT}}
1396(@code{org-metaright}). These commands execute their global bindings 1396(@code{org-metaright}). These commands execute their global bindings
1397if invoked on a body line. 1397if invoked on a body line.
1398 1398
@@ -2175,7 +2175,7 @@ text properties.
2175@cindex soft newline 2175@cindex soft newline
2176@cindex newlines, hard and soft 2176@cindex newlines, hard and soft
2177 2177
2178@cindex use-hard-newlines 2178@findex use-hard-newlines
2179 In Enriched mode, Emacs distinguishes between two different kinds of 2179 In Enriched mode, Emacs distinguishes between two different kinds of
2180newlines, @dfn{hard} newlines and @dfn{soft} newlines. You can also 2180newlines, @dfn{hard} newlines and @dfn{soft} newlines. You can also
2181enable or disable this feature in other buffers, by typing @kbd{M-x 2181enable or disable this feature in other buffers, by typing @kbd{M-x
diff --git a/doc/emacs/trouble.texi b/doc/emacs/trouble.texi
index 9712cc73de0..c0dc3d472e3 100644
--- a/doc/emacs/trouble.texi
+++ b/doc/emacs/trouble.texi
@@ -1411,8 +1411,8 @@ patches) over all your contributions.
1411@node Service 1411@node Service
1412@section How To Get Help with GNU Emacs 1412@section How To Get Help with GNU Emacs
1413@cindex help in using Emacs 1413@cindex help in using Emacs
1414@cindex help-gnu-emacs mailing list 1414@cindex @samp{help-gnu-emacs} mailing list
1415@cindex gnu.emacs.help newsgroup 1415@cindex @samp{gnu.emacs.help} newsgroup
1416 1416
1417If you need help installing, using or changing GNU Emacs, there are 1417If you need help installing, using or changing GNU Emacs, there are
1418two ways to find it: 1418two ways to find it:
diff --git a/doc/emacs/xresources.texi b/doc/emacs/xresources.texi
index 096e747a044..88bfb8261ce 100644
--- a/doc/emacs/xresources.texi
+++ b/doc/emacs/xresources.texi
@@ -12,10 +12,10 @@ resources, as is usual for programs that use X.
12graphical widgets, such as the menu-bar, scroll-bar, and dialog boxes, 12graphical widgets, such as the menu-bar, scroll-bar, and dialog boxes,
13is determined by 13is determined by
14@ifnottex 14@ifnottex
15GTK resources, which we will also describe. 15GTK+ resources, which we will also describe.
16@end ifnottex 16@end ifnottex
17@iftex 17@iftex
18GTK resources. 18GTK+ resources.
19@end iftex 19@end iftex
20When Emacs is built without GTK+ support, the appearance of these 20When Emacs is built without GTK+ support, the appearance of these
21widgets is determined by additional X resources. 21widgets is determined by additional X resources.
@@ -28,7 +28,7 @@ system registry (@pxref{MS-Windows Registry}).
28* Table of Resources:: Table of specific X resources that affect Emacs. 28* Table of Resources:: Table of specific X resources that affect Emacs.
29* Lucid Resources:: X resources for Lucid menus. 29* Lucid Resources:: X resources for Lucid menus.
30* Motif Resources:: X resources for Motif and LessTif menus. 30* Motif Resources:: X resources for Motif and LessTif menus.
31* GTK resources:: Resources for GTK widgets. 31* GTK resources:: Resources for GTK+ widgets.
32@end menu 32@end menu
33 33
34@node Resources 34@node Resources
@@ -160,16 +160,16 @@ Width of the frame's external border, in pixels. This has no effect
160if Emacs is compiled with GTK+ support. 160if Emacs is compiled with GTK+ support.
161@end ifnottex 161@end ifnottex
162 162
163@item @code{cursorColor} (class @code{Foreground})
164Text cursor color. If this resource is specified when Emacs starts
165up, Emacs sets its value as the background color of the @code{cursor}
166face (@pxref{Faces}).
167
168@item @code{cursorBlink} (class @code{CursorBlink}) 163@item @code{cursorBlink} (class @code{CursorBlink})
169If the value of this resource is @samp{off} or @samp{false} or 164If the value of this resource is @samp{off} or @samp{false} or
170@samp{0} at startup, Emacs disables Blink Cursor mode (@pxref{Cursor 165@samp{0} at startup, Emacs disables Blink Cursor mode (@pxref{Cursor
171Display}). 166Display}).
172 167
168@item @code{cursorColor} (class @code{Foreground})
169Text cursor color. If this resource is specified when Emacs starts
170up, Emacs sets its value as the background color of the @code{cursor}
171face (@pxref{Faces}).
172
173@item @code{font} (class @code{Font}) 173@item @code{font} (class @code{Font})
174Font name for the @code{default} face (@pxref{Fonts}). You can also 174Font name for the @code{default} face (@pxref{Fonts}). You can also
175specify a fontset name (@pxref{Fontsets}). 175specify a fontset name (@pxref{Fontsets}).
@@ -184,6 +184,13 @@ in which case Emacs tries using all available font backends.
184@item @code{foreground} (class @code{Foreground}) 184@item @code{foreground} (class @code{Foreground})
185Default foreground color for text. 185Default foreground color for text.
186 186
187@item @code{fullscreen} (class @code{Fullscreen})
188The desired fullscreen size. The value can be one of @code{fullboth},
189@code{maximized}, @code{fullwidth} or @code{fullheight}, which
190correspond to the command-line options @samp{-fs}, @samp{-mm},
191@samp{-fw}, and @samp{-fh} (@pxref{Window Size X}). Note that this
192applies to the initial frame only.
193
187@item @code{geometry} (class @code{Geometry}) 194@item @code{geometry} (class @code{Geometry})
188Window size and position. The value should be a size and position 195Window size and position. The value should be a size and position
189specification, of the same form as in the @samp{-g} or 196specification, of the same form as in the @samp{-g} or
@@ -193,18 +200,15 @@ The size applies to all frames in the Emacs session, but the position
193applies only to the initial Emacs frame (or, in the case of a resource 200applies only to the initial Emacs frame (or, in the case of a resource
194for a specific frame name, only that frame). 201for a specific frame name, only that frame).
195 202
196
197Be careful not to specify this resource as @samp{emacs*geometry}, as 203Be careful not to specify this resource as @samp{emacs*geometry}, as
198that may affect individual menus as well as the main Emacs frame. 204that may affect individual menus as well as the main Emacs frame.
199 205
200@item @code{fullscreen} (class @code{Fullscreen})
201The desired fullscreen size. The value can be one of @code{fullboth},
202@code{maximized}, @code{fullwidth} or @code{fullheight}, which
203correspond to the command-line options @samp{-fs}, @samp{-mm},
204@samp{-fw}, and @samp{-fh} (@pxref{Window Size X}). Note that this
205applies to the initial frame only.
206
207@ifnottex 206@ifnottex
207@item @code{horizontalScrollBars} (class @code{ScrollBars})
208If the value of this resource is @samp{off} or @samp{false} or
209@samp{0}, Emacs disables Horizontal Scroll Bar mode at startup
210(@pxref{Scroll Bars}).
211
208@item @code{iconName} (class @code{Title}) 212@item @code{iconName} (class @code{Title})
209Name to display in the icon. 213Name to display in the icon.
210 214
@@ -318,8 +322,8 @@ This is only relevant if your Emacs is built with XIM support. It
318might be useful to turn off XIM on slow X client/server links. 322might be useful to turn off XIM on slow X client/server links.
319 323
320@item @code{verticalScrollBars} (class @code{ScrollBars}) 324@item @code{verticalScrollBars} (class @code{ScrollBars})
321Give frames scroll bars if @samp{on}; don't have scroll bars if 325Give frames scroll bars on the left if @samp{left}, on the right if
322@samp{off}. 326@samp{right}; don't have scroll bars if @samp{off}.
323 327
324@ifnottex 328@ifnottex
325@item @code{visualClass} (class @code{VisualClass}) 329@item @code{visualClass} (class @code{VisualClass})
@@ -346,13 +350,13 @@ resources. @xref{Face Customization}.
346@cindex Lucid Widget X Resources 350@cindex Lucid Widget X Resources
347 351
348 If Emacs is compiled with the X toolkit support using Lucid widgets, 352 If Emacs is compiled with the X toolkit support using Lucid widgets,
349you can use X resources to customize the appearance of the menu bar, 353you can use X resources to customize the appearance of the menu bar
350pop-up menus, and dialog boxes. The resources for the menu bar fall 354(@pxref{Menu Bar}), pop-up menus, and dialog boxes (@pxref{Dialog
351in the @samp{pane.menubar} class (following, as always, either the 355Boxes}). The resources for the menu bar fall in the
352name of the Emacs executable or @samp{Emacs} for all Emacs 356@samp{pane.menubar} class (following, as always, either the name of
353invocations). The resources for the pop-up menu are in the 357the Emacs executable or @samp{Emacs} for all Emacs invocations). The
354@samp{menu*} class. The resources for dialog boxes are in the 358resources for the pop-up menu are in the @samp{menu*} class. The
355@samp{dialog*} class. 359resources for dialog boxes are in the @samp{dialog*} class.
356 360
357 For example, to display menu bar entries with the @samp{Courier-12} 361 For example, to display menu bar entries with the @samp{Courier-12}
358font (@pxref{Fonts}), write this: 362font (@pxref{Fonts}), write this:
@@ -374,12 +378,12 @@ Here is a list of resources for menu bars, pop-up menus, and dialogs:
374Font for menu item text. 378Font for menu item text.
375@item fontSet 379@item fontSet
376Fontset for menu item text. 380Fontset for menu item text.
377@item foreground
378Foreground color.
379@item background 381@item background
380Background color. 382Background color.
381@item buttonForeground 383@item buttonForeground
382Foreground color for a selected item. 384Foreground color for a selected item.
385@item foreground
386Foreground color.
383@ifnottex 387@ifnottex
384@item horizontalSpacing 388@item horizontalSpacing
385Horizontal spacing in pixels between items. Default is 3. 389Horizontal spacing in pixels between items. Default is 3.
@@ -403,14 +407,15 @@ Margin of the menu bar, in characters. Default is 1.
403 407
404 If Emacs is compiled with the X toolkit support using Motif or 408 If Emacs is compiled with the X toolkit support using Motif or
405LessTif widgets, you can use X resources to customize the appearance 409LessTif widgets, you can use X resources to customize the appearance
406of the menu bar, pop-up menus, and dialog boxes. However, the 410of the menu bar (@pxref{Menu Bar}), pop-up menus, and dialog boxes
407resources are organized differently from Lucid widgets. 411(@pxref{Dialog Boxes}). However, the resources are organized
412differently from Lucid widgets.
408 413
409 The resource names for the menu bar are in the @samp{pane.menubar} 414 The resource names for the menu bar are in the @samp{pane.menubar}
410class, and they must be specified in this form: 415class, and they must be specified in this form:
411 416
412@smallexample 417@smallexample
413Emacs.pane.menubar.@var{subwidget}.@var{resource}: @var{value} 418Emacs.pane.menubar.@var{subwidget}.@var{resource}: @var{value}
414@end smallexample 419@end smallexample
415 420
416@noindent 421@noindent
@@ -427,7 +432,7 @@ For example, to specify the font @samp{8x16} for all menu bar items,
427including submenus, write this: 432including submenus, write this:
428 433
429@smallexample 434@smallexample
430Emacs.pane.menubar.*.fontList: 8x16 435Emacs.pane.menubar.*.fontList: 8x16
431@end smallexample 436@end smallexample
432 437
433 Each item in a submenu also has its own name for X resources; for 438 Each item in a submenu also has its own name for X resources; for
@@ -471,7 +476,7 @@ itself, you must first specify the resource for all of them, then
471override the value for submenus alone. Here is an example: 476override the value for submenus alone. Here is an example:
472 477
473@smallexample 478@smallexample
474Emacs.pane.menubar.*.fontList: 8x16 479Emacs.pane.menubar.*.fontList: 9x18
475Emacs.pane.menubar.popup_*.fontList: 8x16 480Emacs.pane.menubar.popup_*.fontList: 8x16
476@end smallexample 481@end smallexample
477 482
@@ -510,7 +515,7 @@ The color for the border shadow, on the top and the left.
510@node GTK resources 515@node GTK resources
511@appendixsec GTK resources 516@appendixsec GTK resources
512@cindex GTK+ resources 517@cindex GTK+ resources
513@cindex resource files for GTK 518@cindex resource files for GTK+
514@cindex @file{~/.gtkrc-2.0} file 519@cindex @file{~/.gtkrc-2.0} file
515@cindex @file{~/.emacs.d/gtkrc} file 520@cindex @file{~/.emacs.d/gtkrc} file
516 521
@@ -525,7 +530,7 @@ resources are specified in either the file @file{~/.emacs.d/gtkrc}
525(for Emacs-specific GTK+ resources), or @file{~/.gtkrc-2.0} (for 530(for Emacs-specific GTK+ resources), or @file{~/.gtkrc-2.0} (for
526general GTK+ resources). We recommend using @file{~/.emacs.d/gtkrc}, 531general GTK+ resources). We recommend using @file{~/.emacs.d/gtkrc},
527since GTK+ seems to ignore @file{~/.gtkrc-2.0} when running GConf with 532since GTK+ seems to ignore @file{~/.gtkrc-2.0} when running GConf with
528GNOME@. Note, however, that some GTK themes may override 533GNOME@. Note, however, that some GTK+ themes may override
529customizations in @file{~/.emacs.d/gtkrc}; there is nothing we can do 534customizations in @file{~/.emacs.d/gtkrc}; there is nothing we can do
530about this. GTK+ resources do not affect aspects of Emacs unrelated 535about this. GTK+ resources do not affect aspects of Emacs unrelated
531to GTK+ widgets, such as fonts and colors in the main Emacs window; 536to GTK+ widgets, such as fonts and colors in the main Emacs window;
@@ -548,15 +553,15 @@ system, see
548@menu 553@menu
549* GTK Resource Basics:: Basic usage of GTK+ resources. 554* GTK Resource Basics:: Basic usage of GTK+ resources.
550* GTK Widget Names:: How GTK+ widgets are named. 555* GTK Widget Names:: How GTK+ widgets are named.
551* GTK Names in Emacs:: GTK widgets used by Emacs. 556* GTK Names in Emacs:: GTK+ widgets used by Emacs.
552* GTK styles:: What can be customized in a GTK widget. 557* GTK styles:: What can be customized in a GTK+ widget.
553@end menu 558@end menu
554 559
555@node GTK Resource Basics 560@node GTK Resource Basics
556@appendixsubsec GTK Resource Basics 561@appendixsubsec GTK Resource Basics
557 562
558 In a GTK+ 2 resource file (usually @file{~/.emacs.d/gtkrc}), the 563 In a GTK+ 2 resource file (usually @file{~/.emacs.d/gtkrc}), the
559simplest kinds of resource settings simply assign a value to a 564simplest kind of a resource setting simply assigns a value to a
560variable. For example, putting the following line in the resource 565variable. For example, putting the following line in the resource
561file changes the font on all GTK+ widgets to @samp{courier-12}: 566file changes the font on all GTK+ widgets to @samp{courier-12}:
562 567
@@ -612,7 +617,7 @@ widget "*verticalScrollBar*" style "scroll"
612 617
613@node GTK Widget Names 618@node GTK Widget Names
614@appendixsubsec GTK widget names 619@appendixsubsec GTK widget names
615@cindex GTK widget names 620@cindex GTK+ widget names
616 621
617 A GTK+ widget is specified by a @dfn{widget name} and a @dfn{widget 622 A GTK+ widget is specified by a @dfn{widget name} and a @dfn{widget
618class}. The widget name refers to a specific widget 623class}. The widget name refers to a specific widget
@@ -657,8 +662,8 @@ widget "*" style "my_style"
657 662
658@node GTK Names in Emacs 663@node GTK Names in Emacs
659@appendixsubsec GTK Widget Names in Emacs 664@appendixsubsec GTK Widget Names in Emacs
660@cindex GTK widget names in Emacs 665@cindex GTK+ widget names in Emacs
661@cindex GTK widget classes 666@cindex GTK+ widget classes
662 667
663 The GTK+ widgets used by an Emacs frame are listed below: 668 The GTK+ widgets used by an Emacs frame are listed below:
664 669
@@ -721,7 +726,7 @@ widget_class "*Menu*" style "my_menu_style"
721 726
722@node GTK styles 727@node GTK styles
723@appendixsubsec GTK styles 728@appendixsubsec GTK styles
724@cindex GTK styles 729@cindex GTK+ styles
725 730
726 Here is an example of two GTK+ style declarations: 731 Here is an example of two GTK+ style declarations:
727 732
@@ -770,20 +775,24 @@ possible states are:
770@table @code 775@table @code
771@item NORMAL 776@item NORMAL
772This is the default state for widgets. 777This is the default state for widgets.
778
773@item ACTIVE 779@item ACTIVE
774This is the state for a widget that is ready to do something. It is 780This is the state for a widget that is ready to do something. It is
775also for the trough of a scroll bar, i.e., @code{bg[ACTIVE] = "red"} 781also for the trough of a scroll bar, i.e., @code{bg[ACTIVE] = "red"}
776sets the scroll bar trough to red. Buttons that have been armed 782sets the scroll bar trough to red. Buttons that have been armed
777(pressed but not released yet) are in this state. 783(pressed but not released yet) are in this state.
784
778@item PRELIGHT 785@item PRELIGHT
779This is the state for a widget that can be manipulated, when the mouse 786This is the state for a widget that can be manipulated, when the mouse
780pointer is over it---for example when the mouse is over the thumb in 787pointer is over it---for example when the mouse is over the thumb in
781the scroll bar or over a menu item. When the mouse is over a button 788the scroll bar or over a menu item. When the mouse is over a button
782that is not pressed, the button is in this state. 789that is not pressed, the button is in this state.
790
783@item SELECTED 791@item SELECTED
784This is the state for data that has been selected by the user. It can 792This is the state for data that has been selected by the user. It can
785be selected text or items selected in a list. This state is not used 793be selected text or items selected in a list. This state is not used
786in Emacs. 794in Emacs.
795
787@item INSENSITIVE 796@item INSENSITIVE
788This is the state for widgets that are visible, but they cannot be 797This is the state for widgets that are visible, but they cannot be
789manipulated in the usual way---for example, buttons that can't be 798manipulated in the usual way---for example, buttons that can't be
@@ -805,14 +814,14 @@ dialog.
805 814
806@item bg_pixmap[@var{state}] = "@var{pixmap}" 815@item bg_pixmap[@var{state}] = "@var{pixmap}"
807This specifies an image background (instead of a background color). 816This specifies an image background (instead of a background color).
808@var{pixmap} should be the image file name. GTK can use a number of 817@var{pixmap} should be the image file name. GTK+ can use a number of
809image file formats, including XPM, XBM, GIF, JPEG and PNG@. If you 818image file formats, including XPM, XBM, GIF, JPEG and PNG@. If you
810want a widget to use the same image as its parent, use 819want a widget to use the same image as its parent, use
811@samp{<parent>}. If you don't want any image, use @samp{<none>}. 820@samp{<parent>}. If you don't want any image, use @samp{<none>}.
812@samp{<none>} is the way to cancel a background image inherited from a 821@samp{<none>} is the way to cancel a background image inherited from a
813parent style. 822parent style.
814 823
815You can't specify the file by its absolute file name. GTK looks for 824You can't specify the file by its absolute file name. GTK+ looks for
816the pixmap file in directories specified in @code{pixmap_path}. 825the pixmap file in directories specified in @code{pixmap_path}.
817@code{pixmap_path} is a colon-separated list of directories within 826@code{pixmap_path} is a colon-separated list of directories within
818double quotes, specified at the top level in a @file{gtkrc} file 827double quotes, specified at the top level in a @file{gtkrc} file
diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi
index 16216bb774c..c86ca43954e 100644
--- a/doc/lispintro/emacs-lisp-intro.texi
+++ b/doc/lispintro/emacs-lisp-intro.texi
@@ -5882,7 +5882,7 @@ find and use again and again.
5882@node New insert-buffer 5882@node New insert-buffer
5883@subsection New Body for @code{insert-buffer} 5883@subsection New Body for @code{insert-buffer}
5884@findex insert-buffer@r{, new version body} 5884@findex insert-buffer@r{, new version body}
5885@cindex new version body for insert-buffer 5885@cindex new version body for @code{insert-buffer}
5886 5886
5887The body in the GNU Emacs 22 version is more confusing than the original. 5887The body in the GNU Emacs 22 version is more confusing than the original.
5888 5888
@@ -13254,7 +13254,7 @@ If you are reading this inside of GNU Emacs and you want to see the
13254whole function, you can type @kbd{C-h f} (@code{describe-function}) 13254whole function, you can type @kbd{C-h f} (@code{describe-function})
13255and the name of the function. This gives you the function 13255and the name of the function. This gives you the function
13256documentation and the name of the library containing the function's 13256documentation and the name of the library containing the function's
13257source. Place point over the name of the library and press the RET 13257source. Place point over the name of the library and press the @key{RET}
13258key; you will be taken directly to the source. (Be sure to install 13258key; you will be taken directly to the source. (Be sure to install
13259your sources! Without them, you are like a person who tries to drive 13259your sources! Without them, you are like a person who tries to drive
13260a car with his eyes shut!) 13260a car with his eyes shut!)
@@ -14739,7 +14739,7 @@ In Emacs 22
14739 "Edit file FILENAME. 14739 "Edit file FILENAME.
14740Switch to a buffer visiting file FILENAME, 14740Switch to a buffer visiting file FILENAME,
14741creating one if none already exists. 14741creating one if none already exists.
14742Interactively, the default if you just type RET is the current directory, 14742Interactively, the default if you just type @key{RET} is the current directory,
14743but the visited file name is available through the minibuffer history: 14743but the visited file name is available through the minibuffer history:
14744type M-n to pull it into the minibuffer. 14744type M-n to pull it into the minibuffer.
14745 14745
@@ -15917,8 +15917,8 @@ a regular expression, including functions that are not interactive.
15917What we want to look for is some command that prints or inserts 15917What we want to look for is some command that prints or inserts
15918columns. Very likely, the name of the function will contain either 15918columns. Very likely, the name of the function will contain either
15919the word ``print'' or the word ``insert'' or the word ``column''. 15919the word ``print'' or the word ``insert'' or the word ``column''.
15920Therefore, we can simply type @kbd{M-x apropos RET 15920Therefore, we can simply type @kbd{M-x apropos @key{RET}
15921print\|insert\|column RET} and look at the result. On my system, this 15921print\|insert\|column @key{RET}} and look at the result. On my system, this
15922command once took quite some time, and then produced a list of 79 15922command once took quite some time, and then produced a list of 79
15923functions and variables. Now it does not take much time at all and 15923functions and variables. Now it does not take much time at all and
15924produces a list of 211 functions and variables. Scanning down the 15924produces a list of 211 functions and variables. Scanning down the
@@ -18147,7 +18147,7 @@ You can enter the debugger when you call the function by calling
18147Type: 18147Type:
18148 18148
18149@smallexample 18149@smallexample
18150M-x debug-on-entry RET triangle-bugged RET 18150M-x debug-on-entry @key{RET} triangle-bugged @key{RET}
18151@end smallexample 18151@end smallexample
18152 18152
18153@need 1250 18153@need 1250
@@ -18255,7 +18255,7 @@ To cancel the effect of @code{debug-on-entry}, call
18255@code{cancel-debug-on-entry} and the name of the function, like this: 18255@code{cancel-debug-on-entry} and the name of the function, like this:
18256 18256
18257@smallexample 18257@smallexample
18258M-x cancel-debug-on-entry RET triangle-bugged RET 18258M-x cancel-debug-on-entry @key{RET} triangle-bugged @key{RET}
18259@end smallexample 18259@end smallexample
18260 18260
18261@noindent 18261@noindent
@@ -18341,7 +18341,7 @@ this by positioning your cursor within or just after the definition
18341and typing 18341and typing
18342 18342
18343@smallexample 18343@smallexample
18344M-x edebug-defun RET 18344M-x edebug-defun @key{RET}
18345@end smallexample 18345@end smallexample
18346 18346
18347@noindent 18347@noindent
@@ -18552,7 +18552,7 @@ one of those long, but decipherable functions. You can look up
18552 18552
18553In this instance, since the code is Lisp, the @file{*Help*} buffer 18553In this instance, since the code is Lisp, the @file{*Help*} buffer
18554contains the name of the library containing the function's source. 18554contains the name of the library containing the function's source.
18555You can put point over the name of the library and press the RET key, 18555You can put point over the name of the library and press the @key{RET} key,
18556which in this situation is bound to @code{help-follow}, and be taken 18556which in this situation is bound to @code{help-follow}, and be taken
18557directly to the source, in the same way as @kbd{M-.} 18557directly to the source, in the same way as @kbd{M-.}
18558(@code{find-tag}). 18558(@code{find-tag}).
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index 9fbdb628205..3a39826761c 100644
--- a/doc/lispref/files.texi
+++ b/doc/lispref/files.texi
@@ -3267,7 +3267,7 @@ shown above; the details are crucial for proper behavior in the case of
3267multiple handlers, and for operations that have two file names that may 3267multiple handlers, and for operations that have two file names that may
3268each have handlers. 3268each have handlers.
3269 3269
3270@kindex safe-magic (@r{property}) 3270@kindex safe-magic @r{(property)}
3271 Handlers that don't really do anything special for actual access to the 3271 Handlers that don't really do anything special for actual access to the
3272file---such as the ones that implement completion of host names for 3272file---such as the ones that implement completion of host names for
3273remote file names---should have a non-@code{nil} @code{safe-magic} 3273remote file names---should have a non-@code{nil} @code{safe-magic}
@@ -3277,7 +3277,7 @@ file names, by prefixing them with @samp{/:}. But if the handler that
3277would be used for them has a non-@code{nil} @code{safe-magic} 3277would be used for them has a non-@code{nil} @code{safe-magic}
3278property, the @samp{/:} is not added. 3278property, the @samp{/:} is not added.
3279 3279
3280@kindex operations (@r{property}) 3280@kindex operations @r{(property)}
3281 A file name handler can have an @code{operations} property to 3281 A file name handler can have an @code{operations} property to
3282declare which operations it handles in a nontrivial way. If this 3282declare which operations it handles in a nontrivial way. If this
3283property has a non-@code{nil} value, it should be a list of 3283property has a non-@code{nil} value, it should be a list of
diff --git a/doc/lispref/streams.texi b/doc/lispref/streams.texi
index 6172392274a..ebd806601ef 100644
--- a/doc/lispref/streams.texi
+++ b/doc/lispref/streams.texi
@@ -778,6 +778,14 @@ In the second expression, the local binding of
778@code{prin1}, but not during the printing of the result. 778@code{prin1}, but not during the printing of the result.
779@end defvar 779@end defvar
780 780
781@defvar print-escape-control-characters
782If this variable is non-@code{nil}, control characters in strings are
783printed as backslash sequences by the print functions @code{prin1} and
784@code{print} that print with quoting. If this variable and
785@code{print-escape-newlines} are both non-@code{nil}, the latter takes
786precedences for newlines and formfeeds.
787@end defvar
788
781@defvar print-escape-nonascii 789@defvar print-escape-nonascii
782If this variable is non-@code{nil}, then unibyte non-@acronym{ASCII} 790If this variable is non-@code{nil}, then unibyte non-@acronym{ASCII}
783characters in strings are unconditionally printed as backslash sequences 791characters in strings are unconditionally printed as backslash sequences
diff --git a/doc/lispref/strings.texi b/doc/lispref/strings.texi
index 5452ea68790..8a9e27d00ec 100644
--- a/doc/lispref/strings.texi
+++ b/doc/lispref/strings.texi
@@ -727,7 +727,7 @@ minus sign if the argument is negative.
727 @result{} "-23.5" 727 @result{} "-23.5"
728@end example 728@end example
729 729
730@cindex int-to-string 730@cindex @code{int-to-string}
731@code{int-to-string} is a semi-obsolete alias for this function. 731@code{int-to-string} is a semi-obsolete alias for this function.
732 732
733See also the function @code{format} in @ref{Formatting Strings}. 733See also the function @code{format} in @ref{Formatting Strings}.
diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index 9de270c2d8e..e992c0f561d 100644
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -3862,7 +3862,7 @@ clicks on the link quickly without moving the mouse. This behavior is
3862controlled by the user option @code{mouse-1-click-follows-link}. 3862controlled by the user option @code{mouse-1-click-follows-link}.
3863@xref{Mouse References,,, emacs, The GNU Emacs Manual}. 3863@xref{Mouse References,,, emacs, The GNU Emacs Manual}.
3864 3864
3865@cindex follow-link (text or overlay property) 3865@kindex follow-link @r{(text or overlay property)}
3866 To set up the link so that it obeys 3866 To set up the link so that it obeys
3867@code{mouse-1-click-follows-link}, you must either (1) apply a 3867@code{mouse-1-click-follows-link}, you must either (1) apply a
3868@code{follow-link} text or overlay property to the link text, or (2) 3868@code{follow-link} text or overlay property to the link text, or (2)
diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi
index a4a091f243a..1fe7948ab81 100644
--- a/doc/misc/calc.texi
+++ b/doc/misc/calc.texi
@@ -9710,7 +9710,7 @@ The @kbd{C-x * x} command also turns the Calculator off, no matter which
9710user interface (standard, Keypad, or Embedded) is currently active. 9710user interface (standard, Keypad, or Embedded) is currently active.
9711It also cancels @code{calc-edit} mode if used from there. 9711It also cancels @code{calc-edit} mode if used from there.
9712 9712
9713@kindex d @key{SPC} 9713@kindex d SPC
9714@pindex calc-refresh 9714@pindex calc-refresh
9715@cindex Refreshing a garbled display 9715@cindex Refreshing a garbled display
9716@cindex Garbled displays, refreshing 9716@cindex Garbled displays, refreshing
@@ -10268,7 +10268,7 @@ information is cleared whenever you give any command that adds new undo
10268information, i.e., if you undo, then enter a number on the stack or make 10268information, i.e., if you undo, then enter a number on the stack or make
10269any other change, then it will be too late to redo. 10269any other change, then it will be too late to redo.
10270 10270
10271@kindex M-@key{RET} 10271@kindex M-RET
10272@pindex calc-last-args 10272@pindex calc-last-args
10273@cindex Last-arguments feature 10273@cindex Last-arguments feature
10274@cindex Arguments, restoring 10274@cindex Arguments, restoring
@@ -10906,27 +10906,27 @@ degrees, minutes, and seconds.
10906@ignore 10906@ignore
10907@mindex @null 10907@mindex @null
10908@end ignore 10908@end ignore
10909@kindex ' (HMS forms) 10909@kindex ' @r{(HMS forms)}
10910@ignore 10910@ignore
10911@mindex @null 10911@mindex @null
10912@end ignore 10912@end ignore
10913@kindex " (HMS forms) 10913@kindex " @r{(HMS forms)}
10914@ignore 10914@ignore
10915@mindex @null 10915@mindex @null
10916@end ignore 10916@end ignore
10917@kindex h (HMS forms) 10917@kindex h @r{(HMS forms)}
10918@ignore 10918@ignore
10919@mindex @null 10919@mindex @null
10920@end ignore 10920@end ignore
10921@kindex o (HMS forms) 10921@kindex o @r{(HMS forms)}
10922@ignore 10922@ignore
10923@mindex @null 10923@mindex @null
10924@end ignore 10924@end ignore
10925@kindex m (HMS forms) 10925@kindex m @r{(HMS forms)}
10926@ignore 10926@ignore
10927@mindex @null 10927@mindex @null
10928@end ignore 10928@end ignore
10929@kindex s (HMS forms) 10929@kindex s @r{(HMS forms)}
10930The default format for HMS values is 10930The default format for HMS values is
10931@samp{@var{hours}@@ @var{mins}' @var{secs}"}. During entry, the letters 10931@samp{@var{hours}@@ @var{mins}' @var{secs}"}. During entry, the letters
10932@samp{h} (for ``hours'') or 10932@samp{h} (for ``hours'') or
@@ -11125,7 +11125,7 @@ integers but this is not required.
11125@ignore 11125@ignore
11126@mindex M 11126@mindex M
11127@end ignore 11127@end ignore
11128@kindex M (modulo forms) 11128@kindex M @r{(modulo forms)}
11129@ignore 11129@ignore
11130@mindex mod 11130@mindex mod
11131@end ignore 11131@end ignore
@@ -11280,7 +11280,7 @@ would indeed have been negligible.
11280@ignore 11280@ignore
11281@mindex p 11281@mindex p
11282@end ignore 11282@end ignore
11283@kindex p (error forms) 11283@kindex p @r{(error forms)}
11284@tindex +/- 11284@tindex +/-
11285To enter an error form during regular numeric entry, use the @kbd{p} 11285To enter an error form during regular numeric entry, use the @kbd{p}
11286(``plus-or-minus'') key to type the @samp{+/-} symbol. (If you try actually 11286(``plus-or-minus'') key to type the @samp{+/-} symbol. (If you try actually
@@ -11732,8 +11732,8 @@ type, such as numbers, vectors, formulas, and incomplete objects.)
11732@section Stack Manipulation Commands 11732@section Stack Manipulation Commands
11733 11733
11734@noindent 11734@noindent
11735@kindex @key{RET} 11735@kindex RET
11736@kindex @key{SPC} 11736@kindex SPC
11737@pindex calc-enter 11737@pindex calc-enter
11738@cindex Duplicating stack entries 11738@cindex Duplicating stack entries
11739To duplicate the top object on the stack, press @key{RET} or @key{SPC} 11739To duplicate the top object on the stack, press @key{RET} or @key{SPC}
@@ -11749,7 +11749,7 @@ For example, with @samp{10 20 30} on the stack,
11749@kbd{C-u - 2 @key{RET}} creates @samp{10 20 30 20}, and 11749@kbd{C-u - 2 @key{RET}} creates @samp{10 20 30 20}, and
11750@kbd{C-u 0 @key{RET}} creates @samp{10 20 30 10 20 30}. 11750@kbd{C-u 0 @key{RET}} creates @samp{10 20 30 10 20 30}.
11751 11751
11752@kindex @key{LFD} 11752@kindex LFD
11753@pindex calc-over 11753@pindex calc-over
11754The @key{LFD} (@code{calc-over}) command (on a key marked Line-Feed if you 11754The @key{LFD} (@code{calc-over}) command (on a key marked Line-Feed if you
11755have it, else on @kbd{C-j}) is like @code{calc-enter} 11755have it, else on @kbd{C-j}) is like @code{calc-enter}
@@ -11759,7 +11759,7 @@ Thus with @samp{10 20 30} on the stack, @key{LFD} and @kbd{C-u 2 @key{LFD}}
11759are both equivalent to @kbd{C-u - 2 @key{RET}}, producing 11759are both equivalent to @kbd{C-u - 2 @key{RET}}, producing
11760@samp{10 20 30 20}. 11760@samp{10 20 30 20}.
11761 11761
11762@kindex @key{DEL} 11762@kindex DEL
11763@kindex C-d 11763@kindex C-d
11764@pindex calc-pop 11764@pindex calc-pop
11765@cindex Removing stack entries 11765@cindex Removing stack entries
@@ -11777,7 +11777,7 @@ For example, with @samp{10 20 30} on the stack,
11777@kbd{C-u - 2 @key{DEL}} leaves @samp{10 30}, and 11777@kbd{C-u - 2 @key{DEL}} leaves @samp{10 30}, and
11778@kbd{C-u 0 @key{DEL}} leaves an empty stack. 11778@kbd{C-u 0 @key{DEL}} leaves an empty stack.
11779 11779
11780@kindex M-@key{DEL} 11780@kindex M-DEL
11781@pindex calc-pop-above 11781@pindex calc-pop-above
11782The @kbd{M-@key{DEL}} (@code{calc-pop-above}) command is to @key{DEL} what 11782The @kbd{M-@key{DEL}} (@code{calc-pop-above}) command is to @key{DEL} what
11783@key{LFD} is to @key{RET}: It interprets the sign of the numeric 11783@key{LFD} is to @key{RET}: It interprets the sign of the numeric
@@ -11798,7 +11798,7 @@ specified element of the stack regardless of the cursor position.
11798Similarly, @key{DEL} will remove the corresponding elements from the 11798Similarly, @key{DEL} will remove the corresponding elements from the
11799stack. 11799stack.
11800 11800
11801@kindex @key{TAB} 11801@kindex TAB
11802@pindex calc-roll-down 11802@pindex calc-roll-down
11803To exchange the top two elements of the stack, press @key{TAB} 11803To exchange the top two elements of the stack, press @key{TAB}
11804(@code{calc-roll-down}). Given a positive numeric prefix argument, the 11804(@code{calc-roll-down}). Given a positive numeric prefix argument, the
@@ -11812,7 +11812,7 @@ For example, with @samp{10 20 30 40 50} on the stack,
11812@kbd{C-u - 2 @key{TAB}} creates @samp{40 50 10 20 30}, and 11812@kbd{C-u - 2 @key{TAB}} creates @samp{40 50 10 20 30}, and
11813@kbd{C-u 0 @key{TAB}} creates @samp{50 40 30 20 10}. 11813@kbd{C-u 0 @key{TAB}} creates @samp{50 40 30 20 10}.
11814 11814
11815@kindex M-@key{TAB} 11815@kindex M-TAB
11816@pindex calc-roll-up 11816@pindex calc-roll-up
11817The command @kbd{M-@key{TAB}} (@code{calc-roll-up}) is analogous to @key{TAB} 11817The command @kbd{M-@key{TAB}} (@code{calc-roll-up}) is analogous to @key{TAB}
11818except that it rotates upward instead of downward. Also, the default 11818except that it rotates upward instead of downward. Also, the default
@@ -13075,7 +13075,7 @@ refresh the stack to leave the stack display alone. The word ``Dirty''
13075will appear in the mode line when Calc thinks the stack display may not 13075will appear in the mode line when Calc thinks the stack display may not
13076reflect the latest mode settings. 13076reflect the latest mode settings.
13077 13077
13078@kindex d @key{RET} 13078@kindex d RET
13079@pindex calc-refresh-top 13079@pindex calc-refresh-top
13080The @kbd{d @key{RET}} (@code{calc-refresh-top}) command reformats the 13080The @kbd{d @key{RET}} (@code{calc-refresh-top}) command reformats the
13081top stack entry according to all the current modes. Positive prefix 13081top stack entry according to all the current modes. Positive prefix
@@ -16682,8 +16682,8 @@ or matrix argument, these functions operate element-wise.
16682@ignore 16682@ignore
16683@mindex v p 16683@mindex v p
16684@end ignore 16684@end ignore
16685@kindex v p (complex) 16685@kindex v p @r{(complex)}
16686@kindex V p (complex) 16686@kindex V p @r{(complex)}
16687@pindex calc-pack 16687@pindex calc-pack
16688The @kbd{v p} (@code{calc-pack}) command can pack the top two numbers on 16688The @kbd{v p} (@code{calc-pack}) command can pack the top two numbers on
16689the stack into a composite object such as a complex number. With 16689the stack into a composite object such as a complex number. With
@@ -16694,8 +16694,8 @@ with an argument of @mathit{-2}, it produces a polar complex number.
16694@ignore 16694@ignore
16695@mindex v u 16695@mindex v u
16696@end ignore 16696@end ignore
16697@kindex v u (complex) 16697@kindex v u @r{(complex)}
16698@kindex V u (complex) 16698@kindex V u @r{(complex)}
16699@pindex calc-unpack 16699@pindex calc-unpack
16700The @kbd{v u} (@code{calc-unpack}) command takes the complex number 16700The @kbd{v u} (@code{calc-unpack}) command takes the complex number
16701(or other composite object) on the top of the stack and unpacks it 16701(or other composite object) on the top of the stack and unpacks it
@@ -20234,7 +20234,7 @@ the conjugate transpose of its argument, i.e., @samp{conj(trn(x))}.
20234@ignore 20234@ignore
20235@mindex A 20235@mindex A
20236@end ignore 20236@end ignore
20237@kindex A (vectors) 20237@kindex A @r{(vectors)}
20238@pindex calc-abs (vectors) 20238@pindex calc-abs (vectors)
20239@ignore 20239@ignore
20240@mindex abs 20240@mindex abs
@@ -20280,7 +20280,7 @@ exactly three elements.
20280@ignore 20280@ignore
20281@mindex & 20281@mindex &
20282@end ignore 20282@end ignore
20283@kindex & (matrices) 20283@kindex & @r{(matrices)}
20284@pindex calc-inv (matrices) 20284@pindex calc-inv (matrices)
20285@ignore 20285@ignore
20286@mindex inv 20286@mindex inv
@@ -21942,7 +21942,7 @@ If you select an element of a vector and press @key{DEL}, that
21942element is deleted from the vector. If you delete one side of 21942element is deleted from the vector. If you delete one side of
21943an equation or inequality, only the opposite side remains. 21943an equation or inequality, only the opposite side remains.
21944 21944
21945@kindex j @key{DEL} 21945@kindex j DEL
21946@pindex calc-del-selection 21946@pindex calc-del-selection
21947The @kbd{j @key{DEL}} (@code{calc-del-selection}) command is like 21947The @kbd{j @key{DEL}} (@code{calc-del-selection}) command is like
21948@key{DEL} but with the auto-selecting behavior of @kbd{j '} and 21948@key{DEL} but with the auto-selecting behavior of @kbd{j '} and
@@ -21950,7 +21950,7 @@ The @kbd{j @key{DEL}} (@code{calc-del-selection}) command is like
21950indicated by the cursor, or, in the absence of a selection, it 21950indicated by the cursor, or, in the absence of a selection, it
21951deletes the sub-formula indicated by the cursor position. 21951deletes the sub-formula indicated by the cursor position.
21952 21952
21953@kindex j @key{RET} 21953@kindex j RET
21954@pindex calc-grab-selection 21954@pindex calc-grab-selection
21955(There is also an auto-selecting @kbd{j @key{RET}} (@code{calc-copy-selection}) 21955(There is also an auto-selecting @kbd{j @key{RET}} (@code{calc-copy-selection})
21956command.) 21956command.)
@@ -35348,13 +35348,13 @@ followed by @kbd{=}, @kbd{&}, @kbd{#}, @kbd{\}, @kbd{/}, @kbd{+} or
35348@kbd{-} as well as @kbd{*} to start Calc, and so in many cases the last 35348@kbd{-} as well as @kbd{*} to start Calc, and so in many cases the last
35349character of the prefix can simply be typed twice. 35349character of the prefix can simply be typed twice.
35350 35350
35351Calc is controlled by many variables, most of which can be reset 35351Calc is controlled by many variables, most of which can be reset from
35352from within Calc. Some variables are less involved with actual 35352within Calc. Some variables are less involved with actual calculation
35353calculation and can be set outside of Calc using Emacs's 35353and can be set outside of Calc using Emacs's customization facilities.
35354customization facilities. These variables are listed below. 35354These variables are listed below. Typing @kbd{M-x customize-variable
35355Typing @kbd{M-x customize-variable RET @var{variable-name} RET} 35355@key{RET} @var{variable-name} @key{RET}} will bring up a buffer in
35356will bring up a buffer in which the variable's value can be redefined. 35356which the variable's value can be redefined. Typing @kbd{M-x
35357Typing @kbd{M-x customize-group RET calc RET} will bring up a buffer which 35357customize-group @key{RET} calc @key{RET}} will bring up a buffer which
35358contains all of Calc's customizable variables. (These variables can 35358contains all of Calc's customizable variables. (These variables can
35359also be reset by putting the appropriate lines in your .emacs file; 35359also be reset by putting the appropriate lines in your .emacs file;
35360@xref{Init File, ,Init File, emacs, The GNU Emacs Manual}.) 35360@xref{Init File, ,Init File, emacs, The GNU Emacs Manual}.)
diff --git a/doc/misc/cc-mode.texi b/doc/misc/cc-mode.texi
index a506213ea2d..d0d39d44e95 100644
--- a/doc/misc/cc-mode.texi
+++ b/doc/misc/cc-mode.texi
@@ -356,9 +356,9 @@ Customizing Macros
356 356
357@cindex BOCM 357@cindex BOCM
358@cindex history 358@cindex history
359@cindex awk-mode.el 359@cindex @file{awk-mode.el}
360@cindex c-mode.el 360@cindex @file{c-mode.el}
361@cindex c++-mode.el 361@cindex @file{c++-mode.el}
362 362
363Welcome to @ccmode{}, a GNU Emacs mode for editing files containing C, 363Welcome to @ccmode{}, a GNU Emacs mode for editing files containing C,
364C++, Objective-C, Java, CORBA IDL (and the variants CORBA PSDL and 364C++, Objective-C, Java, CORBA IDL (and the variants CORBA PSDL and
@@ -577,9 +577,9 @@ for the latest information on Emacs version and package compatibility
577 577
578@deffn Command c-version 578@deffn Command c-version
579@findex version @r{(c-)} 579@findex version @r{(c-)}
580You can find out what version of @ccmode{} you are using by visiting a C 580You can find out what version of @ccmode{} you are using by visiting a
581file and entering @kbd{M-x c-version RET}. You should see this message in 581C file and entering @kbd{M-x c-version @key{RET}}. You should see
582the echo area: 582this message in the echo area:
583 583
584@example 584@example
585Using CC Mode version 5.XX 585Using CC Mode version 5.XX
@@ -920,8 +920,8 @@ must be in column zero. See @ref{Defuns,,,@emacsman{},
920 920
921@item @kbd{C-M-a} (AWK Mode) (@code{c-awk-beginning-of-defun}) 921@item @kbd{C-M-a} (AWK Mode) (@code{c-awk-beginning-of-defun})
922@itemx @kbd{C-M-e} (AWK Mode) (@code{c-awk-end-of-defun}) 922@itemx @kbd{C-M-e} (AWK Mode) (@code{c-awk-end-of-defun})
923@kindex C-M-a (AWK Mode) 923@kindex C-M-a @r{(AWK Mode)}
924@kindex C-M-e (AWK Mode) 924@kindex C-M-e @r{(AWK Mode)}
925@findex c-awk-beginning-of-defun 925@findex c-awk-beginning-of-defun
926@findex awk-beginning-of-defun @r{(c-)} 926@findex awk-beginning-of-defun @r{(c-)}
927@findex c-awk-end-of-defun 927@findex c-awk-end-of-defun
@@ -1521,7 +1521,7 @@ deletion.
1521@kindex DEL 1521@kindex DEL
1522@findex c-electric-backspace 1522@findex c-electric-backspace
1523@findex electric-backspace @r{(c-)} 1523@findex electric-backspace @r{(c-)}
1524This command is run by default when you hit the @kbd{DEL} key. When 1524This command is run by default when you hit the @kbd{@key{DEL}} key. When
1525hungry delete mode is enabled, it deletes any amount of whitespace in 1525hungry delete mode is enabled, it deletes any amount of whitespace in
1526the backwards direction. Otherwise, or when used with a prefix 1526the backwards direction. Otherwise, or when used with a prefix
1527argument or in a literal (@pxref{Auto-newlines}), the command just 1527argument or in a literal (@pxref{Auto-newlines}), the command just
@@ -1567,8 +1567,8 @@ rather than using the minor mode toggling.
1567 1567
1568@table @asis 1568@table @asis
1569@item @kbd{C-c C-@key{DEL}}, or @kbd{C-c @key{DEL}} (@code{c-hungry-delete-backwards})@footnote{This command was formerly known as @code{c-hungry-backspace}.} 1569@item @kbd{C-c C-@key{DEL}}, or @kbd{C-c @key{DEL}} (@code{c-hungry-delete-backwards})@footnote{This command was formerly known as @code{c-hungry-backspace}.}
1570@kindex C-c C-<backspace> 1570@kindex C-c C-Backspace
1571@kindex C-c <backspace> 1571@kindex C-c Backspace
1572@kindex C-c C-DEL 1572@kindex C-c C-DEL
1573@kindex C-c DEL 1573@kindex C-c DEL
1574@findex c-hungry-delete-backwards 1574@findex c-hungry-delete-backwards
@@ -1581,21 +1581,21 @@ a character terminal.
1581 1581
1582@item @kbd{C-c C-d}, @kbd{C-c C-@key{DELETE}}, or @kbd{C-c @key{DELETE}} (@code{c-hungry-delete-forward}) 1582@item @kbd{C-c C-d}, @kbd{C-c C-@key{DELETE}}, or @kbd{C-c @key{DELETE}} (@code{c-hungry-delete-forward})
1583@kindex C-c C-d 1583@kindex C-c C-d
1584@kindex C-c C-<DELETE> 1584@kindex C-c C-Delete
1585@kindex C-c <DELETE> 1585@kindex C-c Delete
1586@findex c-hungry-delete-forward 1586@findex c-hungry-delete-forward
1587@findex hungry-delete-forward @r{(c-)} 1587@findex hungry-delete-forward @r{(c-)}
1588Delete any amount of whitespace in the forward direction (regardless 1588Delete any amount of whitespace in the forward direction (regardless
1589whether hungry-delete mode is enabled or not). This command is bound 1589whether hungry-delete mode is enabled or not). This command is bound
1590to both @kbd{C-c C-@key{DELETE}} and @kbd{C-c @key{DELETE}} for the 1590to both @kbd{C-c C-@key{Delete}} and @kbd{C-c @key{Delete}} for the
1591same reason as for @key{DEL} above. 1591same reason as for @key{DEL} above.
1592@end table 1592@end table
1593@end table 1593@end table
1594 1594
1595@kindex <delete> 1595@kindex Delete
1596@kindex <backspace> 1596@kindex Backspace
1597 1597
1598When we talk about @kbd{@key{DEL}}, and @kbd{@key{DELETE}} above, we 1598When we talk about @kbd{@key{DEL}}, and @kbd{@key{Delete}} above, we
1599actually do so without connecting them to the physical keys commonly 1599actually do so without connecting them to the physical keys commonly
1600known as @key{Backspace} and @key{Delete}. The default bindings to 1600known as @key{Backspace} and @key{Delete}. The default bindings to
1601those two keys depends on the flavor of (X)Emacs you are using. 1601those two keys depends on the flavor of (X)Emacs you are using.
@@ -1708,7 +1708,7 @@ nomenclature and treat them as separate words:
1708@item @kbd{M-b} @tab @code{backward-word} @tab @code{c-backward-subword} 1708@item @kbd{M-b} @tab @code{backward-word} @tab @code{c-backward-subword}
1709@item @kbd{M-@@} @tab @code{mark-word} @tab @code{c-mark-subword} 1709@item @kbd{M-@@} @tab @code{mark-word} @tab @code{c-mark-subword}
1710@item @kbd{M-d} @tab @code{kill-word} @tab @code{c-kill-subword} 1710@item @kbd{M-d} @tab @code{kill-word} @tab @code{c-kill-subword}
1711@item @kbd{M-DEL} @tab @code{backward-kill-word} @tab @code{c-backward-kill-subword} 1711@item @kbd{M-@key{DEL}} @tab @code{backward-kill-word} @tab @code{c-backward-kill-subword}
1712@item @kbd{M-t} @tab @code{transpose-words} @tab @code{c-transpose-subwords} 1712@item @kbd{M-t} @tab @code{transpose-words} @tab @code{c-transpose-subwords}
1713@item @kbd{M-c} @tab @code{capitalize-word} @tab @code{c-capitalize-subword} 1713@item @kbd{M-c} @tab @code{capitalize-word} @tab @code{c-capitalize-subword}
1714@item @kbd{M-u} @tab @code{upcase-word} @tab @code{c-upcase-subword} 1714@item @kbd{M-u} @tab @code{upcase-word} @tab @code{c-upcase-subword}
@@ -7250,13 +7250,13 @@ Set the variable @code{c-basic-offset}. @xref{Getting Started}.
7250@item 7250@item
7251@kindex RET 7251@kindex RET
7252@kindex C-j 7252@kindex C-j
7253@emph{Why does/doesn't the @kbd{RET} key indent the new line?} 7253@emph{Why does/doesn't the @kbd{@key{RET}} key indent the new line?}
7254 7254
7255Emacs's convention used to be that @kbd{RET} just adds a newline, and that 7255Emacs's convention used to be that @kbd{RET} just adds a newline, and that
7256@kbd{C-j} adds a newline and indents it. In Emacs-24.4, this convention was 7256@kbd{C-j} adds a newline and indents it. In Emacs-24.4, this convention was
7257reversed. 7257reversed.
7258 7258
7259If you use an older Emacs and you want @kbd{RET} do this 7259If you use an older Emacs and you want @kbd{@key{RET}} do this
7260too, add this to your @code{c-initialization-hook}: 7260too, add this to your @code{c-initialization-hook}:
7261 7261
7262@example 7262@example
diff --git a/doc/misc/dired-x.texi b/doc/misc/dired-x.texi
index 130c06b40e8..60e978c9d91 100644
--- a/doc/misc/dired-x.texi
+++ b/doc/misc/dired-x.texi
@@ -995,7 +995,7 @@ If there are several Dired buffers for a directory, the most recently
995used is chosen. 995used is chosen.
996 996
997Dired avoids switching to the current buffer, so that if you have a 997Dired avoids switching to the current buffer, so that if you have a
998normal and a wildcard buffer for the same directory, @kbd{C-x d RET} 998normal and a wildcard buffer for the same directory, @kbd{C-x d @key{RET}}
999will toggle between those two. 999will toggle between those two.
1000@end table 1000@end table
1001 1001
diff --git a/doc/misc/ebrowse.texi b/doc/misc/ebrowse.texi
index 9ac2af1bcf7..b6f2c1865fd 100644
--- a/doc/misc/ebrowse.texi
+++ b/doc/misc/ebrowse.texi
@@ -482,7 +482,7 @@ you are working on, some classes will only be known to exist but the
482location of their declarations and definitions will not be known. 482location of their declarations and definitions will not be known.
483 483
484@item @key{RET} 484@item @key{RET}
485Works like @kbd{SPC}, except that it finds the class 485Works like @kbd{@key{SPC}}, except that it finds the class
486declaration rather than viewing it, so that it is ready for 486declaration rather than viewing it, so that it is ready for
487editing. 487editing.
488@end table 488@end table
@@ -886,7 +886,7 @@ the member.
886This command finds the declaration of the member the cursor is on. 886This command finds the declaration of the member the cursor is on.
887 887
888@item @key{SPC} 888@item @key{SPC}
889This is the same command as @kbd{RET}, but views the member definition 889This is the same command as @kbd{@key{RET}}, but views the member definition
890instead of finding the member's source file. 890instead of finding the member's source file.
891 891
892@item v 892@item v
@@ -1314,7 +1314,7 @@ the next position stored in the position stack.
1314 1314
1315@item C-c C-m p 1315@item C-c C-m p
1316Displays an electric buffer showing all positions saved in the stack. 1316Displays an electric buffer showing all positions saved in the stack.
1317You can select a position by pressing @kbd{SPC} in a line. You can 1317You can select a position by pressing @kbd{@key{SPC}} in a line. You can
1318view a position with @kbd{v}. 1318view a position with @kbd{v}.
1319@end table 1319@end table
1320 1320
diff --git a/doc/misc/ede.texi b/doc/misc/ede.texi
index 88dc9e922e5..42bedb10f68 100644
--- a/doc/misc/ede.texi
+++ b/doc/misc/ede.texi
@@ -160,8 +160,8 @@ First, lets create a directory for our project. For this example,
160we'll start with something in @file{/tmp}. 160we'll start with something in @file{/tmp}.
161 161
162@example 162@example
163C-x C-f /tmp/myproject/README RET 163C-x C-f /tmp/myproject/README @key{RET}
164M-x make-directory RET RET 164M-x make-directory @key{RET} @key{RET}
165@end example 165@end example
166 166
167Now put some plain text in your README file to start. 167Now put some plain text in your README file to start.
@@ -169,7 +169,7 @@ Now put some plain text in your README file to start.
169Now, lets create the project: 169Now, lets create the project:
170 170
171@example 171@example
172M-x ede-new RET Automake RET myproject RET 172M-x ede-new @key{RET} Automake @key{RET} myproject @key{RET}
173@end example 173@end example
174 174
175 175
@@ -191,8 +191,8 @@ We'll make a more complex project, so use dired to create some more
191directories using the @kbd{+} key, and typing in new directories: 191directories using the @kbd{+} key, and typing in new directories:
192 192
193@example 193@example
194+ include RET 194+ include @key{RET}
195+ src RET 195+ src @key{RET}
196@end example 196@end example
197 197
198Now I'll short-cut in this tutorial. Create the following files: 198Now I'll short-cut in this tutorial. Create the following files:
@@ -252,13 +252,13 @@ now create those projects.
252With @file{main.cpp} as your current buffer, type: 252With @file{main.cpp} as your current buffer, type:
253 253
254@example 254@example
255M-x ede-new RET Automake RET src RET 255M-x ede-new @key{RET} Automake @key{RET} src @key{RET}
256@end example 256@end example
257 257
258and in @file{myproj.hh} as your current buffer, type: 258and in @file{myproj.hh} as your current buffer, type:
259 259
260@example 260@example
261M-x ede-new RET Automake RET include RET 261M-x ede-new @key{RET} Automake @key{RET} include @key{RET}
262@end example 262@end example
263 263
264These steps effectively only create the Project.ede file in which you 264These steps effectively only create the Project.ede file in which you
@@ -272,7 +272,7 @@ Projects. You can create targets either from a buffer, or from a
272 272
273Note: If for some reason a directory list buffer, or file does not have the 273Note: If for some reason a directory list buffer, or file does not have the
274@samp{Project} menu item, or if @ede{} keybindings don't work, just 274@samp{Project} menu item, or if @ede{} keybindings don't work, just
275use @kbd{M-x revert-buffer RET} to force a refresh. Sometimes 275use @kbd{M-x revert-buffer @key{RET}} to force a refresh. Sometimes
276creating a new project doesn't restart buffers correctly. 276creating a new project doesn't restart buffers correctly.
277 277
278Lets start with the header file. In @file{include/myproj.hh}, you 278Lets start with the header file. In @file{include/myproj.hh}, you
@@ -280,7 +280,7 @@ could use the menu, but we will now start using the @ede{} command prefix
280which is @kbd{C-c .}. 280which is @kbd{C-c .}.
281 281
282@example 282@example
283C-c . t includes RET miscellaneous RET y 283C-c . t includes @key{RET} miscellaneous @key{RET} y
284@end example 284@end example
285 285
286 286
@@ -292,7 +292,7 @@ Next, visit the @file{src} directory using dired. There should be a
292@samp{Project} menu. You can create a new target with 292@samp{Project} menu. You can create a new target with
293 293
294@example 294@example
295. t myprogram RET program RET 295. t myprogram @key{RET} program @key{RET}
296@end example 296@end example
297 297
298Note that @kbd{. t} is a command for creating a target. This command 298Note that @kbd{. t} is a command for creating a target. This command
@@ -304,7 +304,7 @@ Next, place the cursor on @file{main.cpp}, and use @kbd{. a} to add
304that file to your target. 304that file to your target.
305 305
306@example 306@example
307. a myprogram RET 307. a myprogram @key{RET}
308@end example 308@end example
309 309
310Note that these prompts often have completion, so you can just press 310Note that these prompts often have completion, so you can just press
@@ -316,8 +316,8 @@ all in your dired buffer, and add them all at the same time.
316Next, do the same for the library by placing the cursor on @file{mylib.cpp}. 316Next, do the same for the library by placing the cursor on @file{mylib.cpp}.
317 317
318@example 318@example
319. t mylib RET sharedobject RET 319. t mylib @key{RET} sharedobject @key{RET}
320. a mylib RET 320. a mylib @key{RET}
321@end example 321@end example
322 322
323@section Step 5: Compile, and fail 323@section Step 5: Compile, and fail
@@ -350,7 +350,7 @@ To fix the failed compile, we need to add
350Visit @file{main.cpp}. 350Visit @file{main.cpp}.
351 351
352@example 352@example
353M-x customize-project RET 353M-x customize-project @key{RET}
354@end example 354@end example
355 355
356Select the @samp{[Settings]} subgroup of options. Under 356Select the @samp{[Settings]} subgroup of options. Under
@@ -407,7 +407,7 @@ project. This is because variables such as the include path are
407treated globally, whereas dependencies for a target are target specific. 407treated globally, whereas dependencies for a target are target specific.
408 408
409@example 409@example
410M-x customize-target RET 410M-x customize-target @key{RET}
411@end example 411@end example
412 412
413On the first page, you will see an Ldlibs-local section. Add mylib to 413On the first page, you will see an Ldlibs-local section. Add mylib to
@@ -437,7 +437,7 @@ C-c . C
437You can run your program directly from @ede{}. 437You can run your program directly from @ede{}.
438 438
439@example 439@example
440C-c . R RET RET 440C-c . R @key{RET} @key{RET}
441@end example 441@end example
442 442
443If your program takes command line arguments, you can type them in 443If your program takes command line arguments, you can type them in
diff --git a/doc/misc/ediff.texi b/doc/misc/ediff.texi
index e488fc07f8e..8ffa90fb5b5 100644
--- a/doc/misc/ediff.texi
+++ b/doc/misc/ediff.texi
@@ -541,12 +541,12 @@ Copies the difference region from buffer C to buffer B@.
541The command @kbd{rb} undoes this. 541The command @kbd{rb} undoes this.
542 542
543@item p 543@item p
544@itemx DEL 544@itemx @key{DEL}
545@kindex p 545@kindex p
546@kindex DEL 546@kindex DEL
547Makes the previous difference region current. 547Makes the previous difference region current.
548@item n 548@item n
549@itemx SPC 549@itemx @key{SPC}
550@kindex n 550@kindex n
551@kindex SPC 551@kindex SPC
552Makes the next difference region current. 552Makes the next difference region current.
diff --git a/doc/misc/edt.texi b/doc/misc/edt.texi
index ed486597a7b..754e3c82b23 100644
--- a/doc/misc/edt.texi
+++ b/doc/misc/edt.texi
@@ -195,10 +195,10 @@ EDT Emulation. (Note: In a few rare circumstances this does not work
195properly. In particular, it does not work if a subset of the leading 195properly. In particular, it does not work if a subset of the leading
196@acronym{ASCII} characters in a key sequence are recognized by Emacs as 196@acronym{ASCII} characters in a key sequence are recognized by Emacs as
197having an existing binding. For example, if the keypad 7 (@key{KP7}) 197having an existing binding. For example, if the keypad 7 (@key{KP7})
198key generates the sequence @samp{<ESC>Ow} and @samp{<ESC>O} is already 198key generates the sequence @samp{@key{ESC}Ow} and @samp{@key{ESC}O} is already
199bound to a function, pressing @key{KP7} when told to do so by 199bound to a function, pressing @key{KP7} when told to do so by
200@file{edt-mapper.el} will result in @file{edt-mapper.el} incorrectly 200@file{edt-mapper.el} will result in @file{edt-mapper.el} incorrectly
201mapping @samp{<ESC>O} to @key{KP7} and @samp{w} to @key{KP8}. If 201mapping @samp{@key{ESC}O} to @key{KP7} and @samp{w} to @key{KP8}. If
202something like this happens to you, it is probably a bug in the support 202something like this happens to you, it is probably a bug in the support
203for your keyboard within Emacs @strong{or} a bug in the Unix 203for your keyboard within Emacs @strong{or} a bug in the Unix
204termcap/terminfo support for your terminal @strong{or} a bug in the 204termcap/terminfo support for your terminal @strong{or} a bug in the
diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi
index da6fda08833..e1575f592bf 100644
--- a/doc/misc/efaq.texi
+++ b/doc/misc/efaq.texi
@@ -173,7 +173,7 @@ Key sequences longer than one key (and some single-key sequences) are
173written inside quotes or on lines by themselves, like this: 173written inside quotes or on lines by themselves, like this:
174 174
175@display 175@display
176 @kbd{M-x frobnicate-while-foo RET} 176 @kbd{M-x frobnicate-while-foo @key{RET}}
177@end display 177@end display
178 178
179@noindent 179@noindent
@@ -201,7 +201,7 @@ Also, on very few keyboards does @kbd{C-?} generate @acronym{ASCII} code 127.
201@section What does @file{M-x @var{command}} mean? 201@section What does @file{M-x @var{command}} mean?
202@cindex Extended commands 202@cindex Extended commands
203@cindex Commands, extended 203@cindex Commands, extended
204@cindex M-x, meaning of 204@cindex @kbd{M-x}, meaning of
205 205
206@kbd{M-x @var{command}} means type @kbd{M-x}, then type the name of the 206@kbd{M-x @var{command}} means type @kbd{M-x}, then type the name of the
207command, then type @key{RET}. (@xref{Basic keys}, if you're not sure 207command, then type @key{RET}. (@xref{Basic keys}, if you're not sure
@@ -3808,9 +3808,9 @@ defines the @kbd{M-@key{TAB}} key sequence.
3808 3808
3809@node Backspace invokes help 3809@node Backspace invokes help
3810@section Why does the @key{Backspace} key invoke help? 3810@section Why does the @key{Backspace} key invoke help?
3811@cindex Backspace key invokes help 3811@cindex @key{Backspace} key invokes help
3812@cindex Help invoked by Backspace 3812@cindex Help invoked by @key{Backspace}
3813@cindex DEL key does not delete 3813@cindex @key{DEL} key does not delete
3814 3814
3815The @key{Backspace} key (on most keyboards) generates @acronym{ASCII} code 8. 3815The @key{Backspace} key (on most keyboards) generates @acronym{ASCII} code 8.
3816@kbd{C-h} sends the same code. In Emacs by default @kbd{C-h} invokes 3816@kbd{C-h} sends the same code. In Emacs by default @kbd{C-h} invokes
@@ -4155,7 +4155,7 @@ This will disable the use of the extra keysyms systemwide, which may be
4155undesirable if you actually intend to use them. 4155undesirable if you actually intend to use them.
4156 4156
4157@node SPC no longer completes file names 4157@node SPC no longer completes file names
4158@section Why doesn't SPC complete file names anymore? 4158@section Why doesn't @key{SPC} complete file names anymore?
4159@cindex @kbd{SPC} file name completion 4159@cindex @kbd{SPC} file name completion
4160 4160
4161Starting with Emacs 22.1, @kbd{SPC} no longer completes file names in 4161Starting with Emacs 22.1, @kbd{SPC} no longer completes file names in
diff --git a/doc/misc/eieio.texi b/doc/misc/eieio.texi
index 16c341b8877..689ff72b723 100644
--- a/doc/misc/eieio.texi
+++ b/doc/misc/eieio.texi
@@ -1263,13 +1263,13 @@ The @var{parent-instance} slot indicates the instance which is
1263considered the parent of the current instance. Default is @code{nil}. 1263considered the parent of the current instance. Default is @code{nil}.
1264@end deftp 1264@end deftp
1265 1265
1266@cindex clone 1266@cindex @code{clone}
1267To use this class, inherit from it with your own class. 1267To use this class, inherit from it with your own class.
1268To make a new instance that inherits from and existing instance of your 1268To make a new instance that inherits from and existing instance of your
1269class, use the @code{clone} method with additional parameters 1269class, use the @code{clone} method with additional parameters
1270to specify local values. 1270to specify local values.
1271 1271
1272@cindex slot-unbound 1272@cindex @code{slot-unbound}
1273The @code{eieio-instance-inheritor} class works by causing cloned 1273The @code{eieio-instance-inheritor} class works by causing cloned
1274objects to have all slots unbound. This class' @code{slot-unbound} 1274objects to have all slots unbound. This class' @code{slot-unbound}
1275method will cause references to unbound slots to be redirected to the 1275method will cause references to unbound slots to be redirected to the
@@ -1395,7 +1395,7 @@ with a minimum of effort.
1395 1395
1396@deftp {Class} eieio-speedbar buttontype buttonface 1396@deftp {Class} eieio-speedbar buttontype buttonface
1397Enables base speedbar display for a class. 1397Enables base speedbar display for a class.
1398@cindex speedbar-make-tag-line 1398@cindex @code{speedbar-make-tag-line}
1399The slot @var{buttontype} is any of the symbols allowed by the 1399The slot @var{buttontype} is any of the symbols allowed by the
1400function @code{speedbar-make-tag-line} for the @var{exp-button-type} 1400function @code{speedbar-make-tag-line} for the @var{exp-button-type}
1401argument @xref{Extending,,,speedbar}. 1401argument @xref{Extending,,,speedbar}.
diff --git a/doc/misc/emacs-mime.texi b/doc/misc/emacs-mime.texi
index 4fbb3e5673d..2c607cc97c5 100644
--- a/doc/misc/emacs-mime.texi
+++ b/doc/misc/emacs-mime.texi
@@ -179,18 +179,18 @@ Emacs source code. This item works only in the groups matching
179@code{mm-uu-emacs-sources-regexp}. 179@code{mm-uu-emacs-sources-regexp}.
180 180
181@item diff 181@item diff
182@vindex diff 182@findex diff
183@vindex mm-uu-diff-groups-regexp 183@vindex mm-uu-diff-groups-regexp
184Patches. This is intended for groups where diffs of committed files 184Patches. This is intended for groups where diffs of committed files
185are automatically sent to. It only works in groups matching 185are automatically sent to. It only works in groups matching
186@code{mm-uu-diff-groups-regexp}. 186@code{mm-uu-diff-groups-regexp}.
187 187
188@item verbatim-marks 188@item verbatim-marks
189@cindex verbatim-marks 189@findex verbatim-marks
190Slrn-style verbatim marks. 190Slrn-style verbatim marks.
191 191
192@item LaTeX 192@item LaTeX
193@cindex LaTeX 193@findex LaTeX
194LaTeX documents. It only works in groups matching 194LaTeX documents. It only works in groups matching
195@code{mm-uu-tex-groups-regexp}. 195@code{mm-uu-tex-groups-regexp}.
196 196
@@ -1093,7 +1093,7 @@ If non-@code{nil} a format=flowed article will be displayed flowed.
1093@node Interface Functions 1093@node Interface Functions
1094@chapter Interface Functions 1094@chapter Interface Functions
1095@cindex interface functions 1095@cindex interface functions
1096@cindex mail-parse 1096@cindex @code{mail-parse}
1097 1097
1098The @code{mail-parse} library is an abstraction over the actual 1098The @code{mail-parse} library is an abstraction over the actual
1099low-level libraries that are described in the next chapter. 1099low-level libraries that are described in the next chapter.
diff --git a/doc/misc/epa.texi b/doc/misc/epa.texi
index 237617a524b..d5dfe70760e 100644
--- a/doc/misc/epa.texi
+++ b/doc/misc/epa.texi
@@ -281,22 +281,22 @@ The following keys are assigned.
281 281
282@table @kbd 282@table @kbd
283@item : d 283@item : d
284@kindex @kbd{: d} 284@kindex : d
285@findex epa-dired-do-decrypt 285@findex epa-dired-do-decrypt
286Decrypt marked files. 286Decrypt marked files.
287 287
288@item : v 288@item : v
289@kindex @kbd{: v} 289@kindex : v
290@findex epa-dired-do-verify 290@findex epa-dired-do-verify
291Verify marked files. 291Verify marked files.
292 292
293@item : s 293@item : s
294@kindex @kbd{: s} 294@kindex : s
295@findex epa-dired-do-sign 295@findex epa-dired-do-sign
296Sign marked files. 296Sign marked files.
297 297
298@item : e 298@item : e
299@kindex @kbd{: e} 299@kindex : e
300@findex epa-dired-do-encrypt 300@findex epa-dired-do-encrypt
301Encrypt marked files. 301Encrypt marked files.
302 302
@@ -322,26 +322,26 @@ interface. Try @kbd{M-x customize-variable epa-global-mail-mode}.
322 322
323@table @kbd 323@table @kbd
324@item C-c C-e C-d and C-c C-e d 324@item C-c C-e C-d and C-c C-e d
325@kindex @kbd{C-c C-e C-d} 325@kindex C-c C-e C-d
326@kindex @kbd{C-c C-e d} 326@kindex C-c C-e d
327@findex epa-mail-decrypt 327@findex epa-mail-decrypt
328Decrypt OpenPGP armors in the current buffer. 328Decrypt OpenPGP armors in the current buffer.
329 329
330@item C-c C-e C-v and C-c C-e v 330@item C-c C-e C-v and C-c C-e v
331@kindex @kbd{C-c C-e C-v} 331@kindex C-c C-e C-v
332@kindex @kbd{C-c C-e v} 332@kindex C-c C-e v
333@findex epa-mail-verify 333@findex epa-mail-verify
334Verify OpenPGP cleartext signed messages in the current buffer. 334Verify OpenPGP cleartext signed messages in the current buffer.
335 335
336@item C-c C-e C-s and C-c C-e s 336@item C-c C-e C-s and C-c C-e s
337@kindex @kbd{C-c C-e C-s} 337@kindex C-c C-e C-s
338@kindex @kbd{C-c C-e s} 338@kindex C-c C-e s
339@findex epa-mail-sign 339@findex epa-mail-sign
340Compose a signed message from the current buffer. 340Compose a signed message from the current buffer.
341 341
342@item C-c C-e C-e and C-c C-e e 342@item C-c C-e C-e and C-c C-e e
343@kindex @kbd{C-c C-e C-e} 343@kindex C-c C-e C-e
344@kindex @kbd{C-c C-e e} 344@kindex C-c C-e e
345@findex epa-mail-encrypt 345@findex epa-mail-encrypt
346@vindex epa-mail-aliases 346@vindex epa-mail-aliases
347Compose an encrypted message from the current buffer. 347Compose an encrypted message from the current buffer.
diff --git a/doc/misc/erc.texi b/doc/misc/erc.texi
index 466a4fc4b85..55556c52810 100644
--- a/doc/misc/erc.texi
+++ b/doc/misc/erc.texi
@@ -117,10 +117,11 @@ connect to.
117If you want to place ERC settings in their own file, you can place them 117If you want to place ERC settings in their own file, you can place them
118in @file{~/.emacs.d/.ercrc.el}, creating it if necessary. 118in @file{~/.emacs.d/.ercrc.el}, creating it if necessary.
119 119
120If you would rather use the Customize interface to change how ERC works, 120If you would rather use the Customize interface to change how ERC
121do @kbd{M-x customize-group RET erc RET}. In particular, ERC comes with 121works, do @kbd{M-x customize-group @key{RET} erc @key{RET}}. In
122lots of modules that may be enabled or disabled; to select which ones 122particular, ERC comes with lots of modules that may be enabled or
123you want, do @kbd{M-x customize-variable RET erc-modules RET}. 123disabled; to select which ones you want, do @kbd{M-x
124customize-variable @key{RET} erc-modules @key{RET}}.
124 125
125@menu 126@menu
126* Sample Session:: Example of connecting to the #emacs channel 127* Sample Session:: Example of connecting to the #emacs channel
@@ -269,14 +270,14 @@ This is a summary of keystrokes available in every ERC buffer.
269@item C-a or <home> (@code{erc-bol}) 270@item C-a or <home> (@code{erc-bol})
270Go to beginning of line or end of prompt. 271Go to beginning of line or end of prompt.
271 272
272@item RET (@code{erc-send-current-line}) 273@item @key{RET} (@code{erc-send-current-line})
273Send the current line 274Send the current line
274 275
275@item TAB (@code{erc-complete-word}) 276@item @key{TAB} (@code{erc-complete-word})
276If at prompt, complete the current word. 277If at prompt, complete the current word.
277Otherwise, move to the next link or button. 278Otherwise, move to the next link or button.
278 279
279@item M-TAB (@code{ispell-complete-word}) 280@item M-@key{TAB} (@code{ispell-complete-word})
280Complete the given word, using ispell. 281Complete the given word, using ispell.
281 282
282@item C-c C-a (@code{erc-bol}) 283@item C-c C-a (@code{erc-bol})
@@ -297,7 +298,7 @@ Toggle automatic CTCP replies (like VERSION and PING).
297@item C-c C-f (@code{erc-toggle-flood-control}) 298@item C-c C-f (@code{erc-toggle-flood-control})
298Toggle use of flood control on sent messages. 299Toggle use of flood control on sent messages.
299 300
300@item C-c TAB (@code{erc-invite-only-mode}) 301@item C-c @key{TAB} (@code{erc-invite-only-mode})
301Turn on the invite only mode (+i) for the current channel. 302Turn on the invite only mode (+i) for the current channel.
302 303
303@item C-c C-j (@code{erc-join-channel}) 304@item C-c C-j (@code{erc-join-channel})
@@ -349,8 +350,9 @@ One way to add functionality to ERC is to customize which of its many
349modules are loaded. 350modules are loaded.
350 351
351There is a spiffy customize interface, which may be reached by typing 352There is a spiffy customize interface, which may be reached by typing
352@kbd{M-x customize-option erc-modules RET}. Alternatively, set 353@kbd{M-x customize-option @key{RET} erc-modules @key{RET}}.
353@code{erc-modules} manually and then call @code{erc-update-modules}. 354Alternatively, set @code{erc-modules} manually and then call
355@code{erc-update-modules}.
354 356
355The following is a list of available modules. 357The following is a list of available modules.
356 358
@@ -743,7 +745,7 @@ stuff, to the current ERC buffer."
743 745
744This section is extremely incomplete. For now, the easiest way to 746This section is extremely incomplete. For now, the easiest way to
745check out all the available options for ERC is to do 747check out all the available options for ERC is to do
746@kbd{M-x customize-group erc RET}. 748@kbd{M-x customize-group @key{RET} erc @key{RET}}.
747 749
748@defopt erc-hide-list 750@defopt erc-hide-list
749If non, @code{nil}, this is a list of IRC message types to hide, e.g.: 751If non, @code{nil}, this is a list of IRC message types to hide, e.g.:
diff --git a/doc/misc/ert.texi b/doc/misc/ert.texi
index 3553560f497..82e0e27ed1c 100644
--- a/doc/misc/ert.texi
+++ b/doc/misc/ert.texi
@@ -203,7 +203,7 @@ different Emacs versions.
203 203
204@findex ert 204@findex ert
205You can run the tests that are currently defined in your Emacs with 205You can run the tests that are currently defined in your Emacs with
206the command @kbd{@kbd{M-x} ert @kbd{RET} t @kbd{RET}}. (For an 206the command @kbd{M-x ert @key{RET} t @key{RET}}. (For an
207explanation of the @code{t} argument, @pxref{Test Selectors}.) ERT will pop 207explanation of the @code{t} argument, @pxref{Test Selectors}.) ERT will pop
208up a new buffer, the ERT results buffer, showing the results of the 208up a new buffer, the ERT results buffer, showing the results of the
209tests run. It looks like this: 209tests run. It looks like this:
@@ -262,9 +262,9 @@ for more details.
262 262
263@kindex TAB@r{, in ert results buffer} 263@kindex TAB@r{, in ert results buffer}
264@kindex S-TAB@r{, in ert results buffer} 264@kindex S-TAB@r{, in ert results buffer}
265In the ERT results buffer, @kbd{TAB} and @kbd{S-TAB} cycle between 265In the ERT results buffer, @kbd{@key{TAB}} and @kbd{S-@key{TAB}} cycle between
266buttons. Each name of a function or macro in this buffer is a button; 266buttons. Each name of a function or macro in this buffer is a button;
267moving point to it and typing @kbd{RET} jumps to its definition. 267moving point to it and typing @kbd{@key{RET}} jumps to its definition.
268 268
269@kindex r@r{, in ert results buffer} 269@kindex r@r{, in ert results buffer}
270@kindex d@r{, in ert results buffer} 270@kindex d@r{, in ert results buffer}
@@ -273,7 +273,7 @@ moving point to it and typing @kbd{RET} jumps to its definition.
273@cindex backtrace of a failed test 273@cindex backtrace of a failed test
274Pressing @kbd{r} re-runs the test near point on its own. Pressing 274Pressing @kbd{r} re-runs the test near point on its own. Pressing
275@kbd{d} re-runs it with the debugger enabled. @kbd{.} jumps to the 275@kbd{d} re-runs it with the debugger enabled. @kbd{.} jumps to the
276definition of the test near point (@kbd{RET} has the same effect if 276definition of the test near point (@kbd{@key{RET}} has the same effect if
277point is on the name of the test). On a failed test, @kbd{b} shows 277point is on the name of the test). On a failed test, @kbd{b} shows
278the backtrace of the failure. 278the backtrace of the failure.
279 279
@@ -817,7 +817,7 @@ failed. This can be useful to figure out how far it got.
817@item 817@item
818You can instrument tests for debugging the same way you instrument 818You can instrument tests for debugging the same way you instrument
819@code{defun}s for debugging: go to the source code of the test and 819@code{defun}s for debugging: go to the source code of the test and
820type @kbd{@kbd{C-u} @kbd{C-M-x}}. Then, go back to the ERT buffer and 820type @kbd{C-u C-M-x}. Then, go back to the ERT buffer and
821re-run the test with @kbd{r} or @kbd{d}. 821re-run the test with @kbd{r} or @kbd{d}.
822 822
823@cindex discard obsolete test results 823@cindex discard obsolete test results
diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi
index 1789767dbe2..80077e5ccdb 100644
--- a/doc/misc/eshell.texi
+++ b/doc/misc/eshell.texi
@@ -894,7 +894,7 @@ will happen as it should (albeit slowly).
894 894
895@item Make sure syntax table is correct in Eshell mode 895@item Make sure syntax table is correct in Eshell mode
896 896
897So that @kbd{M-DEL} acts in a predictable manner, etc. 897So that @kbd{M-@key{DEL}} acts in a predictable manner, etc.
898 898
899@item Allow all Eshell buffers to share the same history and list-dir 899@item Allow all Eshell buffers to share the same history and list-dir
900 900
@@ -908,19 +908,19 @@ output from all subsequent commands is swallowed.
908Make it similar to the way that @file{esh-arg.el} is structured. 908Make it similar to the way that @file{esh-arg.el} is structured.
909Then add parsing of @samp{$[?\n]}. 909Then add parsing of @samp{$[?\n]}.
910 910
911@item After pressing @kbd{M-RET}, redisplay before running the next command 911@item After pressing @kbd{M-@key{RET}}, redisplay before running the next command
912 912
913@item Argument predicates and modifiers should work anywhere in a path 913@item Argument predicates and modifiers should work anywhere in a path
914 914
915@example 915@example
916/usr/local/src/editors/vim $ vi **/CVS(/)/Root(.) 916/usr/local/src/editors/vim $ vi **/CVS(/)/Root(.) Invalid regexp:
917Invalid regexp: "Unmatched ( or \\(" 917"Unmatched ( or \\("
918@end example 918@end example
919 919
920With @command{zsh}, the glob above expands to all files named 920With @command{zsh}, the glob above expands to all files named
921@file{Root} in directories named @file{CVS}. 921@file{Root} in directories named @file{CVS}.
922 922
923@item Typing @samp{echo $@{locate locate@}/bin<TAB>} results in a Lisp error 923@item Typing @samp{echo $@{locate locate@}/bin@key{TAB}} results in a Lisp error
924 924
925Perhaps it should interpolate all permutations, and make that the 925Perhaps it should interpolate all permutations, and make that the
926globbing result, since otherwise hitting return here will result in 926globbing result, since otherwise hitting return here will result in
@@ -960,7 +960,7 @@ At the moment, this is not supported.
960An error should be generated only if @code{eshell-error-if-no-glob} is 960An error should be generated only if @code{eshell-error-if-no-glob} is
961non-@code{nil}. 961non-@code{nil}.
962 962
963@item @samp{(+ RET SPC TAB} does not cause @code{indent-according-to-mode} to occur 963@item @samp{(+ @key{RET} @key{SPC} @key{TAB}} does not cause @code{indent-according-to-mode} to occur
964 964
965@item Create @code{eshell-auto-accumulate-list} 965@item Create @code{eshell-auto-accumulate-list}
966 966
@@ -1172,8 +1172,8 @@ only. That way, it could be listed as a login shell.
1172@item Make @kbd{/} electric 1172@item Make @kbd{/} electric
1173 1173
1174So that it automatically expands and corrects pathnames. Or make 1174So that it automatically expands and corrects pathnames. Or make
1175pathname completion for Pcomplete auto-expand @samp{/u/i/std<TAB>} to 1175pathname completion for Pcomplete auto-expand @samp{/u/i/std@key{TAB}} to
1176@samp{/usr/include/std<TAB>}. 1176@samp{/usr/include/std@key{TAB}}.
1177 1177
1178@item Write the @command{pushd} stack to disk along with @code{last-dir-ring} 1178@item Write the @command{pushd} stack to disk along with @code{last-dir-ring}
1179 1179
@@ -1221,7 +1221,7 @@ If the first thing that I do after entering Emacs is to run
1221@code{eshell-command} and invoke @command{ls}, and then use @kbd{M-x 1221@code{eshell-command} and invoke @command{ls}, and then use @kbd{M-x
1222eshell}, it doesn't display anything. 1222eshell}, it doesn't display anything.
1223 1223
1224@item @kbd{M-RET} during a long command (using smart display) doesn't work 1224@item @kbd{M-@key{RET}} during a long command (using smart display) doesn't work
1225 1225
1226Since it keeps the cursor up where the command was invoked. 1226Since it keeps the cursor up where the command was invoked.
1227 1227
diff --git a/doc/misc/eww.texi b/doc/misc/eww.texi
index 258a2f2bff9..43adc2eda0f 100644
--- a/doc/misc/eww.texi
+++ b/doc/misc/eww.texi
@@ -99,7 +99,7 @@ web page hit @kbd{g} (@code{eww-reload}). Pressing @kbd{w}
99 99
100@findex eww-open-in-new-buffer 100@findex eww-open-in-new-buffer
101@kindex M-RET 101@kindex M-RET
102 The @kbd{M-RET} command (@code{eww-open-in-new-buffer}) opens the 102 The @kbd{M-@key{RET}} command (@code{eww-open-in-new-buffer}) opens the
103URL at point in a new EWW buffer, akin to opening a link in a new 103URL at point in a new EWW buffer, akin to opening a link in a new
104``tab'' in other browsers. 104``tab'' in other browsers.
105 105
diff --git a/doc/misc/forms.texi b/doc/misc/forms.texi
index 9857a67745e..70463419e80 100644
--- a/doc/misc/forms.texi
+++ b/doc/misc/forms.texi
@@ -263,14 +263,14 @@ prompted for confirmation before the record is deleted unless a numeric
263argument has been provided. 263argument has been provided.
264 264
265@findex forms-search-forward 265@findex forms-search-forward
266@kindex C-c C-s @var{regexp} @key{RET} 266@kindex C-c C-s @var{regexp} RET
267@item C-c C-s @var{regexp} @key{RET} 267@item C-c C-s @var{regexp} @key{RET}
268Search forward for @var{regexp} in all records following this one 268Search forward for @var{regexp} in all records following this one
269(@code{forms-search-forward}). If found, this record is shown. 269(@code{forms-search-forward}). If found, this record is shown.
270If you give an empty argument, the previous regexp is used again. 270If you give an empty argument, the previous regexp is used again.
271 271
272@findex forms-search-backward 272@findex forms-search-backward
273@kindex C-c C-r @var{regexp} @key{RET} 273@kindex C-c C-r @var{regexp} RET
274@item C-c C-r @var{regexp} @key{RET} 274@item C-c C-r @var{regexp} @key{RET}
275Search backward for @var{regexp} in all records following this one 275Search backward for @var{regexp} in all records following this one
276(@code{forms-search-backward}). If found, this record is shown. 276(@code{forms-search-backward}). If found, this record is shown.
@@ -334,25 +334,25 @@ The following function key definitions are set up in Forms mode
334(whether read-only or not): 334(whether read-only or not):
335 335
336@table @kbd 336@table @kbd
337@kindex next 337@kindex NEXT
338@item next 338@item @key{NEXT}
339forms-next-record 339forms-next-record
340 340
341@kindex prior 341@kindex PRIOR
342@item prior 342@item @key{PRIOR}
343forms-prev-record 343forms-prev-record
344 344
345@kindex begin 345@kindex BEGIN
346@item begin 346@item @key{BEGIN}
347forms-first-record 347forms-first-record
348 348
349@kindex end 349@kindex END
350@item end 350@item @key{END}
351forms-last-record 351forms-last-record
352 352
353@kindex S-Tab 353@kindex S-TAB
354@findex forms-prev-field 354@findex forms-prev-field
355@item S-Tab 355@item S-@key{TAB}
356forms-prev-field 356forms-prev-field
357@end table 357@end table
358 358
diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi
index 4175c88754e..efef01f6978 100644
--- a/doc/misc/gnus-faq.texi
+++ b/doc/misc/gnus-faq.texi
@@ -397,7 +397,7 @@ The ~/ means the home directory where Gnus and Emacs look
397for the configuration files. However, you don't really 397for the configuration files. However, you don't really
398need to know what this means, it suffices that Emacs knows 398need to know what this means, it suffices that Emacs knows
399what it means :-) You can type 399what it means :-) You can type
400@samp{C-x C-f ~/.gnus.el RET } 400@samp{C-x C-f ~/.gnus.el @key{RET}}
401(yes, with the forward slash, even on Windows), and 401(yes, with the forward slash, even on Windows), and
402Emacs will open the right file for you. (It will most 402Emacs will open the right file for you. (It will most
403likely be new, and thus empty.) 403likely be new, and thus empty.)
@@ -422,7 +422,7 @@ possibility to set environment variables. Create a new one with
422name HOME and value C:\myhome. Rebooting is not necessary. 422name HOME and value C:\myhome. Rebooting is not necessary.
423 423
424Now to create @file{~/.gnus.el}, say 424Now to create @file{~/.gnus.el}, say
425@samp{C-x C-f ~/.gnus.el RET C-x C-s}. 425@samp{C-x C-f ~/.gnus.el @key{RET} C-x C-s}.
426in Emacs. 426in Emacs.
427 427
428@node FAQ 3-3 428@node FAQ 3-3
@@ -459,11 +459,11 @@ subscribe to a group.
459@subsubheading Answer 459@subsubheading Answer
460 460
461If you know the name of the group say @samp{U 461If you know the name of the group say @samp{U
462name.of.group RET} in group buffer (use the 462name.of.group @key{RET}} in group buffer (use the
463tab-completion Luke). Otherwise hit ^ in group buffer, 463tab-completion Luke). Otherwise hit ^ in group buffer,
464this brings you to the server buffer. Now place point (the 464this brings you to the server buffer. Now place point (the
465cursor) over the server which carries the group you want, 465cursor) over the server which carries the group you want,
466hit @samp{RET}, move point to the group 466hit @samp{@key{RET}}, move point to the group
467you want to subscribe to and say @samp{u} 467you want to subscribe to and say @samp{u}
468to subscribe to it. 468to subscribe to it.
469 469
@@ -753,11 +753,11 @@ When I enter a group, all read messages are gone. How to view them again?
753@subsubheading Answer 753@subsubheading Answer
754 754
755If you enter the group by saying 755If you enter the group by saying
756@samp{RET} 756@samp{@key{RET}}
757in group buffer with point over the group, only unread and ticked messages are loaded. Say 757in group buffer with point over the group, only unread and ticked messages are loaded. Say
758@samp{C-u RET} 758@samp{C-u @key{RET}}
759instead to load all available messages. If you want only the 300 newest say 759instead to load all available messages. If you want only the 300 newest say
760@samp{C-u 300 RET} 760@samp{C-u 300 @key{RET}}
761 761
762Loading only unread messages can be annoying if you have threaded view enabled, say 762Loading only unread messages can be annoying if you have threaded view enabled, say
763 763
@@ -1019,7 +1019,7 @@ back ends. Gnus thinks ``highest-article-number @minus{}
1019lowest-article-number = total-number-of-articles''. This 1019lowest-article-number = total-number-of-articles''. This
1020works OK for Usenet groups, but if you delete and move 1020works OK for Usenet groups, but if you delete and move
1021many messages in mail groups, this fails. To cure the 1021many messages in mail groups, this fails. To cure the
1022symptom, enter the group via @samp{C-u RET} 1022symptom, enter the group via @samp{C-u @key{RET}}
1023(this makes Gnus get all messages), then 1023(this makes Gnus get all messages), then
1024hit @samp{M P b} to mark all messages and 1024hit @samp{M P b} to mark all messages and
1025then say @samp{B m name.of.group} to move 1025then say @samp{B m name.of.group} to move
@@ -1494,8 +1494,8 @@ place them in ~/.emacs:
1494@end example 1494@end example
1495@noindent 1495@noindent
1496 1496
1497Now you should be ready to go. Say @samp{M-x bbdb RET 1497Now you should be ready to go. Say @samp{M-x bbdb @key{RET}
1498RET} to open a bbdb buffer showing all 1498@key{RET}} to open a bbdb buffer showing all
1499entries. Say @samp{c} to create a new 1499entries. Say @samp{c} to create a new
1500entry, @samp{b} to search your BBDB and 1500entry, @samp{b} to search your BBDB and
1501@samp{C-o} to add a new field to an 1501@samp{C-o} to add a new field to an
@@ -1734,15 +1734,15 @@ world, you may find tools at
1734 1734
1735Now you've got to import this mbox file into Gnus. To do 1735Now you've got to import this mbox file into Gnus. To do
1736this, create a nndoc group based on the mbox file by 1736this, create a nndoc group based on the mbox file by
1737saying @samp{G f /path/file.mbox RET} in 1737saying @samp{G f /path/file.mbox @key{RET}} in
1738Group buffer. You now have read-only access to your 1738Group buffer. You now have read-only access to your
1739mail. If you want to import the messages to your normal 1739mail. If you want to import the messages to your normal
1740Gnus mail groups hierarchy, enter the nndoc group you've 1740Gnus mail groups hierarchy, enter the nndoc group you've
1741just created by saying @samp{C-u RET} 1741just created by saying @samp{C-u @key{RET}}
1742(thus making sure all messages are retrieved), mark all 1742(thus making sure all messages are retrieved), mark all
1743messages by saying @samp{M P b} and 1743messages by saying @samp{M P b} and
1744either copy them to the desired group by saying 1744either copy them to the desired group by saying
1745@samp{B c name.of.group RET} or send them 1745@samp{B c name.of.group @key{RET}} or send them
1746through nnmail-split-methods (respool them) by saying 1746through nnmail-split-methods (respool them) by saying
1747@samp{B r}. 1747@samp{B r}.
1748 1748
@@ -1809,7 +1809,7 @@ a Usenet group the easiest solution is probably to ask
1809@uref{http://groups.google.com, groups.google.com}, 1809@uref{http://groups.google.com, groups.google.com},
1810if you found the posting there, tell Google to display 1810if you found the posting there, tell Google to display
1811the raw message, look for the message-id, and say 1811the raw message, look for the message-id, and say
1812@samp{M-^ the@@message.id RET} in a 1812@samp{M-^ the@@message.id @key{RET}} in a
1813summary buffer. 1813summary buffer.
1814Since Gnus 5.10 there's also a Gnus interface for 1814Since Gnus 5.10 there's also a Gnus interface for
1815groups.google.com which you can call with 1815groups.google.com which you can call with
@@ -1853,7 +1853,7 @@ How to get rid of old unwanted mail?
1853 1853
1854You can of course just mark the mail you don't need 1854You can of course just mark the mail you don't need
1855anymore by saying @samp{#} with point 1855anymore by saying @samp{#} with point
1856over the mail and then say @samp{B DEL} 1856over the mail and then say @samp{B @key{DEL}}
1857to get rid of them forever. You could also instead of 1857to get rid of them forever. You could also instead of
1858actually deleting them, send them to a junk-group by 1858actually deleting them, send them to a junk-group by
1859saying @samp{B m nnml:trash-bin} which 1859saying @samp{B m nnml:trash-bin} which
@@ -2089,7 +2089,7 @@ How to find information and help inside Emacs?
2089@subsubheading Answer 2089@subsubheading Answer
2090 2090
2091The first stop should be the Gnus manual (Say 2091The first stop should be the Gnus manual (Say
2092@samp{C-h i d m Gnus RET} to start the 2092@samp{C-h i d m Gnus @key{RET}} to start the
2093Gnus manual, then walk through the menus or do a 2093Gnus manual, then walk through the menus or do a
2094full-text search with @samp{s}). Then 2094full-text search with @samp{s}). Then
2095there are the general Emacs help commands starting with 2095there are the general Emacs help commands starting with
@@ -2191,8 +2191,8 @@ The reason for this could be the way Gnus reads its
2191active file, see the node "The Active File" in the Gnus 2191active file, see the node "The Active File" in the Gnus
2192manual for things you might try to speed the process up. 2192manual for things you might try to speed the process up.
2193An other idea would be to byte compile your @file{~/.gnus.el} (say 2193An other idea would be to byte compile your @file{~/.gnus.el} (say
2194@samp{M-x byte-compile-file RET ~/.gnus.el 2194@samp{M-x byte-compile-file @key{RET} ~/.gnus.el
2195RET} to do it). Finally, if you have require 2195@key{RET}} to do it). Finally, if you have require
2196statements in your .gnus, you could replace them with 2196statements in your .gnus, you could replace them with
2197@code{with-eval-after-load}, which loads the stuff not at startup 2197@code{with-eval-after-load}, which loads the stuff not at startup
2198time, but when it's needed. Say you've got this in your 2198time, but when it's needed. Say you've got this in your
diff --git a/doc/misc/gnus-news.texi b/doc/misc/gnus-news.texi
index 91908584c96..171f59a3ad0 100644
--- a/doc/misc/gnus-news.texi
+++ b/doc/misc/gnus-news.texi
@@ -324,7 +324,7 @@ messages are deleted again).
324@itemize @bullet 324@itemize @bullet
325 325
326@item The tool bar has been updated to use GNOME icons. 326@item The tool bar has been updated to use GNOME icons.
327You can also customize the tool bars: @kbd{M-x customize-apropos RET 327You can also customize the tool bars: @kbd{M-x customize-apropos @key{RET}
328-tool-bar$} should get you started. (Only for Emacs, not in XEmacs.) 328-tool-bar$} should get you started. (Only for Emacs, not in XEmacs.)
329@c FIXME: Document this in the manual 329@c FIXME: Document this in the manual
330 330
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index 17fbe0e3e39..8a0b6319363 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -959,7 +959,6 @@ Emacs for Heathens
959If you haven't used Emacs much before using Gnus, read @ref{Emacs for 959If you haven't used Emacs much before using Gnus, read @ref{Emacs for
960Heathens} first. 960Heathens} first.
961 961
962@kindex M-x gnus
963@findex gnus 962@findex gnus
964If your system administrator has set things up properly, starting Gnus 963If your system administrator has set things up properly, starting Gnus
965and reading news is extremely easy---you just type @kbd{M-x gnus} in 964and reading news is extremely easy---you just type @kbd{M-x gnus} in
@@ -969,7 +968,6 @@ minimal setup for posting should also customize the variables
969@code{user-full-name} and @code{user-mail-address}. 968@code{user-full-name} and @code{user-mail-address}.
970 969
971@findex gnus-other-frame 970@findex gnus-other-frame
972@kindex M-x gnus-other-frame
973If you want to start Gnus in a different frame, you can use the command 971If you want to start Gnus in a different frame, you can use the command
974@kbd{M-x gnus-other-frame} instead. 972@kbd{M-x gnus-other-frame} instead.
975 973
@@ -1000,7 +998,7 @@ terminology section (@pxref{Terminology}).
1000First of all, you should know that there is a special buffer called 998First of all, you should know that there is a special buffer called
1001@file{*Server*} that lists all the servers Gnus knows about. You can 999@file{*Server*} that lists all the servers Gnus knows about. You can
1002press @kbd{^} from the Group buffer to see it. In the Server buffer, 1000press @kbd{^} from the Group buffer to see it. In the Server buffer,
1003you can press @kbd{RET} on a defined server to see all the groups it 1001you can press @kbd{@key{RET}} on a defined server to see all the groups it
1004serves (subscribed or not!). You can also add or delete servers, edit 1002serves (subscribed or not!). You can also add or delete servers, edit
1005a foreign server's definition, agentize or de-agentize a server, and 1003a foreign server's definition, agentize or de-agentize a server, and
1006do many other neat things. @xref{Server Buffer}. 1004do many other neat things. @xref{Server Buffer}.
@@ -1043,7 +1041,7 @@ If that fails as well, Gnus will try to use the machine running Emacs
1043as an @acronym{NNTP} server. That's a long shot, though. 1041as an @acronym{NNTP} server. That's a long shot, though.
1044 1042
1045@findex gnus-group-browse-foreign-server 1043@findex gnus-group-browse-foreign-server
1046@kindex B (Group) 1044@kindex B @r{(Group)}
1047However, if you use one @acronym{NNTP} server regularly and are just 1045However, if you use one @acronym{NNTP} server regularly and are just
1048interested in a couple of groups from a different server, you would be 1046interested in a couple of groups from a different server, you would be
1049better served by using the @kbd{B} command in the group buffer. It will 1047better served by using the @kbd{B} command in the group buffer. It will
@@ -1087,7 +1085,6 @@ groups, you'll find it difficult to actually do anything in the group
1087buffer. But, hey, that's your problem. Blllrph! 1085buffer. But, hey, that's your problem. Blllrph!
1088 1086
1089@findex gnus-no-server 1087@findex gnus-no-server
1090@kindex M-x gnus-no-server
1091@c @head 1088@c @head
1092If you know that the server is definitely down, or you just want to read 1089If you know that the server is definitely down, or you just want to read
1093your mail without bothering with the server at all, you can use the 1090your mail without bothering with the server at all, you can use the
@@ -1354,13 +1351,11 @@ you have read is by keeping track of article numbers. So when you
1354change @code{gnus-select-method}, your @file{.newsrc} file becomes 1351change @code{gnus-select-method}, your @file{.newsrc} file becomes
1355worthless. 1352worthless.
1356 1353
1357@kindex M-x gnus-group-clear-data-on-native-groups
1358@findex gnus-group-clear-data-on-native-groups 1354@findex gnus-group-clear-data-on-native-groups
1359You can use the @kbd{M-x gnus-group-clear-data-on-native-groups} 1355You can use the @kbd{M-x gnus-group-clear-data-on-native-groups}
1360command to clear out all data that you have on your native groups. 1356command to clear out all data that you have on your native groups.
1361Use with caution. 1357Use with caution.
1362 1358
1363@kindex M-x gnus-group-clear-data
1364@findex gnus-group-clear-data 1359@findex gnus-group-clear-data
1365Clear the data from the current group only---nix out marks and the 1360Clear the data from the current group only---nix out marks and the
1366list of read articles (@code{gnus-group-clear-data}). 1361list of read articles (@code{gnus-group-clear-data}).
@@ -1704,7 +1699,7 @@ long as Gnus is active.
1704@end menu 1699@end menu
1705 1700
1706You can customize the Group Mode tool bar, see @kbd{M-x 1701You can customize the Group Mode tool bar, see @kbd{M-x
1707customize-apropos RET gnus-group-tool-bar}. This feature is only 1702customize-apropos @key{RET} gnus-group-tool-bar}. This feature is only
1708available in Emacs. 1703available in Emacs.
1709 1704
1710The tool bar icons are now (de)activated correctly depending on the 1705The tool bar icons are now (de)activated correctly depending on the
@@ -1989,37 +1984,37 @@ expected, hopefully.
1989@table @kbd 1984@table @kbd
1990 1985
1991@item n 1986@item n
1992@kindex n (Group) 1987@kindex n @r{(Group)}
1993@findex gnus-group-next-unread-group 1988@findex gnus-group-next-unread-group
1994Go to the next group that has unread articles 1989Go to the next group that has unread articles
1995(@code{gnus-group-next-unread-group}). 1990(@code{gnus-group-next-unread-group}).
1996 1991
1997@item p 1992@item p
1998@itemx DEL 1993@itemx @key{DEL}
1999@kindex DEL (Group) 1994@kindex DEL @r{(Group)}
2000@kindex p (Group) 1995@kindex p @r{(Group)}
2001@findex gnus-group-prev-unread-group 1996@findex gnus-group-prev-unread-group
2002Go to the previous group that has unread articles 1997Go to the previous group that has unread articles
2003(@code{gnus-group-prev-unread-group}). 1998(@code{gnus-group-prev-unread-group}).
2004 1999
2005@item N 2000@item N
2006@kindex N (Group) 2001@kindex N @r{(Group)}
2007@findex gnus-group-next-group 2002@findex gnus-group-next-group
2008Go to the next group (@code{gnus-group-next-group}). 2003Go to the next group (@code{gnus-group-next-group}).
2009 2004
2010@item P 2005@item P
2011@kindex P (Group) 2006@kindex P @r{(Group)}
2012@findex gnus-group-prev-group 2007@findex gnus-group-prev-group
2013Go to the previous group (@code{gnus-group-prev-group}). 2008Go to the previous group (@code{gnus-group-prev-group}).
2014 2009
2015@item M-n 2010@item M-n
2016@kindex M-n (Group) 2011@kindex M-n @r{(Group)}
2017@findex gnus-group-next-unread-group-same-level 2012@findex gnus-group-next-unread-group-same-level
2018Go to the next unread group on the same (or lower) level 2013Go to the next unread group on the same (or lower) level
2019(@code{gnus-group-next-unread-group-same-level}). 2014(@code{gnus-group-next-unread-group-same-level}).
2020 2015
2021@item M-p 2016@item M-p
2022@kindex M-p (Group) 2017@kindex M-p @r{(Group)}
2023@findex gnus-group-prev-unread-group-same-level 2018@findex gnus-group-prev-unread-group-same-level
2024Go to the previous unread group on the same (or lower) level 2019Go to the previous unread group on the same (or lower) level
2025(@code{gnus-group-prev-unread-group-same-level}). 2020(@code{gnus-group-prev-unread-group-same-level}).
@@ -2030,20 +2025,20 @@ Three commands for jumping to groups:
2030@table @kbd 2025@table @kbd
2031 2026
2032@item j 2027@item j
2033@kindex j (Group) 2028@kindex j @r{(Group)}
2034@findex gnus-group-jump-to-group 2029@findex gnus-group-jump-to-group
2035Jump to a group (and make it visible if it isn't already) 2030Jump to a group (and make it visible if it isn't already)
2036(@code{gnus-group-jump-to-group}). Killed groups can be jumped to, just 2031(@code{gnus-group-jump-to-group}). Killed groups can be jumped to, just
2037like living groups. 2032like living groups.
2038 2033
2039@item , 2034@item ,
2040@kindex , (Group) 2035@kindex , @r{(Group)}
2041@findex gnus-group-best-unread-group 2036@findex gnus-group-best-unread-group
2042Jump to the unread group with the lowest level 2037Jump to the unread group with the lowest level
2043(@code{gnus-group-best-unread-group}). 2038(@code{gnus-group-best-unread-group}).
2044 2039
2045@item . 2040@item .
2046@kindex . (Group) 2041@kindex . @r{(Group)}
2047@findex gnus-group-first-unread-group 2042@findex gnus-group-first-unread-group
2048Jump to the first group with unread articles 2043Jump to the first group with unread articles
2049(@code{gnus-group-first-unread-group}). 2044(@code{gnus-group-first-unread-group}).
@@ -2067,8 +2062,8 @@ Otherwise, the point is set to the group just exited. The default is
2067 2062
2068@table @kbd 2063@table @kbd
2069 2064
2070@item SPACE 2065@item @key{SPC}
2071@kindex SPACE (Group) 2066@kindex SPC @r{(Group)}
2072@findex gnus-group-read-group 2067@findex gnus-group-read-group
2073Select the current group, switch to the summary buffer and display the 2068Select the current group, switch to the summary buffer and display the
2074first unread article (@code{gnus-group-read-group}). If there are no 2069first unread article (@code{gnus-group-read-group}). If there are no
@@ -2079,16 +2074,16 @@ determines the number of articles Gnus will fetch. If @var{n} is
2079positive, Gnus fetches the @var{n} newest articles, if @var{n} is 2074positive, Gnus fetches the @var{n} newest articles, if @var{n} is
2080negative, Gnus fetches the @code{abs(@var{n})} oldest articles. 2075negative, Gnus fetches the @code{abs(@var{n})} oldest articles.
2081 2076
2082Thus, @kbd{SPC} enters the group normally, @kbd{C-u SPC} offers old 2077Thus, @kbd{@key{SPC}} enters the group normally, @kbd{C-u @key{SPC}}
2083articles, @kbd{C-u 4 2 SPC} fetches the 42 newest articles, and @kbd{C-u 2078offers old articles, @kbd{C-u 4 2 @key{SPC}} fetches the 42 newest
2084- 4 2 SPC} fetches the 42 oldest ones. 2079articles, and @kbd{C-u - 4 2 @key{SPC}} fetches the 42 oldest ones.
2085 2080
2086When you are in the group (in the Summary buffer), you can type 2081When you are in the group (in the Summary buffer), you can type
2087@kbd{M-g} to fetch new articles, or @kbd{C-u M-g} to also show the old 2082@kbd{M-g} to fetch new articles, or @kbd{C-u M-g} to also show the old
2088ones. 2083ones.
2089 2084
2090@item RET 2085@item @key{RET}
2091@kindex RET (Group) 2086@kindex RET @r{(Group)}
2092@findex gnus-group-select-group 2087@findex gnus-group-select-group
2093Select the current group and switch to the summary buffer 2088Select the current group and switch to the summary buffer
2094(@code{gnus-group-select-group}). Takes the same arguments as 2089(@code{gnus-group-select-group}). Takes the same arguments as
@@ -2096,27 +2091,27 @@ Select the current group and switch to the summary buffer
2096does not display the first unread article automatically upon group 2091does not display the first unread article automatically upon group
2097entry. 2092entry.
2098 2093
2099@item M-RET 2094@item M-@key{RET}
2100@kindex M-RET (Group) 2095@kindex M-RET @r{(Group)}
2101@findex gnus-group-quick-select-group 2096@findex gnus-group-quick-select-group
2102This does the same as the command above, but tries to do it with the 2097This does the same as the command above, but tries to do it with the
2103minimum amount of fuzz (@code{gnus-group-quick-select-group}). No 2098minimum amount of fuzz (@code{gnus-group-quick-select-group}). No
2104scoring/killing will be performed, there will be no highlights and no 2099scoring/killing will be performed, there will be no highlights and no
2105expunging. This might be useful if you're in a real hurry and have to 2100expunging. This might be useful if you're in a real hurry and have to
2106enter some humongous group. If you give a 0 prefix to this command 2101enter some humongous group. If you give a 0 prefix to this command
2107(i.e., @kbd{0 M-RET}), Gnus won't even generate the summary buffer, 2102(i.e., @kbd{0 M-@key{RET}}), Gnus won't even generate the summary buffer,
2108which is useful if you want to toggle threading before generating the 2103which is useful if you want to toggle threading before generating the
2109summary buffer (@pxref{Summary Generation Commands}). 2104summary buffer (@pxref{Summary Generation Commands}).
2110 2105
2111@item M-SPACE 2106@item M-@key{SPC}
2112@kindex M-SPACE (Group) 2107@kindex M-SPC @r{(Group)}
2113@findex gnus-group-visible-select-group 2108@findex gnus-group-visible-select-group
2114This is yet one more command that does the same as the @kbd{RET} 2109This is yet one more command that does the same as the @kbd{@key{RET}}
2115command, but this one does it without expunging and hiding dormants 2110command, but this one does it without expunging and hiding dormants
2116(@code{gnus-group-visible-select-group}). 2111(@code{gnus-group-visible-select-group}).
2117 2112
2118@item C-M-RET 2113@item C-M-@key{RET}
2119@kindex C-M-RET (Group) 2114@kindex C-M-RET @r{(Group)}
2120@findex gnus-group-select-group-ephemerally 2115@findex gnus-group-select-group-ephemerally
2121Finally, this command selects the current group ephemerally without 2116Finally, this command selects the current group ephemerally without
2122doing any processing of its contents 2117doing any processing of its contents
@@ -2164,7 +2159,7 @@ means Gnus never ignores old articles.
2164@vindex gnus-auto-select-first 2159@vindex gnus-auto-select-first
2165@vindex gnus-auto-select-subject 2160@vindex gnus-auto-select-subject
2166If @code{gnus-auto-select-first} is non-@code{nil}, select an article 2161If @code{gnus-auto-select-first} is non-@code{nil}, select an article
2167automatically when entering a group with the @kbd{SPACE} command. 2162automatically when entering a group with the @kbd{@key{SPC}} command.
2168Which article this is controlled by the 2163Which article this is controlled by the
2169@code{gnus-auto-select-subject} variable. Valid values for this 2164@code{gnus-auto-select-subject} variable. Valid values for this
2170variable are: 2165variable are:
@@ -2207,15 +2202,15 @@ selected.
2207The following commands allow for managing your subscriptions in the 2202The following commands allow for managing your subscriptions in the
2208Group buffer. If you want to subscribe to many groups, it's probably 2203Group buffer. If you want to subscribe to many groups, it's probably
2209more convenient to go to the @ref{Server Buffer}, and choose the 2204more convenient to go to the @ref{Server Buffer}, and choose the
2210server there using @kbd{RET} or @kbd{SPC}. Then you'll have the 2205server there using @kbd{@key{RET}} or @kbd{@key{SPC}}. Then you'll have the
2211commands listed in @ref{Browse Foreign Server} at hand. 2206commands listed in @ref{Browse Foreign Server} at hand.
2212 2207
2213@table @kbd 2208@table @kbd
2214 2209
2215@item S t 2210@item S t
2216@itemx u 2211@itemx u
2217@kindex S t (Group) 2212@kindex S t @r{(Group)}
2218@kindex u (Group) 2213@kindex u @r{(Group)}
2219@findex gnus-group-unsubscribe-current-group 2214@findex gnus-group-unsubscribe-current-group
2220@c @icon{gnus-group-unsubscribe} 2215@c @icon{gnus-group-unsubscribe}
2221Toggle subscription to the current group 2216Toggle subscription to the current group
@@ -2223,8 +2218,8 @@ Toggle subscription to the current group
2223 2218
2224@item S s 2219@item S s
2225@itemx U 2220@itemx U
2226@kindex S s (Group) 2221@kindex S s @r{(Group)}
2227@kindex U (Group) 2222@kindex U @r{(Group)}
2228@findex gnus-group-unsubscribe-group 2223@findex gnus-group-unsubscribe-group
2229Prompt for a group to subscribe, and then subscribe it. If it was 2224Prompt for a group to subscribe, and then subscribe it. If it was
2230subscribed already, unsubscribe it instead 2225subscribed already, unsubscribe it instead
@@ -2232,21 +2227,21 @@ subscribed already, unsubscribe it instead
2232 2227
2233@item S k 2228@item S k
2234@itemx C-k 2229@itemx C-k
2235@kindex S k (Group) 2230@kindex S k @r{(Group)}
2236@kindex C-k (Group) 2231@kindex C-k @r{(Group)}
2237@findex gnus-group-kill-group 2232@findex gnus-group-kill-group
2238@c @icon{gnus-group-kill-group} 2233@c @icon{gnus-group-kill-group}
2239Kill the current group (@code{gnus-group-kill-group}). 2234Kill the current group (@code{gnus-group-kill-group}).
2240 2235
2241@item S y 2236@item S y
2242@itemx C-y 2237@itemx C-y
2243@kindex S y (Group) 2238@kindex S y @r{(Group)}
2244@kindex C-y (Group) 2239@kindex C-y @r{(Group)}
2245@findex gnus-group-yank-group 2240@findex gnus-group-yank-group
2246Yank the last killed group (@code{gnus-group-yank-group}). 2241Yank the last killed group (@code{gnus-group-yank-group}).
2247 2242
2248@item C-x C-t 2243@item C-x C-t
2249@kindex C-x C-t (Group) 2244@kindex C-x C-t @r{(Group)}
2250@findex gnus-group-transpose-groups 2245@findex gnus-group-transpose-groups
2251Transpose two groups (@code{gnus-group-transpose-groups}). This isn't 2246Transpose two groups (@code{gnus-group-transpose-groups}). This isn't
2252really a subscription command, but you can use it instead of a 2247really a subscription command, but you can use it instead of a
@@ -2254,18 +2249,18 @@ kill-and-yank sequence sometimes.
2254 2249
2255@item S w 2250@item S w
2256@itemx C-w 2251@itemx C-w
2257@kindex S w (Group) 2252@kindex S w @r{(Group)}
2258@kindex C-w (Group) 2253@kindex C-w @r{(Group)}
2259@findex gnus-group-kill-region 2254@findex gnus-group-kill-region
2260Kill all groups in the region (@code{gnus-group-kill-region}). 2255Kill all groups in the region (@code{gnus-group-kill-region}).
2261 2256
2262@item S z 2257@item S z
2263@kindex S z (Group) 2258@kindex S z @r{(Group)}
2264@findex gnus-group-kill-all-zombies 2259@findex gnus-group-kill-all-zombies
2265Kill all zombie groups (@code{gnus-group-kill-all-zombies}). 2260Kill all zombie groups (@code{gnus-group-kill-all-zombies}).
2266 2261
2267@item S C-k 2262@item S C-k
2268@kindex S C-k (Group) 2263@kindex S C-k @r{(Group)}
2269@findex gnus-group-kill-level 2264@findex gnus-group-kill-level
2270Kill all groups on a certain level (@code{gnus-group-kill-level}). 2265Kill all groups on a certain level (@code{gnus-group-kill-level}).
2271These groups can't be yanked back after killing, so this command should 2266These groups can't be yanked back after killing, so this command should
@@ -2286,7 +2281,7 @@ Also @pxref{Group Levels}.
2286@table @kbd 2281@table @kbd
2287 2282
2288@item c 2283@item c
2289@kindex c (Group) 2284@kindex c @r{(Group)}
2290@findex gnus-group-catchup-current 2285@findex gnus-group-catchup-current
2291@vindex gnus-group-catchup-group-hook 2286@vindex gnus-group-catchup-group-hook
2292@c @icon{gnus-group-catchup-current} 2287@c @icon{gnus-group-catchup-current}
@@ -2296,19 +2291,18 @@ Mark all unticked articles in this group as read
2296the group buffer. 2291the group buffer.
2297 2292
2298@item C 2293@item C
2299@kindex C (Group) 2294@kindex C @r{(Group)}
2300@findex gnus-group-catchup-current-all 2295@findex gnus-group-catchup-current-all
2301Mark all articles in this group, even the ticked ones, as read 2296Mark all articles in this group, even the ticked ones, as read
2302(@code{gnus-group-catchup-current-all}). 2297(@code{gnus-group-catchup-current-all}).
2303 2298
2304@item M-c 2299@item M-c
2305@kindex M-c (Group) 2300@kindex M-c @r{(Group)}
2306@findex gnus-group-clear-data 2301@findex gnus-group-clear-data
2307Clear the data from the current group---nix out marks and the list of 2302Clear the data from the current group---nix out marks and the list of
2308read articles (@code{gnus-group-clear-data}). 2303read articles (@code{gnus-group-clear-data}).
2309 2304
2310@item M-x gnus-group-clear-data-on-native-groups 2305@item M-x gnus-group-clear-data-on-native-groups
2311@kindex M-x gnus-group-clear-data-on-native-groups
2312@findex gnus-group-clear-data-on-native-groups 2306@findex gnus-group-clear-data-on-native-groups
2313If you have switched from one @acronym{NNTP} server to another, all your marks 2307If you have switched from one @acronym{NNTP} server to another, all your marks
2314and read ranges have become worthless. You can use this command to 2308and read ranges have become worthless. You can use this command to
@@ -2334,7 +2328,7 @@ Remember: The higher the level of the group, the less important it is.
2334@table @kbd 2328@table @kbd
2335 2329
2336@item S l 2330@item S l
2337@kindex S l (Group) 2331@kindex S l @r{(Group)}
2338@findex gnus-group-set-current-level 2332@findex gnus-group-set-current-level
2339Set the level of the current group. If a numeric prefix is given, the 2333Set the level of the current group. If a numeric prefix is given, the
2340next @var{n} groups will have their levels set. The user will be 2334next @var{n} groups will have their levels set. The user will be
@@ -2478,37 +2472,37 @@ with the process mark and then execute the command.
2478@table @kbd 2472@table @kbd
2479 2473
2480@item # 2474@item #
2481@kindex # (Group) 2475@kindex # @r{(Group)}
2482@itemx M m 2476@itemx M m
2483@kindex M m (Group) 2477@kindex M m @r{(Group)}
2484@findex gnus-group-mark-group 2478@findex gnus-group-mark-group
2485Set the mark on the current group (@code{gnus-group-mark-group}). 2479Set the mark on the current group (@code{gnus-group-mark-group}).
2486 2480
2487@item M-# 2481@item M-#
2488@kindex M-# (Group) 2482@kindex M-# @r{(Group)}
2489@itemx M u 2483@itemx M u
2490@kindex M u (Group) 2484@kindex M u @r{(Group)}
2491@findex gnus-group-unmark-group 2485@findex gnus-group-unmark-group
2492Remove the mark from the current group 2486Remove the mark from the current group
2493(@code{gnus-group-unmark-group}). 2487(@code{gnus-group-unmark-group}).
2494 2488
2495@item M U 2489@item M U
2496@kindex M U (Group) 2490@kindex M U @r{(Group)}
2497@findex gnus-group-unmark-all-groups 2491@findex gnus-group-unmark-all-groups
2498Remove the mark from all groups (@code{gnus-group-unmark-all-groups}). 2492Remove the mark from all groups (@code{gnus-group-unmark-all-groups}).
2499 2493
2500@item M w 2494@item M w
2501@kindex M w (Group) 2495@kindex M w @r{(Group)}
2502@findex gnus-group-mark-region 2496@findex gnus-group-mark-region
2503Mark all groups between point and mark (@code{gnus-group-mark-region}). 2497Mark all groups between point and mark (@code{gnus-group-mark-region}).
2504 2498
2505@item M b 2499@item M b
2506@kindex M b (Group) 2500@kindex M b @r{(Group)}
2507@findex gnus-group-mark-buffer 2501@findex gnus-group-mark-buffer
2508Mark all groups in the buffer (@code{gnus-group-mark-buffer}). 2502Mark all groups in the buffer (@code{gnus-group-mark-buffer}).
2509 2503
2510@item M r 2504@item M r
2511@kindex M r (Group) 2505@kindex M r @r{(Group)}
2512@findex gnus-group-mark-regexp 2506@findex gnus-group-mark-regexp
2513Mark all groups that match some regular expression 2507Mark all groups that match some regular expression
2514(@code{gnus-group-mark-regexp}). 2508(@code{gnus-group-mark-regexp}).
@@ -2549,7 +2543,7 @@ variable @code{gnus-parameters}, @xref{Group Parameters}.
2549@table @kbd 2543@table @kbd
2550 2544
2551@item G m 2545@item G m
2552@kindex G m (Group) 2546@kindex G m @r{(Group)}
2553@findex gnus-group-make-group 2547@findex gnus-group-make-group
2554@cindex making groups 2548@cindex making groups
2555Make a new group (@code{gnus-group-make-group}). Gnus will prompt you 2549Make a new group (@code{gnus-group-make-group}). Gnus will prompt you
@@ -2557,13 +2551,13 @@ for a name, a method and possibly an @dfn{address}. For an easier way
2557to subscribe to @acronym{NNTP} groups (@pxref{Browse Foreign Server}). 2551to subscribe to @acronym{NNTP} groups (@pxref{Browse Foreign Server}).
2558 2552
2559@item G M 2553@item G M
2560@kindex G M (Group) 2554@kindex G M @r{(Group)}
2561@findex gnus-group-read-ephemeral-group 2555@findex gnus-group-read-ephemeral-group
2562Make an ephemeral group (@code{gnus-group-read-ephemeral-group}). Gnus 2556Make an ephemeral group (@code{gnus-group-read-ephemeral-group}). Gnus
2563will prompt you for a name, a method and an @dfn{address}. 2557will prompt you for a name, a method and an @dfn{address}.
2564 2558
2565@item G r 2559@item G r
2566@kindex G r (Group) 2560@kindex G r @r{(Group)}
2567@findex gnus-group-rename-group 2561@findex gnus-group-rename-group
2568@cindex renaming groups 2562@cindex renaming groups
2569Rename the current group to something else 2563Rename the current group to something else
@@ -2572,45 +2566,45 @@ groups---mail groups mostly. This command might very well be quite slow
2572on some back ends. 2566on some back ends.
2573 2567
2574@item G c 2568@item G c
2575@kindex G c (Group) 2569@kindex G c @r{(Group)}
2576@cindex customizing 2570@cindex customizing
2577@findex gnus-group-customize 2571@findex gnus-group-customize
2578Customize the group parameters (@code{gnus-group-customize}). 2572Customize the group parameters (@code{gnus-group-customize}).
2579 2573
2580@item G e 2574@item G e
2581@kindex G e (Group) 2575@kindex G e @r{(Group)}
2582@findex gnus-group-edit-group-method 2576@findex gnus-group-edit-group-method
2583@cindex renaming groups 2577@cindex renaming groups
2584Enter a buffer where you can edit the select method of the current 2578Enter a buffer where you can edit the select method of the current
2585group (@code{gnus-group-edit-group-method}). 2579group (@code{gnus-group-edit-group-method}).
2586 2580
2587@item G p 2581@item G p
2588@kindex G p (Group) 2582@kindex G p @r{(Group)}
2589@findex gnus-group-edit-group-parameters 2583@findex gnus-group-edit-group-parameters
2590Enter a buffer where you can edit the group parameters 2584Enter a buffer where you can edit the group parameters
2591(@code{gnus-group-edit-group-parameters}). 2585(@code{gnus-group-edit-group-parameters}).
2592 2586
2593@item G E 2587@item G E
2594@kindex G E (Group) 2588@kindex G E @r{(Group)}
2595@findex gnus-group-edit-group 2589@findex gnus-group-edit-group
2596Enter a buffer where you can edit the group info 2590Enter a buffer where you can edit the group info
2597(@code{gnus-group-edit-group}). 2591(@code{gnus-group-edit-group}).
2598 2592
2599@item G d 2593@item G d
2600@kindex G d (Group) 2594@kindex G d @r{(Group)}
2601@findex gnus-group-make-directory-group 2595@findex gnus-group-make-directory-group
2602@cindex nndir 2596@cindex nndir
2603Make a directory group (@pxref{Directory Groups}). You will be prompted 2597Make a directory group (@pxref{Directory Groups}). You will be prompted
2604for the directory's name (@code{gnus-group-make-directory-group}). 2598for the directory's name (@code{gnus-group-make-directory-group}).
2605 2599
2606@item G h 2600@item G h
2607@kindex G h (Group) 2601@kindex G h @r{(Group)}
2608@cindex help group 2602@cindex help group
2609@findex gnus-group-make-help-group 2603@findex gnus-group-make-help-group
2610Make the Gnus help group (@code{gnus-group-make-help-group}). 2604Make the Gnus help group (@code{gnus-group-make-help-group}).
2611 2605
2612@item G D 2606@item G D
2613@kindex G D (Group) 2607@kindex G D @r{(Group)}
2614@findex gnus-group-enter-directory 2608@findex gnus-group-enter-directory
2615@cindex nneething 2609@cindex nneething
2616Read an arbitrary directory as if it were a newsgroup with the 2610Read an arbitrary directory as if it were a newsgroup with the
@@ -2618,7 +2612,7 @@ Read an arbitrary directory as if it were a newsgroup with the
2618@xref{Anything Groups}. 2612@xref{Anything Groups}.
2619 2613
2620@item G f 2614@item G f
2621@kindex G f (Group) 2615@kindex G f @r{(Group)}
2622@findex gnus-group-make-doc-group 2616@findex gnus-group-make-doc-group
2623@cindex ClariNet Briefs 2617@cindex ClariNet Briefs
2624@cindex nndoc 2618@cindex nndoc
@@ -2634,14 +2628,14 @@ you run this command without a prefix, Gnus will guess at the file
2634type. @xref{Document Groups}. 2628type. @xref{Document Groups}.
2635 2629
2636@item G u 2630@item G u
2637@kindex G u (Group) 2631@kindex G u @r{(Group)}
2638@vindex gnus-useful-groups 2632@vindex gnus-useful-groups
2639@findex gnus-group-make-useful-group 2633@findex gnus-group-make-useful-group
2640Create one of the groups mentioned in @code{gnus-useful-groups} 2634Create one of the groups mentioned in @code{gnus-useful-groups}
2641(@code{gnus-group-make-useful-group}). 2635(@code{gnus-group-make-useful-group}).
2642 2636
2643@item G w 2637@item G w
2644@kindex G w (Group) 2638@kindex G w @r{(Group)}
2645@findex gnus-group-make-web-group 2639@findex gnus-group-make-web-group
2646@cindex Google 2640@cindex Google
2647@cindex nnweb 2641@cindex nnweb
@@ -2658,14 +2652,14 @@ to a particular group by using a match string like
2658@samp{shaving group:alt.sysadmin.recovery}. 2652@samp{shaving group:alt.sysadmin.recovery}.
2659 2653
2660@item G R 2654@item G R
2661@kindex G R (Group) 2655@kindex G R @r{(Group)}
2662@findex gnus-group-make-rss-group 2656@findex gnus-group-make-rss-group
2663Make a group based on an @acronym{RSS} feed 2657Make a group based on an @acronym{RSS} feed
2664(@code{gnus-group-make-rss-group}). You will be prompted for an URL@. 2658(@code{gnus-group-make-rss-group}). You will be prompted for an URL@.
2665@xref{RSS}. 2659@xref{RSS}.
2666 2660
2667@item G DEL 2661@item G @key{DEL}
2668@kindex G DEL (Group) 2662@kindex G DEL @r{(Group)}
2669@findex gnus-group-delete-group 2663@findex gnus-group-delete-group
2670This function will delete the current group 2664This function will delete the current group
2671(@code{gnus-group-delete-group}). If given a prefix, this function will 2665(@code{gnus-group-delete-group}). If given a prefix, this function will
@@ -2675,13 +2669,13 @@ absolutely sure of what you are doing. This command can't be used on
2675read-only groups (like @code{nntp} groups), though. 2669read-only groups (like @code{nntp} groups), though.
2676 2670
2677@item G V 2671@item G V
2678@kindex G V (Group) 2672@kindex G V @r{(Group)}
2679@findex gnus-group-make-empty-virtual 2673@findex gnus-group-make-empty-virtual
2680Make a new, fresh, empty @code{nnvirtual} group 2674Make a new, fresh, empty @code{nnvirtual} group
2681(@code{gnus-group-make-empty-virtual}). @xref{Virtual Groups}. 2675(@code{gnus-group-make-empty-virtual}). @xref{Virtual Groups}.
2682 2676
2683@item G v 2677@item G v
2684@kindex G v (Group) 2678@kindex G v @r{(Group)}
2685@findex gnus-group-add-to-virtual 2679@findex gnus-group-add-to-virtual
2686Add the current group to an @code{nnvirtual} group 2680Add the current group to an @code{nnvirtual} group
2687(@code{gnus-group-add-to-virtual}). Uses the process/prefix convention. 2681(@code{gnus-group-add-to-virtual}). Uses the process/prefix convention.
@@ -3260,8 +3254,8 @@ These commands all list various slices of the groups available.
3260 3254
3261@item l 3255@item l
3262@itemx A s 3256@itemx A s
3263@kindex A s (Group) 3257@kindex A s @r{(Group)}
3264@kindex l (Group) 3258@kindex l @r{(Group)}
3265@findex gnus-group-list-groups 3259@findex gnus-group-list-groups
3266List all groups that have unread articles 3260List all groups that have unread articles
3267(@code{gnus-group-list-groups}). If the numeric prefix is used, this 3261(@code{gnus-group-list-groups}). If the numeric prefix is used, this
@@ -3272,8 +3266,8 @@ groups).
3272 3266
3273@item L 3267@item L
3274@itemx A u 3268@itemx A u
3275@kindex A u (Group) 3269@kindex A u @r{(Group)}
3276@kindex L (Group) 3270@kindex L @r{(Group)}
3277@findex gnus-group-list-all-groups 3271@findex gnus-group-list-all-groups
3278List all groups, whether they have unread articles or not 3272List all groups, whether they have unread articles or not
3279(@code{gnus-group-list-all-groups}). If the numeric prefix is used, 3273(@code{gnus-group-list-all-groups}). If the numeric prefix is used,
@@ -3282,14 +3276,14 @@ it lists groups of level seven or lower (i.e., just subscribed and
3282unsubscribed groups). 3276unsubscribed groups).
3283 3277
3284@item A l 3278@item A l
3285@kindex A l (Group) 3279@kindex A l @r{(Group)}
3286@findex gnus-group-list-level 3280@findex gnus-group-list-level
3287List all unread groups on a specific level 3281List all unread groups on a specific level
3288(@code{gnus-group-list-level}). If given a prefix, also list the groups 3282(@code{gnus-group-list-level}). If given a prefix, also list the groups
3289with no unread articles. 3283with no unread articles.
3290 3284
3291@item A k 3285@item A k
3292@kindex A k (Group) 3286@kindex A k @r{(Group)}
3293@findex gnus-group-list-killed 3287@findex gnus-group-list-killed
3294List all killed groups (@code{gnus-group-list-killed}). If given a 3288List all killed groups (@code{gnus-group-list-killed}). If given a
3295prefix argument, really list all groups that are available, but aren't 3289prefix argument, really list all groups that are available, but aren't
@@ -3297,23 +3291,23 @@ currently (un)subscribed. This could entail reading the active file
3297from the server. 3291from the server.
3298 3292
3299@item A z 3293@item A z
3300@kindex A z (Group) 3294@kindex A z @r{(Group)}
3301@findex gnus-group-list-zombies 3295@findex gnus-group-list-zombies
3302List all zombie groups (@code{gnus-group-list-zombies}). 3296List all zombie groups (@code{gnus-group-list-zombies}).
3303 3297
3304@item A m 3298@item A m
3305@kindex A m (Group) 3299@kindex A m @r{(Group)}
3306@findex gnus-group-list-matching 3300@findex gnus-group-list-matching
3307List all unread, subscribed groups with names that match a regexp 3301List all unread, subscribed groups with names that match a regexp
3308(@code{gnus-group-list-matching}). 3302(@code{gnus-group-list-matching}).
3309 3303
3310@item A M 3304@item A M
3311@kindex A M (Group) 3305@kindex A M @r{(Group)}
3312@findex gnus-group-list-all-matching 3306@findex gnus-group-list-all-matching
3313List groups that match a regexp (@code{gnus-group-list-all-matching}). 3307List groups that match a regexp (@code{gnus-group-list-all-matching}).
3314 3308
3315@item A A 3309@item A A
3316@kindex A A (Group) 3310@kindex A A @r{(Group)}
3317@findex gnus-group-list-active 3311@findex gnus-group-list-active
3318List absolutely all groups in the active file(s) of the 3312List absolutely all groups in the active file(s) of the
3319server(s) you are connected to (@code{gnus-group-list-active}). This 3313server(s) you are connected to (@code{gnus-group-list-active}). This
@@ -3324,34 +3318,34 @@ don't exist (yet)---these will be listed as if they were killed groups.
3324Take the output with some grains of salt. 3318Take the output with some grains of salt.
3325 3319
3326@item A a 3320@item A a
3327@kindex A a (Group) 3321@kindex A a @r{(Group)}
3328@findex gnus-group-apropos 3322@findex gnus-group-apropos
3329List all groups that have names that match a regexp 3323List all groups that have names that match a regexp
3330(@code{gnus-group-apropos}). 3324(@code{gnus-group-apropos}).
3331 3325
3332@item A d 3326@item A d
3333@kindex A d (Group) 3327@kindex A d @r{(Group)}
3334@findex gnus-group-description-apropos 3328@findex gnus-group-description-apropos
3335List all groups that have names or descriptions that match a regexp 3329List all groups that have names or descriptions that match a regexp
3336(@code{gnus-group-description-apropos}). 3330(@code{gnus-group-description-apropos}).
3337 3331
3338@item A c 3332@item A c
3339@kindex A c (Group) 3333@kindex A c @r{(Group)}
3340@findex gnus-group-list-cached 3334@findex gnus-group-list-cached
3341List all groups with cached articles (@code{gnus-group-list-cached}). 3335List all groups with cached articles (@code{gnus-group-list-cached}).
3342 3336
3343@item A ? 3337@item A ?
3344@kindex A ? (Group) 3338@kindex A ? @r{(Group)}
3345@findex gnus-group-list-dormant 3339@findex gnus-group-list-dormant
3346List all groups with dormant articles (@code{gnus-group-list-dormant}). 3340List all groups with dormant articles (@code{gnus-group-list-dormant}).
3347 3341
3348@item A ! 3342@item A !
3349@kindex A ! (Group) 3343@kindex A ! @r{(Group)}
3350@findex gnus-group-list-ticked 3344@findex gnus-group-list-ticked
3351List all groups with ticked articles (@code{gnus-group-list-ticked}). 3345List all groups with ticked articles (@code{gnus-group-list-ticked}).
3352 3346
3353@item A / 3347@item A /
3354@kindex A / (Group) 3348@kindex A / @r{(Group)}
3355@findex gnus-group-list-limit 3349@findex gnus-group-list-limit
3356Further limit groups within the current selection 3350Further limit groups within the current selection
3357(@code{gnus-group-list-limit}). If you've first limited to groups 3351(@code{gnus-group-list-limit}). If you've first limited to groups
@@ -3361,12 +3355,12 @@ giving you the groups that have both dormant articles and cached
3361articles. 3355articles.
3362 3356
3363@item A f 3357@item A f
3364@kindex A f (Group) 3358@kindex A f @r{(Group)}
3365@findex gnus-group-list-flush 3359@findex gnus-group-list-flush
3366Flush groups from the current selection (@code{gnus-group-list-flush}). 3360Flush groups from the current selection (@code{gnus-group-list-flush}).
3367 3361
3368@item A p 3362@item A p
3369@kindex A p (Group) 3363@kindex A p @r{(Group)}
3370@findex gnus-group-list-plus 3364@findex gnus-group-list-plus
3371List groups plus the current selection (@code{gnus-group-list-plus}). 3365List groups plus the current selection (@code{gnus-group-list-plus}).
3372 3366
@@ -3390,7 +3384,7 @@ groups. It is @code{t} by default.
3390@section Sorting Groups 3384@section Sorting Groups
3391@cindex sorting groups 3385@cindex sorting groups
3392 3386
3393@kindex C-c C-s (Group) 3387@kindex C-c C-s @r{(Group)}
3394@findex gnus-group-sort-groups 3388@findex gnus-group-sort-groups
3395@vindex gnus-group-sort-function 3389@vindex gnus-group-sort-function
3396The @kbd{C-c C-s} (@code{gnus-group-sort-groups}) command sorts the 3390The @kbd{C-c C-s} (@code{gnus-group-sort-groups}) command sorts the
@@ -3446,43 +3440,43 @@ some sorting criteria:
3446 3440
3447@table @kbd 3441@table @kbd
3448@item G S a 3442@item G S a
3449@kindex G S a (Group) 3443@kindex G S a @r{(Group)}
3450@findex gnus-group-sort-groups-by-alphabet 3444@findex gnus-group-sort-groups-by-alphabet
3451Sort the group buffer alphabetically by group name 3445Sort the group buffer alphabetically by group name
3452(@code{gnus-group-sort-groups-by-alphabet}). 3446(@code{gnus-group-sort-groups-by-alphabet}).
3453 3447
3454@item G S u 3448@item G S u
3455@kindex G S u (Group) 3449@kindex G S u @r{(Group)}
3456@findex gnus-group-sort-groups-by-unread 3450@findex gnus-group-sort-groups-by-unread
3457Sort the group buffer by the number of unread articles 3451Sort the group buffer by the number of unread articles
3458(@code{gnus-group-sort-groups-by-unread}). 3452(@code{gnus-group-sort-groups-by-unread}).
3459 3453
3460@item G S l 3454@item G S l
3461@kindex G S l (Group) 3455@kindex G S l @r{(Group)}
3462@findex gnus-group-sort-groups-by-level 3456@findex gnus-group-sort-groups-by-level
3463Sort the group buffer by group level 3457Sort the group buffer by group level
3464(@code{gnus-group-sort-groups-by-level}). 3458(@code{gnus-group-sort-groups-by-level}).
3465 3459
3466@item G S v 3460@item G S v
3467@kindex G S v (Group) 3461@kindex G S v @r{(Group)}
3468@findex gnus-group-sort-groups-by-score 3462@findex gnus-group-sort-groups-by-score
3469Sort the group buffer by group score 3463Sort the group buffer by group score
3470(@code{gnus-group-sort-groups-by-score}). @xref{Group Score}. 3464(@code{gnus-group-sort-groups-by-score}). @xref{Group Score}.
3471 3465
3472@item G S r 3466@item G S r
3473@kindex G S r (Group) 3467@kindex G S r @r{(Group)}
3474@findex gnus-group-sort-groups-by-rank 3468@findex gnus-group-sort-groups-by-rank
3475Sort the group buffer by group rank 3469Sort the group buffer by group rank
3476(@code{gnus-group-sort-groups-by-rank}). @xref{Group Score}. 3470(@code{gnus-group-sort-groups-by-rank}). @xref{Group Score}.
3477 3471
3478@item G S m 3472@item G S m
3479@kindex G S m (Group) 3473@kindex G S m @r{(Group)}
3480@findex gnus-group-sort-groups-by-method 3474@findex gnus-group-sort-groups-by-method
3481Sort the group buffer alphabetically by back end name@* 3475Sort the group buffer alphabetically by back end name@*
3482(@code{gnus-group-sort-groups-by-method}). 3476(@code{gnus-group-sort-groups-by-method}).
3483 3477
3484@item G S n 3478@item G S n
3485@kindex G S n (Group) 3479@kindex G S n @r{(Group)}
3486@findex gnus-group-sort-groups-by-real-name 3480@findex gnus-group-sort-groups-by-real-name
3487Sort the group buffer alphabetically by real (unprefixed) group name 3481Sort the group buffer alphabetically by real (unprefixed) group name
3488(@code{gnus-group-sort-groups-by-real-name}). 3482(@code{gnus-group-sort-groups-by-real-name}).
@@ -3499,49 +3493,49 @@ You can also sort a subset of the groups:
3499 3493
3500@table @kbd 3494@table @kbd
3501@item G P a 3495@item G P a
3502@kindex G P a (Group) 3496@kindex G P a @r{(Group)}
3503@findex gnus-group-sort-selected-groups-by-alphabet 3497@findex gnus-group-sort-selected-groups-by-alphabet
3504Sort the groups alphabetically by group name 3498Sort the groups alphabetically by group name
3505(@code{gnus-group-sort-selected-groups-by-alphabet}). 3499(@code{gnus-group-sort-selected-groups-by-alphabet}).
3506 3500
3507@item G P u 3501@item G P u
3508@kindex G P u (Group) 3502@kindex G P u @r{(Group)}
3509@findex gnus-group-sort-selected-groups-by-unread 3503@findex gnus-group-sort-selected-groups-by-unread
3510Sort the groups by the number of unread articles 3504Sort the groups by the number of unread articles
3511(@code{gnus-group-sort-selected-groups-by-unread}). 3505(@code{gnus-group-sort-selected-groups-by-unread}).
3512 3506
3513@item G P l 3507@item G P l
3514@kindex G P l (Group) 3508@kindex G P l @r{(Group)}
3515@findex gnus-group-sort-selected-groups-by-level 3509@findex gnus-group-sort-selected-groups-by-level
3516Sort the groups by group level 3510Sort the groups by group level
3517(@code{gnus-group-sort-selected-groups-by-level}). 3511(@code{gnus-group-sort-selected-groups-by-level}).
3518 3512
3519@item G P v 3513@item G P v
3520@kindex G P v (Group) 3514@kindex G P v @r{(Group)}
3521@findex gnus-group-sort-selected-groups-by-score 3515@findex gnus-group-sort-selected-groups-by-score
3522Sort the groups by group score 3516Sort the groups by group score
3523(@code{gnus-group-sort-selected-groups-by-score}). @xref{Group Score}. 3517(@code{gnus-group-sort-selected-groups-by-score}). @xref{Group Score}.
3524 3518
3525@item G P r 3519@item G P r
3526@kindex G P r (Group) 3520@kindex G P r @r{(Group)}
3527@findex gnus-group-sort-selected-groups-by-rank 3521@findex gnus-group-sort-selected-groups-by-rank
3528Sort the groups by group rank 3522Sort the groups by group rank
3529(@code{gnus-group-sort-selected-groups-by-rank}). @xref{Group Score}. 3523(@code{gnus-group-sort-selected-groups-by-rank}). @xref{Group Score}.
3530 3524
3531@item G P m 3525@item G P m
3532@kindex G P m (Group) 3526@kindex G P m @r{(Group)}
3533@findex gnus-group-sort-selected-groups-by-method 3527@findex gnus-group-sort-selected-groups-by-method
3534Sort the groups alphabetically by back end name@* 3528Sort the groups alphabetically by back end name@*
3535(@code{gnus-group-sort-selected-groups-by-method}). 3529(@code{gnus-group-sort-selected-groups-by-method}).
3536 3530
3537@item G P n 3531@item G P n
3538@kindex G P n (Group) 3532@kindex G P n @r{(Group)}
3539@findex gnus-group-sort-selected-groups-by-real-name 3533@findex gnus-group-sort-selected-groups-by-real-name
3540Sort the groups alphabetically by real (unprefixed) group name 3534Sort the groups alphabetically by real (unprefixed) group name
3541(@code{gnus-group-sort-selected-groups-by-real-name}). 3535(@code{gnus-group-sort-selected-groups-by-real-name}).
3542 3536
3543@item G P s 3537@item G P s
3544@kindex G P s (Group) 3538@kindex G P s @r{(Group)}
3545@findex gnus-group-sort-selected-groups 3539@findex gnus-group-sort-selected-groups
3546Sort the groups according to @code{gnus-group-sort-function}. 3540Sort the groups according to @code{gnus-group-sort-function}.
3547 3541
@@ -3557,13 +3551,13 @@ move groups around.
3557 3551
3558@table @kbd 3552@table @kbd
3559@item b 3553@item b
3560@kindex b (Group) 3554@kindex b @r{(Group)}
3561@findex gnus-group-check-bogus-groups 3555@findex gnus-group-check-bogus-groups
3562Find bogus groups and delete them 3556Find bogus groups and delete them
3563(@code{gnus-group-check-bogus-groups}). 3557(@code{gnus-group-check-bogus-groups}).
3564 3558
3565@item F 3559@item F
3566@kindex F (Group) 3560@kindex F @r{(Group)}
3567@findex gnus-group-find-new-groups 3561@findex gnus-group-find-new-groups
3568Find new groups and process them (@code{gnus-group-find-new-groups}). 3562Find new groups and process them (@code{gnus-group-find-new-groups}).
3569With 1 @kbd{C-u}, use the @code{ask-server} method to query the server 3563With 1 @kbd{C-u}, use the @code{ask-server} method to query the server
@@ -3572,7 +3566,7 @@ to query the server for new groups, and subscribe the new groups as
3572zombies. 3566zombies.
3573 3567
3574@item C-c C-x 3568@item C-c C-x
3575@kindex C-c C-x (Group) 3569@kindex C-c C-x @r{(Group)}
3576@findex gnus-group-expire-articles 3570@findex gnus-group-expire-articles
3577@cindex expiring mail 3571@cindex expiring mail
3578Run all expirable articles in the current group through the expiry 3572Run all expirable articles in the current group through the expiry
@@ -3581,7 +3575,7 @@ all expirable articles in the group that have been around for a while.
3581(@pxref{Expiring Mail}). 3575(@pxref{Expiring Mail}).
3582 3576
3583@item C-c C-M-x 3577@item C-c C-M-x
3584@kindex C-c C-M-x (Group) 3578@kindex C-c C-M-x @r{(Group)}
3585@findex gnus-group-expire-all-groups 3579@findex gnus-group-expire-all-groups
3586@cindex expiring mail 3580@cindex expiring mail
3587Run all expirable articles in all groups through the expiry process 3581Run all expirable articles in all groups through the expiry process
@@ -3597,7 +3591,7 @@ Run all expirable articles in all groups through the expiry process
3597 3591
3598@table @kbd 3592@table @kbd
3599@item B 3593@item B
3600@kindex B (Group) 3594@kindex B @r{(Group)}
3601@findex gnus-group-browse-foreign-server 3595@findex gnus-group-browse-foreign-server
3602You will be queried for a select method and a server name. Gnus will 3596You will be queried for a select method and a server name. Gnus will
3603then attempt to contact this server and let you browse the groups there 3597then attempt to contact this server and let you browse the groups there
@@ -3613,28 +3607,28 @@ Here's a list of keystrokes available in the browse mode:
3613 3607
3614@table @kbd 3608@table @kbd
3615@item n 3609@item n
3616@kindex n (Browse) 3610@kindex n @r{(Browse)}
3617@findex gnus-group-next-group 3611@findex gnus-group-next-group
3618Go to the next group (@code{gnus-group-next-group}). 3612Go to the next group (@code{gnus-group-next-group}).
3619 3613
3620@item p 3614@item p
3621@kindex p (Browse) 3615@kindex p @r{(Browse)}
3622@findex gnus-group-prev-group 3616@findex gnus-group-prev-group
3623Go to the previous group (@code{gnus-group-prev-group}). 3617Go to the previous group (@code{gnus-group-prev-group}).
3624 3618
3625@item SPACE 3619@item @key{SPC}
3626@kindex SPACE (Browse) 3620@kindex SPC @r{(Browse)}
3627@findex gnus-browse-read-group 3621@findex gnus-browse-read-group
3628Enter the current group and display the first article 3622Enter the current group and display the first article
3629(@code{gnus-browse-read-group}). 3623(@code{gnus-browse-read-group}).
3630 3624
3631@item RET 3625@item @key{RET}
3632@kindex RET (Browse) 3626@kindex RET @r{(Browse)}
3633@findex gnus-browse-select-group 3627@findex gnus-browse-select-group
3634Enter the current group (@code{gnus-browse-select-group}). 3628Enter the current group (@code{gnus-browse-select-group}).
3635 3629
3636@item u 3630@item u
3637@kindex u (Browse) 3631@kindex u @r{(Browse)}
3638@findex gnus-browse-unsubscribe-current-group 3632@findex gnus-browse-unsubscribe-current-group
3639@vindex gnus-browse-subscribe-newsgroup-method 3633@vindex gnus-browse-subscribe-newsgroup-method
3640Unsubscribe to the current group, or, as will be the case here, 3634Unsubscribe to the current group, or, as will be the case here,
@@ -3645,24 +3639,24 @@ using the variable @code{gnus-browse-subscribe-newsgroup-method}. See
3645 3639
3646@item l 3640@item l
3647@itemx q 3641@itemx q
3648@kindex q (Browse) 3642@kindex q @r{(Browse)}
3649@kindex l (Browse) 3643@kindex l @r{(Browse)}
3650@findex gnus-browse-exit 3644@findex gnus-browse-exit
3651Exit browse mode (@code{gnus-browse-exit}). 3645Exit browse mode (@code{gnus-browse-exit}).
3652 3646
3653@item d 3647@item d
3654@kindex d (Browse) 3648@kindex d @r{(Browse)}
3655@findex gnus-browse-describe-group 3649@findex gnus-browse-describe-group
3656Describe the current group (@code{gnus-browse-describe-group}). 3650Describe the current group (@code{gnus-browse-describe-group}).
3657 3651
3658@item ? 3652@item ?
3659@kindex ? (Browse) 3653@kindex ? @r{(Browse)}
3660@findex gnus-browse-describe-briefly 3654@findex gnus-browse-describe-briefly
3661Describe browse mode briefly (well, there's not much to describe, is 3655Describe browse mode briefly (well, there's not much to describe, is
3662there) (@code{gnus-browse-describe-briefly}). 3656there) (@code{gnus-browse-describe-briefly}).
3663 3657
3664@item DEL 3658@item @key{DEL}
3665@kindex DEL (Browse) 3659@kindex DEL @r{(Browse)}
3666@findex gnus-browse-delete-group 3660@findex gnus-browse-delete-group
3667This function will delete the current group 3661This function will delete the current group
3668(@code{gnus-browse-delete-group}). If given a prefix, this function 3662(@code{gnus-browse-delete-group}). If given a prefix, this function
@@ -3680,20 +3674,20 @@ Yes, Gnus is ex(c)iting.
3680 3674
3681@table @kbd 3675@table @kbd
3682@item z 3676@item z
3683@kindex z (Group) 3677@kindex z @r{(Group)}
3684@findex gnus-group-suspend 3678@findex gnus-group-suspend
3685Suspend Gnus (@code{gnus-group-suspend}). This doesn't really exit Gnus, 3679Suspend Gnus (@code{gnus-group-suspend}). This doesn't really exit Gnus,
3686but it kills all buffers except the Group buffer. I'm not sure why this 3680but it kills all buffers except the Group buffer. I'm not sure why this
3687is a gain, but then who am I to judge? 3681is a gain, but then who am I to judge?
3688 3682
3689@item q 3683@item q
3690@kindex q (Group) 3684@kindex q @r{(Group)}
3691@findex gnus-group-exit 3685@findex gnus-group-exit
3692@c @icon{gnus-group-exit} 3686@c @icon{gnus-group-exit}
3693Quit Gnus (@code{gnus-group-exit}). 3687Quit Gnus (@code{gnus-group-exit}).
3694 3688
3695@item Q 3689@item Q
3696@kindex Q (Group) 3690@kindex Q @r{(Group)}
3697@findex gnus-group-quit 3691@findex gnus-group-quit
3698Quit Gnus without saving the @file{.newsrc} files (@code{gnus-group-quit}). 3692Quit Gnus without saving the @file{.newsrc} files (@code{gnus-group-quit}).
3699The dribble file will be saved, though (@pxref{Auto Save}). 3693The dribble file will be saved, though (@pxref{Auto Save}).
@@ -3752,7 +3746,7 @@ Gnus
3752@end example 3746@end example
3753 3747
3754@findex gnus-topic-mode 3748@findex gnus-topic-mode
3755@kindex t (Group) 3749@kindex t @r{(Group)}
3756To get this @emph{fab} functionality you simply turn on (ooh!) the 3750To get this @emph{fab} functionality you simply turn on (ooh!) the
3757@code{gnus-topic} minor mode---type @kbd{t} in the group buffer. (This 3751@code{gnus-topic} minor mode---type @kbd{t} in the group buffer. (This
3758is a toggling command.) 3752is a toggling command.)
@@ -3801,22 +3795,22 @@ the way you like.
3801@table @kbd 3795@table @kbd
3802 3796
3803@item T n 3797@item T n
3804@kindex T n (Topic) 3798@kindex T n @r{(Topic)}
3805@findex gnus-topic-create-topic 3799@findex gnus-topic-create-topic
3806Prompt for a new topic name and create it 3800Prompt for a new topic name and create it
3807(@code{gnus-topic-create-topic}). 3801(@code{gnus-topic-create-topic}).
3808 3802
3809@item T TAB 3803@item T @key{TAB}
3810@itemx TAB 3804@itemx @key{TAB}
3811@kindex T TAB (Topic) 3805@kindex T TAB @r{(Topic)}
3812@kindex TAB (Topic) 3806@kindex TAB @r{(Topic)}
3813@findex gnus-topic-indent 3807@findex gnus-topic-indent
3814``Indent'' the current topic so that it becomes a sub-topic of the 3808``Indent'' the current topic so that it becomes a sub-topic of the
3815previous topic (@code{gnus-topic-indent}). If given a prefix, 3809previous topic (@code{gnus-topic-indent}). If given a prefix,
3816``un-indent'' the topic instead. 3810``un-indent'' the topic instead.
3817 3811
3818@item M-TAB 3812@item M-@key{TAB}
3819@kindex M-TAB (Topic) 3813@kindex M-TAB @r{(Topic)}
3820@findex gnus-topic-unindent 3814@findex gnus-topic-unindent
3821``Un-indent'' the current topic so that it becomes a sub-topic of the 3815``Un-indent'' the current topic so that it becomes a sub-topic of the
3822parent of its current parent (@code{gnus-topic-unindent}). 3816parent of its current parent (@code{gnus-topic-unindent}).
@@ -3831,13 +3825,13 @@ kill and yank rather than cut and paste.
3831@table @kbd 3825@table @kbd
3832 3826
3833@item C-k 3827@item C-k
3834@kindex C-k (Topic) 3828@kindex C-k @r{(Topic)}
3835@findex gnus-topic-kill-group 3829@findex gnus-topic-kill-group
3836Kill a group or topic (@code{gnus-topic-kill-group}). All groups in the 3830Kill a group or topic (@code{gnus-topic-kill-group}). All groups in the
3837topic will be removed along with the topic. 3831topic will be removed along with the topic.
3838 3832
3839@item C-y 3833@item C-y
3840@kindex C-y (Topic) 3834@kindex C-y @r{(Topic)}
3841@findex gnus-topic-yank-group 3835@findex gnus-topic-yank-group
3842Yank the previously killed group or topic 3836Yank the previously killed group or topic
3843(@code{gnus-topic-yank-group}). Note that all topics will be yanked 3837(@code{gnus-topic-yank-group}). Note that all topics will be yanked
@@ -3860,10 +3854,10 @@ key.
3860 3854
3861@table @kbd 3855@table @kbd
3862 3856
3863@item RET 3857@item @key{RET}
3864@kindex RET (Topic) 3858@kindex RET @r{(Topic)}
3865@findex gnus-topic-select-group 3859@findex gnus-topic-select-group
3866@itemx SPACE 3860@itemx @key{SPC}
3867Either select a group or fold a topic (@code{gnus-topic-select-group}). 3861Either select a group or fold a topic (@code{gnus-topic-select-group}).
3868When you perform this command on a group, you'll enter the group, as 3862When you perform this command on a group, you'll enter the group, as
3869usual. When done on a topic line, the topic will be folded (if it was 3863usual. When done on a topic line, the topic will be folded (if it was
@@ -3878,38 +3872,38 @@ Now for a list of other commands, in no particular order.
3878@table @kbd 3872@table @kbd
3879 3873
3880@item T m 3874@item T m
3881@kindex T m (Topic) 3875@kindex T m @r{(Topic)}
3882@findex gnus-topic-move-group 3876@findex gnus-topic-move-group
3883Move the current group to some other topic 3877Move the current group to some other topic
3884(@code{gnus-topic-move-group}). This command uses the process/prefix 3878(@code{gnus-topic-move-group}). This command uses the process/prefix
3885convention (@pxref{Process/Prefix}). 3879convention (@pxref{Process/Prefix}).
3886 3880
3887@item T j 3881@item T j
3888@kindex T j (Topic) 3882@kindex T j @r{(Topic)}
3889@findex gnus-topic-jump-to-topic 3883@findex gnus-topic-jump-to-topic
3890Go to a topic (@code{gnus-topic-jump-to-topic}). 3884Go to a topic (@code{gnus-topic-jump-to-topic}).
3891 3885
3892@item T c 3886@item T c
3893@kindex T c (Topic) 3887@kindex T c @r{(Topic)}
3894@findex gnus-topic-copy-group 3888@findex gnus-topic-copy-group
3895Copy the current group to some other topic 3889Copy the current group to some other topic
3896(@code{gnus-topic-copy-group}). This command uses the process/prefix 3890(@code{gnus-topic-copy-group}). This command uses the process/prefix
3897convention (@pxref{Process/Prefix}). 3891convention (@pxref{Process/Prefix}).
3898 3892
3899@item T h 3893@item T h
3900@kindex T h (Topic) 3894@kindex T h @r{(Topic)}
3901@findex gnus-topic-hide-topic 3895@findex gnus-topic-hide-topic
3902Hide the current topic (@code{gnus-topic-hide-topic}). If given 3896Hide the current topic (@code{gnus-topic-hide-topic}). If given
3903a prefix, hide the topic permanently. 3897a prefix, hide the topic permanently.
3904 3898
3905@item T s 3899@item T s
3906@kindex T s (Topic) 3900@kindex T s @r{(Topic)}
3907@findex gnus-topic-show-topic 3901@findex gnus-topic-show-topic
3908Show the current topic (@code{gnus-topic-show-topic}). If given 3902Show the current topic (@code{gnus-topic-show-topic}). If given
3909a prefix, show the topic permanently. 3903a prefix, show the topic permanently.
3910 3904
3911@item T D 3905@item T D
3912@kindex T D (Topic) 3906@kindex T D @r{(Topic)}
3913@findex gnus-topic-remove-group 3907@findex gnus-topic-remove-group
3914Remove a group from the current topic (@code{gnus-topic-remove-group}). 3908Remove a group from the current topic (@code{gnus-topic-remove-group}).
3915This command is mainly useful if you have the same group in several 3909This command is mainly useful if you have the same group in several
@@ -3923,39 +3917,39 @@ This command uses the process/prefix convention
3923(@pxref{Process/Prefix}). 3917(@pxref{Process/Prefix}).
3924 3918
3925@item T M 3919@item T M
3926@kindex T M (Topic) 3920@kindex T M @r{(Topic)}
3927@findex gnus-topic-move-matching 3921@findex gnus-topic-move-matching
3928Move all groups that match some regular expression to a topic 3922Move all groups that match some regular expression to a topic
3929(@code{gnus-topic-move-matching}). 3923(@code{gnus-topic-move-matching}).
3930 3924
3931@item T C 3925@item T C
3932@kindex T C (Topic) 3926@kindex T C @r{(Topic)}
3933@findex gnus-topic-copy-matching 3927@findex gnus-topic-copy-matching
3934Copy all groups that match some regular expression to a topic 3928Copy all groups that match some regular expression to a topic
3935(@code{gnus-topic-copy-matching}). 3929(@code{gnus-topic-copy-matching}).
3936 3930
3937@item T H 3931@item T H
3938@kindex T H (Topic) 3932@kindex T H @r{(Topic)}
3939@findex gnus-topic-toggle-display-empty-topics 3933@findex gnus-topic-toggle-display-empty-topics
3940Toggle hiding empty topics 3934Toggle hiding empty topics
3941(@code{gnus-topic-toggle-display-empty-topics}). 3935(@code{gnus-topic-toggle-display-empty-topics}).
3942 3936
3943@item T # 3937@item T #
3944@kindex T # (Topic) 3938@kindex T # @r{(Topic)}
3945@findex gnus-topic-mark-topic 3939@findex gnus-topic-mark-topic
3946Mark all groups in the current topic with the process mark 3940Mark all groups in the current topic with the process mark
3947(@code{gnus-topic-mark-topic}). This command works recursively on 3941(@code{gnus-topic-mark-topic}). This command works recursively on
3948sub-topics unless given a prefix. 3942sub-topics unless given a prefix.
3949 3943
3950@item T M-# 3944@item T M-#
3951@kindex T M-# (Topic) 3945@kindex T M-# @r{(Topic)}
3952@findex gnus-topic-unmark-topic 3946@findex gnus-topic-unmark-topic
3953Remove the process mark from all groups in the current topic 3947Remove the process mark from all groups in the current topic
3954(@code{gnus-topic-unmark-topic}). This command works recursively on 3948(@code{gnus-topic-unmark-topic}). This command works recursively on
3955sub-topics unless given a prefix. 3949sub-topics unless given a prefix.
3956 3950
3957@item C-c C-x 3951@item C-c C-x
3958@kindex C-c C-x (Topic) 3952@kindex C-c C-x @r{(Topic)}
3959@findex gnus-topic-expire-articles 3953@findex gnus-topic-expire-articles
3960@cindex expiring mail 3954@cindex expiring mail
3961Run all expirable articles in the current group or topic through the 3955Run all expirable articles in the current group or topic through the
@@ -3963,33 +3957,33 @@ expiry process (if any)
3963(@code{gnus-topic-expire-articles}). (@pxref{Expiring Mail}). 3957(@code{gnus-topic-expire-articles}). (@pxref{Expiring Mail}).
3964 3958
3965@item T r 3959@item T r
3966@kindex T r (Topic) 3960@kindex T r @r{(Topic)}
3967@findex gnus-topic-rename 3961@findex gnus-topic-rename
3968Rename a topic (@code{gnus-topic-rename}). 3962Rename a topic (@code{gnus-topic-rename}).
3969 3963
3970@item T DEL 3964@item T @key{DEL}
3971@kindex T DEL (Topic) 3965@kindex T DEL @r{(Topic)}
3972@findex gnus-topic-delete 3966@findex gnus-topic-delete
3973Delete an empty topic (@code{gnus-topic-delete}). 3967Delete an empty topic (@code{gnus-topic-delete}).
3974 3968
3975@item A T 3969@item A T
3976@kindex A T (Topic) 3970@kindex A T @r{(Topic)}
3977@findex gnus-topic-list-active 3971@findex gnus-topic-list-active
3978List all groups that Gnus knows about in a topics-ified way 3972List all groups that Gnus knows about in a topics-ified way
3979(@code{gnus-topic-list-active}). 3973(@code{gnus-topic-list-active}).
3980 3974
3981@item T M-n 3975@item T M-n
3982@kindex T M-n (Topic) 3976@kindex T M-n @r{(Topic)}
3983@findex gnus-topic-goto-next-topic 3977@findex gnus-topic-goto-next-topic
3984Go to the next topic (@code{gnus-topic-goto-next-topic}). 3978Go to the next topic (@code{gnus-topic-goto-next-topic}).
3985 3979
3986@item T M-p 3980@item T M-p
3987@kindex T M-p (Topic) 3981@kindex T M-p @r{(Topic)}
3988@findex gnus-topic-goto-previous-topic 3982@findex gnus-topic-goto-previous-topic
3989Go to the previous topic (@code{gnus-topic-goto-previous-topic}). 3983Go to the previous topic (@code{gnus-topic-goto-previous-topic}).
3990 3984
3991@item G p 3985@item G p
3992@kindex G p (Topic) 3986@kindex G p @r{(Topic)}
3993@findex gnus-topic-edit-parameters 3987@findex gnus-topic-edit-parameters
3994@cindex group parameters 3988@cindex group parameters
3995@cindex topic parameters 3989@cindex topic parameters
@@ -4052,49 +4046,49 @@ commands:
4052 4046
4053@table @kbd 4047@table @kbd
4054@item T S a 4048@item T S a
4055@kindex T S a (Topic) 4049@kindex T S a @r{(Topic)}
4056@findex gnus-topic-sort-groups-by-alphabet 4050@findex gnus-topic-sort-groups-by-alphabet
4057Sort the current topic alphabetically by group name 4051Sort the current topic alphabetically by group name
4058(@code{gnus-topic-sort-groups-by-alphabet}). 4052(@code{gnus-topic-sort-groups-by-alphabet}).
4059 4053
4060@item T S u 4054@item T S u
4061@kindex T S u (Topic) 4055@kindex T S u @r{(Topic)}
4062@findex gnus-topic-sort-groups-by-unread 4056@findex gnus-topic-sort-groups-by-unread
4063Sort the current topic by the number of unread articles 4057Sort the current topic by the number of unread articles
4064(@code{gnus-topic-sort-groups-by-unread}). 4058(@code{gnus-topic-sort-groups-by-unread}).
4065 4059
4066@item T S l 4060@item T S l
4067@kindex T S l (Topic) 4061@kindex T S l @r{(Topic)}
4068@findex gnus-topic-sort-groups-by-level 4062@findex gnus-topic-sort-groups-by-level
4069Sort the current topic by group level 4063Sort the current topic by group level
4070(@code{gnus-topic-sort-groups-by-level}). 4064(@code{gnus-topic-sort-groups-by-level}).
4071 4065
4072@item T S v 4066@item T S v
4073@kindex T S v (Topic) 4067@kindex T S v @r{(Topic)}
4074@findex gnus-topic-sort-groups-by-score 4068@findex gnus-topic-sort-groups-by-score
4075Sort the current topic by group score 4069Sort the current topic by group score
4076(@code{gnus-topic-sort-groups-by-score}). @xref{Group Score}. 4070(@code{gnus-topic-sort-groups-by-score}). @xref{Group Score}.
4077 4071
4078@item T S r 4072@item T S r
4079@kindex T S r (Topic) 4073@kindex T S r @r{(Topic)}
4080@findex gnus-topic-sort-groups-by-rank 4074@findex gnus-topic-sort-groups-by-rank
4081Sort the current topic by group rank 4075Sort the current topic by group rank
4082(@code{gnus-topic-sort-groups-by-rank}). @xref{Group Score}. 4076(@code{gnus-topic-sort-groups-by-rank}). @xref{Group Score}.
4083 4077
4084@item T S m 4078@item T S m
4085@kindex T S m (Topic) 4079@kindex T S m @r{(Topic)}
4086@findex gnus-topic-sort-groups-by-method 4080@findex gnus-topic-sort-groups-by-method
4087Sort the current topic alphabetically by back end name 4081Sort the current topic alphabetically by back end name
4088(@code{gnus-topic-sort-groups-by-method}). 4082(@code{gnus-topic-sort-groups-by-method}).
4089 4083
4090@item T S e 4084@item T S e
4091@kindex T S e (Topic) 4085@kindex T S e @r{(Topic)}
4092@findex gnus-topic-sort-groups-by-server 4086@findex gnus-topic-sort-groups-by-server
4093Sort the current topic alphabetically by server name 4087Sort the current topic alphabetically by server name
4094(@code{gnus-topic-sort-groups-by-server}). 4088(@code{gnus-topic-sort-groups-by-server}).
4095 4089
4096@item T S s 4090@item T S s
4097@kindex T S s (Topic) 4091@kindex T S s @r{(Topic)}
4098@findex gnus-topic-sort-groups 4092@findex gnus-topic-sort-groups
4099Sort the current topic according to the function(s) given by the 4093Sort the current topic according to the function(s) given by the
4100@code{gnus-group-sort-function} variable 4094@code{gnus-group-sort-function} variable
@@ -4369,7 +4363,7 @@ header will be displayed incorrectly in the article buffer.
4369@table @kbd 4363@table @kbd
4370 4364
4371@item v 4365@item v
4372@kindex v (Group) 4366@kindex v @r{(Group)}
4373@cindex keys, reserved for users (Group) 4367@cindex keys, reserved for users (Group)
4374The key @kbd{v} is reserved for users. You can bind it to some 4368The key @kbd{v} is reserved for users. You can bind it to some
4375command or better use it as a prefix key. For example: 4369command or better use it as a prefix key. For example:
@@ -4385,13 +4379,13 @@ On keys reserved for users in Emacs and on keybindings in general
4385@xref{Keymaps, Keymaps, , emacs, The Emacs Editor}. 4379@xref{Keymaps, Keymaps, , emacs, The Emacs Editor}.
4386 4380
4387@item ^ 4381@item ^
4388@kindex ^ (Group) 4382@kindex ^ @r{(Group)}
4389@findex gnus-group-enter-server-mode 4383@findex gnus-group-enter-server-mode
4390Enter the server buffer (@code{gnus-group-enter-server-mode}). 4384Enter the server buffer (@code{gnus-group-enter-server-mode}).
4391@xref{Server Buffer}. 4385@xref{Server Buffer}.
4392 4386
4393@item a 4387@item a
4394@kindex a (Group) 4388@kindex a @r{(Group)}
4395@findex gnus-group-post-news 4389@findex gnus-group-post-news
4396Start composing a message (a news by default) 4390Start composing a message (a news by default)
4397(@code{gnus-group-post-news}). If given a prefix, post to the group 4391(@code{gnus-group-post-news}). If given a prefix, post to the group
@@ -4401,7 +4395,7 @@ article might be a mail instead of a news, if a mail group is specified
4401with the prefix argument. @xref{Composing Messages}. 4395with the prefix argument. @xref{Composing Messages}.
4402 4396
4403@item m 4397@item m
4404@kindex m (Group) 4398@kindex m @r{(Group)}
4405@findex gnus-group-mail 4399@findex gnus-group-mail
4406Mail a message somewhere (@code{gnus-group-mail}). If given a prefix, 4400Mail a message somewhere (@code{gnus-group-mail}). If given a prefix,
4407use the posting style of the group under the point. If the prefix is 1, 4401use the posting style of the group under the point. If the prefix is 1,
@@ -4409,7 +4403,7 @@ prompt for a group name to find the posting style.
4409@xref{Composing Messages}. 4403@xref{Composing Messages}.
4410 4404
4411@item i 4405@item i
4412@kindex i (Group) 4406@kindex i @r{(Group)}
4413@findex gnus-group-news 4407@findex gnus-group-news
4414Start composing a news (@code{gnus-group-news}). If given a prefix, 4408Start composing a news (@code{gnus-group-news}). If given a prefix,
4415post to the group under the point. If the prefix is 1, prompt 4409post to the group under the point. If the prefix is 1, prompt
@@ -4422,7 +4416,7 @@ in question. The corresponding back end must have a request-post method
4422for this to work though. 4416for this to work though.
4423 4417
4424@item G z 4418@item G z
4425@kindex G z (Group) 4419@kindex G z @r{(Group)}
4426@findex gnus-group-compact-group 4420@findex gnus-group-compact-group
4427 4421
4428Compact the group under point (@code{gnus-group-compact-group}). 4422Compact the group under point (@code{gnus-group-compact-group}).
@@ -4467,7 +4461,7 @@ whether they are empty or not.
4467@table @kbd 4461@table @kbd
4468 4462
4469@item g 4463@item g
4470@kindex g (Group) 4464@kindex g @r{(Group)}
4471@findex gnus-group-get-new-news 4465@findex gnus-group-get-new-news
4472@c @icon{gnus-group-get-new-news} 4466@c @icon{gnus-group-get-new-news}
4473Check the server(s) for new articles. If the numerical prefix is used, 4467Check the server(s) for new articles. If the numerical prefix is used,
@@ -4477,7 +4471,7 @@ command will force a total re-reading of the active file(s) from the
4477back end(s). 4471back end(s).
4478 4472
4479@item M-g 4473@item M-g
4480@kindex M-g (Group) 4474@kindex M-g @r{(Group)}
4481@findex gnus-group-get-new-news-this-group 4475@findex gnus-group-get-new-news-this-group
4482@vindex gnus-goto-next-group-when-activating 4476@vindex gnus-goto-next-group-when-activating
4483@c @icon{gnus-group-get-new-news-this-group} 4477@c @icon{gnus-group-get-new-news-this-group}
@@ -4489,11 +4483,11 @@ to move point to the next group or not. It is @code{t} by default.
4489@findex gnus-activate-all-groups 4483@findex gnus-activate-all-groups
4490@cindex activating groups 4484@cindex activating groups
4491@item C-c M-g 4485@item C-c M-g
4492@kindex C-c M-g (Group) 4486@kindex C-c M-g @r{(Group)}
4493Activate absolutely all groups (@code{gnus-activate-all-groups}). 4487Activate absolutely all groups (@code{gnus-activate-all-groups}).
4494 4488
4495@item R 4489@item R
4496@kindex R (Group) 4490@kindex R @r{(Group)}
4497@cindex restarting 4491@cindex restarting
4498@findex gnus-group-restart 4492@findex gnus-group-restart
4499Restart Gnus (@code{gnus-group-restart}). This saves the @file{.newsrc} 4493Restart Gnus (@code{gnus-group-restart}). This saves the @file{.newsrc}
@@ -4521,8 +4515,8 @@ news.
4521@item H d 4515@item H d
4522@itemx C-c C-d 4516@itemx C-c C-d
4523@c @icon{gnus-group-describe-group} 4517@c @icon{gnus-group-describe-group}
4524@kindex H d (Group) 4518@kindex H d @r{(Group)}
4525@kindex C-c C-d (Group) 4519@kindex C-c C-d @r{(Group)}
4526@cindex describing groups 4520@cindex describing groups
4527@cindex group description 4521@cindex group description
4528@findex gnus-group-describe-group 4522@findex gnus-group-describe-group
@@ -4530,26 +4524,26 @@ Describe the current group (@code{gnus-group-describe-group}). If given
4530a prefix, force Gnus to re-read the description from the server. 4524a prefix, force Gnus to re-read the description from the server.
4531 4525
4532@item M-d 4526@item M-d
4533@kindex M-d (Group) 4527@kindex M-d @r{(Group)}
4534@findex gnus-group-describe-all-groups 4528@findex gnus-group-describe-all-groups
4535Describe all groups (@code{gnus-group-describe-all-groups}). If given a 4529Describe all groups (@code{gnus-group-describe-all-groups}). If given a
4536prefix, force Gnus to re-read the description file from the server. 4530prefix, force Gnus to re-read the description file from the server.
4537 4531
4538@item H v 4532@item H v
4539@itemx V 4533@itemx V
4540@kindex V (Group) 4534@kindex V @r{(Group)}
4541@kindex H v (Group) 4535@kindex H v @r{(Group)}
4542@cindex version 4536@cindex version
4543@findex gnus-version 4537@findex gnus-version
4544Display current Gnus version numbers (@code{gnus-version}). 4538Display current Gnus version numbers (@code{gnus-version}).
4545 4539
4546@item ? 4540@item ?
4547@kindex ? (Group) 4541@kindex ? @r{(Group)}
4548@findex gnus-group-describe-briefly 4542@findex gnus-group-describe-briefly
4549Give a very short help message (@code{gnus-group-describe-briefly}). 4543Give a very short help message (@code{gnus-group-describe-briefly}).
4550 4544
4551@item C-c C-i 4545@item C-c C-i
4552@kindex C-c C-i (Group) 4546@kindex C-c C-i @r{(Group)}
4553@cindex info 4547@cindex info
4554@cindex manual 4548@cindex manual
4555@findex gnus-info-find-node 4549@findex gnus-info-find-node
@@ -4623,7 +4617,7 @@ either.
4623@table @kbd 4617@table @kbd
4624 4618
4625@item r 4619@item r
4626@kindex r (Group) 4620@kindex r @r{(Group)}
4627@findex gnus-group-read-init-file 4621@findex gnus-group-read-init-file
4628@vindex gnus-init-file 4622@vindex gnus-init-file
4629@cindex reading init file 4623@cindex reading init file
@@ -4631,7 +4625,7 @@ Re-read the init file (@code{gnus-init-file}, which defaults to
4631@file{~/.gnus.el}) (@code{gnus-group-read-init-file}). 4625@file{~/.gnus.el}) (@code{gnus-group-read-init-file}).
4632 4626
4633@item s 4627@item s
4634@kindex s (Group) 4628@kindex s @r{(Group)}
4635@findex gnus-group-save-newsrc 4629@findex gnus-group-save-newsrc
4636@cindex saving .newsrc 4630@cindex saving .newsrc
4637Save the @file{.newsrc.eld} file (and @file{.newsrc} if wanted) 4631Save the @file{.newsrc.eld} file (and @file{.newsrc} if wanted)
@@ -4639,7 +4633,7 @@ Save the @file{.newsrc.eld} file (and @file{.newsrc} if wanted)
4639file(s) whether Gnus thinks it is necessary or not. 4633file(s) whether Gnus thinks it is necessary or not.
4640 4634
4641@c @item Z 4635@c @item Z
4642@c @kindex Z (Group) 4636@c @kindex Z @r{(Group)}
4643@c @findex gnus-group-clear-dribble 4637@c @findex gnus-group-clear-dribble
4644@c Clear the dribble buffer (@code{gnus-group-clear-dribble}). 4638@c Clear the dribble buffer (@code{gnus-group-clear-dribble}).
4645 4639
@@ -4689,7 +4683,7 @@ if address "sender" "owner-ding@@hpc.uh.edu" @{
4689@table @kbd 4683@table @kbd
4690 4684
4691@item D g 4685@item D g
4692@kindex D g (Group) 4686@kindex D g @r{(Group)}
4693@findex gnus-sieve-generate 4687@findex gnus-sieve-generate
4694@vindex gnus-sieve-file 4688@vindex gnus-sieve-file
4695@cindex generating sieve script 4689@cindex generating sieve script
@@ -4697,7 +4691,7 @@ Regenerate a Sieve script from the @code{sieve} group parameters and
4697put you into the @code{gnus-sieve-file} without saving it. 4691put you into the @code{gnus-sieve-file} without saving it.
4698 4692
4699@item D u 4693@item D u
4700@kindex D u (Group) 4694@kindex D u @r{(Group)}
4701@findex gnus-sieve-update 4695@findex gnus-sieve-update
4702@vindex gnus-sieve-file 4696@vindex gnus-sieve-file
4703@cindex updating sieve script 4697@cindex updating sieve script
@@ -4721,10 +4715,10 @@ group buffer (@pxref{Selecting a Group}).
4721You can have as many summary buffers open as you wish. 4715You can have as many summary buffers open as you wish.
4722 4716
4723You can customize the Summary Mode tool bar, see @kbd{M-x 4717You can customize the Summary Mode tool bar, see @kbd{M-x
4724customize-apropos RET gnus-summary-tool-bar}. This feature is only 4718customize-apropos @key{RET} gnus-summary-tool-bar}. This feature is only
4725available in Emacs. 4719available in Emacs.
4726 4720
4727@kindex v (Summary) 4721@kindex v @r{(Summary)}
4728@cindex keys, reserved for users (Summary) 4722@cindex keys, reserved for users (Summary)
4729The key @kbd{v} is reserved for users. You can bind it to some 4723The key @kbd{v} is reserved for users. You can bind it to some
4730command or better use it as a prefix key. For example: 4724command or better use it as a prefix key. For example:
@@ -5204,22 +5198,22 @@ None of these commands select articles.
5204@table @kbd 5198@table @kbd
5205@item G M-n 5199@item G M-n
5206@itemx M-n 5200@itemx M-n
5207@kindex M-n (Summary) 5201@kindex M-n @r{(Summary)}
5208@kindex G M-n (Summary) 5202@kindex G M-n @r{(Summary)}
5209@findex gnus-summary-next-unread-subject 5203@findex gnus-summary-next-unread-subject
5210Go to the next summary line of an unread article 5204Go to the next summary line of an unread article
5211(@code{gnus-summary-next-unread-subject}). 5205(@code{gnus-summary-next-unread-subject}).
5212 5206
5213@item G M-p 5207@item G M-p
5214@itemx M-p 5208@itemx M-p
5215@kindex M-p (Summary) 5209@kindex M-p @r{(Summary)}
5216@kindex G M-p (Summary) 5210@kindex G M-p @r{(Summary)}
5217@findex gnus-summary-prev-unread-subject 5211@findex gnus-summary-prev-unread-subject
5218Go to the previous summary line of an unread article 5212Go to the previous summary line of an unread article
5219(@code{gnus-summary-prev-unread-subject}). 5213(@code{gnus-summary-prev-unread-subject}).
5220 5214
5221@item G g 5215@item G g
5222@kindex G g (Summary) 5216@kindex G g @r{(Summary)}
5223@findex gnus-summary-goto-subject 5217@findex gnus-summary-goto-subject
5224Ask for an article number and then go to the summary line of that article 5218Ask for an article number and then go to the summary line of that article
5225without displaying the article (@code{gnus-summary-goto-subject}). 5219without displaying the article (@code{gnus-summary-goto-subject}).
@@ -5281,7 +5275,7 @@ the given number of lines from the top.
5281@item gnus-summary-stop-at-end-of-message 5275@item gnus-summary-stop-at-end-of-message
5282@vindex gnus-summary-stop-at-end-of-message 5276@vindex gnus-summary-stop-at-end-of-message
5283If non-@code{nil}, don't go to the next article when hitting 5277If non-@code{nil}, don't go to the next article when hitting
5284@kbd{SPC}, and you're at the end of the article. 5278@kbd{@key{SPC}}, and you're at the end of the article.
5285 5279
5286@end table 5280@end table
5287 5281
@@ -5306,69 +5300,69 @@ If you want to fetch new articles or redisplay the group, see
5306@ref{Exiting the Summary Buffer}. 5300@ref{Exiting the Summary Buffer}.
5307 5301
5308@table @kbd 5302@table @kbd
5309@item SPACE 5303@item @key{SPC}
5310@kindex SPACE (Summary) 5304@kindex SPC @r{(Summary)}
5311@findex gnus-summary-next-page 5305@findex gnus-summary-next-page
5312Select the current article, or, if that one's read already, the next 5306Select the current article, or, if that one's read already, the next
5313unread article (@code{gnus-summary-next-page}). 5307unread article (@code{gnus-summary-next-page}).
5314 5308
5315If you have an article window open already and you press @kbd{SPACE} 5309If you have an article window open already and you press @kbd{@key{SPC}}
5316again, the article will be scrolled. This lets you conveniently 5310again, the article will be scrolled. This lets you conveniently
5317@kbd{SPACE} through an entire newsgroup. @xref{Paging the Article}. 5311@kbd{@key{SPC}} through an entire newsgroup. @xref{Paging the Article}.
5318 5312
5319@item G n 5313@item G n
5320@itemx n 5314@itemx n
5321@kindex n (Summary) 5315@kindex n @r{(Summary)}
5322@kindex G n (Summary) 5316@kindex G n @r{(Summary)}
5323@findex gnus-summary-next-unread-article 5317@findex gnus-summary-next-unread-article
5324@c @icon{gnus-summary-next-unread} 5318@c @icon{gnus-summary-next-unread}
5325Go to next unread article (@code{gnus-summary-next-unread-article}). 5319Go to next unread article (@code{gnus-summary-next-unread-article}).
5326 5320
5327@item G p 5321@item G p
5328@itemx p 5322@itemx p
5329@kindex p (Summary) 5323@kindex p @r{(Summary)}
5330@findex gnus-summary-prev-unread-article 5324@findex gnus-summary-prev-unread-article
5331@c @icon{gnus-summary-prev-unread} 5325@c @icon{gnus-summary-prev-unread}
5332Go to previous unread article (@code{gnus-summary-prev-unread-article}). 5326Go to previous unread article (@code{gnus-summary-prev-unread-article}).
5333 5327
5334@item G N 5328@item G N
5335@itemx N 5329@itemx N
5336@kindex N (Summary) 5330@kindex N @r{(Summary)}
5337@kindex G N (Summary) 5331@kindex G N @r{(Summary)}
5338@findex gnus-summary-next-article 5332@findex gnus-summary-next-article
5339Go to the next article (@code{gnus-summary-next-article}). 5333Go to the next article (@code{gnus-summary-next-article}).
5340 5334
5341@item G P 5335@item G P
5342@itemx P 5336@itemx P
5343@kindex P (Summary) 5337@kindex P @r{(Summary)}
5344@kindex G P (Summary) 5338@kindex G P @r{(Summary)}
5345@findex gnus-summary-prev-article 5339@findex gnus-summary-prev-article
5346Go to the previous article (@code{gnus-summary-prev-article}). 5340Go to the previous article (@code{gnus-summary-prev-article}).
5347 5341
5348@item G C-n 5342@item G C-n
5349@kindex G C-n (Summary) 5343@kindex G C-n @r{(Summary)}
5350@findex gnus-summary-next-same-subject 5344@findex gnus-summary-next-same-subject
5351Go to the next article with the same subject 5345Go to the next article with the same subject
5352(@code{gnus-summary-next-same-subject}). 5346(@code{gnus-summary-next-same-subject}).
5353 5347
5354@item G C-p 5348@item G C-p
5355@kindex G C-p (Summary) 5349@kindex G C-p @r{(Summary)}
5356@findex gnus-summary-prev-same-subject 5350@findex gnus-summary-prev-same-subject
5357Go to the previous article with the same subject 5351Go to the previous article with the same subject
5358(@code{gnus-summary-prev-same-subject}). 5352(@code{gnus-summary-prev-same-subject}).
5359 5353
5360@item G f 5354@item G f
5361@itemx . 5355@itemx .
5362@kindex G f (Summary) 5356@kindex G f @r{(Summary)}
5363@kindex . (Summary) 5357@kindex . @r{(Summary)}
5364@findex gnus-summary-first-unread-article 5358@findex gnus-summary-first-unread-article
5365Go to the first unread article 5359Go to the first unread article
5366(@code{gnus-summary-first-unread-article}). 5360(@code{gnus-summary-first-unread-article}).
5367 5361
5368@item G b 5362@item G b
5369@itemx , 5363@itemx ,
5370@kindex G b (Summary) 5364@kindex G b @r{(Summary)}
5371@kindex , (Summary) 5365@kindex , @r{(Summary)}
5372@findex gnus-summary-best-unread-article 5366@findex gnus-summary-best-unread-article
5373Go to the unread article with the highest score 5367Go to the unread article with the highest score
5374(@code{gnus-summary-best-unread-article}). If given a prefix argument, 5368(@code{gnus-summary-best-unread-article}). If given a prefix argument,
@@ -5376,13 +5370,13 @@ go to the first unread article that has a score over the default score.
5376 5370
5377@item G l 5371@item G l
5378@itemx l 5372@itemx l
5379@kindex l (Summary) 5373@kindex l @r{(Summary)}
5380@kindex G l (Summary) 5374@kindex G l @r{(Summary)}
5381@findex gnus-summary-goto-last-article 5375@findex gnus-summary-goto-last-article
5382Go to the previous article read (@code{gnus-summary-goto-last-article}). 5376Go to the previous article read (@code{gnus-summary-goto-last-article}).
5383 5377
5384@item G o 5378@item G o
5385@kindex G o (Summary) 5379@kindex G o @r{(Summary)}
5386@findex gnus-summary-pop-article 5380@findex gnus-summary-pop-article
5387@cindex history 5381@cindex history
5388@cindex article history 5382@cindex article history
@@ -5395,8 +5389,8 @@ For a somewhat related issue (if you use these commands a lot),
5395 5389
5396@item G j 5390@item G j
5397@itemx j 5391@itemx j
5398@kindex j (Summary) 5392@kindex j @r{(Summary)}
5399@kindex G j (Summary) 5393@kindex G j @r{(Summary)}
5400@findex gnus-summary-goto-article 5394@findex gnus-summary-goto-article
5401Ask for an article number or @code{Message-ID}, and then go to that 5395Ask for an article number or @code{Message-ID}, and then go to that
5402article (@code{gnus-summary-goto-article}). 5396article (@code{gnus-summary-goto-article}).
@@ -5448,10 +5442,10 @@ instead. It will leave marks like @code{gnus-low-score-mark},
5448 5442
5449@table @kbd 5443@table @kbd
5450 5444
5451@item SPACE 5445@item @key{SPC}
5452@kindex SPACE (Summary) 5446@kindex SPC @r{(Summary)}
5453@findex gnus-summary-next-page 5447@findex gnus-summary-next-page
5454Pressing @kbd{SPACE} will scroll the current article forward one page, 5448Pressing @kbd{@key{SPC}} will scroll the current article forward one page,
5455or, if you have come to the end of the current article, will choose the 5449or, if you have come to the end of the current article, will choose the
5456next article (@code{gnus-summary-next-page}). 5450next article (@code{gnus-summary-next-page}).
5457 5451
@@ -5464,27 +5458,27 @@ what is considered uninteresting with
5464@code{gnus-article-boring-faces}. You can manually view the article's 5458@code{gnus-article-boring-faces}. You can manually view the article's
5465pages, no matter how boring, using @kbd{C-M-v}. 5459pages, no matter how boring, using @kbd{C-M-v}.
5466 5460
5467@item DEL 5461@item @key{DEL}
5468@kindex DEL (Summary) 5462@kindex DEL @r{(Summary)}
5469@findex gnus-summary-prev-page 5463@findex gnus-summary-prev-page
5470Scroll the current article back one page (@code{gnus-summary-prev-page}). 5464Scroll the current article back one page (@code{gnus-summary-prev-page}).
5471 5465
5472@item RET 5466@item @key{RET}
5473@kindex RET (Summary) 5467@kindex RET @r{(Summary)}
5474@findex gnus-summary-scroll-up 5468@findex gnus-summary-scroll-up
5475Scroll the current article one line forward 5469Scroll the current article one line forward
5476(@code{gnus-summary-scroll-up}). 5470(@code{gnus-summary-scroll-up}).
5477 5471
5478@item M-RET 5472@item M-@key{RET}
5479@kindex M-RET (Summary) 5473@kindex M-RET @r{(Summary)}
5480@findex gnus-summary-scroll-down 5474@findex gnus-summary-scroll-down
5481Scroll the current article one line backward 5475Scroll the current article one line backward
5482(@code{gnus-summary-scroll-down}). 5476(@code{gnus-summary-scroll-down}).
5483 5477
5484@item A g 5478@item A g
5485@itemx g 5479@itemx g
5486@kindex A g (Summary) 5480@kindex A g @r{(Summary)}
5487@kindex g (Summary) 5481@kindex g @r{(Summary)}
5488@findex gnus-summary-show-article 5482@findex gnus-summary-show-article
5489@vindex gnus-summary-show-article-charset-alist 5483@vindex gnus-summary-show-article-charset-alist
5490(Re)fetch the current article (@code{gnus-summary-show-article}). If 5484(Re)fetch the current article (@code{gnus-summary-show-article}). If
@@ -5495,7 +5489,7 @@ treatment functions.
5495 5489
5496@cindex charset, view article with different charset 5490@cindex charset, view article with different charset
5497If given a numerical prefix, you can do semi-manual charset stuff. 5491If given a numerical prefix, you can do semi-manual charset stuff.
5498@kbd{C-u 0 g cn-gb-2312 RET} will decode the message as if it were 5492@kbd{C-u 0 g cn-gb-2312 @key{RET}} will decode the message as if it were
5499encoded in the @code{cn-gb-2312} charset. If you have 5493encoded in the @code{cn-gb-2312} charset. If you have
5500 5494
5501@lisp 5495@lisp
@@ -5508,29 +5502,29 @@ then you can say @kbd{C-u 1 g} to get the same effect.
5508 5502
5509@item A < 5503@item A <
5510@itemx < 5504@itemx <
5511@kindex < (Summary) 5505@kindex < @r{(Summary)}
5512@kindex A < (Summary) 5506@kindex A < @r{(Summary)}
5513@findex gnus-summary-beginning-of-article 5507@findex gnus-summary-beginning-of-article
5514Scroll to the beginning of the article 5508Scroll to the beginning of the article
5515(@code{gnus-summary-beginning-of-article}). 5509(@code{gnus-summary-beginning-of-article}).
5516 5510
5517@item A > 5511@item A >
5518@itemx > 5512@itemx >
5519@kindex > (Summary) 5513@kindex > @r{(Summary)}
5520@kindex A > (Summary) 5514@kindex A > @r{(Summary)}
5521@findex gnus-summary-end-of-article 5515@findex gnus-summary-end-of-article
5522Scroll to the end of the article (@code{gnus-summary-end-of-article}). 5516Scroll to the end of the article (@code{gnus-summary-end-of-article}).
5523 5517
5524@item A s 5518@item A s
5525@itemx s 5519@itemx s
5526@kindex A s (Summary) 5520@kindex A s @r{(Summary)}
5527@kindex s (Summary) 5521@kindex s @r{(Summary)}
5528@findex gnus-summary-isearch-article 5522@findex gnus-summary-isearch-article
5529Perform an isearch in the article buffer 5523Perform an isearch in the article buffer
5530(@code{gnus-summary-isearch-article}). 5524(@code{gnus-summary-isearch-article}).
5531 5525
5532@item h 5526@item h
5533@kindex h (Summary) 5527@kindex h @r{(Summary)}
5534@findex gnus-summary-select-article-buffer 5528@findex gnus-summary-select-article-buffer
5535Select the article buffer (@code{gnus-summary-select-article-buffer}). 5529Select the article buffer (@code{gnus-summary-select-article-buffer}).
5536 5530
@@ -5559,8 +5553,8 @@ Commands for composing a mail message:
5559 5553
5560@item S r 5554@item S r
5561@itemx r 5555@itemx r
5562@kindex S r (Summary) 5556@kindex S r @r{(Summary)}
5563@kindex r (Summary) 5557@kindex r @r{(Summary)}
5564@findex gnus-summary-reply 5558@findex gnus-summary-reply
5565@c @icon{gnus-summary-mail-reply} 5559@c @icon{gnus-summary-mail-reply}
5566@c @icon{gnus-summary-reply} 5560@c @icon{gnus-summary-reply}
@@ -5569,8 +5563,8 @@ Mail a reply to the author of the current article
5569 5563
5570@item S R 5564@item S R
5571@itemx R 5565@itemx R
5572@kindex R (Summary) 5566@kindex R @r{(Summary)}
5573@kindex S R (Summary) 5567@kindex S R @r{(Summary)}
5574@findex gnus-summary-reply-with-original 5568@findex gnus-summary-reply-with-original
5575@c @icon{gnus-summary-reply-with-original} 5569@c @icon{gnus-summary-reply-with-original}
5576Mail a reply to the author of the current article and include the 5570Mail a reply to the author of the current article and include the
@@ -5578,7 +5572,7 @@ original message (@code{gnus-summary-reply-with-original}). This
5578command uses the process/prefix convention. 5572command uses the process/prefix convention.
5579 5573
5580@item S w 5574@item S w
5581@kindex S w (Summary) 5575@kindex S w @r{(Summary)}
5582@findex gnus-summary-wide-reply 5576@findex gnus-summary-wide-reply
5583Mail a wide reply to the author of the current article 5577Mail a wide reply to the author of the current article
5584(@code{gnus-summary-wide-reply}). A @dfn{wide reply} is a reply that 5578(@code{gnus-summary-wide-reply}). A @dfn{wide reply} is a reply that
@@ -5587,7 +5581,7 @@ goes out to all people listed in the @code{To}, @code{From} (or
5587present, that's used instead. 5581present, that's used instead.
5588 5582
5589@item S W 5583@item S W
5590@kindex S W (Summary) 5584@kindex S W @r{(Summary)}
5591@findex gnus-summary-wide-reply-with-original 5585@findex gnus-summary-wide-reply-with-original
5592Mail a wide reply to the current article and include the original 5586Mail a wide reply to the current article and include the original
5593message (@code{gnus-summary-wide-reply-with-original}). This command uses 5587message (@code{gnus-summary-wide-reply-with-original}). This command uses
@@ -5595,14 +5589,14 @@ the process/prefix convention, but only uses the headers from the
5595first article to determine the recipients. 5589first article to determine the recipients.
5596 5590
5597@item S L 5591@item S L
5598@kindex S L (Summary) 5592@kindex S L @r{(Summary)}
5599@findex gnus-summary-reply-to-list-with-original 5593@findex gnus-summary-reply-to-list-with-original
5600When replying to a message from a mailing list, send a reply to that 5594When replying to a message from a mailing list, send a reply to that
5601message to the mailing list, and include the original message 5595message to the mailing list, and include the original message
5602(@code{gnus-summary-reply-to-list-with-original}). 5596(@code{gnus-summary-reply-to-list-with-original}).
5603 5597
5604@item S v 5598@item S v
5605@kindex S v (Summary) 5599@kindex S v @r{(Summary)}
5606@findex gnus-summary-very-wide-reply 5600@findex gnus-summary-very-wide-reply
5607Mail a very wide reply to the author of the current article 5601Mail a very wide reply to the author of the current article
5608(@code{gnus-summary-wide-reply}). A @dfn{very wide reply} is a reply 5602(@code{gnus-summary-wide-reply}). A @dfn{very wide reply} is a reply
@@ -5611,14 +5605,14 @@ that goes out to all people listed in the @code{To}, @code{From} (or
5611articles. This command uses the process/prefix convention. 5605articles. This command uses the process/prefix convention.
5612 5606
5613@item S V 5607@item S V
5614@kindex S V (Summary) 5608@kindex S V @r{(Summary)}
5615@findex gnus-summary-very-wide-reply-with-original 5609@findex gnus-summary-very-wide-reply-with-original
5616Mail a very wide reply to the author of the current article and include the 5610Mail a very wide reply to the author of the current article and include the
5617original message (@code{gnus-summary-very-wide-reply-with-original}). This 5611original message (@code{gnus-summary-very-wide-reply-with-original}). This
5618command uses the process/prefix convention. 5612command uses the process/prefix convention.
5619 5613
5620@item S B r 5614@item S B r
5621@kindex S B r (Summary) 5615@kindex S B r @r{(Summary)}
5622@findex gnus-summary-reply-broken-reply-to 5616@findex gnus-summary-reply-broken-reply-to
5623Mail a reply to the author of the current article but ignore the 5617Mail a reply to the author of the current article but ignore the
5624@code{Reply-To} field (@code{gnus-summary-reply-broken-reply-to}). 5618@code{Reply-To} field (@code{gnus-summary-reply-broken-reply-to}).
@@ -5628,7 +5622,7 @@ the @code{broken-reply-to} group parameter instead, so things will work
5628correctly. @xref{Group Parameters}. 5622correctly. @xref{Group Parameters}.
5629 5623
5630@item S B R 5624@item S B R
5631@kindex S B R (Summary) 5625@kindex S B R @r{(Summary)}
5632@findex gnus-summary-reply-broken-reply-to-with-original 5626@findex gnus-summary-reply-broken-reply-to-with-original
5633Mail a reply to the author of the current article and include the 5627Mail a reply to the author of the current article and include the
5634original message but ignore the @code{Reply-To} field 5628original message but ignore the @code{Reply-To} field
@@ -5636,8 +5630,8 @@ original message but ignore the @code{Reply-To} field
5636 5630
5637@item S o m 5631@item S o m
5638@itemx C-c C-f 5632@itemx C-c C-f
5639@kindex S o m (Summary) 5633@kindex S o m @r{(Summary)}
5640@kindex C-c C-f (Summary) 5634@kindex C-c C-f @r{(Summary)}
5641@findex gnus-summary-mail-forward 5635@findex gnus-summary-mail-forward
5642@c @icon{gnus-summary-mail-forward} 5636@c @icon{gnus-summary-mail-forward}
5643Forward the current article to some other person 5637Forward the current article to some other person
@@ -5654,8 +5648,8 @@ section.
5654 5648
5655@item S m 5649@item S m
5656@itemx m 5650@itemx m
5657@kindex m (Summary) 5651@kindex m @r{(Summary)}
5658@kindex S m (Summary) 5652@kindex S m @r{(Summary)}
5659@findex gnus-summary-mail-other-window 5653@findex gnus-summary-mail-other-window
5660@c @icon{gnus-summary-mail-originate} 5654@c @icon{gnus-summary-mail-originate}
5661Prepare a mail (@code{gnus-summary-mail-other-window}). By default, use 5655Prepare a mail (@code{gnus-summary-mail-other-window}). By default, use
@@ -5663,7 +5657,7 @@ the posting style of the current group. If given a prefix, disable that.
5663If the prefix is 1, prompt for a group name to find the posting style. 5657If the prefix is 1, prompt for a group name to find the posting style.
5664 5658
5665@item S i 5659@item S i
5666@kindex S i (Summary) 5660@kindex S i @r{(Summary)}
5667@findex gnus-summary-news-other-window 5661@findex gnus-summary-news-other-window
5668Prepare a news (@code{gnus-summary-news-other-window}). By default, 5662Prepare a news (@code{gnus-summary-news-other-window}). By default,
5669post to the current group. If given a prefix, disable that. If the 5663post to the current group. If given a prefix, disable that. If the
@@ -5676,7 +5670,7 @@ in question. The corresponding back end must have a request-post method
5676for this to work though. 5670for this to work though.
5677 5671
5678@item S D b 5672@item S D b
5679@kindex S D b (Summary) 5673@kindex S D b @r{(Summary)}
5680@findex gnus-summary-resend-bounced-mail 5674@findex gnus-summary-resend-bounced-mail
5681@cindex bouncing mail 5675@cindex bouncing mail
5682If you have sent a mail, but the mail was bounced back to you for some 5676If you have sent a mail, but the mail was bounced back to you for some
@@ -5689,7 +5683,7 @@ that mail and display it for easy perusal of its headers. This might
5689very well fail, though. 5683very well fail, though.
5690 5684
5691@item S D r 5685@item S D r
5692@kindex S D r (Summary) 5686@kindex S D r @r{(Summary)}
5693@findex gnus-summary-resend-message 5687@findex gnus-summary-resend-message
5694Not to be confused with the previous command, 5688Not to be confused with the previous command,
5695@code{gnus-summary-resend-message} will prompt you for an address to 5689@code{gnus-summary-resend-message} will prompt you for an address to
@@ -5710,21 +5704,21 @@ This command understands the process/prefix convention
5710(@pxref{Process/Prefix}). 5704(@pxref{Process/Prefix}).
5711 5705
5712@item S D e 5706@item S D e
5713@kindex S D e (Summary) 5707@kindex S D e @r{(Summary)}
5714@findex gnus-summary-resend-message-edit 5708@findex gnus-summary-resend-message-edit
5715 5709
5716Like the previous command, but will allow you to edit the message as 5710Like the previous command, but will allow you to edit the message as
5717if it were a new message before resending. 5711if it were a new message before resending.
5718 5712
5719@item S O m 5713@item S O m
5720@kindex S O m (Summary) 5714@kindex S O m @r{(Summary)}
5721@findex gnus-uu-digest-mail-forward 5715@findex gnus-uu-digest-mail-forward
5722Digest the current series (@pxref{Decoding Articles}) and forward the 5716Digest the current series (@pxref{Decoding Articles}) and forward the
5723result using mail (@code{gnus-uu-digest-mail-forward}). This command 5717result using mail (@code{gnus-uu-digest-mail-forward}). This command
5724uses the process/prefix convention (@pxref{Process/Prefix}). 5718uses the process/prefix convention (@pxref{Process/Prefix}).
5725 5719
5726@item S M-c 5720@item S M-c
5727@kindex S M-c (Summary) 5721@kindex S M-c @r{(Summary)}
5728@findex gnus-summary-mail-crosspost-complaint 5722@findex gnus-summary-mail-crosspost-complaint
5729@cindex crossposting 5723@cindex crossposting
5730@cindex excessive crossposting 5724@cindex excessive crossposting
@@ -5754,8 +5748,8 @@ Commands for posting a news article:
5754@table @kbd 5748@table @kbd
5755@item S p 5749@item S p
5756@itemx a 5750@itemx a
5757@kindex a (Summary) 5751@kindex a @r{(Summary)}
5758@kindex S p (Summary) 5752@kindex S p @r{(Summary)}
5759@findex gnus-summary-post-news 5753@findex gnus-summary-post-news
5760@c @icon{gnus-summary-post-news} 5754@c @icon{gnus-summary-post-news}
5761Prepare for posting an article (@code{gnus-summary-post-news}). By 5755Prepare for posting an article (@code{gnus-summary-post-news}). By
@@ -5764,16 +5758,16 @@ If the prefix is 1, prompt for another group instead.
5764 5758
5765@item S f 5759@item S f
5766@itemx f 5760@itemx f
5767@kindex f (Summary) 5761@kindex f @r{(Summary)}
5768@kindex S f (Summary) 5762@kindex S f @r{(Summary)}
5769@findex gnus-summary-followup 5763@findex gnus-summary-followup
5770@c @icon{gnus-summary-followup} 5764@c @icon{gnus-summary-followup}
5771Post a followup to the current article (@code{gnus-summary-followup}). 5765Post a followup to the current article (@code{gnus-summary-followup}).
5772 5766
5773@item S F 5767@item S F
5774@itemx F 5768@itemx F
5775@kindex S F (Summary) 5769@kindex S F @r{(Summary)}
5776@kindex F (Summary) 5770@kindex F @r{(Summary)}
5777@c @icon{gnus-summary-followup-with-original} 5771@c @icon{gnus-summary-followup-with-original}
5778@findex gnus-summary-followup-with-original 5772@findex gnus-summary-followup-with-original
5779Post a followup to the current article and include the original message 5773Post a followup to the current article and include the original message
@@ -5781,13 +5775,13 @@ Post a followup to the current article and include the original message
5781process/prefix convention. 5775process/prefix convention.
5782 5776
5783@item S n 5777@item S n
5784@kindex S n (Summary) 5778@kindex S n @r{(Summary)}
5785@findex gnus-summary-followup-to-mail 5779@findex gnus-summary-followup-to-mail
5786Post a followup to the current article via news, even if you got the 5780Post a followup to the current article via news, even if you got the
5787message through mail (@code{gnus-summary-followup-to-mail}). 5781message through mail (@code{gnus-summary-followup-to-mail}).
5788 5782
5789@item S N 5783@item S N
5790@kindex S N (Summary) 5784@kindex S N @r{(Summary)}
5791@findex gnus-summary-followup-to-mail-with-original 5785@findex gnus-summary-followup-to-mail-with-original
5792Post a followup to the current article via news, even if you got the 5786Post a followup to the current article via news, even if you got the
5793message through mail and include the original message 5787message through mail and include the original message
@@ -5795,7 +5789,7 @@ message through mail and include the original message
5795the process/prefix convention. 5789the process/prefix convention.
5796 5790
5797@item S o p 5791@item S o p
5798@kindex S o p (Summary) 5792@kindex S o p @r{(Summary)}
5799@findex gnus-summary-post-forward 5793@findex gnus-summary-post-forward
5800Forward the current article to a newsgroup 5794Forward the current article to a newsgroup
5801(@code{gnus-summary-post-forward}). 5795(@code{gnus-summary-post-forward}).
@@ -5810,7 +5804,7 @@ but use the flipped value of (@code{message-forward-as-mime}). By
5810default, the message is decoded and forwarded as an rfc822 @acronym{MIME} section. 5804default, the message is decoded and forwarded as an rfc822 @acronym{MIME} section.
5811 5805
5812@item S O p 5806@item S O p
5813@kindex S O p (Summary) 5807@kindex S O p @r{(Summary)}
5814@findex gnus-uu-digest-post-forward 5808@findex gnus-uu-digest-post-forward
5815@cindex digests 5809@cindex digests
5816@cindex making digests 5810@cindex making digests
@@ -5819,7 +5813,7 @@ Digest the current series and forward the result to a newsgroup
5819process/prefix convention. 5813process/prefix convention.
5820 5814
5821@item S u 5815@item S u
5822@kindex S u (Summary) 5816@kindex S u @r{(Summary)}
5823@findex gnus-uu-post-news 5817@findex gnus-uu-post-news
5824@c @icon{gnus-uu-post-news} 5818@c @icon{gnus-uu-post-news}
5825Uuencode a file, split it into parts, and post it as a series 5819Uuencode a file, split it into parts, and post it as a series
@@ -5835,7 +5829,7 @@ Manual}, for more information.
5835 5829
5836@table @kbd 5830@table @kbd
5837@item S y 5831@item S y
5838@kindex S y (Summary) 5832@kindex S y @r{(Summary)}
5839@findex gnus-summary-yank-message 5833@findex gnus-summary-yank-message
5840Yank the current article into an already existing Message composition 5834Yank the current article into an already existing Message composition
5841buffer (@code{gnus-summary-yank-message}). This command prompts for 5835buffer (@code{gnus-summary-yank-message}). This command prompts for
@@ -5856,7 +5850,7 @@ really, really wish you hadn't posted that?
5856Well, you can't cancel mail, but you can cancel posts. 5850Well, you can't cancel mail, but you can cancel posts.
5857 5851
5858@findex gnus-summary-cancel-article 5852@findex gnus-summary-cancel-article
5859@kindex C (Summary) 5853@kindex C @r{(Summary)}
5860@c @icon{gnus-summary-cancel-article} 5854@c @icon{gnus-summary-cancel-article}
5861Find the article you wish to cancel (you can only cancel your own 5855Find the article you wish to cancel (you can only cancel your own
5862articles, so don't try any funny stuff). Then press @kbd{C} or @kbd{S 5856articles, so don't try any funny stuff). Then press @kbd{C} or @kbd{S
@@ -5881,7 +5875,7 @@ corrections, you can post a @dfn{superseding} article that will replace
5881your original article. 5875your original article.
5882 5876
5883@findex gnus-summary-supersede-article 5877@findex gnus-summary-supersede-article
5884@kindex S (Summary) 5878@kindex S @r{(Summary)}
5885Go to the original article and press @kbd{S s} 5879Go to the original article and press @kbd{S s}
5886(@code{gnus-summary-supersede-article}). You will be put in a buffer 5880(@code{gnus-summary-supersede-article}). You will be put in a buffer
5887where you can edit the article all you want before sending it off the 5881where you can edit the article all you want before sending it off the
@@ -6064,7 +6058,7 @@ followups, you can use the @kbd{/ D} command (@pxref{Limiting}).
6064Otherwise (except for the visibility issue), they are just like ticked 6058Otherwise (except for the visibility issue), they are just like ticked
6065messages. 6059messages.
6066 6060
6067@item SPACE 6061@item @key{SPC}
6068@vindex gnus-unread-mark 6062@vindex gnus-unread-mark
6069Marked as unread (@code{gnus-unread-mark}). 6063Marked as unread (@code{gnus-unread-mark}).
6070 6064
@@ -6248,8 +6242,8 @@ All the marking commands understand the numeric prefix.
6248@table @kbd 6242@table @kbd
6249@item M c 6243@item M c
6250@itemx M-u 6244@itemx M-u
6251@kindex M c (Summary) 6245@kindex M c @r{(Summary)}
6252@kindex M-u (Summary) 6246@kindex M-u @r{(Summary)}
6253@findex gnus-summary-clear-mark-forward 6247@findex gnus-summary-clear-mark-forward
6254@cindex mark as unread 6248@cindex mark as unread
6255Clear all readedness-marks from the current article 6249Clear all readedness-marks from the current article
@@ -6258,38 +6252,38 @@ article as unread.
6258 6252
6259@item M t 6253@item M t
6260@itemx ! 6254@itemx !
6261@kindex ! (Summary) 6255@kindex ! @r{(Summary)}
6262@kindex M t (Summary) 6256@kindex M t @r{(Summary)}
6263@findex gnus-summary-tick-article-forward 6257@findex gnus-summary-tick-article-forward
6264Tick the current article (@code{gnus-summary-tick-article-forward}). 6258Tick the current article (@code{gnus-summary-tick-article-forward}).
6265@xref{Article Caching}. 6259@xref{Article Caching}.
6266 6260
6267@item M ? 6261@item M ?
6268@itemx ? 6262@itemx ?
6269@kindex ? (Summary) 6263@kindex ? @r{(Summary)}
6270@kindex M ? (Summary) 6264@kindex M ? @r{(Summary)}
6271@findex gnus-summary-mark-as-dormant 6265@findex gnus-summary-mark-as-dormant
6272Mark the current article as dormant 6266Mark the current article as dormant
6273(@code{gnus-summary-mark-as-dormant}). @xref{Article Caching}. 6267(@code{gnus-summary-mark-as-dormant}). @xref{Article Caching}.
6274 6268
6275@item M d 6269@item M d
6276@itemx d 6270@itemx d
6277@kindex M d (Summary) 6271@kindex M d @r{(Summary)}
6278@kindex d (Summary) 6272@kindex d @r{(Summary)}
6279@findex gnus-summary-mark-as-read-forward 6273@findex gnus-summary-mark-as-read-forward
6280Mark the current article as read 6274Mark the current article as read
6281(@code{gnus-summary-mark-as-read-forward}). 6275(@code{gnus-summary-mark-as-read-forward}).
6282 6276
6283@item D 6277@item D
6284@kindex D (Summary) 6278@kindex D @r{(Summary)}
6285@findex gnus-summary-mark-as-read-backward 6279@findex gnus-summary-mark-as-read-backward
6286Mark the current article as read and move point to the previous line 6280Mark the current article as read and move point to the previous line
6287(@code{gnus-summary-mark-as-read-backward}). 6281(@code{gnus-summary-mark-as-read-backward}).
6288 6282
6289@item M k 6283@item M k
6290@itemx k 6284@itemx k
6291@kindex k (Summary) 6285@kindex k @r{(Summary)}
6292@kindex M k (Summary) 6286@kindex M k @r{(Summary)}
6293@findex gnus-summary-kill-same-subject-and-select 6287@findex gnus-summary-kill-same-subject-and-select
6294Mark all articles that have the same subject as the current one as read, 6288Mark all articles that have the same subject as the current one as read,
6295and then select the next unread article 6289and then select the next unread article
@@ -6297,82 +6291,82 @@ and then select the next unread article
6297 6291
6298@item M K 6292@item M K
6299@itemx C-k 6293@itemx C-k
6300@kindex M K (Summary) 6294@kindex M K @r{(Summary)}
6301@kindex C-k (Summary) 6295@kindex C-k @r{(Summary)}
6302@findex gnus-summary-kill-same-subject 6296@findex gnus-summary-kill-same-subject
6303Mark all articles that have the same subject as the current one as read 6297Mark all articles that have the same subject as the current one as read
6304(@code{gnus-summary-kill-same-subject}). 6298(@code{gnus-summary-kill-same-subject}).
6305 6299
6306@item M C 6300@item M C
6307@kindex M C (Summary) 6301@kindex M C @r{(Summary)}
6308@findex gnus-summary-catchup 6302@findex gnus-summary-catchup
6309@c @icon{gnus-summary-catchup} 6303@c @icon{gnus-summary-catchup}
6310Mark all unread articles as read (@code{gnus-summary-catchup}). 6304Mark all unread articles as read (@code{gnus-summary-catchup}).
6311 6305
6312@item M C-c 6306@item M C-c
6313@kindex M C-c (Summary) 6307@kindex M C-c @r{(Summary)}
6314@findex gnus-summary-catchup-all 6308@findex gnus-summary-catchup-all
6315Mark all articles in the group as read---even the ticked and dormant 6309Mark all articles in the group as read---even the ticked and dormant
6316articles (@code{gnus-summary-catchup-all}). 6310articles (@code{gnus-summary-catchup-all}).
6317 6311
6318@item M H 6312@item M H
6319@kindex M H (Summary) 6313@kindex M H @r{(Summary)}
6320@findex gnus-summary-catchup-to-here 6314@findex gnus-summary-catchup-to-here
6321Catchup the current group to point (before the point) 6315Catchup the current group to point (before the point)
6322(@code{gnus-summary-catchup-to-here}). 6316(@code{gnus-summary-catchup-to-here}).
6323 6317
6324@item M h 6318@item M h
6325@kindex M h (Summary) 6319@kindex M h @r{(Summary)}
6326@findex gnus-summary-catchup-from-here 6320@findex gnus-summary-catchup-from-here
6327Catchup the current group from point (after the point) 6321Catchup the current group from point (after the point)
6328(@code{gnus-summary-catchup-from-here}). 6322(@code{gnus-summary-catchup-from-here}).
6329 6323
6330@item C-w 6324@item C-w
6331@kindex C-w (Summary) 6325@kindex C-w @r{(Summary)}
6332@findex gnus-summary-mark-region-as-read 6326@findex gnus-summary-mark-region-as-read
6333Mark all articles between point and mark as read 6327Mark all articles between point and mark as read
6334(@code{gnus-summary-mark-region-as-read}). 6328(@code{gnus-summary-mark-region-as-read}).
6335 6329
6336@item M V k 6330@item M V k
6337@kindex M V k (Summary) 6331@kindex M V k @r{(Summary)}
6338@findex gnus-summary-kill-below 6332@findex gnus-summary-kill-below
6339Kill all articles with scores below the default score (or below the 6333Kill all articles with scores below the default score (or below the
6340numeric prefix) (@code{gnus-summary-kill-below}). 6334numeric prefix) (@code{gnus-summary-kill-below}).
6341 6335
6342@item M e 6336@item M e
6343@itemx E 6337@itemx E
6344@kindex M e (Summary) 6338@kindex M e @r{(Summary)}
6345@kindex E (Summary) 6339@kindex E @r{(Summary)}
6346@findex gnus-summary-mark-as-expirable 6340@findex gnus-summary-mark-as-expirable
6347Mark the current article as expirable 6341Mark the current article as expirable
6348(@code{gnus-summary-mark-as-expirable}). 6342(@code{gnus-summary-mark-as-expirable}).
6349 6343
6350@item M b 6344@item M b
6351@kindex M b (Summary) 6345@kindex M b @r{(Summary)}
6352@findex gnus-summary-set-bookmark 6346@findex gnus-summary-set-bookmark
6353Set a bookmark in the current article 6347Set a bookmark in the current article
6354(@code{gnus-summary-set-bookmark}). 6348(@code{gnus-summary-set-bookmark}).
6355 6349
6356@item M B 6350@item M B
6357@kindex M B (Summary) 6351@kindex M B @r{(Summary)}
6358@findex gnus-summary-remove-bookmark 6352@findex gnus-summary-remove-bookmark
6359Remove the bookmark from the current article 6353Remove the bookmark from the current article
6360(@code{gnus-summary-remove-bookmark}). 6354(@code{gnus-summary-remove-bookmark}).
6361 6355
6362@item M V c 6356@item M V c
6363@kindex M V c (Summary) 6357@kindex M V c @r{(Summary)}
6364@findex gnus-summary-clear-above 6358@findex gnus-summary-clear-above
6365Clear all marks from articles with scores over the default score (or 6359Clear all marks from articles with scores over the default score (or
6366over the numeric prefix) (@code{gnus-summary-clear-above}). 6360over the numeric prefix) (@code{gnus-summary-clear-above}).
6367 6361
6368@item M V u 6362@item M V u
6369@kindex M V u (Summary) 6363@kindex M V u @r{(Summary)}
6370@findex gnus-summary-tick-above 6364@findex gnus-summary-tick-above
6371Tick all articles with scores over the default score (or over the 6365Tick all articles with scores over the default score (or over the
6372numeric prefix) (@code{gnus-summary-tick-above}). 6366numeric prefix) (@code{gnus-summary-tick-above}).
6373 6367
6374@item M V m 6368@item M V m
6375@kindex M V m (Summary) 6369@kindex M V m @r{(Summary)}
6376@findex gnus-summary-mark-above 6370@findex gnus-summary-mark-above
6377Prompt for a mark, and mark all articles with scores over the default 6371Prompt for a mark, and mark all articles with scores over the default
6378score (or over the numeric prefix) with this mark 6372score (or over the numeric prefix) with this mark
@@ -6385,7 +6379,7 @@ be taken after setting a mark. If non-@code{nil}, point will move to
6385the next/previous unread article. If @code{nil}, point will just move 6379the next/previous unread article. If @code{nil}, point will just move
6386one line up or down. As a special case, if this variable is 6380one line up or down. As a special case, if this variable is
6387@code{never}, all the marking commands as well as other commands (like 6381@code{never}, all the marking commands as well as other commands (like
6388@kbd{SPACE}) will move to the next article, whether it is unread or not. 6382@kbd{@key{SPC}}) will move to the next article, whether it is unread or not.
6389The default is @code{t}. 6383The default is @code{t}.
6390 6384
6391 6385
@@ -6445,8 +6439,8 @@ articles into the cache. For more information,
6445 6439
6446@item M P p 6440@item M P p
6447@itemx # 6441@itemx #
6448@kindex # (Summary) 6442@kindex # @r{(Summary)}
6449@kindex M P p (Summary) 6443@kindex M P p @r{(Summary)}
6450@findex gnus-summary-mark-as-processable 6444@findex gnus-summary-mark-as-processable
6451Mark the current article with the process mark 6445Mark the current article with the process mark
6452(@code{gnus-summary-mark-as-processable}). 6446(@code{gnus-summary-mark-as-processable}).
@@ -6454,99 +6448,99 @@ Mark the current article with the process mark
6454 6448
6455@item M P u 6449@item M P u
6456@itemx M-# 6450@itemx M-#
6457@kindex M P u (Summary) 6451@kindex M P u @r{(Summary)}
6458@kindex M-# (Summary) 6452@kindex M-# @r{(Summary)}
6459Remove the process mark, if any, from the current article 6453Remove the process mark, if any, from the current article
6460(@code{gnus-summary-unmark-as-processable}). 6454(@code{gnus-summary-unmark-as-processable}).
6461 6455
6462@item M P U 6456@item M P U
6463@kindex M P U (Summary) 6457@kindex M P U @r{(Summary)}
6464@findex gnus-summary-unmark-all-processable 6458@findex gnus-summary-unmark-all-processable
6465Remove the process mark from all articles 6459Remove the process mark from all articles
6466(@code{gnus-summary-unmark-all-processable}). 6460(@code{gnus-summary-unmark-all-processable}).
6467 6461
6468@item M P i 6462@item M P i
6469@kindex M P i (Summary) 6463@kindex M P i @r{(Summary)}
6470@findex gnus-uu-invert-processable 6464@findex gnus-uu-invert-processable
6471Invert the list of process marked articles 6465Invert the list of process marked articles
6472(@code{gnus-uu-invert-processable}). 6466(@code{gnus-uu-invert-processable}).
6473 6467
6474@item M P R 6468@item M P R
6475@kindex M P R (Summary) 6469@kindex M P R @r{(Summary)}
6476@findex gnus-uu-mark-by-regexp 6470@findex gnus-uu-mark-by-regexp
6477Mark articles that have a @code{Subject} header that matches a regular 6471Mark articles that have a @code{Subject} header that matches a regular
6478expression (@code{gnus-uu-mark-by-regexp}). 6472expression (@code{gnus-uu-mark-by-regexp}).
6479 6473
6480@item M P G 6474@item M P G
6481@kindex M P G (Summary) 6475@kindex M P G @r{(Summary)}
6482@findex gnus-uu-unmark-by-regexp 6476@findex gnus-uu-unmark-by-regexp
6483Unmark articles that have a @code{Subject} header that matches a regular 6477Unmark articles that have a @code{Subject} header that matches a regular
6484expression (@code{gnus-uu-unmark-by-regexp}). 6478expression (@code{gnus-uu-unmark-by-regexp}).
6485 6479
6486@item M P r 6480@item M P r
6487@kindex M P r (Summary) 6481@kindex M P r @r{(Summary)}
6488@findex gnus-uu-mark-region 6482@findex gnus-uu-mark-region
6489Mark articles in region (@code{gnus-uu-mark-region}). 6483Mark articles in region (@code{gnus-uu-mark-region}).
6490 6484
6491@item M P g 6485@item M P g
6492@kindex M P g (Summary) 6486@kindex M P g @r{(Summary)}
6493@findex gnus-uu-unmark-region 6487@findex gnus-uu-unmark-region
6494Unmark articles in region (@code{gnus-uu-unmark-region}). 6488Unmark articles in region (@code{gnus-uu-unmark-region}).
6495 6489
6496@item M P t 6490@item M P t
6497@kindex M P t (Summary) 6491@kindex M P t @r{(Summary)}
6498@findex gnus-uu-mark-thread 6492@findex gnus-uu-mark-thread
6499Mark all articles in the current (sub)thread 6493Mark all articles in the current (sub)thread
6500(@code{gnus-uu-mark-thread}). 6494(@code{gnus-uu-mark-thread}).
6501 6495
6502@item M P T 6496@item M P T
6503@kindex M P T (Summary) 6497@kindex M P T @r{(Summary)}
6504@findex gnus-uu-unmark-thread 6498@findex gnus-uu-unmark-thread
6505Unmark all articles in the current (sub)thread 6499Unmark all articles in the current (sub)thread
6506(@code{gnus-uu-unmark-thread}). 6500(@code{gnus-uu-unmark-thread}).
6507 6501
6508@item M P v 6502@item M P v
6509@kindex M P v (Summary) 6503@kindex M P v @r{(Summary)}
6510@findex gnus-uu-mark-over 6504@findex gnus-uu-mark-over
6511Mark all articles that have a score above the prefix argument 6505Mark all articles that have a score above the prefix argument
6512(@code{gnus-uu-mark-over}). 6506(@code{gnus-uu-mark-over}).
6513 6507
6514@item M P s 6508@item M P s
6515@kindex M P s (Summary) 6509@kindex M P s @r{(Summary)}
6516@findex gnus-uu-mark-series 6510@findex gnus-uu-mark-series
6517Mark all articles in the current series (@code{gnus-uu-mark-series}). 6511Mark all articles in the current series (@code{gnus-uu-mark-series}).
6518 6512
6519@item M P S 6513@item M P S
6520@kindex M P S (Summary) 6514@kindex M P S @r{(Summary)}
6521@findex gnus-uu-mark-sparse 6515@findex gnus-uu-mark-sparse
6522Mark all series that have already had some articles marked 6516Mark all series that have already had some articles marked
6523(@code{gnus-uu-mark-sparse}). 6517(@code{gnus-uu-mark-sparse}).
6524 6518
6525@item M P a 6519@item M P a
6526@kindex M P a (Summary) 6520@kindex M P a @r{(Summary)}
6527@findex gnus-uu-mark-all 6521@findex gnus-uu-mark-all
6528Mark all articles in series order (@code{gnus-uu-mark-all}). 6522Mark all articles in series order (@code{gnus-uu-mark-all}).
6529 6523
6530@item M P b 6524@item M P b
6531@kindex M P b (Summary) 6525@kindex M P b @r{(Summary)}
6532@findex gnus-uu-mark-buffer 6526@findex gnus-uu-mark-buffer
6533Mark all articles in the buffer in the order they appear 6527Mark all articles in the buffer in the order they appear
6534(@code{gnus-uu-mark-buffer}). 6528(@code{gnus-uu-mark-buffer}).
6535 6529
6536@item M P k 6530@item M P k
6537@kindex M P k (Summary) 6531@kindex M P k @r{(Summary)}
6538@findex gnus-summary-kill-process-mark 6532@findex gnus-summary-kill-process-mark
6539Push the current process mark set onto the stack and unmark all articles 6533Push the current process mark set onto the stack and unmark all articles
6540(@code{gnus-summary-kill-process-mark}). 6534(@code{gnus-summary-kill-process-mark}).
6541 6535
6542@item M P y 6536@item M P y
6543@kindex M P y (Summary) 6537@kindex M P y @r{(Summary)}
6544@findex gnus-summary-yank-process-mark 6538@findex gnus-summary-yank-process-mark
6545Pop the previous process mark set from the stack and restore it 6539Pop the previous process mark set from the stack and restore it
6546(@code{gnus-summary-yank-process-mark}). 6540(@code{gnus-summary-yank-process-mark}).
6547 6541
6548@item M P w 6542@item M P w
6549@kindex M P w (Summary) 6543@kindex M P w @r{(Summary)}
6550@findex gnus-summary-save-process-mark 6544@findex gnus-summary-save-process-mark
6551Push the current process mark set onto the stack 6545Push the current process mark set onto the stack
6552(@code{gnus-summary-save-process-mark}). 6546(@code{gnus-summary-save-process-mark}).
@@ -6574,42 +6568,42 @@ articles.
6574 6568
6575@item / / 6569@item / /
6576@itemx / s 6570@itemx / s
6577@kindex / / (Summary) 6571@kindex / / @r{(Summary)}
6578@findex gnus-summary-limit-to-subject 6572@findex gnus-summary-limit-to-subject
6579Limit the summary buffer to articles that match some subject 6573Limit the summary buffer to articles that match some subject
6580(@code{gnus-summary-limit-to-subject}). If given a prefix, exclude 6574(@code{gnus-summary-limit-to-subject}). If given a prefix, exclude
6581matching articles. 6575matching articles.
6582 6576
6583@item / a 6577@item / a
6584@kindex / a (Summary) 6578@kindex / a @r{(Summary)}
6585@findex gnus-summary-limit-to-author 6579@findex gnus-summary-limit-to-author
6586Limit the summary buffer to articles that match some author 6580Limit the summary buffer to articles that match some author
6587(@code{gnus-summary-limit-to-author}). If given a prefix, exclude 6581(@code{gnus-summary-limit-to-author}). If given a prefix, exclude
6588matching articles. 6582matching articles.
6589 6583
6590@item / R 6584@item / R
6591@kindex / R (Summary) 6585@kindex / R @r{(Summary)}
6592@findex gnus-summary-limit-to-recipient 6586@findex gnus-summary-limit-to-recipient
6593Limit the summary buffer to articles that match some recipient 6587Limit the summary buffer to articles that match some recipient
6594(@code{gnus-summary-limit-to-recipient}). If given a prefix, exclude 6588(@code{gnus-summary-limit-to-recipient}). If given a prefix, exclude
6595matching articles. 6589matching articles.
6596 6590
6597@item / A 6591@item / A
6598@kindex / A (Summary) 6592@kindex / A @r{(Summary)}
6599@findex gnus-summary-limit-to-address 6593@findex gnus-summary-limit-to-address
6600Limit the summary buffer to articles in which contents of From, To or Cc 6594Limit the summary buffer to articles in which contents of From, To or Cc
6601header match a given address (@code{gnus-summary-limit-to-address}). If 6595header match a given address (@code{gnus-summary-limit-to-address}). If
6602given a prefix, exclude matching articles. 6596given a prefix, exclude matching articles.
6603 6597
6604@item / S 6598@item / S
6605@kindex / S (Summary) 6599@kindex / S @r{(Summary)}
6606@findex gnus-summary-limit-to-singletons 6600@findex gnus-summary-limit-to-singletons
6607Limit the summary buffer to articles that aren't part of any displayed 6601Limit the summary buffer to articles that aren't part of any displayed
6608threads (@code{gnus-summary-limit-to-singletons}). If given a prefix, 6602threads (@code{gnus-summary-limit-to-singletons}). If given a prefix,
6609limit to articles that are part of displayed threads. 6603limit to articles that are part of displayed threads.
6610 6604
6611@item / x 6605@item / x
6612@kindex / x (Summary) 6606@kindex / x @r{(Summary)}
6613@findex gnus-summary-limit-to-extra 6607@findex gnus-summary-limit-to-extra
6614Limit the summary buffer to articles that match one of the ``extra'' 6608Limit the summary buffer to articles that match one of the ``extra''
6615headers (@pxref{To From Newsgroups}) 6609headers (@pxref{To From Newsgroups})
@@ -6618,8 +6612,8 @@ matching articles.
6618 6612
6619@item / u 6613@item / u
6620@itemx x 6614@itemx x
6621@kindex / u (Summary) 6615@kindex / u @r{(Summary)}
6622@kindex x (Summary) 6616@kindex x @r{(Summary)}
6623@findex gnus-summary-limit-to-unread 6617@findex gnus-summary-limit-to-unread
6624Limit the summary buffer to articles not marked as read 6618Limit the summary buffer to articles not marked as read
6625(@code{gnus-summary-limit-to-unread}). If given a prefix, limit the 6619(@code{gnus-summary-limit-to-unread}). If given a prefix, limit the
@@ -6627,46 +6621,46 @@ buffer to articles strictly unread. This means that ticked and
6627dormant articles will also be excluded. 6621dormant articles will also be excluded.
6628 6622
6629@item / m 6623@item / m
6630@kindex / m (Summary) 6624@kindex / m @r{(Summary)}
6631@findex gnus-summary-limit-to-marks 6625@findex gnus-summary-limit-to-marks
6632Ask for a mark and then limit to all articles that have been marked 6626Ask for a mark and then limit to all articles that have been marked
6633with that mark (@code{gnus-summary-limit-to-marks}). 6627with that mark (@code{gnus-summary-limit-to-marks}).
6634 6628
6635@item / t 6629@item / t
6636@kindex / t (Summary) 6630@kindex / t @r{(Summary)}
6637@findex gnus-summary-limit-to-age 6631@findex gnus-summary-limit-to-age
6638Ask for a number and then limit the summary buffer to articles older than (or equal to) that number of days 6632Ask for a number and then limit the summary buffer to articles older than (or equal to) that number of days
6639(@code{gnus-summary-limit-to-age}). If given a prefix, limit to 6633(@code{gnus-summary-limit-to-age}). If given a prefix, limit to
6640articles younger than that number of days. 6634articles younger than that number of days.
6641 6635
6642@item / n 6636@item / n
6643@kindex / n (Summary) 6637@kindex / n @r{(Summary)}
6644@findex gnus-summary-limit-to-articles 6638@findex gnus-summary-limit-to-articles
6645With prefix @samp{n}, limit the summary buffer to the next @samp{n} 6639With prefix @samp{n}, limit the summary buffer to the next @samp{n}
6646articles. If not given a prefix, use the process marked articles 6640articles. If not given a prefix, use the process marked articles
6647instead. (@code{gnus-summary-limit-to-articles}). 6641instead. (@code{gnus-summary-limit-to-articles}).
6648 6642
6649@item / w 6643@item / w
6650@kindex / w (Summary) 6644@kindex / w @r{(Summary)}
6651@findex gnus-summary-pop-limit 6645@findex gnus-summary-pop-limit
6652Pop the previous limit off the stack and restore it 6646Pop the previous limit off the stack and restore it
6653(@code{gnus-summary-pop-limit}). If given a prefix, pop all limits off 6647(@code{gnus-summary-pop-limit}). If given a prefix, pop all limits off
6654the stack. 6648the stack.
6655 6649
6656@item / . 6650@item / .
6657@kindex / . (Summary) 6651@kindex / . @r{(Summary)}
6658@findex gnus-summary-limit-to-unseen 6652@findex gnus-summary-limit-to-unseen
6659Limit the summary buffer to the unseen articles 6653Limit the summary buffer to the unseen articles
6660(@code{gnus-summary-limit-to-unseen}). 6654(@code{gnus-summary-limit-to-unseen}).
6661 6655
6662@item / v 6656@item / v
6663@kindex / v (Summary) 6657@kindex / v @r{(Summary)}
6664@findex gnus-summary-limit-to-score 6658@findex gnus-summary-limit-to-score
6665Limit the summary buffer to articles that have a score at or above some 6659Limit the summary buffer to articles that have a score at or above some
6666score (@code{gnus-summary-limit-to-score}). 6660score (@code{gnus-summary-limit-to-score}).
6667 6661
6668@item / p 6662@item / p
6669@kindex / p (Summary) 6663@kindex / p @r{(Summary)}
6670@findex gnus-summary-limit-to-display-predicate 6664@findex gnus-summary-limit-to-display-predicate
6671Limit the summary buffer to articles that satisfy the @code{display} 6665Limit the summary buffer to articles that satisfy the @code{display}
6672group parameter predicate 6666group parameter predicate
@@ -6674,7 +6668,7 @@ group parameter predicate
6674Parameters}, for more on this predicate. 6668Parameters}, for more on this predicate.
6675 6669
6676@item / r 6670@item / r
6677@kindex / r (Summary) 6671@kindex / r @r{(Summary)}
6678@findex gnus-summary-limit-to-replied 6672@findex gnus-summary-limit-to-replied
6679Limit the summary buffer to replied articles 6673Limit the summary buffer to replied articles
6680(@code{gnus-summary-limit-to-replied}). If given a prefix, exclude 6674(@code{gnus-summary-limit-to-replied}). If given a prefix, exclude
@@ -6682,55 +6676,55 @@ replied articles.
6682 6676
6683@item / E 6677@item / E
6684@itemx M S 6678@itemx M S
6685@kindex M S (Summary) 6679@kindex M S @r{(Summary)}
6686@kindex / E (Summary) 6680@kindex / E @r{(Summary)}
6687@findex gnus-summary-limit-include-expunged 6681@findex gnus-summary-limit-include-expunged
6688Include all expunged articles in the limit 6682Include all expunged articles in the limit
6689(@code{gnus-summary-limit-include-expunged}). 6683(@code{gnus-summary-limit-include-expunged}).
6690 6684
6691@item / D 6685@item / D
6692@kindex / D (Summary) 6686@kindex / D @r{(Summary)}
6693@findex gnus-summary-limit-include-dormant 6687@findex gnus-summary-limit-include-dormant
6694Include all dormant articles in the limit 6688Include all dormant articles in the limit
6695(@code{gnus-summary-limit-include-dormant}). 6689(@code{gnus-summary-limit-include-dormant}).
6696 6690
6697@item / * 6691@item / *
6698@kindex / * (Summary) 6692@kindex / * @r{(Summary)}
6699@findex gnus-summary-limit-include-cached 6693@findex gnus-summary-limit-include-cached
6700Include all cached articles in the limit 6694Include all cached articles in the limit
6701(@code{gnus-summary-limit-include-cached}). 6695(@code{gnus-summary-limit-include-cached}).
6702 6696
6703@item / d 6697@item / d
6704@kindex / d (Summary) 6698@kindex / d @r{(Summary)}
6705@findex gnus-summary-limit-exclude-dormant 6699@findex gnus-summary-limit-exclude-dormant
6706Exclude all dormant articles from the limit 6700Exclude all dormant articles from the limit
6707(@code{gnus-summary-limit-exclude-dormant}). 6701(@code{gnus-summary-limit-exclude-dormant}).
6708 6702
6709@item / M 6703@item / M
6710@kindex / M (Summary) 6704@kindex / M @r{(Summary)}
6711@findex gnus-summary-limit-exclude-marks 6705@findex gnus-summary-limit-exclude-marks
6712Exclude all marked articles (@code{gnus-summary-limit-exclude-marks}). 6706Exclude all marked articles (@code{gnus-summary-limit-exclude-marks}).
6713 6707
6714@item / T 6708@item / T
6715@kindex / T (Summary) 6709@kindex / T @r{(Summary)}
6716@findex gnus-summary-limit-include-thread 6710@findex gnus-summary-limit-include-thread
6717Include all the articles in the current thread in the limit. 6711Include all the articles in the current thread in the limit.
6718 6712
6719@item / c 6713@item / c
6720@kindex / c (Summary) 6714@kindex / c @r{(Summary)}
6721@findex gnus-summary-limit-exclude-childless-dormant 6715@findex gnus-summary-limit-exclude-childless-dormant
6722Exclude all dormant articles that have no children from the limit@* 6716Exclude all dormant articles that have no children from the limit@*
6723(@code{gnus-summary-limit-exclude-childless-dormant}). 6717(@code{gnus-summary-limit-exclude-childless-dormant}).
6724 6718
6725@item / C 6719@item / C
6726@kindex / C (Summary) 6720@kindex / C @r{(Summary)}
6727@findex gnus-summary-limit-mark-excluded-as-read 6721@findex gnus-summary-limit-mark-excluded-as-read
6728Mark all excluded unread articles as read 6722Mark all excluded unread articles as read
6729(@code{gnus-summary-limit-mark-excluded-as-read}). If given a prefix, 6723(@code{gnus-summary-limit-mark-excluded-as-read}). If given a prefix,
6730also mark excluded ticked and dormant articles as read. 6724also mark excluded ticked and dormant articles as read.
6731 6725
6732@item / b 6726@item / b
6733@kindex / b (Summary) 6727@kindex / b @r{(Summary)}
6734@findex gnus-summary-limit-to-bodies 6728@findex gnus-summary-limit-to-bodies
6735Limit the summary buffer to articles that have bodies that match a 6729Limit the summary buffer to articles that have bodies that match a
6736certain regexp (@code{gnus-summary-limit-to-bodies}). If given a 6730certain regexp (@code{gnus-summary-limit-to-bodies}). If given a
@@ -6738,7 +6732,7 @@ prefix, reverse the limit. This command is quite slow since it
6738requires selecting each article to find the matches. 6732requires selecting each article to find the matches.
6739 6733
6740@item / h 6734@item / h
6741@kindex / h (Summary) 6735@kindex / h @r{(Summary)}
6742@findex gnus-summary-limit-to-headers 6736@findex gnus-summary-limit-to-headers
6743Like the previous command, only limit to headers instead 6737Like the previous command, only limit to headers instead
6744(@code{gnus-summary-limit-to-headers}). 6738(@code{gnus-summary-limit-to-headers}).
@@ -6751,13 +6745,13 @@ prefix as well.
6751 6745
6752@table @kbd 6746@table @kbd
6753@item / N 6747@item / N
6754@kindex / N (Summary) 6748@kindex / N @r{(Summary)}
6755@findex gnus-summary-insert-new-articles 6749@findex gnus-summary-insert-new-articles
6756Insert all new articles in the summary buffer. It scans for new emails 6750Insert all new articles in the summary buffer. It scans for new emails
6757if @var{back-end}@code{-get-new-mail} is non-@code{nil}. 6751if @var{back-end}@code{-get-new-mail} is non-@code{nil}.
6758 6752
6759@item / o 6753@item / o
6760@kindex / o (Summary) 6754@kindex / o @r{(Summary)}
6761@findex gnus-summary-insert-old-articles 6755@findex gnus-summary-insert-old-articles
6762Insert all old articles in the summary buffer. If given a numbered 6756Insert all old articles in the summary buffer. If given a numbered
6763prefix, fetch this number of articles. 6757prefix, fetch this number of articles.
@@ -7043,7 +7037,7 @@ visible effects, but is useful if you use the @kbd{A T} command a lot
7043 7037
7044The server has to support @acronym{NOV} for any of this to work. 7038The server has to support @acronym{NOV} for any of this to work.
7045 7039
7046@cindex Gmane, gnus-fetch-old-headers 7040@cindex Gmane, @code{gnus-fetch-old-headers}
7047This feature can seriously impact performance it ignores all locally 7041This feature can seriously impact performance it ignores all locally
7048cached header entries. Setting it to @code{t} for groups for a server 7042cached header entries. Setting it to @code{t} for groups for a server
7049that doesn't expire articles (such as news.gmane.org), leads to very 7043that doesn't expire articles (such as news.gmane.org), leads to very
@@ -7197,8 +7191,8 @@ meaningful. Here's one example:
7197 7191
7198@item T k 7192@item T k
7199@itemx C-M-k 7193@itemx C-M-k
7200@kindex T k (Summary) 7194@kindex T k @r{(Summary)}
7201@kindex C-M-k (Summary) 7195@kindex C-M-k @r{(Summary)}
7202@findex gnus-summary-kill-thread 7196@findex gnus-summary-kill-thread
7203Mark all articles in the current (sub-)thread as read 7197Mark all articles in the current (sub-)thread as read
7204(@code{gnus-summary-kill-thread}). If the prefix argument is positive, 7198(@code{gnus-summary-kill-thread}). If the prefix argument is positive,
@@ -7207,71 +7201,71 @@ articles instead.
7207 7201
7208@item T l 7202@item T l
7209@itemx C-M-l 7203@itemx C-M-l
7210@kindex T l (Summary) 7204@kindex T l @r{(Summary)}
7211@kindex C-M-l (Summary) 7205@kindex C-M-l @r{(Summary)}
7212@findex gnus-summary-lower-thread 7206@findex gnus-summary-lower-thread
7213Lower the score of the current (sub-)thread 7207Lower the score of the current (sub-)thread
7214(@code{gnus-summary-lower-thread}). 7208(@code{gnus-summary-lower-thread}).
7215 7209
7216@item T i 7210@item T i
7217@kindex T i (Summary) 7211@kindex T i @r{(Summary)}
7218@findex gnus-summary-raise-thread 7212@findex gnus-summary-raise-thread
7219Increase the score of the current (sub-)thread 7213Increase the score of the current (sub-)thread
7220(@code{gnus-summary-raise-thread}). 7214(@code{gnus-summary-raise-thread}).
7221 7215
7222@item T # 7216@item T #
7223@kindex T # (Summary) 7217@kindex T # @r{(Summary)}
7224@findex gnus-uu-mark-thread 7218@findex gnus-uu-mark-thread
7225Set the process mark on the current (sub-)thread 7219Set the process mark on the current (sub-)thread
7226(@code{gnus-uu-mark-thread}). 7220(@code{gnus-uu-mark-thread}).
7227 7221
7228@item T M-# 7222@item T M-#
7229@kindex T M-# (Summary) 7223@kindex T M-# @r{(Summary)}
7230@findex gnus-uu-unmark-thread 7224@findex gnus-uu-unmark-thread
7231Remove the process mark from the current (sub-)thread 7225Remove the process mark from the current (sub-)thread
7232(@code{gnus-uu-unmark-thread}). 7226(@code{gnus-uu-unmark-thread}).
7233 7227
7234@item T T 7228@item T T
7235@kindex T T (Summary) 7229@kindex T T @r{(Summary)}
7236@findex gnus-summary-toggle-threads 7230@findex gnus-summary-toggle-threads
7237Toggle threading (@code{gnus-summary-toggle-threads}). 7231Toggle threading (@code{gnus-summary-toggle-threads}).
7238 7232
7239@item T s 7233@item T s
7240@kindex T s (Summary) 7234@kindex T s @r{(Summary)}
7241@findex gnus-summary-show-thread 7235@findex gnus-summary-show-thread
7242Expose the (sub-)thread hidden under the current article, if any@* 7236Expose the (sub-)thread hidden under the current article, if any@*
7243(@code{gnus-summary-show-thread}). 7237(@code{gnus-summary-show-thread}).
7244 7238
7245@item T h 7239@item T h
7246@kindex T h (Summary) 7240@kindex T h @r{(Summary)}
7247@findex gnus-summary-hide-thread 7241@findex gnus-summary-hide-thread
7248Hide the current (sub-)thread (@code{gnus-summary-hide-thread}). 7242Hide the current (sub-)thread (@code{gnus-summary-hide-thread}).
7249 7243
7250@item T S 7244@item T S
7251@kindex T S (Summary) 7245@kindex T S @r{(Summary)}
7252@findex gnus-summary-show-all-threads 7246@findex gnus-summary-show-all-threads
7253Expose all hidden threads (@code{gnus-summary-show-all-threads}). 7247Expose all hidden threads (@code{gnus-summary-show-all-threads}).
7254 7248
7255@item T H 7249@item T H
7256@kindex T H (Summary) 7250@kindex T H @r{(Summary)}
7257@findex gnus-summary-hide-all-threads 7251@findex gnus-summary-hide-all-threads
7258Hide all threads (@code{gnus-summary-hide-all-threads}). 7252Hide all threads (@code{gnus-summary-hide-all-threads}).
7259 7253
7260@item T t 7254@item T t
7261@kindex T t (Summary) 7255@kindex T t @r{(Summary)}
7262@findex gnus-summary-rethread-current 7256@findex gnus-summary-rethread-current
7263Re-thread the current article's thread 7257Re-thread the current article's thread
7264(@code{gnus-summary-rethread-current}). This works even when the 7258(@code{gnus-summary-rethread-current}). This works even when the
7265summary buffer is otherwise unthreaded. 7259summary buffer is otherwise unthreaded.
7266 7260
7267@item T ^ 7261@item T ^
7268@kindex T ^ (Summary) 7262@kindex T ^ @r{(Summary)}
7269@findex gnus-summary-reparent-thread 7263@findex gnus-summary-reparent-thread
7270Make the current article the child of the marked (or previous) article 7264Make the current article the child of the marked (or previous) article
7271(@code{gnus-summary-reparent-thread}). 7265(@code{gnus-summary-reparent-thread}).
7272 7266
7273@item T M-^ 7267@item T M-^
7274@kindex T M-^ (Summary) 7268@kindex T M-^ @r{(Summary)}
7275@findex gnus-summary-reparent-children 7269@findex gnus-summary-reparent-children
7276Make the current article the parent of the marked articles 7270Make the current article the parent of the marked articles
7277(@code{gnus-summary-reparent-children}). 7271(@code{gnus-summary-reparent-children}).
@@ -7284,35 +7278,35 @@ understand the numeric prefix.
7284@table @kbd 7278@table @kbd
7285 7279
7286@item T n 7280@item T n
7287@kindex T n (Summary) 7281@kindex T n @r{(Summary)}
7288@itemx C-M-f 7282@itemx C-M-f
7289@kindex C-M-n (Summary) 7283@kindex C-M-n @r{(Summary)}
7290@itemx M-down 7284@itemx M-@key{DOWN}
7291@kindex M-down (Summary) 7285@kindex M-DOWN @r{(Summary)}
7292@findex gnus-summary-next-thread 7286@findex gnus-summary-next-thread
7293Go to the next thread (@code{gnus-summary-next-thread}). 7287Go to the next thread (@code{gnus-summary-next-thread}).
7294 7288
7295@item T p 7289@item T p
7296@kindex T p (Summary) 7290@kindex T p @r{(Summary)}
7297@itemx C-M-b 7291@itemx C-M-b
7298@kindex C-M-p (Summary) 7292@kindex C-M-p @r{(Summary)}
7299@itemx M-up 7293@itemx M-@key{UP}
7300@kindex M-up (Summary) 7294@kindex M-UP @r{(Summary)}
7301@findex gnus-summary-prev-thread 7295@findex gnus-summary-prev-thread
7302Go to the previous thread (@code{gnus-summary-prev-thread}). 7296Go to the previous thread (@code{gnus-summary-prev-thread}).
7303 7297
7304@item T d 7298@item T d
7305@kindex T d (Summary) 7299@kindex T d @r{(Summary)}
7306@findex gnus-summary-down-thread 7300@findex gnus-summary-down-thread
7307Descend the thread (@code{gnus-summary-down-thread}). 7301Descend the thread (@code{gnus-summary-down-thread}).
7308 7302
7309@item T u 7303@item T u
7310@kindex T u (Summary) 7304@kindex T u @r{(Summary)}
7311@findex gnus-summary-up-thread 7305@findex gnus-summary-up-thread
7312Ascend the thread (@code{gnus-summary-up-thread}). 7306Ascend the thread (@code{gnus-summary-up-thread}).
7313 7307
7314@item T o 7308@item T o
7315@kindex T o (Summary) 7309@kindex T o @r{(Summary)}
7316@findex gnus-summary-top-thread 7310@findex gnus-summary-top-thread
7317Go to the top of the thread (@code{gnus-summary-top-thread}). 7311Go to the top of the thread (@code{gnus-summary-top-thread}).
7318@end table 7312@end table
@@ -7654,12 +7648,12 @@ you use two explicit commands for managing persistent articles:
7654@table @kbd 7648@table @kbd
7655 7649
7656@item * 7650@item *
7657@kindex * (Summary) 7651@kindex * @r{(Summary)}
7658@findex gnus-cache-enter-article 7652@findex gnus-cache-enter-article
7659Make the current article persistent (@code{gnus-cache-enter-article}). 7653Make the current article persistent (@code{gnus-cache-enter-article}).
7660 7654
7661@item M-* 7655@item M-*
7662@kindex M-* (Summary) 7656@kindex M-* @r{(Summary)}
7663@findex gnus-cache-remove-article 7657@findex gnus-cache-remove-article
7664Remove the current article from the persistent articles 7658Remove the current article from the persistent articles
7665(@code{gnus-cache-remove-article}). This will normally delete the 7659(@code{gnus-cache-remove-article}). This will normally delete the
@@ -7697,7 +7691,7 @@ select another article. You can make an article sticky with:
7697 7691
7698@table @kbd 7692@table @kbd
7699@item A S 7693@item A S
7700@kindex A S (Summary) 7694@kindex A S @r{(Summary)}
7701@findex gnus-sticky-article 7695@findex gnus-sticky-article
7702Make the current article sticky. If a prefix arg is given, ask for a 7696Make the current article sticky. If a prefix arg is given, ask for a
7703name for this sticky article buffer. 7697name for this sticky article buffer.
@@ -7707,12 +7701,12 @@ To close a sticky article buffer you can use these commands:
7707 7701
7708@table @kbd 7702@table @kbd
7709@item q 7703@item q
7710@kindex q (Article) 7704@kindex q @r{@r{(Article)}}
7711@findex bury-buffer 7705@findex bury-buffer
7712Puts this sticky article buffer at the end of the list of all buffers. 7706Puts this sticky article buffer at the end of the list of all buffers.
7713 7707
7714@item k 7708@item k
7715@kindex k (Article) 7709@kindex k @r{(Article)}
7716@findex gnus-kill-sticky-article-buffer 7710@findex gnus-kill-sticky-article-buffer
7717Kills this sticky article buffer. 7711Kills this sticky article buffer.
7718@end table 7712@end table
@@ -7778,61 +7772,61 @@ deleted before saving.
7778 7772
7779@item O o 7773@item O o
7780@itemx o 7774@itemx o
7781@kindex O o (Summary) 7775@kindex O o @r{(Summary)}
7782@kindex o (Summary) 7776@kindex o @r{(Summary)}
7783@findex gnus-summary-save-article 7777@findex gnus-summary-save-article
7784@c @icon{gnus-summary-save-article} 7778@c @icon{gnus-summary-save-article}
7785Save the current article using the default article saver 7779Save the current article using the default article saver
7786(@code{gnus-summary-save-article}). 7780(@code{gnus-summary-save-article}).
7787 7781
7788@item O m 7782@item O m
7789@kindex O m (Summary) 7783@kindex O m @r{(Summary)}
7790@findex gnus-summary-save-article-mail 7784@findex gnus-summary-save-article-mail
7791Save the current article in a Unix mail box (mbox) file 7785Save the current article in a Unix mail box (mbox) file
7792(@code{gnus-summary-save-article-mail}). 7786(@code{gnus-summary-save-article-mail}).
7793 7787
7794@item O r 7788@item O r
7795@kindex O r (Summary) 7789@kindex O r @r{(Summary)}
7796@findex gnus-summary-save-article-rmail 7790@findex gnus-summary-save-article-rmail
7797Save the current article in Rmail format 7791Save the current article in Rmail format
7798(@code{gnus-summary-save-article-rmail}). This is mbox since Emacs 23, 7792(@code{gnus-summary-save-article-rmail}). This is mbox since Emacs 23,
7799Babyl in older versions. 7793Babyl in older versions.
7800 7794
7801@item O f 7795@item O f
7802@kindex O f (Summary) 7796@kindex O f @r{(Summary)}
7803@findex gnus-summary-save-article-file 7797@findex gnus-summary-save-article-file
7804@c @icon{gnus-summary-save-article-file} 7798@c @icon{gnus-summary-save-article-file}
7805Save the current article in plain file format 7799Save the current article in plain file format
7806(@code{gnus-summary-save-article-file}). 7800(@code{gnus-summary-save-article-file}).
7807 7801
7808@item O F 7802@item O F
7809@kindex O F (Summary) 7803@kindex O F @r{(Summary)}
7810@findex gnus-summary-write-article-file 7804@findex gnus-summary-write-article-file
7811Write the current article in plain file format, overwriting any previous 7805Write the current article in plain file format, overwriting any previous
7812file contents (@code{gnus-summary-write-article-file}). 7806file contents (@code{gnus-summary-write-article-file}).
7813 7807
7814@item O b 7808@item O b
7815@kindex O b (Summary) 7809@kindex O b @r{(Summary)}
7816@findex gnus-summary-save-article-body-file 7810@findex gnus-summary-save-article-body-file
7817Save the current article body in plain file format 7811Save the current article body in plain file format
7818(@code{gnus-summary-save-article-body-file}). 7812(@code{gnus-summary-save-article-body-file}).
7819 7813
7820@item O h 7814@item O h
7821@kindex O h (Summary) 7815@kindex O h @r{(Summary)}
7822@findex gnus-summary-save-article-folder 7816@findex gnus-summary-save-article-folder
7823Save the current article in mh folder format 7817Save the current article in mh folder format
7824(@code{gnus-summary-save-article-folder}). 7818(@code{gnus-summary-save-article-folder}).
7825 7819
7826@item O v 7820@item O v
7827@kindex O v (Summary) 7821@kindex O v @r{(Summary)}
7828@findex gnus-summary-save-article-vm 7822@findex gnus-summary-save-article-vm
7829Save the current article in a VM folder 7823Save the current article in a VM folder
7830(@code{gnus-summary-save-article-vm}). 7824(@code{gnus-summary-save-article-vm}).
7831 7825
7832@item O p 7826@item O p
7833@itemx | 7827@itemx |
7834@kindex O p (Summary) 7828@kindex O p @r{(Summary)}
7835@kindex | (Summary) 7829@kindex | @r{(Summary)}
7836@findex gnus-summary-pipe-output 7830@findex gnus-summary-pipe-output
7837@vindex gnus-summary-pipe-output-default-command 7831@vindex gnus-summary-pipe-output-default-command
7838Save the current article in a pipe. Uhm, like, what I mean is---Pipe 7832Save the current article in a pipe. Uhm, like, what I mean is---Pipe
@@ -7845,7 +7839,7 @@ to a string containing the default command and options (default
7845@code{nil}). 7839@code{nil}).
7846 7840
7847@item O P 7841@item O P
7848@kindex O P (Summary) 7842@kindex O P @r{(Summary)}
7849@findex gnus-summary-muttprint 7843@findex gnus-summary-muttprint
7850@vindex gnus-summary-muttprint-program 7844@vindex gnus-summary-muttprint-program
7851Save the current article into muttprint. That is, print it using the 7845Save the current article into muttprint. That is, print it using the
@@ -8152,24 +8146,24 @@ commands, and you have to mark the articles manually with @kbd{#}.
8152@table @kbd 8146@table @kbd
8153 8147
8154@item X u 8148@item X u
8155@kindex X u (Summary) 8149@kindex X u @r{(Summary)}
8156@findex gnus-uu-decode-uu 8150@findex gnus-uu-decode-uu
8157@c @icon{gnus-uu-decode-uu} 8151@c @icon{gnus-uu-decode-uu}
8158Uudecodes the current series (@code{gnus-uu-decode-uu}). 8152Uudecodes the current series (@code{gnus-uu-decode-uu}).
8159 8153
8160@item X U 8154@item X U
8161@kindex X U (Summary) 8155@kindex X U @r{(Summary)}
8162@findex gnus-uu-decode-uu-and-save 8156@findex gnus-uu-decode-uu-and-save
8163Uudecodes and saves the current series 8157Uudecodes and saves the current series
8164(@code{gnus-uu-decode-uu-and-save}). 8158(@code{gnus-uu-decode-uu-and-save}).
8165 8159
8166@item X v u 8160@item X v u
8167@kindex X v u (Summary) 8161@kindex X v u @r{(Summary)}
8168@findex gnus-uu-decode-uu-view 8162@findex gnus-uu-decode-uu-view
8169Uudecodes and views the current series (@code{gnus-uu-decode-uu-view}). 8163Uudecodes and views the current series (@code{gnus-uu-decode-uu-view}).
8170 8164
8171@item X v U 8165@item X v U
8172@kindex X v U (Summary) 8166@kindex X v U @r{(Summary)}
8173@findex gnus-uu-decode-uu-and-save-view 8167@findex gnus-uu-decode-uu-and-save-view
8174Uudecodes, views and saves the current series 8168Uudecodes, views and saves the current series
8175(@code{gnus-uu-decode-uu-and-save-view}). 8169(@code{gnus-uu-decode-uu-and-save-view}).
@@ -8210,22 +8204,22 @@ some commands to deal with these:
8210@table @kbd 8204@table @kbd
8211 8205
8212@item X s 8206@item X s
8213@kindex X s (Summary) 8207@kindex X s @r{(Summary)}
8214@findex gnus-uu-decode-unshar 8208@findex gnus-uu-decode-unshar
8215Unshars the current series (@code{gnus-uu-decode-unshar}). 8209Unshars the current series (@code{gnus-uu-decode-unshar}).
8216 8210
8217@item X S 8211@item X S
8218@kindex X S (Summary) 8212@kindex X S @r{(Summary)}
8219@findex gnus-uu-decode-unshar-and-save 8213@findex gnus-uu-decode-unshar-and-save
8220Unshars and saves the current series (@code{gnus-uu-decode-unshar-and-save}). 8214Unshars and saves the current series (@code{gnus-uu-decode-unshar-and-save}).
8221 8215
8222@item X v s 8216@item X v s
8223@kindex X v s (Summary) 8217@kindex X v s @r{(Summary)}
8224@findex gnus-uu-decode-unshar-view 8218@findex gnus-uu-decode-unshar-view
8225Unshars and views the current series (@code{gnus-uu-decode-unshar-view}). 8219Unshars and views the current series (@code{gnus-uu-decode-unshar-view}).
8226 8220
8227@item X v S 8221@item X v S
8228@kindex X v S (Summary) 8222@kindex X v S @r{(Summary)}
8229@findex gnus-uu-decode-unshar-and-save-view 8223@findex gnus-uu-decode-unshar-and-save-view
8230Unshars, views and saves the current series 8224Unshars, views and saves the current series
8231(@code{gnus-uu-decode-unshar-and-save-view}). 8225(@code{gnus-uu-decode-unshar-and-save-view}).
@@ -8239,24 +8233,24 @@ Unshars, views and saves the current series
8239@table @kbd 8233@table @kbd
8240 8234
8241@item X p 8235@item X p
8242@kindex X p (Summary) 8236@kindex X p @r{(Summary)}
8243@findex gnus-uu-decode-postscript 8237@findex gnus-uu-decode-postscript
8244Unpack the current PostScript series (@code{gnus-uu-decode-postscript}). 8238Unpack the current PostScript series (@code{gnus-uu-decode-postscript}).
8245 8239
8246@item X P 8240@item X P
8247@kindex X P (Summary) 8241@kindex X P @r{(Summary)}
8248@findex gnus-uu-decode-postscript-and-save 8242@findex gnus-uu-decode-postscript-and-save
8249Unpack and save the current PostScript series 8243Unpack and save the current PostScript series
8250(@code{gnus-uu-decode-postscript-and-save}). 8244(@code{gnus-uu-decode-postscript-and-save}).
8251 8245
8252@item X v p 8246@item X v p
8253@kindex X v p (Summary) 8247@kindex X v p @r{(Summary)}
8254@findex gnus-uu-decode-postscript-view 8248@findex gnus-uu-decode-postscript-view
8255View the current PostScript series 8249View the current PostScript series
8256(@code{gnus-uu-decode-postscript-view}). 8250(@code{gnus-uu-decode-postscript-view}).
8257 8251
8258@item X v P 8252@item X v P
8259@kindex X v P (Summary) 8253@kindex X v P @r{(Summary)}
8260@findex gnus-uu-decode-postscript-and-save-view 8254@findex gnus-uu-decode-postscript-and-save-view
8261View and save the current PostScript series 8255View and save the current PostScript series
8262(@code{gnus-uu-decode-postscript-and-save-view}). 8256(@code{gnus-uu-decode-postscript-and-save-view}).
@@ -8268,19 +8262,19 @@ View and save the current PostScript series
8268 8262
8269@table @kbd 8263@table @kbd
8270@item X o 8264@item X o
8271@kindex X o (Summary) 8265@kindex X o @r{(Summary)}
8272@findex gnus-uu-decode-save 8266@findex gnus-uu-decode-save
8273Save the current series 8267Save the current series
8274(@code{gnus-uu-decode-save}). 8268(@code{gnus-uu-decode-save}).
8275 8269
8276@item X b 8270@item X b
8277@kindex X b (Summary) 8271@kindex X b @r{(Summary)}
8278@findex gnus-uu-decode-binhex 8272@findex gnus-uu-decode-binhex
8279Unbinhex the current series (@code{gnus-uu-decode-binhex}). This 8273Unbinhex the current series (@code{gnus-uu-decode-binhex}). This
8280doesn't really work yet. 8274doesn't really work yet.
8281 8275
8282@item X Y 8276@item X Y
8283@kindex X Y (Summary) 8277@kindex X Y @r{(Summary)}
8284@findex gnus-uu-decode-yenc 8278@findex gnus-uu-decode-yenc
8285yEnc-decode the current series and save it (@code{gnus-uu-decode-yenc}). 8279yEnc-decode the current series and save it (@code{gnus-uu-decode-yenc}).
8286@end table 8280@end table
@@ -8554,7 +8548,7 @@ you want it to look like technicolor fruit salad.
8554@table @kbd 8548@table @kbd
8555 8549
8556@item W H a 8550@item W H a
8557@kindex W H a (Summary) 8551@kindex W H a @r{(Summary)}
8558@findex gnus-article-highlight 8552@findex gnus-article-highlight
8559@findex gnus-article-maybe-highlight 8553@findex gnus-article-maybe-highlight
8560Do much highlighting of the current article 8554Do much highlighting of the current article
@@ -8562,7 +8556,7 @@ Do much highlighting of the current article
8562text, the signature, and adds buttons to the body and the head. 8556text, the signature, and adds buttons to the body and the head.
8563 8557
8564@item W H h 8558@item W H h
8565@kindex W H h (Summary) 8559@kindex W H h @r{(Summary)}
8566@findex gnus-article-highlight-headers 8560@findex gnus-article-highlight-headers
8567@vindex gnus-header-face-alist 8561@vindex gnus-header-face-alist
8568Highlight the headers (@code{gnus-article-highlight-headers}). The 8562Highlight the headers (@code{gnus-article-highlight-headers}). The
@@ -8576,7 +8570,7 @@ the header value. The first match made will be used. Note that
8576@var{regexp} shouldn't have @samp{^} prepended---Gnus will add one. 8570@var{regexp} shouldn't have @samp{^} prepended---Gnus will add one.
8577 8571
8578@item W H c 8572@item W H c
8579@kindex W H c (Summary) 8573@kindex W H c @r{(Summary)}
8580@findex gnus-article-highlight-citation 8574@findex gnus-article-highlight-citation
8581Highlight cited text (@code{gnus-article-highlight-citation}). 8575Highlight cited text (@code{gnus-article-highlight-citation}).
8582 8576
@@ -8637,7 +8631,7 @@ is @code{t}.
8637 8631
8638 8632
8639@item W H s 8633@item W H s
8640@kindex W H s (Summary) 8634@kindex W H s @r{(Summary)}
8641@vindex gnus-signature-separator 8635@vindex gnus-signature-separator
8642@vindex gnus-signature-face 8636@vindex gnus-signature-face
8643@findex gnus-article-highlight-signature 8637@findex gnus-article-highlight-signature
@@ -8658,7 +8652,7 @@ default.
8658@cindex article emphasis 8652@cindex article emphasis
8659 8653
8660@findex gnus-article-emphasize 8654@findex gnus-article-emphasize
8661@kindex W e (Summary) 8655@kindex W e @r{(Summary)}
8662People commonly add emphasis to words in news articles by writing things 8656People commonly add emphasis to words in news articles by writing things
8663like @samp{_this_} or @samp{*this*} or @samp{/this/}. Gnus can make 8657like @samp{_this_} or @samp{*this*} or @samp{/this/}. Gnus can make
8664this look nicer by running the article through the @kbd{W e} 8658this look nicer by running the article through the @kbd{W e}
@@ -8729,32 +8723,32 @@ too much cruft in most articles.
8729@table @kbd 8723@table @kbd
8730 8724
8731@item W W a 8725@item W W a
8732@kindex W W a (Summary) 8726@kindex W W a @r{(Summary)}
8733@findex gnus-article-hide 8727@findex gnus-article-hide
8734Do quite a lot of hiding on the article buffer 8728Do quite a lot of hiding on the article buffer
8735(@kbd{gnus-article-hide}). In particular, this function will hide 8729(@kbd{gnus-article-hide}). In particular, this function will hide
8736headers, @acronym{PGP}, cited text and the signature. 8730headers, @acronym{PGP}, cited text and the signature.
8737 8731
8738@item W W h 8732@item W W h
8739@kindex W W h (Summary) 8733@kindex W W h @r{(Summary)}
8740@findex gnus-article-hide-headers 8734@findex gnus-article-hide-headers
8741Hide headers (@code{gnus-article-hide-headers}). @xref{Hiding 8735Hide headers (@code{gnus-article-hide-headers}). @xref{Hiding
8742Headers}. 8736Headers}.
8743 8737
8744@item W W b 8738@item W W b
8745@kindex W W b (Summary) 8739@kindex W W b @r{(Summary)}
8746@findex gnus-article-hide-boring-headers 8740@findex gnus-article-hide-boring-headers
8747Hide headers that aren't particularly interesting 8741Hide headers that aren't particularly interesting
8748(@code{gnus-article-hide-boring-headers}). @xref{Hiding Headers}. 8742(@code{gnus-article-hide-boring-headers}). @xref{Hiding Headers}.
8749 8743
8750@item W W s 8744@item W W s
8751@kindex W W s (Summary) 8745@kindex W W s @r{(Summary)}
8752@findex gnus-article-hide-signature 8746@findex gnus-article-hide-signature
8753Hide signature (@code{gnus-article-hide-signature}). @xref{Article 8747Hide signature (@code{gnus-article-hide-signature}). @xref{Article
8754Signature}. 8748Signature}.
8755 8749
8756@item W W l 8750@item W W l
8757@kindex W W l (Summary) 8751@kindex W W l @r{(Summary)}
8758@findex gnus-article-hide-list-identifiers 8752@findex gnus-article-hide-list-identifiers
8759@vindex gnus-list-identifiers 8753@vindex gnus-list-identifiers
8760Strip list identifiers specified in @code{gnus-list-identifiers}. These 8754Strip list identifiers specified in @code{gnus-list-identifiers}. These
@@ -8773,13 +8767,13 @@ subject. This can also be a list of regular expressions.
8773@end table 8767@end table
8774 8768
8775@item W W P 8769@item W W P
8776@kindex W W P (Summary) 8770@kindex W W P @r{(Summary)}
8777@findex gnus-article-hide-pem 8771@findex gnus-article-hide-pem
8778Hide @acronym{PEM} (privacy enhanced messages) cruft 8772Hide @acronym{PEM} (privacy enhanced messages) cruft
8779(@code{gnus-article-hide-pem}). 8773(@code{gnus-article-hide-pem}).
8780 8774
8781@item W W B 8775@item W W B
8782@kindex W W B (Summary) 8776@kindex W W B @r{(Summary)}
8783@findex gnus-article-strip-banner 8777@findex gnus-article-strip-banner
8784@vindex gnus-article-banner-alist 8778@vindex gnus-article-banner-alist
8785@vindex gnus-article-address-banner-alist 8779@vindex gnus-article-address-banner-alist
@@ -8833,7 +8827,7 @@ sends, you can use the following element to remove them:
8833@end table 8827@end table
8834 8828
8835@item W W c 8829@item W W c
8836@kindex W W c (Summary) 8830@kindex W W c @r{(Summary)}
8837@findex gnus-article-hide-citation 8831@findex gnus-article-hide-citation
8838Hide citation (@code{gnus-article-hide-citation}). Some variables for 8832Hide citation (@code{gnus-article-hide-citation}). Some variables for
8839customizing the hiding: 8833customizing the hiding:
@@ -8869,7 +8863,7 @@ and bottom of the text, respectively, to remain visible.
8869@end table 8863@end table
8870 8864
8871@item W W C-c 8865@item W W C-c
8872@kindex W W C-c (Summary) 8866@kindex W W C-c @r{(Summary)}
8873@findex gnus-article-hide-citation-maybe 8867@findex gnus-article-hide-citation-maybe
8874 8868
8875Hide citation (@code{gnus-article-hide-citation-maybe}) depending on the 8869Hide citation (@code{gnus-article-hide-citation-maybe}) depending on the
@@ -8888,7 +8882,7 @@ is hidden.
8888@end table 8882@end table
8889 8883
8890@item W W C 8884@item W W C
8891@kindex W W C (Summary) 8885@kindex W W C @r{(Summary)}
8892@findex gnus-article-hide-citation-in-followups 8886@findex gnus-article-hide-citation-in-followups
8893Hide cited text in articles that aren't roots 8887Hide cited text in articles that aren't roots
8894(@code{gnus-article-hide-citation-in-followups}). This isn't very 8888(@code{gnus-article-hide-citation-in-followups}). This isn't very
@@ -8938,14 +8932,14 @@ interactive Washing functions but with all default treatments
8938(@pxref{Customizing Articles}). 8932(@pxref{Customizing Articles}).
8939 8933
8940@item W l 8934@item W l
8941@kindex W l (Summary) 8935@kindex W l @r{(Summary)}
8942@findex gnus-summary-stop-page-breaking 8936@findex gnus-summary-stop-page-breaking
8943Remove page breaks from the current article 8937Remove page breaks from the current article
8944(@code{gnus-summary-stop-page-breaking}). @xref{Misc Article}, for page 8938(@code{gnus-summary-stop-page-breaking}). @xref{Misc Article}, for page
8945delimiters. 8939delimiters.
8946 8940
8947@item W r 8941@item W r
8948@kindex W r (Summary) 8942@kindex W r @r{(Summary)}
8949@findex gnus-summary-caesar-message 8943@findex gnus-summary-caesar-message
8950@c @icon{gnus-summary-caesar-message} 8944@c @icon{gnus-summary-caesar-message}
8951Do a Caesar rotate (rot13) on the article buffer 8945Do a Caesar rotate (rot13) on the article buffer
@@ -8959,12 +8953,12 @@ positions in the alphabet, e.g., @samp{B} (letter #2) -> @samp{O} (letter
8959is rumored to have employed this form of, uh, somewhat weak encryption. 8953is rumored to have employed this form of, uh, somewhat weak encryption.
8960 8954
8961@item W m 8955@item W m
8962@kindex W m (Summary) 8956@kindex W m @r{(Summary)}
8963@findex gnus-summary-morse-message 8957@findex gnus-summary-morse-message
8964Morse decode the article buffer (@code{gnus-summary-morse-message}). 8958Morse decode the article buffer (@code{gnus-summary-morse-message}).
8965 8959
8966@item W i 8960@item W i
8967@kindex W i (Summary) 8961@kindex W i @r{(Summary)}
8968@findex gnus-summary-idna-message 8962@findex gnus-summary-idna-message
8969Decode IDNA encoded domain names in the current articles. IDNA 8963Decode IDNA encoded domain names in the current articles. IDNA
8970encoded domain names looks like @samp{xn--bar}. If a string remain 8964encoded domain names looks like @samp{xn--bar}. If a string remain
@@ -8975,25 +8969,25 @@ to work.
8975 8969
8976@item W t 8970@item W t
8977@item t 8971@item t
8978@kindex W t (Summary) 8972@kindex W t @r{(Summary)}
8979@kindex t (Summary) 8973@kindex t @r{(Summary)}
8980@findex gnus-summary-toggle-header 8974@findex gnus-summary-toggle-header
8981Toggle whether to display all headers in the article buffer 8975Toggle whether to display all headers in the article buffer
8982(@code{gnus-summary-toggle-header}). 8976(@code{gnus-summary-toggle-header}).
8983 8977
8984@item W v 8978@item W v
8985@kindex W v (Summary) 8979@kindex W v @r{(Summary)}
8986@findex gnus-summary-verbose-headers 8980@findex gnus-summary-verbose-headers
8987Toggle whether to display all headers in the article buffer permanently 8981Toggle whether to display all headers in the article buffer permanently
8988(@code{gnus-summary-verbose-headers}). 8982(@code{gnus-summary-verbose-headers}).
8989 8983
8990@item W o 8984@item W o
8991@kindex W o (Summary) 8985@kindex W o @r{(Summary)}
8992@findex gnus-article-treat-overstrike 8986@findex gnus-article-treat-overstrike
8993Treat overstrike (@code{gnus-article-treat-overstrike}). 8987Treat overstrike (@code{gnus-article-treat-overstrike}).
8994 8988
8995@item W d 8989@item W d
8996@kindex W d (Summary) 8990@kindex W d @r{(Summary)}
8997@findex gnus-article-treat-dumbquotes 8991@findex gnus-article-treat-dumbquotes
8998@vindex gnus-article-dumbquotes-map 8992@vindex gnus-article-dumbquotes-map
8999@cindex Smartquotes 8993@cindex Smartquotes
@@ -9011,7 +9005,7 @@ like @code{\222} or @code{\264} where you're expecting some kind of
9011apostrophe or quotation mark, then try this wash. 9005apostrophe or quotation mark, then try this wash.
9012 9006
9013@item W U 9007@item W U
9014@kindex W U (Summary) 9008@kindex W U @r{(Summary)}
9015@findex gnus-article-treat-non-ascii 9009@findex gnus-article-treat-non-ascii
9016@cindex Unicode 9010@cindex Unicode
9017@cindex Non-@acronym{ASCII} 9011@cindex Non-@acronym{ASCII}
@@ -9022,7 +9016,7 @@ and doesn't show accented characters, ``advanced'' punctuation, and the
9022like. For instance, @samp{»} is translated into @samp{>>}, and so on. 9016like. For instance, @samp{»} is translated into @samp{>>}, and so on.
9023 9017
9024@item W Y f 9018@item W Y f
9025@kindex W Y f (Summary) 9019@kindex W Y f @r{(Summary)}
9026@findex gnus-article-outlook-deuglify-article 9020@findex gnus-article-outlook-deuglify-article
9027@cindex Outlook Express 9021@cindex Outlook Express
9028Full deuglify of broken Outlook (Express) articles: Treat dumbquotes, 9022Full deuglify of broken Outlook (Express) articles: Treat dumbquotes,
@@ -9030,7 +9024,7 @@ unwrap lines, repair attribution and rearrange citation.
9030(@code{gnus-article-outlook-deuglify-article}). 9024(@code{gnus-article-outlook-deuglify-article}).
9031 9025
9032@item W Y u 9026@item W Y u
9033@kindex W Y u (Summary) 9027@kindex W Y u @r{(Summary)}
9034@findex gnus-article-outlook-unwrap-lines 9028@findex gnus-article-outlook-unwrap-lines
9035@vindex gnus-outlook-deuglify-unwrap-min 9029@vindex gnus-outlook-deuglify-unwrap-min
9036@vindex gnus-outlook-deuglify-unwrap-max 9030@vindex gnus-outlook-deuglify-unwrap-max
@@ -9042,19 +9036,19 @@ maximum length of an unwrapped citation line.
9042(@code{gnus-article-outlook-unwrap-lines}). 9036(@code{gnus-article-outlook-unwrap-lines}).
9043 9037
9044@item W Y a 9038@item W Y a
9045@kindex W Y a (Summary) 9039@kindex W Y a @r{(Summary)}
9046@findex gnus-article-outlook-repair-attribution 9040@findex gnus-article-outlook-repair-attribution
9047Repair a broken attribution line.@* 9041Repair a broken attribution line.@*
9048(@code{gnus-article-outlook-repair-attribution}). 9042(@code{gnus-article-outlook-repair-attribution}).
9049 9043
9050@item W Y c 9044@item W Y c
9051@kindex W Y c (Summary) 9045@kindex W Y c @r{(Summary)}
9052@findex gnus-article-outlook-rearrange-citation 9046@findex gnus-article-outlook-rearrange-citation
9053Repair broken citations by rearranging the text. 9047Repair broken citations by rearranging the text.
9054(@code{gnus-article-outlook-rearrange-citation}). 9048(@code{gnus-article-outlook-rearrange-citation}).
9055 9049
9056@item W w 9050@item W w
9057@kindex W w (Summary) 9051@kindex W w @r{(Summary)}
9058@findex gnus-article-fill-cited-article 9052@findex gnus-article-fill-cited-article
9059Do word wrap (@code{gnus-article-fill-cited-article}). 9053Do word wrap (@code{gnus-article-fill-cited-article}).
9060 9054
@@ -9062,18 +9056,18 @@ You can give the command a numerical prefix to specify the width to use
9062when filling. 9056when filling.
9063 9057
9064@item W Q 9058@item W Q
9065@kindex W Q (Summary) 9059@kindex W Q @r{(Summary)}
9066@findex gnus-article-fill-long-lines 9060@findex gnus-article-fill-long-lines
9067Fill long lines (@code{gnus-article-fill-long-lines}). 9061Fill long lines (@code{gnus-article-fill-long-lines}).
9068 9062
9069@item W C 9063@item W C
9070@kindex W C (Summary) 9064@kindex W C @r{(Summary)}
9071@findex gnus-article-capitalize-sentences 9065@findex gnus-article-capitalize-sentences
9072Capitalize the first word in each sentence 9066Capitalize the first word in each sentence
9073(@code{gnus-article-capitalize-sentences}). 9067(@code{gnus-article-capitalize-sentences}).
9074 9068
9075@item W c 9069@item W c
9076@kindex W c (Summary) 9070@kindex W c @r{(Summary)}
9077@findex gnus-article-remove-cr 9071@findex gnus-article-remove-cr
9078Translate CRLF pairs (i.e., @samp{^M}s on the end of the lines) into LF 9072Translate CRLF pairs (i.e., @samp{^M}s on the end of the lines) into LF
9079(this takes care of DOS line endings), and then translate any remaining 9073(this takes care of DOS line endings), and then translate any remaining
@@ -9081,7 +9075,7 @@ CRs into LF (this takes care of Mac line endings)
9081(@code{gnus-article-remove-cr}). 9075(@code{gnus-article-remove-cr}).
9082 9076
9083@item W q 9077@item W q
9084@kindex W q (Summary) 9078@kindex W q @r{(Summary)}
9085@findex gnus-article-de-quoted-unreadable 9079@findex gnus-article-de-quoted-unreadable
9086Treat quoted-printable (@code{gnus-article-de-quoted-unreadable}). 9080Treat quoted-printable (@code{gnus-article-de-quoted-unreadable}).
9087Quoted-Printable is one common @acronym{MIME} encoding employed when 9081Quoted-Printable is one common @acronym{MIME} encoding employed when
@@ -9093,7 +9087,7 @@ done automatically by Gnus if the message in question has a
9093has been done. If a prefix is given, a charset will be asked for. 9087has been done. If a prefix is given, a charset will be asked for.
9094 9088
9095@item W 6 9089@item W 6
9096@kindex W 6 (Summary) 9090@kindex W 6 @r{(Summary)}
9097@findex gnus-article-de-base64-unreadable 9091@findex gnus-article-de-base64-unreadable
9098Treat base64 (@code{gnus-article-de-base64-unreadable}). Base64 is 9092Treat base64 (@code{gnus-article-de-base64-unreadable}). Base64 is
9099one common @acronym{MIME} encoding employed when sending 9093one common @acronym{MIME} encoding employed when sending
@@ -9103,14 +9097,14 @@ usually done automatically by Gnus if the message in question has a
9103has been done. If a prefix is given, a charset will be asked for. 9097has been done. If a prefix is given, a charset will be asked for.
9104 9098
9105@item W Z 9099@item W Z
9106@kindex W Z (Summary) 9100@kindex W Z @r{(Summary)}
9107@findex gnus-article-decode-HZ 9101@findex gnus-article-decode-HZ
9108Treat HZ or HZP (@code{gnus-article-decode-HZ}). HZ (or HZP) is one 9102Treat HZ or HZP (@code{gnus-article-decode-HZ}). HZ (or HZP) is one
9109common encoding employed when sending Chinese articles. It typically 9103common encoding employed when sending Chinese articles. It typically
9110makes strings look like @samp{~@{<:Ky2;S@{#,NpJ)l6HK!#~@}}. 9104makes strings look like @samp{~@{<:Ky2;S@{#,NpJ)l6HK!#~@}}.
9111 9105
9112@item W A 9106@item W A
9113@kindex W A (Summary) 9107@kindex W A @r{(Summary)}
9114@findex gnus-article-treat-ansi-sequences 9108@findex gnus-article-treat-ansi-sequences
9115@cindex @acronym{ANSI} control sequences 9109@cindex @acronym{ANSI} control sequences
9116Translate @acronym{ANSI} SGR control sequences into overlays or 9110Translate @acronym{ANSI} SGR control sequences into overlays or
@@ -9118,7 +9112,7 @@ extents (@code{gnus-article-treat-ansi-sequences}). @acronym{ANSI}
9118sequences are used in some Chinese hierarchies for highlighting. 9112sequences are used in some Chinese hierarchies for highlighting.
9119 9113
9120@item W u 9114@item W u
9121@kindex W u (Summary) 9115@kindex W u @r{(Summary)}
9122@findex gnus-article-unsplit-urls 9116@findex gnus-article-unsplit-urls
9123Remove newlines from within URLs. Some mailers insert newlines into 9117Remove newlines from within URLs. Some mailers insert newlines into
9124outgoing email messages to keep lines short. This reformatting can 9118outgoing email messages to keep lines short. This reformatting can
@@ -9126,7 +9120,7 @@ split long URLs onto multiple lines. Repair those URLs by removing
9126the newlines (@code{gnus-article-unsplit-urls}). 9120the newlines (@code{gnus-article-unsplit-urls}).
9127 9121
9128@item W h 9122@item W h
9129@kindex W h (Summary) 9123@kindex W h @r{(Summary)}
9130@findex gnus-article-wash-html 9124@findex gnus-article-wash-html
9131Treat @acronym{HTML} (@code{gnus-article-wash-html}). Note that this is 9125Treat @acronym{HTML} (@code{gnus-article-wash-html}). Note that this is
9132usually done automatically by Gnus if the message in question has a 9126usually done automatically by Gnus if the message in question has a
@@ -9166,19 +9160,19 @@ Use html2text---a simple @acronym{HTML} converter included with Gnus.
9166@end table 9160@end table
9167 9161
9168@item W b 9162@item W b
9169@kindex W b (Summary) 9163@kindex W b @r{(Summary)}
9170@findex gnus-article-add-buttons 9164@findex gnus-article-add-buttons
9171Add clickable buttons to the article (@code{gnus-article-add-buttons}). 9165Add clickable buttons to the article (@code{gnus-article-add-buttons}).
9172@xref{Article Buttons}. 9166@xref{Article Buttons}.
9173 9167
9174@item W B 9168@item W B
9175@kindex W B (Summary) 9169@kindex W B @r{(Summary)}
9176@findex gnus-article-add-buttons-to-head 9170@findex gnus-article-add-buttons-to-head
9177Add clickable buttons to the article headers 9171Add clickable buttons to the article headers
9178(@code{gnus-article-add-buttons-to-head}). 9172(@code{gnus-article-add-buttons-to-head}).
9179 9173
9180@item W p 9174@item W p
9181@kindex W p (Summary) 9175@kindex W p @r{(Summary)}
9182@findex gnus-article-verify-x-pgp-sig 9176@findex gnus-article-verify-x-pgp-sig
9183Verify a signed control message 9177Verify a signed control message
9184(@code{gnus-article-verify-x-pgp-sig}). Control messages such as 9178(@code{gnus-article-verify-x-pgp-sig}). Control messages such as
@@ -9189,57 +9183,57 @@ message.@footnote{@acronym{PGP} keys for many hierarchies are
9189available at @uref{https://ftp.isc.org/pub/pgpcontrol/README.html}} 9183available at @uref{https://ftp.isc.org/pub/pgpcontrol/README.html}}
9190 9184
9191@item W s 9185@item W s
9192@kindex W s (Summary) 9186@kindex W s @r{(Summary)}
9193@findex gnus-summary-force-verify-and-decrypt 9187@findex gnus-summary-force-verify-and-decrypt
9194Verify a signed (@acronym{PGP}, @acronym{PGP/MIME} or 9188Verify a signed (@acronym{PGP}, @acronym{PGP/MIME} or
9195@acronym{S/MIME}) message 9189@acronym{S/MIME}) message
9196(@code{gnus-summary-force-verify-and-decrypt}). @xref{Security}. 9190(@code{gnus-summary-force-verify-and-decrypt}). @xref{Security}.
9197 9191
9198@item W a 9192@item W a
9199@kindex W a (Summary) 9193@kindex W a @r{(Summary)}
9200@findex gnus-article-strip-headers-in-body 9194@findex gnus-article-strip-headers-in-body
9201Strip headers like the @code{X-No-Archive} header from the beginning of 9195Strip headers like the @code{X-No-Archive} header from the beginning of
9202article bodies (@code{gnus-article-strip-headers-in-body}). 9196article bodies (@code{gnus-article-strip-headers-in-body}).
9203 9197
9204@item W E l 9198@item W E l
9205@kindex W E l (Summary) 9199@kindex W E l @r{(Summary)}
9206@findex gnus-article-strip-leading-blank-lines 9200@findex gnus-article-strip-leading-blank-lines
9207Remove all blank lines from the beginning of the article 9201Remove all blank lines from the beginning of the article
9208(@code{gnus-article-strip-leading-blank-lines}). 9202(@code{gnus-article-strip-leading-blank-lines}).
9209 9203
9210@item W E m 9204@item W E m
9211@kindex W E m (Summary) 9205@kindex W E m @r{(Summary)}
9212@findex gnus-article-strip-multiple-blank-lines 9206@findex gnus-article-strip-multiple-blank-lines
9213Replace all blank lines with empty lines and then all multiple empty 9207Replace all blank lines with empty lines and then all multiple empty
9214lines with a single empty line. 9208lines with a single empty line.
9215(@code{gnus-article-strip-multiple-blank-lines}). 9209(@code{gnus-article-strip-multiple-blank-lines}).
9216 9210
9217@item W E t 9211@item W E t
9218@kindex W E t (Summary) 9212@kindex W E t @r{(Summary)}
9219@findex gnus-article-remove-trailing-blank-lines 9213@findex gnus-article-remove-trailing-blank-lines
9220Remove all blank lines at the end of the article 9214Remove all blank lines at the end of the article
9221(@code{gnus-article-remove-trailing-blank-lines}). 9215(@code{gnus-article-remove-trailing-blank-lines}).
9222 9216
9223@item W E a 9217@item W E a
9224@kindex W E a (Summary) 9218@kindex W E a @r{(Summary)}
9225@findex gnus-article-strip-blank-lines 9219@findex gnus-article-strip-blank-lines
9226Do all the three commands above 9220Do all the three commands above
9227(@code{gnus-article-strip-blank-lines}). 9221(@code{gnus-article-strip-blank-lines}).
9228 9222
9229@item W E A 9223@item W E A
9230@kindex W E A (Summary) 9224@kindex W E A @r{(Summary)}
9231@findex gnus-article-strip-all-blank-lines 9225@findex gnus-article-strip-all-blank-lines
9232Remove all blank lines 9226Remove all blank lines
9233(@code{gnus-article-strip-all-blank-lines}). 9227(@code{gnus-article-strip-all-blank-lines}).
9234 9228
9235@item W E s 9229@item W E s
9236@kindex W E s (Summary) 9230@kindex W E s @r{(Summary)}
9237@findex gnus-article-strip-leading-space 9231@findex gnus-article-strip-leading-space
9238Remove all white space from the beginning of all lines of the article 9232Remove all white space from the beginning of all lines of the article
9239body (@code{gnus-article-strip-leading-space}). 9233body (@code{gnus-article-strip-leading-space}).
9240 9234
9241@item W E e 9235@item W E e
9242@kindex W E e (Summary) 9236@kindex W E e @r{(Summary)}
9243@findex gnus-article-strip-trailing-space 9237@findex gnus-article-strip-trailing-space
9244Remove all white space from the end of all lines of the article 9238Remove all white space from the end of all lines of the article
9245body (@code{gnus-article-strip-trailing-space}). 9239body (@code{gnus-article-strip-trailing-space}).
@@ -9257,24 +9251,24 @@ These commands perform various transformations of article header.
9257@table @kbd 9251@table @kbd
9258 9252
9259@item W G u 9253@item W G u
9260@kindex W G u (Summary) 9254@kindex W G u @r{(Summary)}
9261@findex gnus-article-treat-unfold-headers 9255@findex gnus-article-treat-unfold-headers
9262Unfold folded header lines (@code{gnus-article-treat-unfold-headers}). 9256Unfold folded header lines (@code{gnus-article-treat-unfold-headers}).
9263 9257
9264@item W G n 9258@item W G n
9265@kindex W G n (Summary) 9259@kindex W G n @r{(Summary)}
9266@findex gnus-article-treat-fold-newsgroups 9260@findex gnus-article-treat-fold-newsgroups
9267Fold the @code{Newsgroups} and @code{Followup-To} headers 9261Fold the @code{Newsgroups} and @code{Followup-To} headers
9268(@code{gnus-article-treat-fold-newsgroups}). 9262(@code{gnus-article-treat-fold-newsgroups}).
9269 9263
9270@item W G f 9264@item W G f
9271@kindex W G f (Summary) 9265@kindex W G f @r{(Summary)}
9272@findex gnus-article-treat-fold-headers 9266@findex gnus-article-treat-fold-headers
9273Fold all the message headers 9267Fold all the message headers
9274(@code{gnus-article-treat-fold-headers}). 9268(@code{gnus-article-treat-fold-headers}).
9275 9269
9276@item W E w 9270@item W E w
9277@kindex W E w (Summary) 9271@kindex W E w @r{(Summary)}
9278@findex gnus-article-remove-leading-whitespace 9272@findex gnus-article-remove-leading-whitespace
9279Remove excessive whitespace from all headers 9273Remove excessive whitespace from all headers
9280(@code{gnus-article-remove-leading-whitespace}). 9274(@code{gnus-article-remove-leading-whitespace}).
@@ -9288,7 +9282,7 @@ Remove excessive whitespace from all headers
9288 9282
9289People often include references to other stuff in articles, and it would 9283People often include references to other stuff in articles, and it would
9290be nice if Gnus could just fetch whatever it is that people talk about 9284be nice if Gnus could just fetch whatever it is that people talk about
9291with the minimum of fuzz when you hit @kbd{RET} or use the middle mouse 9285with the minimum of fuzz when you hit @kbd{@key{RET}} or use the middle mouse
9292button on these references. 9286button on these references.
9293 9287
9294@vindex gnus-button-man-handler 9288@vindex gnus-button-man-handler
@@ -9494,31 +9488,31 @@ when the article was sent.
9494@table @kbd 9488@table @kbd
9495 9489
9496@item W T u 9490@item W T u
9497@kindex W T u (Summary) 9491@kindex W T u @r{(Summary)}
9498@findex gnus-article-date-ut 9492@findex gnus-article-date-ut
9499Display the date in UT (aka. GMT, aka ZULU) 9493Display the date in UT (aka. GMT, aka ZULU)
9500(@code{gnus-article-date-ut}). 9494(@code{gnus-article-date-ut}).
9501 9495
9502@item W T i 9496@item W T i
9503@kindex W T i (Summary) 9497@kindex W T i @r{(Summary)}
9504@findex gnus-article-date-iso8601 9498@findex gnus-article-date-iso8601
9505@cindex ISO 8601 9499@cindex ISO 8601
9506Display the date in international format, aka. ISO 8601 9500Display the date in international format, aka. ISO 8601
9507(@code{gnus-article-date-iso8601}). 9501(@code{gnus-article-date-iso8601}).
9508 9502
9509@item W T l 9503@item W T l
9510@kindex W T l (Summary) 9504@kindex W T l @r{(Summary)}
9511@findex gnus-article-date-local 9505@findex gnus-article-date-local
9512Display the date in the local timezone (@code{gnus-article-date-local}). 9506Display the date in the local timezone (@code{gnus-article-date-local}).
9513 9507
9514@item W T p 9508@item W T p
9515@kindex W T p (Summary) 9509@kindex W T p @r{(Summary)}
9516@findex gnus-article-date-english 9510@findex gnus-article-date-english
9517Display the date in a format that's easily pronounceable in English 9511Display the date in a format that's easily pronounceable in English
9518(@code{gnus-article-date-english}). 9512(@code{gnus-article-date-english}).
9519 9513
9520@item W T s 9514@item W T s
9521@kindex W T s (Summary) 9515@kindex W T s @r{(Summary)}
9522@vindex gnus-article-time-format 9516@vindex gnus-article-time-format
9523@findex gnus-article-date-user 9517@findex gnus-article-date-user
9524@findex format-time-string 9518@findex format-time-string
@@ -9529,7 +9523,7 @@ to @code{format-time-string}. See the documentation of that variable
9529for a list of possible format specs. 9523for a list of possible format specs.
9530 9524
9531@item W T e 9525@item W T e
9532@kindex W T e (Summary) 9526@kindex W T e @r{(Summary)}
9533@findex gnus-article-date-lapsed 9527@findex gnus-article-date-lapsed
9534@findex gnus-start-date-timer 9528@findex gnus-start-date-timer
9535@findex gnus-stop-date-timer 9529@findex gnus-stop-date-timer
@@ -9545,7 +9539,7 @@ To make this line updated continually, set the
9545seconds (the default is @code{nil}). 9539seconds (the default is @code{nil}).
9546 9540
9547@item W T o 9541@item W T o
9548@kindex W T o (Summary) 9542@kindex W T o @r{(Summary)}
9549@findex gnus-article-date-original 9543@findex gnus-article-date-original
9550Display the original date (@code{gnus-article-date-original}). This can 9544Display the original date (@code{gnus-article-date-original}). This can
9551be useful if you normally use some other conversion function and are 9545be useful if you normally use some other conversion function and are
@@ -9589,58 +9583,58 @@ they'll be removed.
9589 9583
9590@table @kbd 9584@table @kbd
9591@item W D x 9585@item W D x
9592@kindex W D x (Summary) 9586@kindex W D x @r{(Summary)}
9593@findex gnus-article-display-x-face 9587@findex gnus-article-display-x-face
9594Display an @code{X-Face} in the @code{From} header. 9588Display an @code{X-Face} in the @code{From} header.
9595(@code{gnus-article-display-x-face}). 9589(@code{gnus-article-display-x-face}).
9596 9590
9597@item W D d 9591@item W D d
9598@kindex W D d (Summary) 9592@kindex W D d @r{(Summary)}
9599@findex gnus-article-display-face 9593@findex gnus-article-display-face
9600Display a @code{Face} in the @code{From} header. 9594Display a @code{Face} in the @code{From} header.
9601(@code{gnus-article-display-face}). 9595(@code{gnus-article-display-face}).
9602 9596
9603@item W D s 9597@item W D s
9604@kindex W D s (Summary) 9598@kindex W D s @r{(Summary)}
9605@findex gnus-treat-smiley 9599@findex gnus-treat-smiley
9606Display smileys (@code{gnus-treat-smiley}). 9600Display smileys (@code{gnus-treat-smiley}).
9607 9601
9608@item W D f 9602@item W D f
9609@kindex W D f (Summary) 9603@kindex W D f @r{(Summary)}
9610@findex gnus-treat-from-picon 9604@findex gnus-treat-from-picon
9611Piconify the @code{From} header (@code{gnus-treat-from-picon}). 9605Piconify the @code{From} header (@code{gnus-treat-from-picon}).
9612 9606
9613@item W D m 9607@item W D m
9614@kindex W D m (Summary) 9608@kindex W D m @r{(Summary)}
9615@findex gnus-treat-mail-picon 9609@findex gnus-treat-mail-picon
9616Piconify all mail headers (i.e., @code{Cc}, @code{To}) 9610Piconify all mail headers (i.e., @code{Cc}, @code{To})
9617(@code{gnus-treat-mail-picon}). 9611(@code{gnus-treat-mail-picon}).
9618 9612
9619@item W D n 9613@item W D n
9620@kindex W D n (Summary) 9614@kindex W D n @r{(Summary)}
9621@findex gnus-treat-newsgroups-picon 9615@findex gnus-treat-newsgroups-picon
9622Piconify all news headers (i.e., @code{Newsgroups} and 9616Piconify all news headers (i.e., @code{Newsgroups} and
9623@code{Followup-To}) (@code{gnus-treat-newsgroups-picon}). 9617@code{Followup-To}) (@code{gnus-treat-newsgroups-picon}).
9624 9618
9625@item W D g 9619@item W D g
9626@kindex W D g (Summary) 9620@kindex W D g @r{(Summary)}
9627@findex gnus-treat-from-gravatar 9621@findex gnus-treat-from-gravatar
9628Gravatarify the @code{From} header (@code{gnus-treat-from-gravatar}). 9622Gravatarify the @code{From} header (@code{gnus-treat-from-gravatar}).
9629 9623
9630@item W D h 9624@item W D h
9631@kindex W D h (Summary) 9625@kindex W D h @r{(Summary)}
9632@findex gnus-treat-mail-gravatar 9626@findex gnus-treat-mail-gravatar
9633Gravatarify all mail headers (i.e., @code{Cc}, @code{To}) 9627Gravatarify all mail headers (i.e., @code{Cc}, @code{To})
9634(@code{gnus-treat-from-gravatar}). 9628(@code{gnus-treat-from-gravatar}).
9635 9629
9636@item W D D 9630@item W D D
9637@kindex W D D (Summary) 9631@kindex W D D @r{(Summary)}
9638@findex gnus-article-remove-images 9632@findex gnus-article-remove-images
9639Remove all images from the article buffer 9633Remove all images from the article buffer
9640(@code{gnus-article-remove-images}). 9634(@code{gnus-article-remove-images}).
9641 9635
9642@item W D W 9636@item W D W
9643@kindex W D W (Summary) 9637@kindex W D W @r{(Summary)}
9644@findex gnus-html-show-images 9638@findex gnus-html-show-images
9645If you're reading an @acronym{HTML} article rendered with 9639If you're reading an @acronym{HTML} article rendered with
9646@code{gnus-article-html}, then you can insert any blocked images in 9640@code{gnus-article-html}, then you can insert any blocked images in
@@ -9718,7 +9712,7 @@ signature after all.
9718 9712
9719@table @kbd 9713@table @kbd
9720@item A t 9714@item A t
9721@kindex A t (Summary) 9715@kindex A t @r{(Summary)}
9722@findex gnus-article-babel 9716@findex gnus-article-babel
9723Translate the article from one language to another 9717Translate the article from one language to another
9724(@code{gnus-article-babel}). 9718(@code{gnus-article-babel}).
@@ -9738,43 +9732,43 @@ instance, @kbd{3 K v} means ``view the third @acronym{MIME} part''.
9738@table @kbd 9732@table @kbd
9739@item b 9733@item b
9740@itemx K v 9734@itemx K v
9741@kindex b (Summary) 9735@kindex b @r{(Summary)}
9742@kindex K v (Summary) 9736@kindex K v @r{(Summary)}
9743View the @acronym{MIME} part. 9737View the @acronym{MIME} part.
9744 9738
9745@item K o 9739@item K o
9746@kindex K o (Summary) 9740@kindex K o @r{(Summary)}
9747Save the @acronym{MIME} part. 9741Save the @acronym{MIME} part.
9748 9742
9749@item K O 9743@item K O
9750@kindex K O (Summary) 9744@kindex K O @r{(Summary)}
9751Prompt for a file name, then save the @acronym{MIME} part and strip it 9745Prompt for a file name, then save the @acronym{MIME} part and strip it
9752from the article. The stripped @acronym{MIME} object will be referred 9746from the article. The stripped @acronym{MIME} object will be referred
9753via the message/external-body @acronym{MIME} type. 9747via the message/external-body @acronym{MIME} type.
9754 9748
9755@item K r 9749@item K r
9756@kindex K r (Summary) 9750@kindex K r @r{(Summary)}
9757Replace the @acronym{MIME} part with an external body. 9751Replace the @acronym{MIME} part with an external body.
9758 9752
9759@item K d 9753@item K d
9760@kindex K d (Summary) 9754@kindex K d @r{(Summary)}
9761Delete the @acronym{MIME} part and add some information about the 9755Delete the @acronym{MIME} part and add some information about the
9762removed part. 9756removed part.
9763 9757
9764@item K c 9758@item K c
9765@kindex K c (Summary) 9759@kindex K c @r{(Summary)}
9766Copy the @acronym{MIME} part. 9760Copy the @acronym{MIME} part.
9767 9761
9768@item K e 9762@item K e
9769@kindex K e (Summary) 9763@kindex K e @r{(Summary)}
9770View the @acronym{MIME} part externally. 9764View the @acronym{MIME} part externally.
9771 9765
9772@item K i 9766@item K i
9773@kindex K i (Summary) 9767@kindex K i @r{(Summary)}
9774View the @acronym{MIME} part internally. 9768View the @acronym{MIME} part internally.
9775 9769
9776@item K | 9770@item K |
9777@kindex K | (Summary) 9771@kindex K | @r{(Summary)}
9778Pipe the @acronym{MIME} part to an external command. 9772Pipe the @acronym{MIME} part to an external command.
9779@end table 9773@end table
9780 9774
@@ -9783,7 +9777,7 @@ the same manner:
9783 9777
9784@table @kbd 9778@table @kbd
9785@item K H 9779@item K H
9786@kindex K H (Summary) 9780@kindex K H @r{(Summary)}
9787@findex gnus-article-browse-html-article 9781@findex gnus-article-browse-html-article
9788View @samp{text/html} parts of the current article with a WWW browser. 9782View @samp{text/html} parts of the current article with a WWW browser.
9789Inline images embedded in a message using the @code{cid} scheme, as they 9783Inline images embedded in a message using the @code{cid} scheme, as they
@@ -9805,13 +9799,13 @@ including images if any to the browser, and deletes them when exiting
9805the group (if you want). 9799the group (if you want).
9806 9800
9807@item K b 9801@item K b
9808@kindex K b (Summary) 9802@kindex K b @r{(Summary)}
9809Make all the @acronym{MIME} parts have buttons in front of them. This is 9803Make all the @acronym{MIME} parts have buttons in front of them. This is
9810mostly useful if you wish to save (or perform other actions) on inlined 9804mostly useful if you wish to save (or perform other actions) on inlined
9811parts. 9805parts.
9812 9806
9813@item W M h 9807@item W M h
9814@kindex W M h (Summary) 9808@kindex W M h @r{(Summary)}
9815@findex gnus-mime-buttonize-attachments-in-header 9809@findex gnus-mime-buttonize-attachments-in-header
9816@vindex gnus-mime-display-attachment-buttons-in-header 9810@vindex gnus-mime-display-attachment-buttons-in-header
9817Display @acronym{MIME} part buttons in the end of the header of an 9811Display @acronym{MIME} part buttons in the end of the header of an
@@ -9824,7 +9818,7 @@ The default is @code{t}. To change the appearance of buttons, customize
9824@code{gnus-header-face-alist}. 9818@code{gnus-header-face-alist}.
9825 9819
9826@item K m 9820@item K m
9827@kindex K m (Summary) 9821@kindex K m @r{(Summary)}
9828@findex gnus-summary-repair-multipart 9822@findex gnus-summary-repair-multipart
9829Some multipart messages are transmitted with missing or faulty headers. 9823Some multipart messages are transmitted with missing or faulty headers.
9830This command will attempt to ``repair'' these messages so that they can 9824This command will attempt to ``repair'' these messages so that they can
@@ -9832,26 +9826,26 @@ be viewed in a more pleasant manner
9832(@code{gnus-summary-repair-multipart}). 9826(@code{gnus-summary-repair-multipart}).
9833 9827
9834@item X m 9828@item X m
9835@kindex X m (Summary) 9829@kindex X m @r{(Summary)}
9836@findex gnus-summary-save-parts 9830@findex gnus-summary-save-parts
9837Save all parts matching a @acronym{MIME} type to a directory 9831Save all parts matching a @acronym{MIME} type to a directory
9838(@code{gnus-summary-save-parts}). Understands the process/prefix 9832(@code{gnus-summary-save-parts}). Understands the process/prefix
9839convention (@pxref{Process/Prefix}). 9833convention (@pxref{Process/Prefix}).
9840 9834
9841@item M-t 9835@item M-t
9842@kindex M-t (Summary) 9836@kindex M-t @r{(Summary)}
9843@findex gnus-summary-toggle-display-buttonized 9837@findex gnus-summary-toggle-display-buttonized
9844Toggle the buttonized display of the article buffer 9838Toggle the buttonized display of the article buffer
9845(@code{gnus-summary-toggle-display-buttonized}). 9839(@code{gnus-summary-toggle-display-buttonized}).
9846 9840
9847@item W M w 9841@item W M w
9848@kindex W M w (Summary) 9842@kindex W M w @r{(Summary)}
9849@findex gnus-article-decode-mime-words 9843@findex gnus-article-decode-mime-words
9850Decode RFC 2047-encoded words in the article headers 9844Decode RFC 2047-encoded words in the article headers
9851(@code{gnus-article-decode-mime-words}). 9845(@code{gnus-article-decode-mime-words}).
9852 9846
9853@item W M c 9847@item W M c
9854@kindex W M c (Summary) 9848@kindex W M c @r{(Summary)}
9855@findex gnus-article-decode-charset 9849@findex gnus-article-decode-charset
9856Decode encoded article bodies as well as charsets 9850Decode encoded article bodies as well as charsets
9857(@code{gnus-article-decode-charset}). 9851(@code{gnus-article-decode-charset}).
@@ -9864,7 +9858,7 @@ include @acronym{MIME} headers), you can set the @code{charset} group/topic
9864parameter to the required charset (@pxref{Group Parameters}). 9858parameter to the required charset (@pxref{Group Parameters}).
9865 9859
9866@item W M v 9860@item W M v
9867@kindex W M v (Summary) 9861@kindex W M v @r{(Summary)}
9868@findex gnus-mime-view-all-parts 9862@findex gnus-mime-view-all-parts
9869View all the @acronym{MIME} parts in the current article 9863View all the @acronym{MIME} parts in the current article
9870(@code{gnus-mime-view-all-parts}). 9864(@code{gnus-mime-view-all-parts}).
@@ -10123,7 +10117,7 @@ something like
10123@item A P 10117@item A P
10124@cindex PostScript 10118@cindex PostScript
10125@cindex printing 10119@cindex printing
10126@kindex A P (Summary) 10120@kindex A P @r{(Summary)}
10127@vindex gnus-ps-print-hook 10121@vindex gnus-ps-print-hook
10128@findex gnus-summary-print-article 10122@findex gnus-summary-print-article
10129Generate and print a PostScript image of the article buffer 10123Generate and print a PostScript image of the article buffer
@@ -10154,68 +10148,68 @@ can't really see why you'd want that.
10154@table @kbd 10148@table @kbd
10155 10149
10156@item C-c C-s C-n 10150@item C-c C-s C-n
10157@kindex C-c C-s C-n (Summary) 10151@kindex C-c C-s C-n @r{(Summary)}
10158@findex gnus-summary-sort-by-number 10152@findex gnus-summary-sort-by-number
10159Sort by article number (@code{gnus-summary-sort-by-number}). 10153Sort by article number (@code{gnus-summary-sort-by-number}).
10160 10154
10161@item C-c C-s C-m C-n 10155@item C-c C-s C-m C-n
10162@kindex C-c C-s C-n (Summary) 10156@kindex C-c C-s C-n @r{(Summary)}
10163@findex gnus-summary-sort-by-most-recent-number 10157@findex gnus-summary-sort-by-most-recent-number
10164Sort by most recent article number 10158Sort by most recent article number
10165(@code{gnus-summary-sort-by-most-recent-number}). 10159(@code{gnus-summary-sort-by-most-recent-number}).
10166 10160
10167@item C-c C-s C-a 10161@item C-c C-s C-a
10168@kindex C-c C-s C-a (Summary) 10162@kindex C-c C-s C-a @r{(Summary)}
10169@findex gnus-summary-sort-by-author 10163@findex gnus-summary-sort-by-author
10170Sort by author (@code{gnus-summary-sort-by-author}). 10164Sort by author (@code{gnus-summary-sort-by-author}).
10171 10165
10172@item C-c C-s C-t 10166@item C-c C-s C-t
10173@kindex C-c C-s C-t (Summary) 10167@kindex C-c C-s C-t @r{(Summary)}
10174@findex gnus-summary-sort-by-recipient 10168@findex gnus-summary-sort-by-recipient
10175Sort by recipient (@code{gnus-summary-sort-by-recipient}). 10169Sort by recipient (@code{gnus-summary-sort-by-recipient}).
10176 10170
10177@item C-c C-s C-s 10171@item C-c C-s C-s
10178@kindex C-c C-s C-s (Summary) 10172@kindex C-c C-s C-s @r{(Summary)}
10179@findex gnus-summary-sort-by-subject 10173@findex gnus-summary-sort-by-subject
10180Sort by subject (@code{gnus-summary-sort-by-subject}). 10174Sort by subject (@code{gnus-summary-sort-by-subject}).
10181 10175
10182@item C-c C-s C-d 10176@item C-c C-s C-d
10183@kindex C-c C-s C-d (Summary) 10177@kindex C-c C-s C-d @r{(Summary)}
10184@findex gnus-summary-sort-by-date 10178@findex gnus-summary-sort-by-date
10185Sort by date (@code{gnus-summary-sort-by-date}). 10179Sort by date (@code{gnus-summary-sort-by-date}).
10186 10180
10187@item C-c C-s C-m C-d 10181@item C-c C-s C-m C-d
10188@kindex C-c C-s C-m C-d (Summary) 10182@kindex C-c C-s C-m C-d @r{(Summary)}
10189@findex gnus-summary-sort-by-most-recent-date 10183@findex gnus-summary-sort-by-most-recent-date
10190Sort by most recent date (@code{gnus-summary-sort-by-most-recent-date}). 10184Sort by most recent date (@code{gnus-summary-sort-by-most-recent-date}).
10191 10185
10192@item C-c C-s C-l 10186@item C-c C-s C-l
10193@kindex C-c C-s C-l (Summary) 10187@kindex C-c C-s C-l @r{(Summary)}
10194@findex gnus-summary-sort-by-lines 10188@findex gnus-summary-sort-by-lines
10195Sort by lines (@code{gnus-summary-sort-by-lines}). 10189Sort by lines (@code{gnus-summary-sort-by-lines}).
10196 10190
10197@item C-c C-s C-c 10191@item C-c C-s C-c
10198@kindex C-c C-s C-c (Summary) 10192@kindex C-c C-s C-c @r{(Summary)}
10199@findex gnus-summary-sort-by-chars 10193@findex gnus-summary-sort-by-chars
10200Sort by article length (@code{gnus-summary-sort-by-chars}). 10194Sort by article length (@code{gnus-summary-sort-by-chars}).
10201 10195
10202@item C-c C-s C-m C-m 10196@item C-c C-s C-m C-m
10203@kindex C-c C-s C-m C-m (Summary) 10197@kindex C-c C-s C-m C-m @r{(Summary)}
10204@findex gnus-summary-sort-by-marks 10198@findex gnus-summary-sort-by-marks
10205Sort by article ``readedness'' marks (@code{gnus-summary-sort-by-marks}). 10199Sort by article ``readedness'' marks (@code{gnus-summary-sort-by-marks}).
10206 10200
10207@item C-c C-s C-i 10201@item C-c C-s C-i
10208@kindex C-c C-s C-i (Summary) 10202@kindex C-c C-s C-i @r{(Summary)}
10209@findex gnus-summary-sort-by-score 10203@findex gnus-summary-sort-by-score
10210Sort by score (@code{gnus-summary-sort-by-score}). 10204Sort by score (@code{gnus-summary-sort-by-score}).
10211 10205
10212@item C-c C-s C-r 10206@item C-c C-s C-r
10213@kindex C-c C-s C-r (Summary) 10207@kindex C-c C-s C-r @r{(Summary)}
10214@findex gnus-summary-sort-by-random 10208@findex gnus-summary-sort-by-random
10215Randomize (@code{gnus-summary-sort-by-random}). 10209Randomize (@code{gnus-summary-sort-by-random}).
10216 10210
10217@item C-c C-s C-o 10211@item C-c C-s C-o
10218@kindex C-c C-s C-o (Summary) 10212@kindex C-c C-s C-o @r{(Summary)}
10219@findex gnus-summary-sort-by-original 10213@findex gnus-summary-sort-by-original
10220Sort using the default sorting method 10214Sort using the default sorting method
10221(@code{gnus-summary-sort-by-original}). 10215(@code{gnus-summary-sort-by-original}).
@@ -10238,7 +10232,7 @@ If a prefix argument if given, the sort order is reversed.
10238 10232
10239@table @kbd 10233@table @kbd
10240@item ^ 10234@item ^
10241@kindex ^ (Summary) 10235@kindex ^ @r{(Summary)}
10242@findex gnus-summary-refer-parent-article 10236@findex gnus-summary-refer-parent-article
10243If you'd like to read the parent of the current article, and it is not 10237If you'd like to read the parent of the current article, and it is not
10244displayed in the summary buffer, you might still be able to. That is, 10238displayed in the summary buffer, you might still be able to. That is,
@@ -10258,13 +10252,13 @@ article.
10258 10252
10259@item A R (Summary) 10253@item A R (Summary)
10260@findex gnus-summary-refer-references 10254@findex gnus-summary-refer-references
10261@kindex A R (Summary) 10255@kindex A R @r{(Summary)}
10262Fetch all articles mentioned in the @code{References} header of the 10256Fetch all articles mentioned in the @code{References} header of the
10263article (@code{gnus-summary-refer-references}). 10257article (@code{gnus-summary-refer-references}).
10264 10258
10265@item A T (Summary) 10259@item A T (Summary)
10266@findex gnus-summary-refer-thread 10260@findex gnus-summary-refer-thread
10267@kindex A T (Summary) 10261@kindex A T @r{(Summary)}
10268Display the full thread where the current article appears 10262Display the full thread where the current article appears
10269(@code{gnus-summary-refer-thread}). This command has to fetch all the 10263(@code{gnus-summary-refer-thread}). This command has to fetch all the
10270headers in the current group to work, so it usually takes a while. If 10264headers in the current group to work, so it usually takes a while. If
@@ -10282,7 +10276,7 @@ by giving the @kbd{A T} command a numerical prefix.
10282 10276
10283@item M-^ (Summary) 10277@item M-^ (Summary)
10284@findex gnus-summary-refer-article 10278@findex gnus-summary-refer-article
10285@kindex M-^ (Summary) 10279@kindex M-^ @r{(Summary)}
10286@cindex Message-ID 10280@cindex Message-ID
10287@cindex fetching by Message-ID 10281@cindex fetching by Message-ID
10288You can also ask Gnus for an arbitrary article, no matter what group it 10282You can also ask Gnus for an arbitrary article, no matter what group it
@@ -10352,7 +10346,6 @@ buffer the articles she wants to read. Then she starts reading the
10352articles with just an article buffer displayed. 10346articles with just an article buffer displayed.
10353 10347
10354@findex gnus-pick-mode 10348@findex gnus-pick-mode
10355@kindex M-x gnus-pick-mode
10356Gnus provides a summary buffer minor mode that allows 10349Gnus provides a summary buffer minor mode that allows
10357this---@code{gnus-pick-mode}. This basically means that a few process 10350this---@code{gnus-pick-mode}. This basically means that a few process
10358mark commands become one-keystroke commands to allow easy marking, and 10351mark commands become one-keystroke commands to allow easy marking, and
@@ -10362,7 +10355,7 @@ Here are the available keystrokes when using pick mode:
10362 10355
10363@table @kbd 10356@table @kbd
10364@item . 10357@item .
10365@kindex . (Pick) 10358@kindex . @r{(Pick)}
10366@findex gnus-pick-article-or-thread 10359@findex gnus-pick-article-or-thread
10367Pick the article or thread on the current line 10360Pick the article or thread on the current line
10368(@code{gnus-pick-article-or-thread}). If the variable 10361(@code{gnus-pick-article-or-thread}). If the variable
@@ -10372,14 +10365,14 @@ it selects just the article. If given a numerical prefix, go to that
10372thread or article and pick it. (The line number is normally displayed 10365thread or article and pick it. (The line number is normally displayed
10373at the beginning of the summary pick lines.) 10366at the beginning of the summary pick lines.)
10374 10367
10375@item SPACE 10368@item @key{SPC}
10376@kindex SPACE (Pick) 10369@kindex SPC @r{(Pick)}
10377@findex gnus-pick-next-page 10370@findex gnus-pick-next-page
10378Scroll the summary buffer up one page (@code{gnus-pick-next-page}). If 10371Scroll the summary buffer up one page (@code{gnus-pick-next-page}). If
10379at the end of the buffer, start reading the picked articles. 10372at the end of the buffer, start reading the picked articles.
10380 10373
10381@item u 10374@item u
10382@kindex u (Pick) 10375@kindex u @r{(Pick)}
10383@findex gnus-pick-unmark-article-or-thread. 10376@findex gnus-pick-unmark-article-or-thread.
10384Unpick the thread or article 10377Unpick the thread or article
10385(@code{gnus-pick-unmark-article-or-thread}). If the variable 10378(@code{gnus-pick-unmark-article-or-thread}). If the variable
@@ -10388,8 +10381,8 @@ thread if used at the first article of the thread. Otherwise it unpicks
10388just the article. You can give this key a numerical prefix to unpick 10381just the article. You can give this key a numerical prefix to unpick
10389the thread or article at that line. 10382the thread or article at that line.
10390 10383
10391@item RET 10384@item @key{RET}
10392@kindex RET (Pick) 10385@kindex RET @r{(Pick)}
10393@findex gnus-pick-start-reading 10386@findex gnus-pick-start-reading
10394@vindex gnus-pick-display-summary 10387@vindex gnus-pick-display-summary
10395Start reading the picked articles (@code{gnus-pick-start-reading}). If 10388Start reading the picked articles (@code{gnus-pick-start-reading}). If
@@ -10431,14 +10424,13 @@ Variables}). It accepts the same format specs that
10431@cindex binary groups 10424@cindex binary groups
10432 10425
10433@findex gnus-binary-mode 10426@findex gnus-binary-mode
10434@kindex M-x gnus-binary-mode
10435If you spend much time in binary groups, you may grow tired of hitting 10427If you spend much time in binary groups, you may grow tired of hitting
10436@kbd{X u}, @kbd{n}, @kbd{RET} all the time. @kbd{M-x gnus-binary-mode} 10428@kbd{X u}, @kbd{n}, @kbd{@key{RET}} all the time. @kbd{M-x gnus-binary-mode}
10437is a minor mode for summary buffers that makes all ordinary Gnus article 10429is a minor mode for summary buffers that makes all ordinary Gnus article
10438selection functions uudecode series of articles and display the result 10430selection functions uudecode series of articles and display the result
10439instead of just displaying the articles the normal way. 10431instead of just displaying the articles the normal way.
10440 10432
10441@kindex g (Binary) 10433@kindex g @r{(Binary)}
10442@findex gnus-binary-show-article 10434@findex gnus-binary-show-article
10443The only way, in fact, to see the actual articles is the @kbd{g} 10435The only way, in fact, to see the actual articles is the @kbd{g}
10444command, when you have turned on this mode 10436command, when you have turned on this mode
@@ -10614,7 +10606,7 @@ process/prefix convention (@pxref{Process/Prefix}).
10614@table @kbd 10606@table @kbd
10615 10607
10616@item B e 10608@item B e
10617@kindex B e (Summary) 10609@kindex B e @r{(Summary)}
10618@findex gnus-summary-expire-articles 10610@findex gnus-summary-expire-articles
10619@cindex expiring mail 10611@cindex expiring mail
10620Run all expirable articles in the current group through the expiry 10612Run all expirable articles in the current group through the expiry
@@ -10623,7 +10615,7 @@ expirable articles in the group that have been around for a while.
10623(@pxref{Expiring Mail}). 10615(@pxref{Expiring Mail}).
10624 10616
10625@item B C-M-e 10617@item B C-M-e
10626@kindex B C-M-e (Summary) 10618@kindex B C-M-e @r{(Summary)}
10627@findex gnus-summary-expire-articles-now 10619@findex gnus-summary-expire-articles-now
10628@cindex expiring mail 10620@cindex expiring mail
10629Delete all the expirable articles in the group 10621Delete all the expirable articles in the group
@@ -10631,8 +10623,8 @@ Delete all the expirable articles in the group
10631articles eligible for expiry in the current group will 10623articles eligible for expiry in the current group will
10632disappear forever into that big @file{/dev/null} in the sky. 10624disappear forever into that big @file{/dev/null} in the sky.
10633 10625
10634@item B DEL 10626@item B @key{DEL}
10635@kindex B DEL (Summary) 10627@kindex B DEL @r{(Summary)}
10636@cindex deleting mail 10628@cindex deleting mail
10637@findex gnus-summary-delete-article 10629@findex gnus-summary-delete-article
10638@c @icon{gnus-summary-mail-delete} 10630@c @icon{gnus-summary-mail-delete}
@@ -10641,7 +10633,7 @@ disk forever and ever, never to return again.'' Use with caution.
10641(@code{gnus-summary-delete-article}). 10633(@code{gnus-summary-delete-article}).
10642 10634
10643@item B m 10635@item B m
10644@kindex B m (Summary) 10636@kindex B m @r{(Summary)}
10645@cindex move mail 10637@cindex move mail
10646@findex gnus-summary-move-article 10638@findex gnus-summary-move-article
10647@vindex gnus-preserve-marks 10639@vindex gnus-preserve-marks
@@ -10650,7 +10642,7 @@ Move the article from one mail group to another
10650@code{gnus-preserve-marks} is non-@code{nil} (which is the default). 10642@code{gnus-preserve-marks} is non-@code{nil} (which is the default).
10651 10643
10652@item B c 10644@item B c
10653@kindex B c (Summary) 10645@kindex B c @r{(Summary)}
10654@cindex copy mail 10646@cindex copy mail
10655@findex gnus-summary-copy-article 10647@findex gnus-summary-copy-article
10656@c @icon{gnus-summary-mail-copy} 10648@c @icon{gnus-summary-mail-copy}
@@ -10659,7 +10651,7 @@ Copy the article from one group (mail group or not) to a mail group
10659@code{gnus-preserve-marks} is non-@code{nil} (which is the default). 10651@code{gnus-preserve-marks} is non-@code{nil} (which is the default).
10660 10652
10661@item B B 10653@item B B
10662@kindex B B (Summary) 10654@kindex B B @r{(Summary)}
10663@cindex crosspost mail 10655@cindex crosspost mail
10664@findex gnus-summary-crosspost-article 10656@findex gnus-summary-crosspost-article
10665Crosspost the current article to some other group 10657Crosspost the current article to some other group
@@ -10668,21 +10660,21 @@ the article in the other group, and the Xref headers of the article will
10668be properly updated. 10660be properly updated.
10669 10661
10670@item B i 10662@item B i
10671@kindex B i (Summary) 10663@kindex B i @r{(Summary)}
10672@findex gnus-summary-import-article 10664@findex gnus-summary-import-article
10673Import an arbitrary file into the current mail newsgroup 10665Import an arbitrary file into the current mail newsgroup
10674(@code{gnus-summary-import-article}). You will be prompted for a file 10666(@code{gnus-summary-import-article}). You will be prompted for a file
10675name, a @code{From} header and a @code{Subject} header. 10667name, a @code{From} header and a @code{Subject} header.
10676 10668
10677@item B I 10669@item B I
10678@kindex B I (Summary) 10670@kindex B I @r{(Summary)}
10679@findex gnus-summary-create-article 10671@findex gnus-summary-create-article
10680Create an empty article in the current mail newsgroups 10672Create an empty article in the current mail newsgroups
10681(@code{gnus-summary-create-article}). You will be prompted for a 10673(@code{gnus-summary-create-article}). You will be prompted for a
10682@code{From} header and a @code{Subject} header. 10674@code{From} header and a @code{Subject} header.
10683 10675
10684@item B r 10676@item B r
10685@kindex B r (Summary) 10677@kindex B r @r{(Summary)}
10686@findex gnus-summary-respool-article 10678@findex gnus-summary-respool-article
10687@vindex gnus-summary-respool-default-method 10679@vindex gnus-summary-respool-default-method
10688Respool the mail article (@code{gnus-summary-respool-article}). 10680Respool the mail article (@code{gnus-summary-respool-article}).
@@ -10694,10 +10686,10 @@ Marks will be preserved if @code{gnus-preserve-marks} is non-@code{nil}
10694 10686
10695@item B w 10687@item B w
10696@itemx e 10688@itemx e
10697@kindex B w (Summary) 10689@kindex B w @r{(Summary)}
10698@kindex e (Summary) 10690@kindex e @r{(Summary)}
10699@findex gnus-summary-edit-article 10691@findex gnus-summary-edit-article
10700@kindex C-c C-c (Article) 10692@kindex C-c C-c @r{(Article)}
10701@findex gnus-summary-edit-article-done 10693@findex gnus-summary-edit-article-done
10702Edit the current article (@code{gnus-summary-edit-article}). To finish 10694Edit the current article (@code{gnus-summary-edit-article}). To finish
10703editing and make the changes permanent, type @kbd{C-c C-c} 10695editing and make the changes permanent, type @kbd{C-c C-c}
@@ -10705,20 +10697,20 @@ editing and make the changes permanent, type @kbd{C-c C-c}
10705@kbd{C-c C-c} command, Gnus won't re-highlight the article. 10697@kbd{C-c C-c} command, Gnus won't re-highlight the article.
10706 10698
10707@item B q 10699@item B q
10708@kindex B q (Summary) 10700@kindex B q @r{(Summary)}
10709@findex gnus-summary-respool-query 10701@findex gnus-summary-respool-query
10710If you want to re-spool an article, you might be curious as to what group 10702If you want to re-spool an article, you might be curious as to what group
10711the article will end up in before you do the re-spooling. This command 10703the article will end up in before you do the re-spooling. This command
10712will tell you (@code{gnus-summary-respool-query}). 10704will tell you (@code{gnus-summary-respool-query}).
10713 10705
10714@item B t 10706@item B t
10715@kindex B t (Summary) 10707@kindex B t @r{(Summary)}
10716@findex gnus-summary-respool-trace 10708@findex gnus-summary-respool-trace
10717Similarly, this command will display all fancy splitting patterns used 10709Similarly, this command will display all fancy splitting patterns used
10718when respooling, if any (@code{gnus-summary-respool-trace}). 10710when respooling, if any (@code{gnus-summary-respool-trace}).
10719 10711
10720@item B p 10712@item B p
10721@kindex B p (Summary) 10713@kindex B p @r{(Summary)}
10722@findex gnus-summary-article-posted-p 10714@findex gnus-summary-article-posted-p
10723Some people have a tendency to send you ``courtesy'' copies when they 10715Some people have a tendency to send you ``courtesy'' copies when they
10724follow up to articles you have posted. These usually have a 10716follow up to articles you have posted. These usually have a
@@ -10732,7 +10724,7 @@ propagation is much faster than news propagation, and the news copy may
10732just not have arrived yet. 10724just not have arrived yet.
10733 10725
10734@item K E 10726@item K E
10735@kindex K E (Summary) 10727@kindex K E @r{(Summary)}
10736@findex gnus-article-encrypt-body 10728@findex gnus-article-encrypt-body
10737@vindex gnus-article-encrypt-protocol 10729@vindex gnus-article-encrypt-protocol
10738Encrypt the body of an article (@code{gnus-article-encrypt-body}). 10730Encrypt the body of an article (@code{gnus-article-encrypt-body}).
@@ -10867,20 +10859,20 @@ Also @pxref{Group Parameters}.
10867@table @kbd 10859@table @kbd
10868 10860
10869@item H d 10861@item H d
10870@kindex H d (Summary) 10862@kindex H d @r{(Summary)}
10871@findex gnus-summary-describe-group 10863@findex gnus-summary-describe-group
10872Give a brief description of the current group 10864Give a brief description of the current group
10873(@code{gnus-summary-describe-group}). If given a prefix, force 10865(@code{gnus-summary-describe-group}). If given a prefix, force
10874rereading the description from the server. 10866rereading the description from the server.
10875 10867
10876@item H h 10868@item H h
10877@kindex H h (Summary) 10869@kindex H h @r{(Summary)}
10878@findex gnus-summary-describe-briefly 10870@findex gnus-summary-describe-briefly
10879Give an extremely brief description of the most important summary 10871Give an extremely brief description of the most important summary
10880keystrokes (@code{gnus-summary-describe-briefly}). 10872keystrokes (@code{gnus-summary-describe-briefly}).
10881 10873
10882@item H i 10874@item H i
10883@kindex H i (Summary) 10875@kindex H i @r{(Summary)}
10884@findex gnus-info-find-node 10876@findex gnus-info-find-node
10885Go to the Gnus info node (@code{gnus-info-find-node}). 10877Go to the Gnus info node (@code{gnus-info-find-node}).
10886@end table 10878@end table
@@ -10892,31 +10884,31 @@ Go to the Gnus info node (@code{gnus-info-find-node}).
10892@table @kbd 10884@table @kbd
10893 10885
10894@item M-s 10886@item M-s
10895@kindex M-s (Summary) 10887@kindex M-s @r{(Summary)}
10896@findex gnus-summary-search-article-forward 10888@findex gnus-summary-search-article-forward
10897Search through all subsequent (raw) articles for a regexp 10889Search through all subsequent (raw) articles for a regexp
10898(@code{gnus-summary-search-article-forward}). 10890(@code{gnus-summary-search-article-forward}).
10899 10891
10900@item M-r 10892@item M-r
10901@kindex M-r (Summary) 10893@kindex M-r @r{(Summary)}
10902@findex gnus-summary-search-article-backward 10894@findex gnus-summary-search-article-backward
10903Search through all previous (raw) articles for a regexp 10895Search through all previous (raw) articles for a regexp
10904(@code{gnus-summary-search-article-backward}). 10896(@code{gnus-summary-search-article-backward}).
10905 10897
10906@item M-S 10898@item M-S
10907@kindex M-S (Summary) 10899@kindex M-S @r{(Summary)}
10908@findex gnus-summary-repeat-search-article-forward 10900@findex gnus-summary-repeat-search-article-forward
10909Repeat the previous search forwards 10901Repeat the previous search forwards
10910(@code{gnus-summary-repeat-search-article-forward}). 10902(@code{gnus-summary-repeat-search-article-forward}).
10911 10903
10912@item M-R 10904@item M-R
10913@kindex M-R (Summary) 10905@kindex M-R @r{(Summary)}
10914@findex gnus-summary-repeat-search-article-backward 10906@findex gnus-summary-repeat-search-article-backward
10915Repeat the previous search backwards 10907Repeat the previous search backwards
10916(@code{gnus-summary-repeat-search-article-backward}). 10908(@code{gnus-summary-repeat-search-article-backward}).
10917 10909
10918@item & 10910@item &
10919@kindex & (Summary) 10911@kindex & @r{(Summary)}
10920@findex gnus-summary-execute-command 10912@findex gnus-summary-execute-command
10921This command will prompt you for a header, a regular expression to match 10913This command will prompt you for a header, a regular expression to match
10922on this field, and a command to be executed if the match is made 10914on this field, and a command to be executed if the match is made
@@ -10924,11 +10916,12 @@ on this field, and a command to be executed if the match is made
10924string, the match is done on the entire article. If given a prefix, 10916string, the match is done on the entire article. If given a prefix,
10925search backward instead. 10917search backward instead.
10926 10918
10927For instance, @kbd{& RET some.*string RET #} will put the process mark on 10919For instance, @kbd{& @key{RET} some.*string @key{RET} #} will put the
10928all articles that have heads or bodies that match @samp{some.*string}. 10920process mark on all articles that have heads or bodies that match
10921@samp{some.*string}.
10929 10922
10930@item M-& 10923@item M-&
10931@kindex M-& (Summary) 10924@kindex M-& @r{(Summary)}
10932@findex gnus-summary-universal-argument 10925@findex gnus-summary-universal-argument
10933Perform any operation on all articles that have been marked with 10926Perform any operation on all articles that have been marked with
10934the process mark (@code{gnus-summary-universal-argument}). 10927the process mark (@code{gnus-summary-universal-argument}).
@@ -10940,24 +10933,24 @@ the process mark (@code{gnus-summary-universal-argument}).
10940@table @kbd 10933@table @kbd
10941 10934
10942@item Y g 10935@item Y g
10943@kindex Y g (Summary) 10936@kindex Y g @r{(Summary)}
10944@findex gnus-summary-prepare 10937@findex gnus-summary-prepare
10945Regenerate the current summary buffer (@code{gnus-summary-prepare}). 10938Regenerate the current summary buffer (@code{gnus-summary-prepare}).
10946 10939
10947@item Y c 10940@item Y c
10948@kindex Y c (Summary) 10941@kindex Y c @r{(Summary)}
10949@findex gnus-summary-insert-cached-articles 10942@findex gnus-summary-insert-cached-articles
10950Pull all cached articles (for the current group) into the summary buffer 10943Pull all cached articles (for the current group) into the summary buffer
10951(@code{gnus-summary-insert-cached-articles}). 10944(@code{gnus-summary-insert-cached-articles}).
10952 10945
10953@item Y d 10946@item Y d
10954@kindex Y d (Summary) 10947@kindex Y d @r{(Summary)}
10955@findex gnus-summary-insert-dormant-articles 10948@findex gnus-summary-insert-dormant-articles
10956Pull all dormant articles (for the current group) into the summary buffer 10949Pull all dormant articles (for the current group) into the summary buffer
10957(@code{gnus-summary-insert-dormant-articles}). 10950(@code{gnus-summary-insert-dormant-articles}).
10958 10951
10959@item Y t 10952@item Y t
10960@kindex Y t (Summary) 10953@kindex Y t @r{(Summary)}
10961@findex gnus-summary-insert-ticked-articles 10954@findex gnus-summary-insert-ticked-articles
10962Pull all ticked articles (for the current group) into the summary buffer 10955Pull all ticked articles (for the current group) into the summary buffer
10963(@code{gnus-summary-insert-ticked-articles}). 10956(@code{gnus-summary-insert-ticked-articles}).
@@ -10972,8 +10965,8 @@ Pull all ticked articles (for the current group) into the summary buffer
10972 10965
10973@item A D 10966@item A D
10974@itemx C-d 10967@itemx C-d
10975@kindex C-d (Summary) 10968@kindex C-d @r{(Summary)}
10976@kindex A D (Summary) 10969@kindex A D @r{(Summary)}
10977@findex gnus-summary-enter-digest-group 10970@findex gnus-summary-enter-digest-group
10978If the current article is a collection of other articles (for instance, 10971If the current article is a collection of other articles (for instance,
10979a digest), you might use this command to enter a group based on that 10972a digest), you might use this command to enter a group based on that
@@ -11007,7 +11000,7 @@ If it has any other value or there is no next (unread) article, the
11007article selected before entering to the digest group will appear. 11000article selected before entering to the digest group will appear.
11008 11001
11009@item C-M-d 11002@item C-M-d
11010@kindex C-M-d (Summary) 11003@kindex C-M-d @r{(Summary)}
11011@findex gnus-summary-read-document 11004@findex gnus-summary-read-document
11012This command is very similar to the one above, but lets you gather 11005This command is very similar to the one above, but lets you gather
11013several documents into one biiig group 11006several documents into one biiig group
@@ -11018,7 +11011,7 @@ command understands the process/prefix convention
11018(@pxref{Process/Prefix}). 11011(@pxref{Process/Prefix}).
11019 11012
11020@item C-t 11013@item C-t
11021@kindex C-t (Summary) 11014@kindex C-t @r{(Summary)}
11022@findex gnus-summary-toggle-truncation 11015@findex gnus-summary-toggle-truncation
11023Toggle truncation of summary lines 11016Toggle truncation of summary lines
11024(@code{gnus-summary-toggle-truncation}). This will probably confuse the 11017(@code{gnus-summary-toggle-truncation}). This will probably confuse the
@@ -11026,19 +11019,19 @@ line centering function in the summary buffer, so it's not a good idea
11026to have truncation switched off while reading articles. 11019to have truncation switched off while reading articles.
11027 11020
11028@item = 11021@item =
11029@kindex = (Summary) 11022@kindex = @r{(Summary)}
11030@findex gnus-summary-expand-window 11023@findex gnus-summary-expand-window
11031Expand the summary buffer window (@code{gnus-summary-expand-window}). 11024Expand the summary buffer window (@code{gnus-summary-expand-window}).
11032If given a prefix, force an @code{article} window configuration. 11025If given a prefix, force an @code{article} window configuration.
11033 11026
11034@item C-M-e 11027@item C-M-e
11035@kindex C-M-e (Summary) 11028@kindex C-M-e @r{(Summary)}
11036@findex gnus-summary-edit-parameters 11029@findex gnus-summary-edit-parameters
11037Edit the group parameters (@pxref{Group Parameters}) of the current 11030Edit the group parameters (@pxref{Group Parameters}) of the current
11038group (@code{gnus-summary-edit-parameters}). 11031group (@code{gnus-summary-edit-parameters}).
11039 11032
11040@item C-M-a 11033@item C-M-a
11041@kindex C-M-a (Summary) 11034@kindex C-M-a @r{(Summary)}
11042@findex gnus-summary-customize-parameters 11035@findex gnus-summary-customize-parameters
11043Customize the group parameters (@pxref{Group Parameters}) of the current 11036Customize the group parameters (@pxref{Group Parameters}) of the current
11044group (@code{gnus-summary-customize-parameters}). 11037group (@code{gnus-summary-customize-parameters}).
@@ -11059,9 +11052,9 @@ group and return you to the group buffer.
11059@item Z Z 11052@item Z Z
11060@itemx Z Q 11053@itemx Z Q
11061@itemx q 11054@itemx q
11062@kindex Z Z (Summary) 11055@kindex Z Z @r{(Summary)}
11063@kindex Z Q (Summary) 11056@kindex Z Q @r{(Summary)}
11064@kindex q (Summary) 11057@kindex q @r{(Summary)}
11065@findex gnus-summary-exit 11058@findex gnus-summary-exit
11066@vindex gnus-summary-exit-hook 11059@vindex gnus-summary-exit-hook
11067@vindex gnus-summary-prepare-exit-hook 11060@vindex gnus-summary-prepare-exit-hook
@@ -11077,43 +11070,43 @@ group mode having no more (unread) groups.
11077 11070
11078@item Z E 11071@item Z E
11079@itemx Q 11072@itemx Q
11080@kindex Z E (Summary) 11073@kindex Z E @r{(Summary)}
11081@kindex Q (Summary) 11074@kindex Q @r{(Summary)}
11082@findex gnus-summary-exit-no-update 11075@findex gnus-summary-exit-no-update
11083Exit the current group without updating any information on the group 11076Exit the current group without updating any information on the group
11084(@code{gnus-summary-exit-no-update}). 11077(@code{gnus-summary-exit-no-update}).
11085 11078
11086@item Z c 11079@item Z c
11087@itemx c 11080@itemx c
11088@kindex Z c (Summary) 11081@kindex Z c @r{(Summary)}
11089@kindex c (Summary) 11082@kindex c @r{(Summary)}
11090@findex gnus-summary-catchup-and-exit 11083@findex gnus-summary-catchup-and-exit
11091@c @icon{gnus-summary-catchup-and-exit} 11084@c @icon{gnus-summary-catchup-and-exit}
11092Mark all unticked articles in the group as read and then exit 11085Mark all unticked articles in the group as read and then exit
11093(@code{gnus-summary-catchup-and-exit}). 11086(@code{gnus-summary-catchup-and-exit}).
11094 11087
11095@item Z C 11088@item Z C
11096@kindex Z C (Summary) 11089@kindex Z C @r{(Summary)}
11097@findex gnus-summary-catchup-all-and-exit 11090@findex gnus-summary-catchup-all-and-exit
11098Mark all articles, even the ticked ones, as read and then exit 11091Mark all articles, even the ticked ones, as read and then exit
11099(@code{gnus-summary-catchup-all-and-exit}). 11092(@code{gnus-summary-catchup-all-and-exit}).
11100 11093
11101@item Z n 11094@item Z n
11102@kindex Z n (Summary) 11095@kindex Z n @r{(Summary)}
11103@findex gnus-summary-catchup-and-goto-next-group 11096@findex gnus-summary-catchup-and-goto-next-group
11104Mark all articles as read and go to the next group 11097Mark all articles as read and go to the next group
11105(@code{gnus-summary-catchup-and-goto-next-group}). 11098(@code{gnus-summary-catchup-and-goto-next-group}).
11106 11099
11107@item Z p 11100@item Z p
11108@kindex Z p (Summary) 11101@kindex Z p @r{(Summary)}
11109@findex gnus-summary-catchup-and-goto-prev-group 11102@findex gnus-summary-catchup-and-goto-prev-group
11110Mark all articles as read and go to the previous group 11103Mark all articles as read and go to the previous group
11111(@code{gnus-summary-catchup-and-goto-prev-group}). 11104(@code{gnus-summary-catchup-and-goto-prev-group}).
11112 11105
11113@item Z R 11106@item Z R
11114@itemx C-x C-s 11107@itemx C-x C-s
11115@kindex Z R (Summary) 11108@kindex Z R @r{(Summary)}
11116@kindex C-x C-s (Summary) 11109@kindex C-x C-s @r{(Summary)}
11117@findex gnus-summary-reselect-current-group 11110@findex gnus-summary-reselect-current-group
11118Exit this group, and then enter it again 11111Exit this group, and then enter it again
11119(@code{gnus-summary-reselect-current-group}). If given a prefix, select 11112(@code{gnus-summary-reselect-current-group}). If given a prefix, select
@@ -11121,8 +11114,8 @@ all articles, both read and unread.
11121 11114
11122@item Z G 11115@item Z G
11123@itemx M-g 11116@itemx M-g
11124@kindex Z G (Summary) 11117@kindex Z G @r{(Summary)}
11125@kindex M-g (Summary) 11118@kindex M-g @r{(Summary)}
11126@findex gnus-summary-rescan-group 11119@findex gnus-summary-rescan-group
11127@c @icon{gnus-summary-mail-get} 11120@c @icon{gnus-summary-mail-get}
11128Exit the group, check for new articles in the group, and select the 11121Exit the group, check for new articles in the group, and select the
@@ -11130,19 +11123,19 @@ group (@code{gnus-summary-rescan-group}). If given a prefix, select all
11130articles, both read and unread. 11123articles, both read and unread.
11131 11124
11132@item Z N 11125@item Z N
11133@kindex Z N (Summary) 11126@kindex Z N @r{(Summary)}
11134@findex gnus-summary-next-group 11127@findex gnus-summary-next-group
11135Exit the group and go to the next group 11128Exit the group and go to the next group
11136(@code{gnus-summary-next-group}). 11129(@code{gnus-summary-next-group}).
11137 11130
11138@item Z P 11131@item Z P
11139@kindex Z P (Summary) 11132@kindex Z P @r{(Summary)}
11140@findex gnus-summary-prev-group 11133@findex gnus-summary-prev-group
11141Exit the group and go to the previous group 11134Exit the group and go to the previous group
11142(@code{gnus-summary-prev-group}). 11135(@code{gnus-summary-prev-group}).
11143 11136
11144@item Z s 11137@item Z s
11145@kindex Z s (Summary) 11138@kindex Z s @r{(Summary)}
11146@findex gnus-summary-save-newsrc 11139@findex gnus-summary-save-newsrc
11147Save the current number of read/marked articles in the dribble buffer 11140Save the current number of read/marked articles in the dribble buffer
11148and then save the dribble buffer (@code{gnus-summary-save-newsrc}). If 11141and then save the dribble buffer (@code{gnus-summary-save-newsrc}). If
@@ -11413,7 +11406,7 @@ encrypted messages up can be found in the message manual
11413@cindex mailing list 11406@cindex mailing list
11414@cindex RFC 2396 11407@cindex RFC 2396
11415 11408
11416@kindex A M (summary) 11409@kindex A M @r{(Summary)}
11417@findex gnus-mailing-list-insinuate 11410@findex gnus-mailing-list-insinuate
11418Gnus understands some mailing list fields of RFC 2369. To enable it, 11411Gnus understands some mailing list fields of RFC 2369. To enable it,
11419add a @code{to-list} group parameter (@pxref{Group Parameters}), 11412add a @code{to-list} group parameter (@pxref{Group Parameters}),
@@ -11425,33 +11418,33 @@ That enables the following commands to the summary buffer:
11425@table @kbd 11418@table @kbd
11426 11419
11427@item C-c C-n h 11420@item C-c C-n h
11428@kindex C-c C-n h (Summary) 11421@kindex C-c C-n h @r{(Summary)}
11429@findex gnus-mailing-list-help 11422@findex gnus-mailing-list-help
11430Send a message to fetch mailing list help, if List-Help field exists. 11423Send a message to fetch mailing list help, if List-Help field exists.
11431 11424
11432@item C-c C-n s 11425@item C-c C-n s
11433@kindex C-c C-n s (Summary) 11426@kindex C-c C-n s @r{(Summary)}
11434@findex gnus-mailing-list-subscribe 11427@findex gnus-mailing-list-subscribe
11435Send a message to subscribe the mailing list, if List-Subscribe field exists. 11428Send a message to subscribe the mailing list, if List-Subscribe field exists.
11436 11429
11437@item C-c C-n u 11430@item C-c C-n u
11438@kindex C-c C-n u (Summary) 11431@kindex C-c C-n u @r{(Summary)}
11439@findex gnus-mailing-list-unsubscribe 11432@findex gnus-mailing-list-unsubscribe
11440Send a message to unsubscribe the mailing list, if List-Unsubscribe 11433Send a message to unsubscribe the mailing list, if List-Unsubscribe
11441field exists. 11434field exists.
11442 11435
11443@item C-c C-n p 11436@item C-c C-n p
11444@kindex C-c C-n p (Summary) 11437@kindex C-c C-n p @r{(Summary)}
11445@findex gnus-mailing-list-post 11438@findex gnus-mailing-list-post
11446Post to the mailing list, if List-Post field exists. 11439Post to the mailing list, if List-Post field exists.
11447 11440
11448@item C-c C-n o 11441@item C-c C-n o
11449@kindex C-c C-n o (Summary) 11442@kindex C-c C-n o @r{(Summary)}
11450@findex gnus-mailing-list-owner 11443@findex gnus-mailing-list-owner
11451Send a message to the mailing list owner, if List-Owner field exists. 11444Send a message to the mailing list owner, if List-Owner field exists.
11452 11445
11453@item C-c C-n a 11446@item C-c C-n a
11454@kindex C-c C-n a (Summary) 11447@kindex C-c C-n a @r{(Summary)}
11455@findex gnus-mailing-list-archive 11448@findex gnus-mailing-list-archive
11456Browse the mailing list archive, if List-Archive field exists. 11449Browse the mailing list archive, if List-Archive field exists.
11457 11450
@@ -11629,9 +11622,9 @@ The following commands are available when you have placed point over a
11629 11622
11630@table @kbd 11623@table @kbd
11631@findex gnus-article-press-button 11624@findex gnus-article-press-button
11632@item RET (Article) 11625@item @key{RET} (Article)
11633@kindex RET (Article) 11626@kindex RET @r{(Article)}
11634@itemx BUTTON-2 (Article) 11627@itemx @key{BUTTON-2} (Article)
11635Toggle displaying of the @acronym{MIME} object 11628Toggle displaying of the @acronym{MIME} object
11636(@code{gnus-article-press-button}). If built-in viewers can not display 11629(@code{gnus-article-press-button}). If built-in viewers can not display
11637the object, Gnus resorts to external viewers in the @file{mailcap} 11630the object, Gnus resorts to external viewers in the @file{mailcap}
@@ -11639,33 +11632,33 @@ files. If a viewer has the @samp{copiousoutput} specification, the
11639object is displayed inline. 11632object is displayed inline.
11640 11633
11641@findex gnus-mime-view-part 11634@findex gnus-mime-view-part
11642@item M-RET (Article) 11635@item M-@key{RET} (Article)
11643@kindex M-RET (Article) 11636@kindex M-RET @r{(Article)}
11644@itemx v (Article) 11637@itemx v (Article)
11645Prompt for a method, and then view the @acronym{MIME} object using this 11638Prompt for a method, and then view the @acronym{MIME} object using this
11646method (@code{gnus-mime-view-part}). 11639method (@code{gnus-mime-view-part}).
11647 11640
11648@findex gnus-mime-view-part-as-type 11641@findex gnus-mime-view-part-as-type
11649@item t (Article) 11642@item t (Article)
11650@kindex t (Article) 11643@kindex t @r{(Article)}
11651View the @acronym{MIME} object as if it were a different @acronym{MIME} media type 11644View the @acronym{MIME} object as if it were a different @acronym{MIME} media type
11652(@code{gnus-mime-view-part-as-type}). 11645(@code{gnus-mime-view-part-as-type}).
11653 11646
11654@findex gnus-mime-view-part-as-charset 11647@findex gnus-mime-view-part-as-charset
11655@item C (Article) 11648@item C (Article)
11656@kindex C (Article) 11649@kindex C @r{(Article)}
11657Prompt for a charset, and then view the @acronym{MIME} object using this 11650Prompt for a charset, and then view the @acronym{MIME} object using this
11658charset (@code{gnus-mime-view-part-as-charset}). 11651charset (@code{gnus-mime-view-part-as-charset}).
11659 11652
11660@findex gnus-mime-save-part 11653@findex gnus-mime-save-part
11661@item o (Article) 11654@item o (Article)
11662@kindex o (Article) 11655@kindex o @r{(Article)}
11663Prompt for a file name, and then save the @acronym{MIME} object 11656Prompt for a file name, and then save the @acronym{MIME} object
11664(@code{gnus-mime-save-part}). 11657(@code{gnus-mime-save-part}).
11665 11658
11666@findex gnus-mime-save-part-and-strip 11659@findex gnus-mime-save-part-and-strip
11667@item C-o (Article) 11660@item C-o (Article)
11668@kindex C-o (Article) 11661@kindex C-o @r{(Article)}
11669Prompt for a file name, then save the @acronym{MIME} object and strip it from 11662Prompt for a file name, then save the @acronym{MIME} object and strip it from
11670the article. Then proceed to article editing, where a reasonable 11663the article. Then proceed to article editing, where a reasonable
11671suggestion is being made on how the altered article should look 11664suggestion is being made on how the altered article should look
@@ -11675,14 +11668,14 @@ message/external-body @acronym{MIME} type.
11675 11668
11676@findex gnus-mime-replace-part 11669@findex gnus-mime-replace-part
11677@item r (Article) 11670@item r (Article)
11678@kindex r (Article) 11671@kindex r @r{(Article)}
11679Prompt for a file name, replace the @acronym{MIME} object with an 11672Prompt for a file name, replace the @acronym{MIME} object with an
11680external body referring to the file via the message/external-body 11673external body referring to the file via the message/external-body
11681@acronym{MIME} type. (@code{gnus-mime-replace-part}). 11674@acronym{MIME} type. (@code{gnus-mime-replace-part}).
11682 11675
11683@findex gnus-mime-delete-part 11676@findex gnus-mime-delete-part
11684@item d (Article) 11677@item d (Article)
11685@kindex d (Article) 11678@kindex d @r{(Article)}
11686Delete the @acronym{MIME} object from the article and replace it with some 11679Delete the @acronym{MIME} object from the article and replace it with some
11687information about the removed @acronym{MIME} object 11680information about the removed @acronym{MIME} object
11688(@code{gnus-mime-delete-part}). 11681(@code{gnus-mime-delete-part}).
@@ -11691,7 +11684,7 @@ information about the removed @acronym{MIME} object
11691 11684
11692@findex gnus-mime-copy-part 11685@findex gnus-mime-copy-part
11693@item c (Article) 11686@item c (Article)
11694@kindex c (Article) 11687@kindex c @r{(Article)}
11695Copy the @acronym{MIME} object to a fresh buffer and display this buffer 11688Copy the @acronym{MIME} object to a fresh buffer and display this buffer
11696(@code{gnus-mime-copy-part}). If given a prefix, copy the raw contents 11689(@code{gnus-mime-copy-part}). If given a prefix, copy the raw contents
11697without decoding. If given a numerical prefix, you can do semi-manual 11690without decoding. If given a numerical prefix, you can do semi-manual
@@ -11703,14 +11696,14 @@ Accessing Compressed Files, emacs, The Emacs Editor}).
11703 11696
11704@findex gnus-mime-print-part 11697@findex gnus-mime-print-part
11705@item p (Article) 11698@item p (Article)
11706@kindex p (Article) 11699@kindex p @r{(Article)}
11707Print the @acronym{MIME} object (@code{gnus-mime-print-part}). This 11700Print the @acronym{MIME} object (@code{gnus-mime-print-part}). This
11708command respects the @samp{print=} specifications in the 11701command respects the @samp{print=} specifications in the
11709@file{.mailcap} file. 11702@file{.mailcap} file.
11710 11703
11711@findex gnus-mime-inline-part 11704@findex gnus-mime-inline-part
11712@item i (Article) 11705@item i (Article)
11713@kindex i (Article) 11706@kindex i @r{(Article)}
11714Insert the contents of the @acronym{MIME} object into the buffer 11707Insert the contents of the @acronym{MIME} object into the buffer
11715(@code{gnus-mime-inline-part}) as @samp{text/plain}. If given a prefix, insert 11708(@code{gnus-mime-inline-part}) as @samp{text/plain}. If given a prefix, insert
11716the raw contents without decoding. If given a numerical prefix, you can 11709the raw contents without decoding. If given a numerical prefix, you can
@@ -11723,25 +11716,25 @@ Compressed Files, emacs, The Emacs Editor}).
11723 11716
11724@findex gnus-mime-view-part-internally 11717@findex gnus-mime-view-part-internally
11725@item E (Article) 11718@item E (Article)
11726@kindex E (Article) 11719@kindex E @r{(Article)}
11727View the @acronym{MIME} object with an internal viewer. If no internal 11720View the @acronym{MIME} object with an internal viewer. If no internal
11728viewer is available, use an external viewer 11721viewer is available, use an external viewer
11729(@code{gnus-mime-view-part-internally}). 11722(@code{gnus-mime-view-part-internally}).
11730 11723
11731@findex gnus-mime-view-part-externally 11724@findex gnus-mime-view-part-externally
11732@item e (Article) 11725@item e (Article)
11733@kindex e (Article) 11726@kindex e @r{(Article)}
11734View the @acronym{MIME} object with an external viewer. 11727View the @acronym{MIME} object with an external viewer.
11735(@code{gnus-mime-view-part-externally}). 11728(@code{gnus-mime-view-part-externally}).
11736 11729
11737@findex gnus-mime-pipe-part 11730@findex gnus-mime-pipe-part
11738@item | (Article) 11731@item | (Article)
11739@kindex | (Article) 11732@kindex | @r{(Article)}
11740Output the @acronym{MIME} object to a process (@code{gnus-mime-pipe-part}). 11733Output the @acronym{MIME} object to a process (@code{gnus-mime-pipe-part}).
11741 11734
11742@findex gnus-mime-action-on-part 11735@findex gnus-mime-action-on-part
11743@item . (Article) 11736@item . (Article)
11744@kindex . (Article) 11737@kindex . @r{(Article)}
11745Interactively run an action on the @acronym{MIME} object 11738Interactively run an action on the @acronym{MIME} object
11746(@code{gnus-mime-action-on-part}). 11739(@code{gnus-mime-action-on-part}).
11747 11740
@@ -11925,7 +11918,7 @@ controlling variable is a predicate list, as described above.
11925 11918
11926@ifinfo 11919@ifinfo
11927@c Avoid sort of redundant entries in the same section for the printed 11920@c Avoid sort of redundant entries in the same section for the printed
11928@c manual, but add them in info to allow 'i gnus-treat-foo-bar RET' or 11921@c manual, but add them in info to allow 'i gnus-treat-foo-bar @key{RET}' or
11929@c 'i foo-bar'. 11922@c 'i foo-bar'.
11930@vindex gnus-treat-buttonize 11923@vindex gnus-treat-buttonize
11931@vindex gnus-treat-buttonize-head 11924@vindex gnus-treat-buttonize-head
@@ -12130,7 +12123,7 @@ buffer, which means that you don't actually have to have a summary
12130buffer displayed while reading. You can do it all from the article 12123buffer displayed while reading. You can do it all from the article
12131buffer. 12124buffer.
12132 12125
12133@kindex v (Article) 12126@kindex v @r{(Article)}
12134@cindex keys, reserved for users (Article) 12127@cindex keys, reserved for users (Article)
12135The key @kbd{v} is reserved for users. You can bind it to some 12128The key @kbd{v} is reserved for users. You can bind it to some
12136command or better use it as a prefix key. 12129command or better use it as a prefix key.
@@ -12139,70 +12132,70 @@ A few additional keystrokes are available:
12139 12132
12140@table @kbd 12133@table @kbd
12141 12134
12142@item SPACE 12135@item @key{SPC}
12143@kindex SPACE (Article) 12136@kindex SPC @r{(Article)}
12144@findex gnus-article-next-page 12137@findex gnus-article-next-page
12145Scroll forwards one page (@code{gnus-article-next-page}). 12138Scroll forwards one page (@code{gnus-article-next-page}).
12146This is exactly the same as @kbd{h SPACE h}. 12139This is exactly the same as @kbd{h @key{SPC} h}.
12147 12140
12148@item DEL 12141@item @key{DEL}
12149@kindex DEL (Article) 12142@kindex DEL @r{(Article)}
12150@findex gnus-article-prev-page 12143@findex gnus-article-prev-page
12151Scroll backwards one page (@code{gnus-article-prev-page}). 12144Scroll backwards one page (@code{gnus-article-prev-page}).
12152This is exactly the same as @kbd{h DEL h}. 12145This is exactly the same as @kbd{h @key{DEL} h}.
12153 12146
12154@item C-c ^ 12147@item C-c ^
12155@kindex C-c ^ (Article) 12148@kindex C-c ^ @r{(Article)}
12156@findex gnus-article-refer-article 12149@findex gnus-article-refer-article
12157If point is in the neighborhood of a @code{Message-ID} and you press 12150If point is in the neighborhood of a @code{Message-ID} and you press
12158@kbd{C-c ^}, Gnus will try to get that article from the server 12151@kbd{C-c ^}, Gnus will try to get that article from the server
12159(@code{gnus-article-refer-article}). 12152(@code{gnus-article-refer-article}).
12160 12153
12161@item C-c C-m 12154@item C-c C-m
12162@kindex C-c C-m (Article) 12155@kindex C-c C-m @r{(Article)}
12163@findex gnus-article-mail 12156@findex gnus-article-mail
12164Send a reply to the address near point (@code{gnus-article-mail}). If 12157Send a reply to the address near point (@code{gnus-article-mail}). If
12165given a prefix, include the mail. 12158given a prefix, include the mail.
12166 12159
12167@item s 12160@item s
12168@kindex s (Article) 12161@kindex s @r{(Article)}
12169@findex gnus-article-show-summary 12162@findex gnus-article-show-summary
12170Reconfigure the buffers so that the summary buffer becomes visible 12163Reconfigure the buffers so that the summary buffer becomes visible
12171(@code{gnus-article-show-summary}). 12164(@code{gnus-article-show-summary}).
12172 12165
12173@item ? 12166@item ?
12174@kindex ? (Article) 12167@kindex ? @r{(Article)}
12175@findex gnus-article-describe-briefly 12168@findex gnus-article-describe-briefly
12176Give a very brief description of the available keystrokes 12169Give a very brief description of the available keystrokes
12177(@code{gnus-article-describe-briefly}). 12170(@code{gnus-article-describe-briefly}).
12178 12171
12179@item TAB 12172@item @key{TAB}
12180@kindex TAB (Article) 12173@kindex TAB @r{(Article)}
12181@findex gnus-article-next-button 12174@findex gnus-article-next-button
12182Go to the next button, if any (@code{gnus-article-next-button}). This 12175Go to the next button, if any (@code{gnus-article-next-button}). This
12183only makes sense if you have buttonizing turned on. 12176only makes sense if you have buttonizing turned on.
12184 12177
12185@item M-TAB 12178@item M-@key{TAB}
12186@kindex M-TAB (Article) 12179@kindex M-TAB @r{(Article)}
12187@findex gnus-article-prev-button 12180@findex gnus-article-prev-button
12188Go to the previous button, if any (@code{gnus-article-prev-button}). 12181Go to the previous button, if any (@code{gnus-article-prev-button}).
12189 12182
12190@item R 12183@item R
12191@kindex R (Article) 12184@kindex R @r{(Article)}
12192@findex gnus-article-reply-with-original 12185@findex gnus-article-reply-with-original
12193Send a reply to the current article and yank the current article 12186Send a reply to the current article and yank the current article
12194(@code{gnus-article-reply-with-original}). If the region is active, 12187(@code{gnus-article-reply-with-original}). If the region is active,
12195only yank the text in the region. 12188only yank the text in the region.
12196 12189
12197@item S W 12190@item S W
12198@kindex S W (Article) 12191@kindex S W @r{(Article)}
12199@findex gnus-article-wide-reply-with-original 12192@findex gnus-article-wide-reply-with-original
12200Send a wide reply to the current article and yank the current article 12193Send a wide reply to the current article and yank the current article
12201(@code{gnus-article-wide-reply-with-original}). If the region is 12194(@code{gnus-article-wide-reply-with-original}). If the region is
12202active, only yank the text in the region. 12195active, only yank the text in the region.
12203 12196
12204@item F 12197@item F
12205@kindex F (Article) 12198@kindex F @r{(Article)}
12206@findex gnus-article-followup-with-original 12199@findex gnus-article-followup-with-original
12207Send a followup to the current article and yank the current article 12200Send a followup to the current article and yank the current article
12208(@code{gnus-article-followup-with-original}). If the region is active, 12201(@code{gnus-article-followup-with-original}). If the region is active,
@@ -12225,7 +12218,7 @@ If non-@code{nil}, use the same article buffer for all the groups.
12225article buffer. 12218article buffer.
12226 12219
12227@item gnus-widen-article-window 12220@item gnus-widen-article-window
12228@cindex gnus-widen-article-window 12221@vindex gnus-widen-article-window
12229If non-@code{nil}, selecting the article buffer with the @kbd{h} 12222If non-@code{nil}, selecting the article buffer with the @kbd{h}
12230command will ``widen'' the article window to take the entire frame. 12223command will ``widen'' the article window to take the entire frame.
12231 12224
@@ -12348,7 +12341,7 @@ when @code{mm-text-html-renderer} (@pxref{Display Customization,
12348@cindex using s/mime 12341@cindex using s/mime
12349@cindex using smime 12342@cindex using smime
12350 12343
12351@kindex C-c C-c (Post) 12344@kindex C-c C-c @r{(Post)}
12352All commands for posting and mailing will put you in a message buffer 12345All commands for posting and mailing will put you in a message buffer
12353where you can edit the article all you like, before you send the 12346where you can edit the article all you like, before you send the
12354article by pressing @kbd{C-c C-c}. @xref{Top, , Overview, message, 12347article by pressing @kbd{C-c C-c}. @xref{Top, , Overview, message,
@@ -12946,10 +12939,10 @@ correct parameters. The content of the group is not lost.
12946 12939
12947@c @findex gnus-dissociate-buffer-from-draft 12940@c @findex gnus-dissociate-buffer-from-draft
12948@c @kindex C-c M-d (Mail) 12941@c @kindex C-c M-d (Mail)
12949@c @kindex C-c M-d (Post) 12942@c @kindex C-c M-d @r{(Post)}
12950@c @findex gnus-associate-buffer-with-draft 12943@c @findex gnus-associate-buffer-with-draft
12951@c @kindex C-c C-d (Mail) 12944@c @kindex C-c C-d (Mail)
12952@c @kindex C-c C-d (Post) 12945@c @kindex C-c C-d @r{(Post)}
12953@c If you're writing some super-secret message that you later want to 12946@c If you're writing some super-secret message that you later want to
12954@c encode with PGP before sending, you may wish to turn the auto-saving 12947@c encode with PGP before sending, you may wish to turn the auto-saving
12955@c (and association with the draft group) off. You never know who might be 12948@c (and association with the draft group) off. You never know who might be
@@ -12964,7 +12957,7 @@ correct parameters. The content of the group is not lost.
12964@c @code{gnus-use-draft} to @code{nil}. It is @code{t} by default. 12957@c @code{gnus-use-draft} to @code{nil}. It is @code{t} by default.
12965 12958
12966@findex gnus-draft-edit-message 12959@findex gnus-draft-edit-message
12967@kindex D e (Draft) 12960@kindex D e @r{(Draft)}
12968When you want to continue editing the article, you simply enter the 12961When you want to continue editing the article, you simply enter the
12969draft group and push @kbd{D e} (@code{gnus-draft-edit-message}) to do 12962draft group and push @kbd{D e} (@code{gnus-draft-edit-message}) to do
12970that. You will be placed in a buffer where you left off. 12963that. You will be placed in a buffer where you left off.
@@ -12973,9 +12966,9 @@ Rejected articles will also be put in this draft group (@pxref{Rejected
12973Articles}). 12966Articles}).
12974 12967
12975@findex gnus-draft-send-all-messages 12968@findex gnus-draft-send-all-messages
12976@kindex D s (Draft) 12969@kindex D s @r{(Draft)}
12977@findex gnus-draft-send-message 12970@findex gnus-draft-send-message
12978@kindex D S (Draft) 12971@kindex D S @r{(Draft)}
12979If you have lots of rejected messages you want to post (or mail) without 12972If you have lots of rejected messages you want to post (or mail) without
12980doing further editing, you can use the @kbd{D s} command 12973doing further editing, you can use the @kbd{D s} command
12981(@code{gnus-draft-send-message}). This command understands the 12974(@code{gnus-draft-send-message}). This command understands the
@@ -12984,12 +12977,12 @@ command (@code{gnus-draft-send-all-messages}) will ship off all messages
12984in the buffer. 12977in the buffer.
12985 12978
12986@findex gnus-draft-toggle-sending 12979@findex gnus-draft-toggle-sending
12987@kindex D t (Draft) 12980@kindex D t @r{(Draft)}
12988If you have some messages that you wish not to send, you can use the 12981If you have some messages that you wish not to send, you can use the
12989@kbd{D t} (@code{gnus-draft-toggle-sending}) command to mark the message 12982@kbd{D t} (@code{gnus-draft-toggle-sending}) command to mark the message
12990as unsendable. This is a toggling command. 12983as unsendable. This is a toggling command.
12991 12984
12992Finally, if you want to delete a draft, use the normal @kbd{B DEL} 12985Finally, if you want to delete a draft, use the normal @kbd{B @key{DEL}}
12993command (@pxref{Mail Group Commands}). 12986command (@pxref{Mail Group Commands}).
12994 12987
12995 12988
@@ -13041,43 +13034,43 @@ signing and the @kbd{C-c C-m c} key map for encryption, as follows.
13041@table @kbd 13034@table @kbd
13042 13035
13043@item C-c C-m s s 13036@item C-c C-m s s
13044@kindex C-c C-m s s (Message) 13037@kindex C-c C-m s s @r{(Message)}
13045@findex mml-secure-message-sign-smime 13038@findex mml-secure-message-sign-smime
13046 13039
13047Digitally sign current message using @acronym{S/MIME}. 13040Digitally sign current message using @acronym{S/MIME}.
13048 13041
13049@item C-c C-m s o 13042@item C-c C-m s o
13050@kindex C-c C-m s o (Message) 13043@kindex C-c C-m s o @r{(Message)}
13051@findex mml-secure-message-sign-pgp 13044@findex mml-secure-message-sign-pgp
13052 13045
13053Digitally sign current message using @acronym{PGP}. 13046Digitally sign current message using @acronym{PGP}.
13054 13047
13055@item C-c C-m s p 13048@item C-c C-m s p
13056@kindex C-c C-m s p (Message) 13049@kindex C-c C-m s p @r{(Message)}
13057@findex mml-secure-message-sign-pgp 13050@findex mml-secure-message-sign-pgp
13058 13051
13059Digitally sign current message using @acronym{PGP/MIME}. 13052Digitally sign current message using @acronym{PGP/MIME}.
13060 13053
13061@item C-c C-m c s 13054@item C-c C-m c s
13062@kindex C-c C-m c s (Message) 13055@kindex C-c C-m c s @r{(Message)}
13063@findex mml-secure-message-encrypt-smime 13056@findex mml-secure-message-encrypt-smime
13064 13057
13065Digitally encrypt current message using @acronym{S/MIME}. 13058Digitally encrypt current message using @acronym{S/MIME}.
13066 13059
13067@item C-c C-m c o 13060@item C-c C-m c o
13068@kindex C-c C-m c o (Message) 13061@kindex C-c C-m c o @r{(Message)}
13069@findex mml-secure-message-encrypt-pgp 13062@findex mml-secure-message-encrypt-pgp
13070 13063
13071Digitally encrypt current message using @acronym{PGP}. 13064Digitally encrypt current message using @acronym{PGP}.
13072 13065
13073@item C-c C-m c p 13066@item C-c C-m c p
13074@kindex C-c C-m c p (Message) 13067@kindex C-c C-m c p @r{(Message)}
13075@findex mml-secure-message-encrypt-pgpmime 13068@findex mml-secure-message-encrypt-pgpmime
13076 13069
13077Digitally encrypt current message using @acronym{PGP/MIME}. 13070Digitally encrypt current message using @acronym{PGP/MIME}.
13078 13071
13079@item C-c C-m C-n 13072@item C-c C-m C-n
13080@kindex C-c C-m C-n (Message) 13073@kindex C-c C-m C-n @r{(Message)}
13081@findex mml-unsecure-message 13074@findex mml-unsecure-message
13082Remove security related @acronym{MML} tags from message. 13075Remove security related @acronym{MML} tags from message.
13083 13076
@@ -13224,72 +13217,72 @@ in your init files.
13224@table @kbd 13217@table @kbd
13225 13218
13226@item v 13219@item v
13227@kindex v (Server) 13220@kindex v @r{(Server)}
13228@cindex keys, reserved for users (Server) 13221@cindex keys, reserved for users (Server)
13229The key @kbd{v} is reserved for users. You can bind it to some 13222The key @kbd{v} is reserved for users. You can bind it to some
13230command or better use it as a prefix key. 13223command or better use it as a prefix key.
13231 13224
13232@item a 13225@item a
13233@kindex a (Server) 13226@kindex a @r{(Server)}
13234@findex gnus-server-add-server 13227@findex gnus-server-add-server
13235Add a new server (@code{gnus-server-add-server}). 13228Add a new server (@code{gnus-server-add-server}).
13236 13229
13237@item e 13230@item e
13238@kindex e (Server) 13231@kindex e @r{(Server)}
13239@findex gnus-server-edit-server 13232@findex gnus-server-edit-server
13240Edit a server (@code{gnus-server-edit-server}). 13233Edit a server (@code{gnus-server-edit-server}).
13241 13234
13242@item S 13235@item S
13243@kindex S (Server) 13236@kindex S @r{(Server)}
13244@findex gnus-server-show-server 13237@findex gnus-server-show-server
13245Show the definition of a server (@code{gnus-server-show-server}). 13238Show the definition of a server (@code{gnus-server-show-server}).
13246 13239
13247@item SPACE 13240@item @key{SPC}
13248@kindex SPACE (Server) 13241@kindex SPC @r{(Server)}
13249@findex gnus-server-read-server 13242@findex gnus-server-read-server
13250Browse the current server (@code{gnus-server-read-server}). 13243Browse the current server (@code{gnus-server-read-server}).
13251 13244
13252@item q 13245@item q
13253@kindex q (Server) 13246@kindex q @r{(Server)}
13254@findex gnus-server-exit 13247@findex gnus-server-exit
13255Return to the group buffer (@code{gnus-server-exit}). 13248Return to the group buffer (@code{gnus-server-exit}).
13256 13249
13257@item k 13250@item k
13258@kindex k (Server) 13251@kindex k @r{(Server)}
13259@findex gnus-server-kill-server 13252@findex gnus-server-kill-server
13260Kill the current server (@code{gnus-server-kill-server}). 13253Kill the current server (@code{gnus-server-kill-server}).
13261 13254
13262@item y 13255@item y
13263@kindex y (Server) 13256@kindex y @r{(Server)}
13264@findex gnus-server-yank-server 13257@findex gnus-server-yank-server
13265Yank the previously killed server (@code{gnus-server-yank-server}). 13258Yank the previously killed server (@code{gnus-server-yank-server}).
13266 13259
13267@item c 13260@item c
13268@kindex c (Server) 13261@kindex c @r{(Server)}
13269@findex gnus-server-copy-server 13262@findex gnus-server-copy-server
13270Copy the current server (@code{gnus-server-copy-server}). 13263Copy the current server (@code{gnus-server-copy-server}).
13271 13264
13272@item l 13265@item l
13273@kindex l (Server) 13266@kindex l @r{(Server)}
13274@findex gnus-server-list-servers 13267@findex gnus-server-list-servers
13275List all servers (@code{gnus-server-list-servers}). 13268List all servers (@code{gnus-server-list-servers}).
13276 13269
13277@item s 13270@item s
13278@kindex s (Server) 13271@kindex s @r{(Server)}
13279@findex gnus-server-scan-server 13272@findex gnus-server-scan-server
13280Request that the server scan its sources for new articles 13273Request that the server scan its sources for new articles
13281(@code{gnus-server-scan-server}). This is mainly sensible with mail 13274(@code{gnus-server-scan-server}). This is mainly sensible with mail
13282servers. 13275servers.
13283 13276
13284@item g 13277@item g
13285@kindex g (Server) 13278@kindex g @r{(Server)}
13286@findex gnus-server-regenerate-server 13279@findex gnus-server-regenerate-server
13287Request that the server regenerate all its data structures 13280Request that the server regenerate all its data structures
13288(@code{gnus-server-regenerate-server}). This can be useful if you have 13281(@code{gnus-server-regenerate-server}). This can be useful if you have
13289a mail back end that has gotten out of sync. 13282a mail back end that has gotten out of sync.
13290 13283
13291@item z 13284@item z
13292@kindex z (Server) 13285@kindex z @r{(Server)}
13293@findex gnus-server-compact-server 13286@findex gnus-server-compact-server
13294 13287
13295Compact all groups in the server under point 13288Compact all groups in the server under point
@@ -13421,7 +13414,7 @@ First you need to add a new server. The @kbd{a} command does that. It
13421would probably be best to use @code{nnml} to read the cache. You 13414would probably be best to use @code{nnml} to read the cache. You
13422could also use @code{nnspool} or @code{nnmh}, though. 13415could also use @code{nnspool} or @code{nnmh}, though.
13423 13416
13424Type @kbd{a nnml RET cache RET}. 13417Type @kbd{a nnml @key{RET} cache @key{RET}}.
13425 13418
13426You should now have a brand new @code{nnml} virtual server called 13419You should now have a brand new @code{nnml} virtual server called
13427@samp{cache}. You now need to edit it to have the right definitions. 13420@samp{cache}. You now need to edit it to have the right definitions.
@@ -13441,7 +13434,7 @@ Change that to:
13441@end lisp 13434@end lisp
13442 13435
13443Type @kbd{C-c C-c} to return to the server buffer. If you now press 13436Type @kbd{C-c C-c} to return to the server buffer. If you now press
13444@kbd{RET} over this virtual server, you should be entered into a browse 13437@kbd{@key{RET}} over this virtual server, you should be entered into a browse
13445buffer, and you should be able to enter any of the groups displayed. 13438buffer, and you should be able to enter any of the groups displayed.
13446 13439
13447 13440
@@ -13512,44 +13505,44 @@ with the following commands:
13512@table @kbd 13505@table @kbd
13513 13506
13514@item O 13507@item O
13515@kindex O (Server) 13508@kindex O @r{(Server)}
13516@findex gnus-server-open-server 13509@findex gnus-server-open-server
13517Try to establish connection to the server on the current line 13510Try to establish connection to the server on the current line
13518(@code{gnus-server-open-server}). 13511(@code{gnus-server-open-server}).
13519 13512
13520@item C 13513@item C
13521@kindex C (Server) 13514@kindex C @r{(Server)}
13522@findex gnus-server-close-server 13515@findex gnus-server-close-server
13523Close the connection (if any) to the server 13516Close the connection (if any) to the server
13524(@code{gnus-server-close-server}). 13517(@code{gnus-server-close-server}).
13525 13518
13526@item D 13519@item D
13527@kindex D (Server) 13520@kindex D @r{(Server)}
13528@findex gnus-server-deny-server 13521@findex gnus-server-deny-server
13529Mark the current server as unreachable 13522Mark the current server as unreachable
13530(@code{gnus-server-deny-server}). This will effectively disable the 13523(@code{gnus-server-deny-server}). This will effectively disable the
13531server. 13524server.
13532 13525
13533@item M-o 13526@item M-o
13534@kindex M-o (Server) 13527@kindex M-o @r{(Server)}
13535@findex gnus-server-open-all-servers 13528@findex gnus-server-open-all-servers
13536Open the connections to all servers in the buffer 13529Open the connections to all servers in the buffer
13537(@code{gnus-server-open-all-servers}). 13530(@code{gnus-server-open-all-servers}).
13538 13531
13539@item M-c 13532@item M-c
13540@kindex M-c (Server) 13533@kindex M-c @r{(Server)}
13541@findex gnus-server-close-all-servers 13534@findex gnus-server-close-all-servers
13542Close the connections to all servers in the buffer 13535Close the connections to all servers in the buffer
13543(@code{gnus-server-close-all-servers}). 13536(@code{gnus-server-close-all-servers}).
13544 13537
13545@item R 13538@item R
13546@kindex R (Server) 13539@kindex R @r{(Server)}
13547@findex gnus-server-remove-denials 13540@findex gnus-server-remove-denials
13548Remove all marks to whether Gnus was denied connection from any servers 13541Remove all marks to whether Gnus was denied connection from any servers
13549(@code{gnus-server-remove-denials}). 13542(@code{gnus-server-remove-denials}).
13550 13543
13551@item c 13544@item c
13552@kindex c (Server) 13545@kindex c @r{(Server)}
13553@findex gnus-server-copy-server 13546@findex gnus-server-copy-server
13554Copy a server and give it a new name 13547Copy a server and give it a new name
13555(@code{gnus-server-copy-server}). This can be useful if you have a 13548(@code{gnus-server-copy-server}). This can be useful if you have a
@@ -13557,7 +13550,7 @@ complex method definition, and want to use the same definition towards
13557a different (physical) server. 13550a different (physical) server.
13558 13551
13559@item L 13552@item L
13560@kindex L (Server) 13553@kindex L @r{(Server)}
13561@findex gnus-server-offline-server 13554@findex gnus-server-offline-server
13562Set server status to offline (@code{gnus-server-offline-server}). 13555Set server status to offline (@code{gnus-server-offline-server}).
13563 13556
@@ -14565,7 +14558,7 @@ see @ref{Fancy Mail Splitting}.
14565Note that the mail back ends are free to maul the poor, innocent, 14558Note that the mail back ends are free to maul the poor, innocent,
14566incoming headers all they want to. They all add @code{Lines} headers; 14559incoming headers all they want to. They all add @code{Lines} headers;
14567some add @code{X-Gnus-Group} headers; most rename the Unix mbox 14560some add @code{X-Gnus-Group} headers; most rename the Unix mbox
14568@code{From<SPACE>} line to something else. 14561@code{From@key{SPC}} line to something else.
14569 14562
14570@vindex nnmail-crosspost 14563@vindex nnmail-crosspost
14571The mail back ends all support cross-posting. If several regexps match, 14564The mail back ends all support cross-posting. If several regexps match,
@@ -14582,7 +14575,6 @@ links. If that's the case for you, set
14582@code{nnmail-crosspost-link-function} to @code{copy-file}. (This 14575@code{nnmail-crosspost-link-function} to @code{copy-file}. (This
14583variable is @code{add-name-to-file} by default.) 14576variable is @code{add-name-to-file} by default.)
14584 14577
14585@kindex M-x nnmail-split-history
14586@findex nnmail-split-history 14578@findex nnmail-split-history
14587If you wish to see where the previous mail split put the messages, you 14579If you wish to see where the previous mail split put the messages, you
14588can use the @kbd{M-x nnmail-split-history} command. If you wish to see 14580can use the @kbd{M-x nnmail-split-history} command. If you wish to see
@@ -15721,7 +15713,7 @@ Type @kbd{G f} and give the file name to the mbox file when prompted to create a
15721@code{nndoc} group from the mbox file (@pxref{Foreign Groups}). 15713@code{nndoc} group from the mbox file (@pxref{Foreign Groups}).
15722 15714
15723@item 15715@item
15724Type @kbd{SPACE} to enter the newly created group. 15716Type @kbd{@key{SPC}} to enter the newly created group.
15725 15717
15726@item 15718@item
15727Type @kbd{M P b} to process-mark all articles in this group's buffer 15719Type @kbd{M P b} to process-mark all articles in this group's buffer
@@ -16036,7 +16028,7 @@ This can also be done non-destructively with
16036 16028
16037@item nnmail-remove-tabs 16029@item nnmail-remove-tabs
16038@findex nnmail-remove-tabs 16030@findex nnmail-remove-tabs
16039Translate all @samp{TAB} characters into @samp{SPACE} characters. 16031Translate all @samp{@key{TAB}} characters into @samp{@key{SPC}} characters.
16040 16032
16041@item nnmail-ignore-broken-references 16033@item nnmail-ignore-broken-references
16042@findex nnmail-ignore-broken-references 16034@findex nnmail-ignore-broken-references
@@ -16713,7 +16705,6 @@ The directory where the @acronym{NOV} files should be stored. If
16713 16705
16714 16706
16715@findex nnfolder-generate-active-file 16707@findex nnfolder-generate-active-file
16716@kindex M-x nnfolder-generate-active-file
16717If you have lots of @code{nnfolder}-like files you'd like to read with 16708If you have lots of @code{nnfolder}-like files you'd like to read with
16718@code{nnfolder}, you can use the @kbd{M-x nnfolder-generate-active-file} 16709@code{nnfolder}, you can use the @kbd{M-x nnfolder-generate-active-file}
16719command to make @code{nnfolder} aware of all likely files in 16710command to make @code{nnfolder} aware of all likely files in
@@ -17062,14 +17053,14 @@ system because @acronym{RSS} uses UTF-8 for encoding non-@acronym{ASCII}
17062text by default. It is also used by default for non-@acronym{ASCII} 17053text by default. It is also used by default for non-@acronym{ASCII}
17063group names. 17054group names.
17064 17055
17065@kindex G R (Group) 17056@kindex G R @r{(Group)}
17066Use @kbd{G R} from the group buffer to subscribe to a feed---you will be 17057Use @kbd{G R} from the group buffer to subscribe to a feed---you will be
17067prompted for the location, the title and the description of the feed. 17058prompted for the location, the title and the description of the feed.
17068The title, which allows any characters, will be used for the group name 17059The title, which allows any characters, will be used for the group name
17069and the name of the group data file. The description can be omitted. 17060and the name of the group data file. The description can be omitted.
17070 17061
17071An easy way to get started with @code{nnrss} is to say something like 17062An easy way to get started with @code{nnrss} is to say something like
17072the following in the group buffer: @kbd{B nnrss RET RET y}, then 17063the following in the group buffer: @kbd{B nnrss @key{RET} @key{RET} y}, then
17073subscribe to groups. 17064subscribe to groups.
17074 17065
17075The @code{nnrss} back end saves the group data file in 17066The @code{nnrss} back end saves the group data file in
@@ -18670,51 +18661,51 @@ The following commands are available in this buffer:
18670 18661
18671@table @kbd 18662@table @kbd
18672@item q 18663@item q
18673@kindex q (Category) 18664@kindex q @r{(Category)}
18674@findex gnus-category-exit 18665@findex gnus-category-exit
18675Return to the group buffer (@code{gnus-category-exit}). 18666Return to the group buffer (@code{gnus-category-exit}).
18676 18667
18677@item e 18668@item e
18678@kindex e (Category) 18669@kindex e @r{(Category)}
18679@findex gnus-category-customize-category 18670@findex gnus-category-customize-category
18680Use a customization buffer to set all of the selected category's 18671Use a customization buffer to set all of the selected category's
18681parameters at one time (@code{gnus-category-customize-category}). 18672parameters at one time (@code{gnus-category-customize-category}).
18682 18673
18683@item k 18674@item k
18684@kindex k (Category) 18675@kindex k @r{(Category)}
18685@findex gnus-category-kill 18676@findex gnus-category-kill
18686Kill the current category (@code{gnus-category-kill}). 18677Kill the current category (@code{gnus-category-kill}).
18687 18678
18688@item c 18679@item c
18689@kindex c (Category) 18680@kindex c @r{(Category)}
18690@findex gnus-category-copy 18681@findex gnus-category-copy
18691Copy the current category (@code{gnus-category-copy}). 18682Copy the current category (@code{gnus-category-copy}).
18692 18683
18693@item a 18684@item a
18694@kindex a (Category) 18685@kindex a @r{(Category)}
18695@findex gnus-category-add 18686@findex gnus-category-add
18696Add a new category (@code{gnus-category-add}). 18687Add a new category (@code{gnus-category-add}).
18697 18688
18698@item p 18689@item p
18699@kindex p (Category) 18690@kindex p @r{(Category)}
18700@findex gnus-category-edit-predicate 18691@findex gnus-category-edit-predicate
18701Edit the predicate of the current category 18692Edit the predicate of the current category
18702(@code{gnus-category-edit-predicate}). 18693(@code{gnus-category-edit-predicate}).
18703 18694
18704@item g 18695@item g
18705@kindex g (Category) 18696@kindex g @r{(Category)}
18706@findex gnus-category-edit-groups 18697@findex gnus-category-edit-groups
18707Edit the list of groups belonging to the current category 18698Edit the list of groups belonging to the current category
18708(@code{gnus-category-edit-groups}). 18699(@code{gnus-category-edit-groups}).
18709 18700
18710@item s 18701@item s
18711@kindex s (Category) 18702@kindex s @r{(Category)}
18712@findex gnus-category-edit-score 18703@findex gnus-category-edit-score
18713Edit the download score rule of the current category 18704Edit the download score rule of the current category
18714(@code{gnus-category-edit-score}). 18705(@code{gnus-category-edit-score}).
18715 18706
18716@item l 18707@item l
18717@kindex l (Category) 18708@kindex l @r{(Category)}
18718@findex gnus-category-list 18709@findex gnus-category-list
18719List all the categories (@code{gnus-category-list}). 18710List all the categories (@code{gnus-category-list}).
18720@end table 18711@end table
@@ -18788,7 +18779,7 @@ have to enable expiration in selected groups.
18788@node Agent Commands 18779@node Agent Commands
18789@subsection Agent Commands 18780@subsection Agent Commands
18790@findex gnus-agent-toggle-plugged 18781@findex gnus-agent-toggle-plugged
18791@kindex J j (Agent) 18782@kindex J j @r{(Agent)}
18792 18783
18793All the Gnus Agent commands are on the @kbd{J} submap. The @kbd{J j} 18784All the Gnus Agent commands are on the @kbd{J} submap. The @kbd{J j}
18794(@code{gnus-agent-toggle-plugged}) command works in all modes, and 18785(@code{gnus-agent-toggle-plugged}) command works in all modes, and
@@ -18809,44 +18800,44 @@ toggles the plugged/unplugged state of the Gnus Agent.
18809 18800
18810@table @kbd 18801@table @kbd
18811@item J u 18802@item J u
18812@kindex J u (Agent Group) 18803@kindex J u @r{(Agent Group)}
18813@findex gnus-agent-fetch-groups 18804@findex gnus-agent-fetch-groups
18814Fetch all eligible articles in the current group 18805Fetch all eligible articles in the current group
18815(@code{gnus-agent-fetch-groups}). 18806(@code{gnus-agent-fetch-groups}).
18816 18807
18817@item J c 18808@item J c
18818@kindex J c (Agent Group) 18809@kindex J c @r{(Agent Group)}
18819@findex gnus-enter-category-buffer 18810@findex gnus-enter-category-buffer
18820Enter the Agent category buffer (@code{gnus-enter-category-buffer}). 18811Enter the Agent category buffer (@code{gnus-enter-category-buffer}).
18821 18812
18822@item J s 18813@item J s
18823@kindex J s (Agent Group) 18814@kindex J s @r{(Agent Group)}
18824@findex gnus-agent-fetch-session 18815@findex gnus-agent-fetch-session
18825Fetch all eligible articles in all groups 18816Fetch all eligible articles in all groups
18826(@code{gnus-agent-fetch-session}). 18817(@code{gnus-agent-fetch-session}).
18827 18818
18828@item J S 18819@item J S
18829@kindex J S (Agent Group) 18820@kindex J S @r{(Agent Group)}
18830@findex gnus-group-send-queue 18821@findex gnus-group-send-queue
18831Send all sendable messages in the queue group 18822Send all sendable messages in the queue group
18832(@code{gnus-group-send-queue}). @xref{Drafts}. 18823(@code{gnus-group-send-queue}). @xref{Drafts}.
18833 18824
18834@item J a 18825@item J a
18835@kindex J a (Agent Group) 18826@kindex J a @r{(Agent Group)}
18836@findex gnus-agent-add-group 18827@findex gnus-agent-add-group
18837Add the current group to an Agent category 18828Add the current group to an Agent category
18838(@code{gnus-agent-add-group}). This command understands the 18829(@code{gnus-agent-add-group}). This command understands the
18839process/prefix convention (@pxref{Process/Prefix}). 18830process/prefix convention (@pxref{Process/Prefix}).
18840 18831
18841@item J r 18832@item J r
18842@kindex J r (Agent Group) 18833@kindex J r @r{(Agent Group)}
18843@findex gnus-agent-remove-group 18834@findex gnus-agent-remove-group
18844Remove the current group from its category, if any 18835Remove the current group from its category, if any
18845(@code{gnus-agent-remove-group}). This command understands the 18836(@code{gnus-agent-remove-group}). This command understands the
18846process/prefix convention (@pxref{Process/Prefix}). 18837process/prefix convention (@pxref{Process/Prefix}).
18847 18838
18848@item J Y 18839@item J Y
18849@kindex J Y (Agent Group) 18840@kindex J Y @r{(Agent Group)}
18850@findex gnus-agent-synchronize-flags 18841@findex gnus-agent-synchronize-flags
18851Synchronize flags changed while unplugged with remote server, if any. 18842Synchronize flags changed while unplugged with remote server, if any.
18852 18843
@@ -18859,43 +18850,43 @@ Synchronize flags changed while unplugged with remote server, if any.
18859 18850
18860@table @kbd 18851@table @kbd
18861@item J # 18852@item J #
18862@kindex J # (Agent Summary) 18853@kindex J # @r{(Agent Summary)}
18863@findex gnus-agent-mark-article 18854@findex gnus-agent-mark-article
18864Mark the article for downloading (@code{gnus-agent-mark-article}). 18855Mark the article for downloading (@code{gnus-agent-mark-article}).
18865 18856
18866@item J M-# 18857@item J M-#
18867@kindex J M-# (Agent Summary) 18858@kindex J M-# @r{(Agent Summary)}
18868@findex gnus-agent-unmark-article 18859@findex gnus-agent-unmark-article
18869Remove the downloading mark from the article 18860Remove the downloading mark from the article
18870(@code{gnus-agent-unmark-article}). 18861(@code{gnus-agent-unmark-article}).
18871 18862
18872@cindex % 18863@cindex %
18873@item @@ 18864@item @@
18874@kindex @@ (Agent Summary) 18865@kindex @@ @r{(Agent Summary)}
18875@findex gnus-agent-toggle-mark 18866@findex gnus-agent-toggle-mark
18876Toggle whether to download the article 18867Toggle whether to download the article
18877(@code{gnus-agent-toggle-mark}). The download mark is @samp{%} by 18868(@code{gnus-agent-toggle-mark}). The download mark is @samp{%} by
18878default. 18869default.
18879 18870
18880@item J c 18871@item J c
18881@kindex J c (Agent Summary) 18872@kindex J c @r{(Agent Summary)}
18882@findex gnus-agent-catchup 18873@findex gnus-agent-catchup
18883Mark all articles as read (@code{gnus-agent-catchup}) that are neither cached, downloaded, nor downloadable. 18874Mark all articles as read (@code{gnus-agent-catchup}) that are neither cached, downloaded, nor downloadable.
18884 18875
18885@item J S 18876@item J S
18886@kindex J S (Agent Summary) 18877@kindex J S @r{(Agent Summary)}
18887@findex gnus-agent-fetch-group 18878@findex gnus-agent-fetch-group
18888Download all eligible (@pxref{Agent Categories}) articles in this group. 18879Download all eligible (@pxref{Agent Categories}) articles in this group.
18889(@code{gnus-agent-fetch-group}). 18880(@code{gnus-agent-fetch-group}).
18890 18881
18891@item J s 18882@item J s
18892@kindex J s (Agent Summary) 18883@kindex J s @r{(Agent Summary)}
18893@findex gnus-agent-summary-fetch-series 18884@findex gnus-agent-summary-fetch-series
18894Download all processable articles in this group. 18885Download all processable articles in this group.
18895(@code{gnus-agent-summary-fetch-series}). 18886(@code{gnus-agent-summary-fetch-series}).
18896 18887
18897@item J u 18888@item J u
18898@kindex J u (Agent Summary) 18889@kindex J u @r{(Agent Summary)}
18899@findex gnus-agent-summary-fetch-group 18890@findex gnus-agent-summary-fetch-group
18900Download all downloadable articles in the current group 18891Download all downloadable articles in the current group
18901(@code{gnus-agent-summary-fetch-group}). 18892(@code{gnus-agent-summary-fetch-group}).
@@ -18908,13 +18899,13 @@ Download all downloadable articles in the current group
18908 18899
18909@table @kbd 18900@table @kbd
18910@item J a 18901@item J a
18911@kindex J a (Agent Server) 18902@kindex J a @r{(Agent Server)}
18912@findex gnus-agent-add-server 18903@findex gnus-agent-add-server
18913Add the current server to the list of servers covered by the Gnus Agent 18904Add the current server to the list of servers covered by the Gnus Agent
18914(@code{gnus-agent-add-server}). 18905(@code{gnus-agent-add-server}).
18915 18906
18916@item J r 18907@item J r
18917@kindex J r (Agent Server) 18908@kindex J r @r{(Agent Server)}
18918@findex gnus-agent-remove-server 18909@findex gnus-agent-remove-server
18919Remove the current server from the list of servers covered by the Gnus 18910Remove the current server from the list of servers covered by the Gnus
18920Agent (@code{gnus-agent-remove-server}). 18911Agent (@code{gnus-agent-remove-server}).
@@ -19015,8 +19006,6 @@ sense if you are using a nntp or nnimap back end.
19015 19006
19016@vindex gnus-agent-expire-days 19007@vindex gnus-agent-expire-days
19017@findex gnus-agent-expire 19008@findex gnus-agent-expire
19018@kindex M-x gnus-agent-expire
19019@kindex M-x gnus-agent-expire-group
19020@findex gnus-agent-expire-group 19009@findex gnus-agent-expire-group
19021@cindex agent expiry 19010@cindex agent expiry
19022@cindex Gnus agent expiry 19011@cindex Gnus agent expiry
@@ -19070,14 +19059,12 @@ failure. Running @code{gnus-agent-regenerate} or
19070such that you don't need to download these articles a second time. 19059such that you don't need to download these articles a second time.
19071 19060
19072@findex gnus-agent-regenerate 19061@findex gnus-agent-regenerate
19073@kindex M-x gnus-agent-regenerate
19074The command @code{gnus-agent-regenerate} will perform 19062The command @code{gnus-agent-regenerate} will perform
19075@code{gnus-agent-regenerate-group} on every agentized group. While 19063@code{gnus-agent-regenerate-group} on every agentized group. While
19076you can run @code{gnus-agent-regenerate} in any buffer, it is strongly 19064you can run @code{gnus-agent-regenerate} in any buffer, it is strongly
19077recommended that you first close all summary buffers. 19065recommended that you first close all summary buffers.
19078 19066
19079@findex gnus-agent-regenerate-group 19067@findex gnus-agent-regenerate-group
19080@kindex M-x gnus-agent-regenerate-group
19081The command @code{gnus-agent-regenerate-group} uses the local copies 19068The command @code{gnus-agent-regenerate-group} uses the local copies
19082of individual articles to repair the local @acronym{NOV}(header) database. It 19069of individual articles to repair the local @acronym{NOV}(header) database. It
19083then updates the internal data structures that document which articles 19070then updates the internal data structures that document which articles
@@ -19463,18 +19450,18 @@ General score commands that don't actually change the score file:
19463@table @kbd 19450@table @kbd
19464 19451
19465@item V s 19452@item V s
19466@kindex V s (Summary) 19453@kindex V s @r{(Summary)}
19467@findex gnus-summary-set-score 19454@findex gnus-summary-set-score
19468Set the score of the current article (@code{gnus-summary-set-score}). 19455Set the score of the current article (@code{gnus-summary-set-score}).
19469 19456
19470@item V S 19457@item V S
19471@kindex V S (Summary) 19458@kindex V S @r{(Summary)}
19472@findex gnus-summary-current-score 19459@findex gnus-summary-current-score
19473Display the score of the current article 19460Display the score of the current article
19474(@code{gnus-summary-current-score}). 19461(@code{gnus-summary-current-score}).
19475 19462
19476@item V t 19463@item V t
19477@kindex V t (Summary) 19464@kindex V t @r{(Summary)}
19478@findex gnus-score-find-trace 19465@findex gnus-score-find-trace
19479Display all score rules that have been used on the current article 19466Display all score rules that have been used on the current article
19480(@code{gnus-score-find-trace}). In the @file{*Score Trace*} buffer, you 19467(@code{gnus-score-find-trace}). In the @file{*Score Trace*} buffer, you
@@ -19483,12 +19470,12 @@ current line and @kbd{f} to format (@code{gnus-score-pretty-print}) the
19483score file and edit it. 19470score file and edit it.
19484 19471
19485@item V w 19472@item V w
19486@kindex V w (Summary) 19473@kindex V w @r{(Summary)}
19487@findex gnus-score-find-favourite-words 19474@findex gnus-score-find-favourite-words
19488List words used in scoring (@code{gnus-score-find-favourite-words}). 19475List words used in scoring (@code{gnus-score-find-favourite-words}).
19489 19476
19490@item V R 19477@item V R
19491@kindex V R (Summary) 19478@kindex V R @r{(Summary)}
19492@findex gnus-summary-rescore 19479@findex gnus-summary-rescore
19493Run the current summary through the scoring process 19480Run the current summary through the scoring process
19494(@code{gnus-summary-rescore}). This might be useful if you're playing 19481(@code{gnus-summary-rescore}). This might be useful if you're playing
@@ -19496,32 +19483,32 @@ around with your score files behind Gnus' back and want to see the
19496effect you're having. 19483effect you're having.
19497 19484
19498@item V c 19485@item V c
19499@kindex V c (Summary) 19486@kindex V c @r{(Summary)}
19500@findex gnus-score-change-score-file 19487@findex gnus-score-change-score-file
19501Make a different score file the current 19488Make a different score file the current
19502(@code{gnus-score-change-score-file}). 19489(@code{gnus-score-change-score-file}).
19503 19490
19504@item V e 19491@item V e
19505@kindex V e (Summary) 19492@kindex V e @r{(Summary)}
19506@findex gnus-score-edit-current-scores 19493@findex gnus-score-edit-current-scores
19507Edit the current score file (@code{gnus-score-edit-current-scores}). 19494Edit the current score file (@code{gnus-score-edit-current-scores}).
19508You will be popped into a @code{gnus-score-mode} buffer (@pxref{Score 19495You will be popped into a @code{gnus-score-mode} buffer (@pxref{Score
19509File Editing}). 19496File Editing}).
19510 19497
19511@item V f 19498@item V f
19512@kindex V f (Summary) 19499@kindex V f @r{(Summary)}
19513@findex gnus-score-edit-file 19500@findex gnus-score-edit-file
19514Edit a score file and make this score file the current one 19501Edit a score file and make this score file the current one
19515(@code{gnus-score-edit-file}). 19502(@code{gnus-score-edit-file}).
19516 19503
19517@item V F 19504@item V F
19518@kindex V F (Summary) 19505@kindex V F @r{(Summary)}
19519@findex gnus-score-flush-cache 19506@findex gnus-score-flush-cache
19520Flush the score cache (@code{gnus-score-flush-cache}). This is useful 19507Flush the score cache (@code{gnus-score-flush-cache}). This is useful
19521after editing score files. 19508after editing score files.
19522 19509
19523@item V C 19510@item V C
19524@kindex V C (Summary) 19511@kindex V C @r{(Summary)}
19525@findex gnus-score-customize 19512@findex gnus-score-customize
19526Customize a score file in a visually pleasing manner 19513Customize a score file in a visually pleasing manner
19527(@code{gnus-score-customize}). 19514(@code{gnus-score-customize}).
@@ -19533,13 +19520,13 @@ The rest of these commands modify the local score file.
19533@table @kbd 19520@table @kbd
19534 19521
19535@item V m 19522@item V m
19536@kindex V m (Summary) 19523@kindex V m @r{(Summary)}
19537@findex gnus-score-set-mark-below 19524@findex gnus-score-set-mark-below
19538Prompt for a score, and mark all articles with a score below this as 19525Prompt for a score, and mark all articles with a score below this as
19539read (@code{gnus-score-set-mark-below}). 19526read (@code{gnus-score-set-mark-below}).
19540 19527
19541@item V x 19528@item V x
19542@kindex V x (Summary) 19529@kindex V x @r{(Summary)}
19543@findex gnus-score-set-expunge-below 19530@findex gnus-score-set-expunge-below
19544Prompt for a score, and add a score rule to the current score file to 19531Prompt for a score, and add a score rule to the current score file to
19545expunge all articles below this score 19532expunge all articles below this score
@@ -19674,7 +19661,7 @@ Immediately scoring.
19674@item 19661@item
19675If you are scoring on @samp{e} (extra) headers, you will then be prompted for 19662If you are scoring on @samp{e} (extra) headers, you will then be prompted for
19676the header name on which you wish to score. This must be a header named 19663the header name on which you wish to score. This must be a header named
19677in gnus-extra-headers, and @samp{TAB} completion is available. 19664in gnus-extra-headers, and @samp{@key{TAB}} completion is available.
19678 19665
19679@end enumerate 19666@end enumerate
19680 19667
@@ -19709,13 +19696,13 @@ There aren't many of these as yet, I'm afraid.
19709@table @kbd 19696@table @kbd
19710 19697
19711@item W e 19698@item W e
19712@kindex W e (Group) 19699@kindex W e @r{(Group)}
19713@findex gnus-score-edit-all-score 19700@findex gnus-score-edit-all-score
19714Edit the apply-to-all-groups all.SCORE file. You will be popped into 19701Edit the apply-to-all-groups all.SCORE file. You will be popped into
19715a @code{gnus-score-mode} buffer (@pxref{Score File Editing}). 19702a @code{gnus-score-mode} buffer (@pxref{Score File Editing}).
19716 19703
19717@item W f 19704@item W f
19718@kindex W f (Group) 19705@kindex W f @r{(Group)}
19719@findex gnus-score-flush-cache 19706@findex gnus-score-flush-cache
19720Gnus maintains a cache of score alists to avoid having to reload them 19707Gnus maintains a cache of score alists to avoid having to reload them
19721all the time. This command will flush the cache 19708all the time. This command will flush the cache
@@ -20199,20 +20186,20 @@ additional commands:
20199@table @kbd 20186@table @kbd
20200 20187
20201@item C-c C-c 20188@item C-c C-c
20202@kindex C-c C-c (Score) 20189@kindex C-c C-c @r{(Score)}
20203@findex gnus-score-edit-exit 20190@findex gnus-score-edit-exit
20204Save the changes you have made and return to the summary buffer 20191Save the changes you have made and return to the summary buffer
20205(@code{gnus-score-edit-exit}). 20192(@code{gnus-score-edit-exit}).
20206 20193
20207@item C-c C-d 20194@item C-c C-d
20208@kindex C-c C-d (Score) 20195@kindex C-c C-d @r{(Score)}
20209@findex gnus-score-edit-insert-date 20196@findex gnus-score-edit-insert-date
20210Insert the current date in numerical format 20197Insert the current date in numerical format
20211(@code{gnus-score-edit-insert-date}). This is really the day number, if 20198(@code{gnus-score-edit-insert-date}). This is really the day number, if
20212you were wondering. 20199you were wondering.
20213 20200
20214@item C-c C-p 20201@item C-c C-p
20215@kindex C-c C-p (Score) 20202@kindex C-c C-p @r{(Score)}
20216@findex gnus-score-pretty-print 20203@findex gnus-score-pretty-print
20217The adaptive score files are saved in an unformatted fashion. If you 20204The adaptive score files are saved in an unformatted fashion. If you
20218intend to read one of these files, you want to @dfn{pretty print} it 20205intend to read one of these files, you want to @dfn{pretty print} it
@@ -20578,7 +20565,7 @@ Restart Gnus and rebuild your @code{nnml} overview files with the
20578time if you have much mail. 20565time if you have much mail.
20579 20566
20580Now you can score on @samp{To} and @samp{Cc} as ``extra headers'' like 20567Now you can score on @samp{To} and @samp{Cc} as ``extra headers'' like
20581so: @kbd{I e s p To RET <your name> RET}. 20568so: @kbd{I e s p To @key{RET} <your name> @key{RET}}.
20582 20569
20583See? Simple. 20570See? Simple.
20584 20571
@@ -20765,12 +20752,12 @@ Two summary functions for editing a @sc{gnus} kill file:
20765@table @kbd 20752@table @kbd
20766 20753
20767@item M-k 20754@item M-k
20768@kindex M-k (Summary) 20755@kindex M-k @r{(Summary)}
20769@findex gnus-summary-edit-local-kill 20756@findex gnus-summary-edit-local-kill
20770Edit this group's kill file (@code{gnus-summary-edit-local-kill}). 20757Edit this group's kill file (@code{gnus-summary-edit-local-kill}).
20771 20758
20772@item M-K 20759@item M-K
20773@kindex M-K (Summary) 20760@kindex M-K @r{(Summary)}
20774@findex gnus-summary-edit-global-kill 20761@findex gnus-summary-edit-global-kill
20775Edit the general kill file (@code{gnus-summary-edit-global-kill}). 20762Edit the general kill file (@code{gnus-summary-edit-global-kill}).
20776@end table 20763@end table
@@ -20780,12 +20767,12 @@ Two group mode functions for editing the kill files:
20780@table @kbd 20767@table @kbd
20781 20768
20782@item M-k 20769@item M-k
20783@kindex M-k (Group) 20770@kindex M-k @r{(Group)}
20784@findex gnus-group-edit-local-kill 20771@findex gnus-group-edit-local-kill
20785Edit this group's kill file (@code{gnus-group-edit-local-kill}). 20772Edit this group's kill file (@code{gnus-group-edit-local-kill}).
20786 20773
20787@item M-K 20774@item M-K
20788@kindex M-K (Group) 20775@kindex M-K @r{(Group)}
20789@findex gnus-group-edit-global-kill 20776@findex gnus-group-edit-global-kill
20790Edit the general kill file (@code{gnus-group-edit-global-kill}). 20777Edit the general kill file (@code{gnus-group-edit-global-kill}).
20791@end table 20778@end table
@@ -21725,7 +21712,7 @@ want.
21725@item 21712@item
21726The name of the @strong{back end server} where mairix should store its 21713The name of the @strong{back end server} where mairix should store its
21727searches. This must be a full server name, like @code{nnml:mymail}. 21714searches. This must be a full server name, like @code{nnml:mymail}.
21728Just hit @kbd{TAB} to see the available servers. Currently, servers 21715Just hit @kbd{@key{TAB}} to see the available servers. Currently, servers
21729which are accessed through @code{nnmaildir}, @code{nnimap} and 21716which are accessed through @code{nnmaildir}, @code{nnimap} and
21730@code{nnml} are supported. As explained above, for locally stored 21717@code{nnml} are supported. As explained above, for locally stored
21731mails, this can be an existing server where you store your mails. 21718mails, this can be an existing server where you store your mails.
@@ -21770,34 +21757,34 @@ In group mode:
21770@table @kbd 21757@table @kbd
21771 21758
21772@item G b c 21759@item G b c
21773@kindex G b c (Group) 21760@kindex G b c @r{(Group)}
21774@findex nnmairix-create-server-and-default-group 21761@findex nnmairix-create-server-and-default-group
21775Creates @code{nnmairix} server and default search group for this server 21762Creates @code{nnmairix} server and default search group for this server
21776(@code{nnmairix-create-server-and-default-group}). You should have done 21763(@code{nnmairix-create-server-and-default-group}). You should have done
21777this by now (@pxref{Configuring nnmairix}). 21764this by now (@pxref{Configuring nnmairix}).
21778 21765
21779@item G b s 21766@item G b s
21780@kindex G b s (Group) 21767@kindex G b s @r{(Group)}
21781@findex nnmairix-search 21768@findex nnmairix-search
21782Prompts for query which is then sent to the mairix binary. Search 21769Prompts for query which is then sent to the mairix binary. Search
21783results are put into the default search group which is automatically 21770results are put into the default search group which is automatically
21784displayed (@code{nnmairix-search}). 21771displayed (@code{nnmairix-search}).
21785 21772
21786@item G b m 21773@item G b m
21787@kindex G b m (Group) 21774@kindex G b m @r{(Group)}
21788@findex nnmairix-widget-search 21775@findex nnmairix-widget-search
21789Allows you to create a mairix search or a permanent group more 21776Allows you to create a mairix search or a permanent group more
21790comfortably using graphical widgets, similar to a customization 21777comfortably using graphical widgets, similar to a customization
21791group. Just try it to see how it works (@code{nnmairix-widget-search}). 21778group. Just try it to see how it works (@code{nnmairix-widget-search}).
21792 21779
21793@item G b i 21780@item G b i
21794@kindex G b i (Group) 21781@kindex G b i @r{(Group)}
21795@findex nnmairix-search-interactive 21782@findex nnmairix-search-interactive
21796Another command for creating a mairix query more comfortably, but uses 21783Another command for creating a mairix query more comfortably, but uses
21797only the minibuffer (@code{nnmairix-search-interactive}). 21784only the minibuffer (@code{nnmairix-search-interactive}).
21798 21785
21799@item G b g 21786@item G b g
21800@kindex G b g (Group) 21787@kindex G b g @r{(Group)}
21801@findex nnmairix-create-search-group 21788@findex nnmairix-create-search-group
21802Creates a permanent group which is associated with a search query 21789Creates a permanent group which is associated with a search query
21803(@code{nnmairix-create-search-group}). The @code{nnmairix} back end 21790(@code{nnmairix-create-search-group}). The @code{nnmairix} back end
@@ -21805,20 +21792,20 @@ automatically calls mairix when you update this group with @kbd{g} or
21805@kbd{M-g}. 21792@kbd{M-g}.
21806 21793
21807@item G b q 21794@item G b q
21808@kindex G b q (Group) 21795@kindex G b q @r{(Group)}
21809@findex nnmairix-group-change-query-this-group 21796@findex nnmairix-group-change-query-this-group
21810Changes the search query for the @code{nnmairix} group under cursor 21797Changes the search query for the @code{nnmairix} group under cursor
21811(@code{nnmairix-group-change-query-this-group}). 21798(@code{nnmairix-group-change-query-this-group}).
21812 21799
21813@item G b t 21800@item G b t
21814@kindex G b t (Group) 21801@kindex G b t @r{(Group)}
21815@findex nnmairix-group-toggle-threads-this-group 21802@findex nnmairix-group-toggle-threads-this-group
21816Toggles the 'threads' parameter for the @code{nnmairix} group under cursor, 21803Toggles the 'threads' parameter for the @code{nnmairix} group under cursor,
21817i.e., if you want see the whole threads of the found messages 21804i.e., if you want see the whole threads of the found messages
21818(@code{nnmairix-group-toggle-threads-this-group}). 21805(@code{nnmairix-group-toggle-threads-this-group}).
21819 21806
21820@item G b u 21807@item G b u
21821@kindex G b u (Group) 21808@kindex G b u @r{(Group)}
21822@findex nnmairix-update-database 21809@findex nnmairix-update-database
21823@vindex nnmairix-mairix-update-options 21810@vindex nnmairix-mairix-update-options
21824Calls mairix binary for updating the database 21811Calls mairix binary for updating the database
@@ -21828,20 +21815,20 @@ and @code{-Q} for making this as fast as possible (see variable
21828options). 21815options).
21829 21816
21830@item G b r 21817@item G b r
21831@kindex G b r (Group) 21818@kindex G b r @r{(Group)}
21832@findex nnmairix-group-toggle-readmarks-this-group 21819@findex nnmairix-group-toggle-readmarks-this-group
21833Keep articles in this @code{nnmairix} group always read or unread, or leave the 21820Keep articles in this @code{nnmairix} group always read or unread, or leave the
21834marks unchanged (@code{nnmairix-group-toggle-readmarks-this-group}). 21821marks unchanged (@code{nnmairix-group-toggle-readmarks-this-group}).
21835 21822
21836@item G b d 21823@item G b d
21837@kindex G b d (Group) 21824@kindex G b d @r{(Group)}
21838@findex nnmairix-group-delete-recreate-this-group 21825@findex nnmairix-group-delete-recreate-this-group
21839Recreate @code{nnmairix} group on the ``real'' mail back end 21826Recreate @code{nnmairix} group on the ``real'' mail back end
21840(@code{nnmairix-group-delete-recreate-this-group}). You can do this if 21827(@code{nnmairix-group-delete-recreate-this-group}). You can do this if
21841you always get wrong article counts with a @code{nnmairix} group. 21828you always get wrong article counts with a @code{nnmairix} group.
21842 21829
21843@item G b a 21830@item G b a
21844@kindex G b a (Group) 21831@kindex G b a @r{(Group)}
21845@findex nnmairix-group-toggle-allowfast-this-group 21832@findex nnmairix-group-toggle-allowfast-this-group
21846Toggles the @code{allow-fast} parameters for group under cursor 21833Toggles the @code{allow-fast} parameters for group under cursor
21847(@code{nnmairix-group-toggle-allowfast-this-group}). The default 21834(@code{nnmairix-group-toggle-allowfast-this-group}). The default
@@ -21853,14 +21840,14 @@ lead to dangling symlinks if something changed between updating and
21853entering the group which is not yet in the mairix database. 21840entering the group which is not yet in the mairix database.
21854 21841
21855@item G b p 21842@item G b p
21856@kindex G b p (Group) 21843@kindex G b p @r{(Group)}
21857@findex nnmairix-group-toggle-propmarks-this-group 21844@findex nnmairix-group-toggle-propmarks-this-group
21858Toggle marks propagation for this group 21845Toggle marks propagation for this group
21859(@code{nnmairix-group-toggle-propmarks-this-group}). (@pxref{Propagating 21846(@code{nnmairix-group-toggle-propmarks-this-group}). (@pxref{Propagating
21860marks}). 21847marks}).
21861 21848
21862@item G b o 21849@item G b o
21863@kindex G b o (Group) 21850@kindex G b o @r{(Group)}
21864@findex nnmairix-propagate-marks 21851@findex nnmairix-propagate-marks
21865Manually propagate marks (@code{nnmairix-propagate-marks}); needed only when 21852Manually propagate marks (@code{nnmairix-propagate-marks}); needed only when
21866@code{nnmairix-propagate-marks-upon-close} is set to @code{nil}. 21853@code{nnmairix-propagate-marks-upon-close} is set to @code{nil}.
@@ -21872,21 +21859,21 @@ In summary mode:
21872@table @kbd 21859@table @kbd
21873 21860
21874@item G G m 21861@item G G m
21875@kindex G G m (Summary) 21862@kindex G G m @r{(Summary)}
21876@findex nnmairix-widget-search-from-this-article 21863@findex nnmairix-widget-search-from-this-article
21877Allows you to create a mairix query or group based on the current 21864Allows you to create a mairix query or group based on the current
21878message using graphical widgets (same as @code{nnmairix-widget-search}) 21865message using graphical widgets (same as @code{nnmairix-widget-search})
21879(@code{nnmairix-widget-search-from-this-article}). 21866(@code{nnmairix-widget-search-from-this-article}).
21880 21867
21881@item G G g 21868@item G G g
21882@kindex G G g (Summary) 21869@kindex G G g @r{(Summary)}
21883@findex nnmairix-create-search-group-from-message 21870@findex nnmairix-create-search-group-from-message
21884Interactively creates a new search group with query based on the current 21871Interactively creates a new search group with query based on the current
21885message, but uses the minibuffer instead of graphical widgets 21872message, but uses the minibuffer instead of graphical widgets
21886(@code{nnmairix-create-search-group-from-message}). 21873(@code{nnmairix-create-search-group-from-message}).
21887 21874
21888@item G G t 21875@item G G t
21889@kindex G G t (Summary) 21876@kindex G G t @r{(Summary)}
21890@findex nnmairix-search-thread-this-article 21877@findex nnmairix-search-thread-this-article
21891Searches thread for the current article 21878Searches thread for the current article
21892(@code{nnmairix-search-thread-this-article}). This is effectively a 21879(@code{nnmairix-search-thread-this-article}). This is effectively a
@@ -21894,14 +21881,14 @@ shortcut for calling @code{nnmairix-search} with @samp{m:msgid} of the
21894current article and enabled threads. 21881current article and enabled threads.
21895 21882
21896@item G G f 21883@item G G f
21897@kindex G G f (Summary) 21884@kindex G G f @r{(Summary)}
21898@findex nnmairix-search-from-this-article 21885@findex nnmairix-search-from-this-article
21899Searches all messages from sender of the current article 21886Searches all messages from sender of the current article
21900(@code{nnmairix-search-from-this-article}). This is a shortcut for 21887(@code{nnmairix-search-from-this-article}). This is a shortcut for
21901calling @code{nnmairix-search} with @samp{f:From}. 21888calling @code{nnmairix-search} with @samp{f:From}.
21902 21889
21903@item G G o 21890@item G G o
21904@kindex G G o (Summary) 21891@kindex G G o @r{(Summary)}
21905@findex nnmairix-goto-original-article 21892@findex nnmairix-goto-original-article
21906(Only in @code{nnmairix} groups!) Tries determine the group this article 21893(Only in @code{nnmairix} groups!) Tries determine the group this article
21907originally came from and displays the article in this group, so that, 21894originally came from and displays the article in this group, so that,
@@ -21911,7 +21898,7 @@ function will use the registry if available, but can also parse the
21911article file name as a fallback method. 21898article file name as a fallback method.
21912 21899
21913@item G G u 21900@item G G u
21914@kindex G G u (Summary) 21901@kindex G G u @r{(Summary)}
21915@findex nnmairix-remove-tick-mark-original-article 21902@findex nnmairix-remove-tick-mark-original-article
21916Remove possibly existing tick mark from original article 21903Remove possibly existing tick mark from original article
21917(@code{nnmairix-remove-tick-mark-original-article}). (@pxref{nnmairix 21904(@code{nnmairix-remove-tick-mark-original-article}). (@pxref{nnmairix
@@ -22334,7 +22321,7 @@ for instance. But what if you want to save without making a backup
22334file, and you want Emacs to flash lights and play a nice tune at the 22321file, and you want Emacs to flash lights and play a nice tune at the
22335same time? You can't, and you're probably perfectly happy that way. 22322same time? You can't, and you're probably perfectly happy that way.
22336 22323
22337@kindex M-i (Summary) 22324@kindex M-i @r{(Summary)}
22338@findex gnus-symbolic-argument 22325@findex gnus-symbolic-argument
22339I'm not, so I've added a second prefix---the @dfn{symbolic prefix}. The 22326I'm not, so I've added a second prefix---the @dfn{symbolic prefix}. The
22340prefix key is @kbd{M-i} (@code{gnus-symbolic-argument}), and the next 22327prefix key is @kbd{M-i} (@code{gnus-symbolic-argument}), and the next
@@ -22390,7 +22377,6 @@ Currently Gnus uses the following formatting variables:
22390All these format variables can also be arbitrary elisp forms. In that 22377All these format variables can also be arbitrary elisp forms. In that
22391case, they will be @code{eval}ed to insert the required lines. 22378case, they will be @code{eval}ed to insert the required lines.
22392 22379
22393@kindex M-x gnus-update-format
22394@findex gnus-update-format 22380@findex gnus-update-format
22395Gnus includes a command to help you while creating your own format 22381Gnus includes a command to help you while creating your own format
22396specs. @kbd{M-x gnus-update-format} will @code{eval} the current form, 22382specs. @kbd{M-x gnus-update-format} will @code{eval} the current form,
@@ -24292,10 +24278,10 @@ group:
24292@itemx M-d 24278@itemx M-d
24293@itemx M s x 24279@itemx M s x
24294@itemx S x 24280@itemx S x
24295@kindex $ (Summary) 24281@kindex $ @r{(Summary)}
24296@kindex M-d (Summary) 24282@kindex M-d @r{(Summary)}
24297@kindex S x (Summary) 24283@kindex S x @r{(Summary)}
24298@kindex M s x (Summary) 24284@kindex M s x @r{(Summary)}
24299@findex gnus-summary-mark-as-spam 24285@findex gnus-summary-mark-as-spam
24300@findex gnus-summary-mark-as-spam 24286@findex gnus-summary-mark-as-spam
24301Mark current article as spam, showing it with the @samp{$} mark 24287Mark current article as spam, showing it with the @samp{$} mark
@@ -24567,7 +24553,7 @@ determined by either the @code{ham-process-destination} group
24567parameter or a match in the @code{gnus-ham-process-destinations} 24553parameter or a match in the @code{gnus-ham-process-destinations}
24568variable, which is a list of regular expressions matched with group 24554variable, which is a list of regular expressions matched with group
24569names (it's easiest to customize this variable with @kbd{M-x 24555names (it's easiest to customize this variable with @kbd{M-x
24570customize-variable @key{RET} gnus-ham-process-destinations}). Each 24556customize-variable @key{@key{RET}} gnus-ham-process-destinations}). Each
24571group name list is a standard Lisp list, if you prefer to customize 24557group name list is a standard Lisp list, if you prefer to customize
24572the variable manually. If the @code{ham-process-destination} 24558the variable manually. If the @code{ham-process-destination}
24573parameter is not set, ham articles are left in place. If the 24559parameter is not set, ham articles are left in place. If the
@@ -24603,7 +24589,7 @@ When you leave a @emph{ham} or @emph{unclassified} group, all
24603the @code{spam-process-destination} group parameter or a match in the 24589the @code{spam-process-destination} group parameter or a match in the
24604@code{gnus-spam-process-destinations} variable, which is a list of 24590@code{gnus-spam-process-destinations} variable, which is a list of
24605regular expressions matched with group names (it's easiest to 24591regular expressions matched with group names (it's easiest to
24606customize this variable with @kbd{M-x customize-variable @key{RET} 24592customize this variable with @kbd{M-x customize-variable @key{@key{RET}}
24607gnus-spam-process-destinations}). Each group name list is a standard 24593gnus-spam-process-destinations}). Each group name list is a standard
24608Lisp list, if you prefer to customize the variable manually. If the 24594Lisp list, if you prefer to customize the variable manually. If the
24609@code{spam-process-destination} parameter is not set, the spam 24595@code{spam-process-destination} parameter is not set, the spam
@@ -26235,7 +26221,7 @@ you to optionally upload your first CloudSynchronizationDataPack(TM).
26235After setting up, you can use these shortcuts from the Group buffer: 26221After setting up, you can use these shortcuts from the Group buffer:
26236 26222
26237@table @kbd 26223@table @kbd
26238@item ~ RET 26224@item ~ @key{RET}
26239@item ~ d 26225@item ~ d
26240@findex gnus-cloud-download-all-data 26226@findex gnus-cloud-download-all-data
26241@cindex cloud, download 26227@cindex cloud, download
@@ -26670,7 +26656,6 @@ to stop doing it the old way.
26670 26656
26671Gnus understands all @sc{gnus} startup files. 26657Gnus understands all @sc{gnus} startup files.
26672 26658
26673@kindex M-x gnus-bug
26674@findex gnus-bug 26659@findex gnus-bug
26675@cindex reporting bugs 26660@cindex reporting bugs
26676@cindex bugs 26661@cindex bugs
@@ -27749,7 +27734,7 @@ control over simplification.
27749limit. 27734limit.
27750 27735
27751@item 27736@item
27752@kbd{M-RET} is a new Message command for breaking cited text. 27737@kbd{M-@key{RET}} is a new Message command for breaking cited text.
27753 27738
27754@item 27739@item
27755@samp{\\1}-expressions are now valid in @code{nnmail-split-methods}. 27740@samp{\\1}-expressions are now valid in @code{nnmail-split-methods}.
@@ -28304,10 +28289,10 @@ Easy inclusion of X-Faces headers. @xref{X-Face}.
28304@item 28289@item
28305Group Carbon Copy (GCC) quoting 28290Group Carbon Copy (GCC) quoting
28306 28291
28307To support groups that contains SPC and other weird characters, groups 28292To support groups that contains @key{SPC} and other weird characters, groups
28308are quoted before they are placed in the Gcc: header. This means 28293are quoted before they are placed in the Gcc: header. This means
28309variables such as @code{gnus-message-archive-group} should no longer 28294variables such as @code{gnus-message-archive-group} should no longer
28310contain quote characters to make groups containing SPC work. Also, if 28295contain quote characters to make groups containing @key{SPC} work. Also, if
28311you are using the string @samp{nnml:foo, nnml:bar} (indicating Gcc 28296you are using the string @samp{nnml:foo, nnml:bar} (indicating Gcc
28312into two groups) you must change it to return the list 28297into two groups) you must change it to return the list
28313@code{("nnml:foo" "nnml:bar")}, otherwise the Gcc: line will be quoted 28298@code{("nnml:foo" "nnml:bar")}, otherwise the Gcc: line will be quoted
@@ -28396,7 +28381,7 @@ Gnus supports @acronym{PGP} (RFC 1991/2440), @acronym{PGP/MIME} (RFC
28396 28381
28397It needs an external @acronym{S/MIME} and OpenPGP implementation, but no 28382It needs an external @acronym{S/MIME} and OpenPGP implementation, but no
28398additional Lisp libraries. This add several menu items to the 28383additional Lisp libraries. This add several menu items to the
28399Attachments menu, and @kbd{C-c RET} key bindings, when composing 28384Attachments menu, and @kbd{C-c @key{RET}} key bindings, when composing
28400messages. This also obsoletes @code{gnus-article-hide-pgp-hook}. 28385messages. This also obsoletes @code{gnus-article-hide-pgp-hook}.
28401 28386
28402@item 28387@item
@@ -28492,7 +28477,7 @@ message, Message Manual}).
28492@item 28477@item
28493The tool bars have been updated to use GNOME icons in Group, Summary and 28478The tool bars have been updated to use GNOME icons in Group, Summary and
28494Message mode. You can also customize the tool bars: @kbd{M-x 28479Message mode. You can also customize the tool bars: @kbd{M-x
28495customize-apropos RET -tool-bar$} should get you started. This is a new 28480customize-apropos @key{RET} -tool-bar$} should get you started. This is a new
28496feature in Gnus 5.10.10. (Only for Emacs, not in XEmacs.) 28481feature in Gnus 5.10.10. (Only for Emacs, not in XEmacs.)
28497 28482
28498@item The tool bar icons are now (de)activated correctly 28483@item The tool bar icons are now (de)activated correctly
@@ -28723,7 +28708,7 @@ commonly fetched via the protocol @acronym{NNTP}, whereas mail
28723messages could be read from a file on the local disk. The internal 28708messages could be read from a file on the local disk. The internal
28724architecture of Gnus thus comprises a ``front end'' and a number of 28709architecture of Gnus thus comprises a ``front end'' and a number of
28725``back ends''. Internally, when you enter a group (by hitting 28710``back ends''. Internally, when you enter a group (by hitting
28726@key{RET}, say), you thereby invoke a function in the front end in 28711@key{@key{RET}}, say), you thereby invoke a function in the front end in
28727Gnus. The front end then ``talks'' to a back end and says things like 28712Gnus. The front end then ``talks'' to a back end and says things like
28728``Give me the list of articles in the foo group'' or ``Show me article 28713``Give me the list of articles in the foo group'' or ``Show me article
28729number 4711''. 28714number 4711''.
@@ -29125,12 +29110,12 @@ If all else fails, report the problem as a bug.
29125@cindex bugs 29110@cindex bugs
29126@cindex reporting bugs 29111@cindex reporting bugs
29127 29112
29128@kindex M-x gnus-bug
29129@findex gnus-bug 29113@findex gnus-bug
29130If you find a bug in Gnus, you can report it with the @kbd{M-x gnus-bug} 29114If you find a bug in Gnus, you can report it with the @kbd{M-x
29131command. @kbd{M-x set-variable RET debug-on-error RET t RET}, and send 29115gnus-bug} command. @kbd{M-x set-variable @key{RET} debug-on-error
29132me the backtrace. I will fix bugs, but I can only fix them if you send 29116@key{RET} t @key{RET}}, and send me the backtrace. I will fix bugs,
29133me a precise description as to how to reproduce the bug. 29117but I can only fix them if you send me a precise description as to how
29118to reproduce the bug.
29134 29119
29135You really can never be too detailed in a bug report. Always use the 29120You really can never be too detailed in a bug report. Always use the
29136@kbd{M-x gnus-bug} command when you make bug reports, even if it creates 29121@kbd{M-x gnus-bug} command when you make bug reports, even if it creates
@@ -29163,9 +29148,9 @@ Lisp Reference Manual}). To get you started with edebug, consider if
29163you discover some weird behavior when pressing @kbd{c}, the first 29148you discover some weird behavior when pressing @kbd{c}, the first
29164step is to do @kbd{C-h k c} and click on the hyperlink (Emacs only) in 29149step is to do @kbd{C-h k c} and click on the hyperlink (Emacs only) in
29165the documentation buffer that leads you to the function definition, 29150the documentation buffer that leads you to the function definition,
29166then press @kbd{M-x edebug-defun RET} with point inside that function, 29151then press @kbd{M-x edebug-defun @key{RET}} with point inside that function,
29167return to Gnus and press @kbd{c} to invoke the code. You will be 29152return to Gnus and press @kbd{c} to invoke the code. You will be
29168placed in the lisp buffer and can single step using @kbd{SPC} and 29153placed in the lisp buffer and can single step using @kbd{@key{SPC}} and
29169evaluate expressions using @kbd{M-:} or inspect variables using 29154evaluate expressions using @kbd{M-:} or inspect variables using
29170@kbd{C-h v}, abort execution with @kbd{q}, and resume execution with 29155@kbd{C-h v}, abort execution with @kbd{q}, and resume execution with
29171@kbd{c} or @kbd{g}. 29156@kbd{c} or @kbd{g}.
@@ -29183,8 +29168,8 @@ A fancier approach is to use the elisp profiler, ELP@. The profiler is
29183(or should be) fully documented elsewhere, but to get you started 29168(or should be) fully documented elsewhere, but to get you started
29184there are a few steps that need to be followed. First, instrument the 29169there are a few steps that need to be followed. First, instrument the
29185part of Gnus you are interested in for profiling, e.g., @kbd{M-x 29170part of Gnus you are interested in for profiling, e.g., @kbd{M-x
29186elp-instrument-package RET gnus} or @kbd{M-x elp-instrument-package 29171elp-instrument-package @key{RET} gnus} or @kbd{M-x elp-instrument-package
29187RET message}. Then perform the operation that is slow and press 29172@key{RET} message}. Then perform the operation that is slow and press
29188@kbd{M-x elp-results}. You will then see which operations that takes 29173@kbd{M-x elp-results}. You will then see which operations that takes
29189time, and can debug them further. If the entire operation takes much 29174time, and can debug them further. If the entire operation takes much
29190longer than the time spent in the slowest function in the profiler 29175longer than the time spent in the slowest function in the profiler
diff --git a/doc/misc/htmlfontify.texi b/doc/misc/htmlfontify.texi
index 9f1d1b4ee32..6bc57daf627 100644
--- a/doc/misc/htmlfontify.texi
+++ b/doc/misc/htmlfontify.texi
@@ -1116,7 +1116,7 @@ Some of the (informal) data structures used in Htmlfontify are detailed here:
1116@table @code 1116@table @code
1117 1117
1118@item hfy-style-assoc 1118@item hfy-style-assoc
1119@cindex hfy-style-assoc 1119@cindex @code{hfy-style-assoc}
1120@anchor{hfy-style-assoc} 1120@anchor{hfy-style-assoc}
1121 1121
1122An assoc representing/describing an Emacs face. Properties may be repeated, 1122An assoc representing/describing an Emacs face. Properties may be repeated,
@@ -1148,7 +1148,7 @@ Some examples:
1148@end lisp 1148@end lisp
1149 1149
1150@item hfy-sheet-assoc 1150@item hfy-sheet-assoc
1151@cindex hfy-sheet-assoc 1151@cindex @code{hfy-sheet-assoc}
1152@anchor{hfy-sheet-assoc} 1152@anchor{hfy-sheet-assoc}
1153 1153
1154An assoc with elements of the form @samp{(face-name style-name . style-string)}. 1154An assoc with elements of the form @samp{(face-name style-name . style-string)}.
@@ -1160,7 +1160,7 @@ The actual stylesheet for each page is derived from one of these.
1160@end lisp 1160@end lisp
1161 1161
1162@item hfy-facemap-assoc 1162@item hfy-facemap-assoc
1163@cindex hfy-facemap-assoc 1163@cindex @code{hfy-facemap-assoc}
1164@anchor{hfy-facemap-assoc} 1164@anchor{hfy-facemap-assoc}
1165 1165
1166An assoc of @code{(point . @var{face-symbol})} or 1166An assoc of @code{(point . @var{face-symbol})} or
diff --git a/doc/misc/idlwave.texi b/doc/misc/idlwave.texi
index c37ca16b0cf..204a4499258 100644
--- a/doc/misc/idlwave.texi
+++ b/doc/misc/idlwave.texi
@@ -172,7 +172,7 @@ Catalogs
172@cindex CORBA (Common Object Request Broker Architecture) 172@cindex CORBA (Common Object Request Broker Architecture)
173@cindex Interface Definition Language 173@cindex Interface Definition Language
174@cindex Interactive Data Language 174@cindex Interactive Data Language
175@cindex cc-mode.el 175@cindex @file{cc-mode.el}
176@cindex @file{idl.el} 176@cindex @file{idl.el}
177@cindex @file{idl-shell.el} 177@cindex @file{idl-shell.el}
178@cindex Feature overview 178@cindex Feature overview
@@ -935,7 +935,7 @@ IDL code.
935@cindex String splitting 935@cindex String splitting
936@cindex Splitting, of lines 936@cindex Splitting, of lines
937 937
938@kindex M-@key{RET} 938@kindex M-RET
939In IDL, a newline character terminates a statement unless preceded by a 939In IDL, a newline character terminates a statement unless preceded by a
940@samp{$}. If you would like to start a continuation line, use 940@samp{$}. If you would like to start a continuation line, use
941@kbd{M-@key{RET}}, which calls the command @code{idlwave-split-line}. 941@kbd{M-@key{RET}}, which calls the command @code{idlwave-split-line}.
@@ -1523,7 +1523,7 @@ The case-insensitive heading word in doclib headers to locate the
1523@cindex Function name completion 1523@cindex Function name completion
1524@cindex Procedure name completion 1524@cindex Procedure name completion
1525 1525
1526@kindex M-@key{TAB} 1526@kindex M-TAB
1527@kindex C-c C-i 1527@kindex C-c C-i
1528IDLWAVE offers completion for class names, routine names, keywords, 1528IDLWAVE offers completion for class names, routine names, keywords,
1529system variables, system variable tags, class structure tags, regular 1529system variables, system variable tags, class structure tags, regular
@@ -4064,7 +4064,7 @@ sure you check the following things:
4064@itemize @bullet 4064@itemize @bullet
4065@item When you download the IDLWAVE distribution, make sure you save the 4065@item When you download the IDLWAVE distribution, make sure you save the
4066file under the names @file{idlwave.tar.gz}. 4066file under the names @file{idlwave.tar.gz}.
4067@item M-TAB switches among running programs---use Esc-TAB 4067@item M-@key{TAB} switches among running programs---use @key{ESC}-@key{TAB}
4068instead. 4068instead.
4069@item Other issues as yet unnamed... 4069@item Other issues as yet unnamed...
4070@end itemize 4070@end itemize
diff --git a/doc/misc/ido.texi b/doc/misc/ido.texi
index bc374299730..098b28ee524 100644
--- a/doc/misc/ido.texi
+++ b/doc/misc/ido.texi
@@ -456,14 +456,14 @@ You can toggle display of the hidden buffers and files with @kbd{C-a}
456You can customize the @code{ido} group to change Ido functionality: 456You can customize the @code{ido} group to change Ido functionality:
457 457
458@example 458@example
459M-x customize-group RET ido RET 459M-x customize-group @key{RET} ido @key{RET}
460@end example 460@end example
461 461
462@noindent 462@noindent
463or customize a certain variable: 463or customize a certain variable:
464 464
465@example 465@example
466M-x customize-variable RET ido-xxxxx 466M-x customize-variable @key{RET} ido-xxxxx @key{RET}
467@end example 467@end example
468 468
469To modify the keybindings, use the @code{ido-setup-hook}. For example: 469To modify the keybindings, use the @code{ido-setup-hook}. For example:
diff --git a/doc/misc/mairix-el.texi b/doc/misc/mairix-el.texi
index 906448c1028..8d620c720e6 100644
--- a/doc/misc/mairix-el.texi
+++ b/doc/misc/mairix-el.texi
@@ -169,13 +169,13 @@ the updates incrementally and hence is very fast.
169 169
170First, put @code{mairix.el} in your Emacs search path and put 170First, put @code{mairix.el} in your Emacs search path and put
171@code{(require 'mairix)} into your @file{.emacs} file. Then, use 171@code{(require 'mairix)} into your @file{.emacs} file. Then, use
172@kbd{M-x customize-group mairix RET} to set your preferences for 172@kbd{M-x customize-group @key{RET} mairix @key{RET}} to set your
173mairix.el. The most important items are @emph{Mairix File Path}, 173preferences for mairix.el. The most important items are @emph{Mairix
174@emph{Mairix Search File} and @emph{Mairix Mail Program}. The latter 174File Path}, @emph{Mairix Search File} and @emph{Mairix Mail Program}.
175specifies which mail program should be used to display the mairix search 175The latter specifies which mail program should be used to display the
176results. Currently, RMail, Gnus with mbox files, and VM are supported. 176mairix search results. Currently, RMail, Gnus with mbox files, and VM
177If you use Gnus with maildir or mh, use the native Gnus back end 177are supported. If you use Gnus with maildir or mh, use the native
178nnmairix instead. 178Gnus back end nnmairix instead.
179 179
180If you use another Emacs mail program which is not yet supported by 180If you use another Emacs mail program which is not yet supported by
181mairix.el, it is pretty easy to integrate it. @xref{Extending}, 181mairix.el, it is pretty easy to integrate it. @xref{Extending},
@@ -213,7 +213,6 @@ Here's a description of the available interactive functions:
213@table @code 213@table @code
214 214
215@item mairix-search 215@item mairix-search
216@kindex M-x mairix-search
217@findex mairix-search 216@findex mairix-search
218@vindex mairix-search-file 217@vindex mairix-search-file
219@vindex mairix-file-path 218@vindex mairix-file-path
@@ -229,7 +228,6 @@ is specified by the variable @code{mairix-command}, together with the options
229for making searching faster. 228for making searching faster.
230 229
231@item mairix-widget-search 230@item mairix-widget-search
232@kindex M-x mairix-widget-search
233@findex mairix-widget-search 231@findex mairix-widget-search
234@vindex mairix-widget-fields-list 232@vindex mairix-widget-fields-list
235Creates a mairix query using graphical widgets. Very handy if you're 233Creates a mairix query using graphical widgets. Very handy if you're
@@ -241,28 +239,24 @@ might want to include some other fields. This can be easily done by
241modifying @code{mairix-widget-fields-list}. 239modifying @code{mairix-widget-fields-list}.
242 240
243@item mairix-widget-search-based-on-article 241@item mairix-widget-search-based-on-article
244@kindex M-x mairix-widget-search-based-on-article
245@findex mairix-widget-search-based-on-article 242@findex mairix-widget-search-based-on-article
246Create a mairix query using graphical widgets, but based on the 243Create a mairix query using graphical widgets, but based on the
247currently displayed article, i.e., the available fields will be filled 244currently displayed article, i.e., the available fields will be filled
248with the current header values. 245with the current header values.
249 246
250@item mairix-search-from-this-article 247@item mairix-search-from-this-article
251@kindex M-x mairix-search-from-this-article
252@findex mairix-search-from-this-article 248@findex mairix-search-from-this-article
253Search messages from sender of the current article. This is effectively 249Search messages from sender of the current article. This is effectively
254a shortcut for calling @code{mairix-search} with @code{f:current_from}. 250a shortcut for calling @code{mairix-search} with @code{f:current_from}.
255If used with a prefix, include whole threads of the found messages. 251If used with a prefix, include whole threads of the found messages.
256 252
257@item mairix-search-thread-this-article 253@item mairix-search-thread-this-article
258@kindex M-x mairix-search-thread-this-article
259@findex mairix-search-thread-this-article 254@findex mairix-search-thread-this-article
260Search thread for the current article. This is effectively a shortcut 255Search thread for the current article. This is effectively a shortcut
261for calling @code{mairix-search} with @code{m:msgid} of the current article and 256for calling @code{mairix-search} with @code{m:msgid} of the current article and
262enabled threads. 257enabled threads.
263 258
264@item mairix-save-search 259@item mairix-save-search
265@kindex M-x mairix-save-search
266@findex mairix-save-search 260@findex mairix-save-search
267Save the last search for future use. You will have to specify a name 261Save the last search for future use. You will have to specify a name
268for the search and will then be asked if you want to save your saved 262for the search and will then be asked if you want to save your saved
@@ -272,13 +266,11 @@ your @file{.emacs}. You can also do this later by using
272@code{mairix-edit-saved-searches}. 266@code{mairix-edit-saved-searches}.
273 267
274@item mairix-use-saved-search 268@item mairix-use-saved-search
275@kindex M-x mairix-use-saved-search
276@findex mairix-use-saved-search 269@findex mairix-use-saved-search
277Call mairix with a previously saved search. You will be asked for the 270Call mairix with a previously saved search. You will be asked for the
278name of the saved search (use @kbd{TAB} for completion). 271name of the saved search (use @kbd{TAB} for completion).
279 272
280@item mairix-edit-saved-searches 273@item mairix-edit-saved-searches
281@kindex M-x mairix-edit-saved-searches
282@findex mairix-edit-saved-searches 274@findex mairix-edit-saved-searches
283Edit your current mairix searches. This is a simple major mode for 275Edit your current mairix searches. This is a simple major mode for
284editing the contents of the variable @code{mairix-saved-searches}. You 276editing the contents of the variable @code{mairix-saved-searches}. You
@@ -290,14 +282,12 @@ to open different searches at the same time, or if you want to regularly
290access certain searches without the need to call mairix. 282access certain searches without the need to call mairix.
291 283
292@item mairix-edit-saved-searches-customize 284@item mairix-edit-saved-searches-customize
293@kindex M-x mairix-edit-saved-searches-customize
294@findex mairix-edit-saved-searches-customize 285@findex mairix-edit-saved-searches-customize
295Edit the variable @code{mairix-saved-searches} in a normal customization 286Edit the variable @code{mairix-saved-searches} in a normal customization
296buffer. This function exists more or less for historic reasons, but 287buffer. This function exists more or less for historic reasons, but
297maybe you like it. 288maybe you like it.
298 289
299@item mairix-update-database 290@item mairix-update-database
300@kindex M-x mairix-update-database
301@findex mairix-update-database 291@findex mairix-update-database
302@vindex mairix-update-options 292@vindex mairix-update-options
303@vindex mairix-synchronous-update 293@vindex mairix-synchronous-update
diff --git a/doc/misc/message.texi b/doc/misc/message.texi
index 1ef67fe0cb2..0a2a6ce49d2 100644
--- a/doc/misc/message.texi
+++ b/doc/misc/message.texi
@@ -104,7 +104,7 @@ sending it.
104@end menu 104@end menu
105 105
106You can customize the Message Mode tool bar, see @kbd{M-x 106You can customize the Message Mode tool bar, see @kbd{M-x
107customize-apropos RET message-tool-bar}. This feature is only available 107customize-apropos @key{RET} message-tool-bar}. This feature is only available
108in Emacs. 108in Emacs.
109 109
110@node New Mail Message 110@node New Mail Message
@@ -707,14 +707,12 @@ This means that if the recipient supports RFC 2298 she might send you a
707notification that she received the message. 707notification that she received the message.
708 708
709@item M-x message-insert-importance-high 709@item M-x message-insert-importance-high
710@kindex M-x message-insert-importance-high
711@findex message-insert-importance-high 710@findex message-insert-importance-high
712@cindex Importance 711@cindex Importance
713Insert an @samp{Importance} header with a value of @samp{high}, 712Insert an @samp{Importance} header with a value of @samp{high},
714deleting headers if necessary. 713deleting headers if necessary.
715 714
716@item M-x message-insert-importance-low 715@item M-x message-insert-importance-low
717@kindex M-x message-insert-importance-low
718@findex message-insert-importance-low 716@findex message-insert-importance-low
719@cindex Importance 717@cindex Importance
720Insert an @samp{Importance} header with a value of @samp{low}, deleting 718Insert an @samp{Importance} header with a value of @samp{low}, deleting
@@ -921,7 +919,7 @@ is fully available) @acronym{IDNA} encoding happens automatically.
921 919
922@findex message-idna-to-ascii-rhs 920@findex message-idna-to-ascii-rhs
923If you want to experiment with the @acronym{IDNA} encoding, you can 921If you want to experiment with the @acronym{IDNA} encoding, you can
924invoke @kbd{M-x message-idna-to-ascii-rhs RET} in the message buffer 922invoke @kbd{M-x message-idna-to-ascii-rhs @key{RET}} in the message buffer
925to have the non-@acronym{ASCII} domain names encoded while you edit 923to have the non-@acronym{ASCII} domain names encoded while you edit
926the message. 924the message.
927 925
@@ -1084,7 +1082,7 @@ Since signing and especially encryption often is used when sensitive
1084information is sent, you may want to have some way to ensure that your 1082information is sent, you may want to have some way to ensure that your
1085mail is actually signed or encrypted. After invoking the above 1083mail is actually signed or encrypted. After invoking the above
1086sign/encrypt commands, it is possible to preview the raw article by 1084sign/encrypt commands, it is possible to preview the raw article by
1087using @kbd{C-u C-c RET P} (@code{mml-preview}). Then you can 1085using @kbd{C-u C-c @key{RET} P} (@code{mml-preview}). Then you can
1088verify that your long rant about what your ex-significant other or 1086verify that your long rant about what your ex-significant other or
1089whomever actually did with that funny looking person at that strange 1087whomever actually did with that funny looking person at that strange
1090party the other night, actually will be sent encrypted. 1088party the other night, actually will be sent encrypted.
@@ -1176,7 +1174,7 @@ without some kind of configuration. Especially, you need to tell it
1176where your private key and your certificate is stored. @acronym{MML} 1174where your private key and your certificate is stored. @acronym{MML}
1177uses an Emacs interface to OpenSSL, aptly named @code{smime.el}, and it 1175uses an Emacs interface to OpenSSL, aptly named @code{smime.el}, and it
1178contain a @code{custom} group used for this configuration. So, try 1176contain a @code{custom} group used for this configuration. So, try
1179@kbd{M-x customize-group RET smime RET} and look around. 1177@kbd{M-x customize-group @key{RET} smime @key{RET}} and look around.
1180 1178
1181Currently there is no support for talking to a CA (or RA) to create 1179Currently there is no support for talking to a CA (or RA) to create
1182your own certificate. None is planned either. You need to do this 1180your own certificate. None is planned either. You need to do this
@@ -1222,7 +1220,7 @@ according to two different standards, namely @acronym{PGP} or
1222@node Passphrase caching 1220@node Passphrase caching
1223@subsection Passphrase caching 1221@subsection Passphrase caching
1224 1222
1225@cindex gpg-agent 1223@cindex @command{gpg-agent}
1226Message with EasyPG internally calls GnuPG (the @command{gpg} or 1224Message with EasyPG internally calls GnuPG (the @command{gpg} or
1227@command{gpgsm} command) to perform 1225@command{gpgsm} command) to perform
1228data encryption, and in certain cases (decrypting or signing for 1226data encryption, and in certain cases (decrypting or signing for
@@ -1379,7 +1377,7 @@ end of the message (@code{message-kill-to-signature}).
1379Delete all text in the body of the message that is outside the region 1377Delete all text in the body of the message that is outside the region
1380(@code{message-delete-not-region}). 1378(@code{message-delete-not-region}).
1381 1379
1382@item M-RET 1380@item M-@key{RET}
1383@kindex M-RET 1381@kindex M-RET
1384@findex message-newline-and-reformat 1382@findex message-newline-and-reformat
1385Insert four newlines, and then reformat if inside quoted text. 1383Insert four newlines, and then reformat if inside quoted text.
@@ -1390,7 +1388,7 @@ Here's an example:
1390> This is some quoted text. And here's more quoted text. 1388> This is some quoted text. And here's more quoted text.
1391@end example 1389@end example
1392 1390
1393If point is before @samp{And} and you press @kbd{M-RET}, you'll get: 1391If point is before @samp{And} and you press @kbd{M-@key{RET}}, you'll get:
1394 1392
1395@example 1393@example
1396> This is some quoted text. 1394> This is some quoted text.
@@ -1408,12 +1406,12 @@ If point is before @samp{And} and you press @kbd{M-RET}, you'll get:
1408Rename the buffer (@code{message-rename-buffer}). If given a prefix, 1406Rename the buffer (@code{message-rename-buffer}). If given a prefix,
1409prompt for a new buffer name. 1407prompt for a new buffer name.
1410 1408
1411@item TAB 1409@item @key{TAB}
1412@kindex TAB 1410@kindex TAB
1413@findex message-tab 1411@findex message-tab
1414@vindex message-tab-body-function 1412@vindex message-tab-body-function
1415If @code{message-tab-body-function} is non-@code{nil}, execute the 1413If @code{message-tab-body-function} is non-@code{nil}, execute the
1416function it specifies. Otherwise use the function bound to @kbd{TAB} in 1414function it specifies. Otherwise use the function bound to @key{TAB} in
1417@code{text-mode-map} or @code{global-map}. 1415@code{text-mode-map} or @code{global-map}.
1418 1416
1419@end table 1417@end table
diff --git a/doc/misc/mh-e.texi b/doc/misc/mh-e.texi
index 5f0cc32cc48..74b17264d27 100644
--- a/doc/misc/mh-e.texi
+++ b/doc/misc/mh-e.texi
@@ -442,7 +442,7 @@ either @code{customize-option} or @code{add-hook}.
442@cindex point 442@cindex point
443@cindex region 443@cindex region
444@kindex C-@@ 444@kindex C-@@
445@kindex C-@key{SPC} 445@kindex C-SPC
446 446
447There are several other terms that are used in Emacs that you should 447There are several other terms that are used in Emacs that you should
448know. The @dfn{point} is where the cursor currently is. You can save 448know. The @dfn{point} is where the cursor currently is. You can save
@@ -692,7 +692,6 @@ get the big picture, and then you can read the manual as you wish.
692@cindex modes, MH-Letter 692@cindex modes, MH-Letter
693@cindex sending mail 693@cindex sending mail
694@findex mh-smail 694@findex mh-smail
695@kindex M-x mh-smail
696 695
697Let's start our tour by sending ourselves a message which we can later 696Let's start our tour by sending ourselves a message which we can later
698read and process. Enter @kbd{M-x mh-smail} to invoke the MH-E program 697read and process. Enter @kbd{M-x mh-smail} to invoke the MH-E program
@@ -762,7 +761,6 @@ message. Type @kbd{C-c C-c} now. That's all there is to it!
762@cindex modes, MH-Folder 761@cindex modes, MH-Folder
763@cindex reading mail 762@cindex reading mail
764@findex mh-rmail 763@findex mh-rmail
765@kindex M-x mh-rmail
766 764
767To read the mail you've just sent yourself, enter @kbd{M-x mh-rmail}. 765To read the mail you've just sent yourself, enter @kbd{M-x mh-rmail}.
768This incorporates the new mail and puts the output from 766This incorporates the new mail and puts the output from
@@ -777,7 +775,6 @@ major mode is MH-Folder.
777 775
778@findex mh-rmail 776@findex mh-rmail
779@kindex F r 777@kindex F r
780@kindex M-x mh-rmail
781 778
782@sp 1 779@sp 1
783@center @strong{NOTE} 780@center @strong{NOTE}
@@ -790,7 +787,7 @@ use @kbd{F r} to pull all your messages into MH-E.
790@end quotation 787@end quotation
791@sp 1 788@sp 1
792 789
793@kindex @key{RET} 790@kindex RET
794@kindex n 791@kindex n
795@kindex p 792@kindex p
796 793
@@ -820,8 +817,8 @@ This is a test message to get the wheels churning...
820@end cartouche 817@end cartouche
821@i{After incorporating new messages} 818@i{After incorporating new messages}
822 819
823@kindex @key{DEL} 820@kindex DEL
824@kindex @key{SPC} 821@kindex SPC
825 822
826If you typed a long message, you can view subsequent pages with 823If you typed a long message, you can view subsequent pages with
827@key{SPC} and previous pages with @key{DEL}. 824@key{SPC} and previous pages with @key{DEL}.
@@ -830,7 +827,7 @@ If you typed a long message, you can view subsequent pages with
830@section Processing Mail 827@section Processing Mail
831 828
832@cindex processing mail 829@cindex processing mail
833@kindex @key{RET} 830@kindex RET
834@kindex r 831@kindex r
835 832
836The first thing we want to do is reply to the message that we sent 833The first thing we want to do is reply to the message that we sent
@@ -883,7 +880,7 @@ Type C-c C-c to send message, C-c ? for help
883@kindex C-f 880@kindex C-f
884@kindex C-n 881@kindex C-n
885@kindex C-p 882@kindex C-p
886@kindex @key{BS} 883@kindex BS
887 884
888By default, MH will not add you to the address list of your replies, 885By default, MH will not add you to the address list of your replies,
889so if you find that the @samp{To:} header field is missing, don't 886so if you find that the @samp{To:} header field is missing, don't
@@ -898,7 +895,7 @@ editing your message, send it with @kbd{C-c C-c} as before.
898@cindex @command{refile} 895@cindex @command{refile}
899@cindex MH commands, @command{refile} 896@cindex MH commands, @command{refile}
900@cindex folders 897@cindex folders
901@kindex @key{SPC} 898@kindex SPC
902@kindex o 899@kindex o
903 900
904You'll often want to save messages that were sent to you in an 901You'll often want to save messages that were sent to you in an
@@ -918,7 +915,7 @@ in a moment.
918@cindex modes, MH-Folder 915@cindex modes, MH-Folder
919@kindex d 916@kindex d
920@kindex i 917@kindex i
921@kindex @key{RET} 918@kindex RET
922@kindex n 919@kindex n
923@kindex p 920@kindex p
924@kindex x 921@kindex x
@@ -935,7 +932,6 @@ command.
935 932
936@findex mh-smail 933@findex mh-smail
937@kindex m 934@kindex m
938@kindex M-x mh-smail
939 935
940If you want to send another message you can use @kbd{m} instead of 936If you want to send another message you can use @kbd{m} instead of
941@kbd{M-x mh-smail}. So go ahead, send some mail to your friends! 937@kbd{M-x mh-smail}. So go ahead, send some mail to your friends!
@@ -970,7 +966,6 @@ perform any refiles and deletes that you did there.
970@findex mh-rmail 966@findex mh-rmail
971@kindex C-x b 967@kindex C-x b
972@kindex C-x k 968@kindex C-x k
973@kindex M-x mh-rmail
974@kindex q 969@kindex q
975 970
976If you don't want to leave Emacs, you can type @kbd{q} to bury (hide) 971If you don't want to leave Emacs, you can type @kbd{q} to bury (hide)
@@ -1228,7 +1223,7 @@ Many commands that operate on individual messages, such as
1228@code{mh-forward} or @code{mh-refile-msg} take a @code{RANGE} 1223@code{mh-forward} or @code{mh-refile-msg} take a @code{RANGE}
1229argument. This argument can be used in several ways. 1224argument. This argument can be used in several ways.
1230 1225
1231@kindex C-u, with ranges 1226@kindex C-u@r{, with ranges}
1232 1227
1233If you provide the prefix argument @kbd{C-u} to these commands, then 1228If you provide the prefix argument @kbd{C-u} to these commands, then
1234you will be prompted for the message range. This can be any valid MH 1229you will be prompted for the message range. This can be any valid MH
@@ -1552,7 +1547,6 @@ the message numbers from outside of MH-E.
1552@findex mh-rmail 1547@findex mh-rmail
1553@kindex F r 1548@kindex F r
1554@kindex F v 1549@kindex F v
1555@kindex M-x mh-rmail
1556 1550
1557The MH-E entry point for reading mail is @kbd{M-x mh-rmail}. This 1551The MH-E entry point for reading mail is @kbd{M-x mh-rmail}. This
1558command incorporates your mail and creates a buffer called 1552command incorporates your mail and creates a buffer called
@@ -1592,38 +1586,38 @@ Display cheat sheet for the MH-E commands (@code{mh-help}).
1592@c ------------------------- 1586@c -------------------------
1593@cindex @samp{Message > Show Message} menu item 1587@cindex @samp{Message > Show Message} menu item
1594@cindex menu item, @samp{Message > Show Message} 1588@cindex menu item, @samp{Message > Show Message}
1595@kindex @key{RET} 1589@kindex RET
1596@findex mh-show 1590@findex mh-show
1597@item @key{RET} 1591@item @key{RET}
1598Display message (@code{mh-show}). 1592Display message (@code{mh-show}).
1599@c ------------------------- 1593@c -------------------------
1600@cindex @samp{Message > Show Message with Header} menu item 1594@cindex @samp{Message > Show Message with Header} menu item
1601@cindex menu item, @samp{Message > Show Message with Header} 1595@cindex menu item, @samp{Message > Show Message with Header}
1602@kindex , (comma) 1596@kindex , @r{(comma)}
1603@findex mh-header-display 1597@findex mh-header-display
1604@item , (comma) 1598@item , (comma)
1605Display message with all header fields (@code{mh-header-display}). 1599Display message with all header fields (@code{mh-header-display}).
1606@c ------------------------- 1600@c -------------------------
1607@cindex @samp{Message > Show Message with Preferred Alternative} menu item 1601@cindex @samp{Message > Show Message with Preferred Alternative} menu item
1608@cindex menu item, @samp{Message > Show Message with Preferred Alternative} 1602@cindex menu item, @samp{Message > Show Message with Preferred Alternative}
1609@kindex : (colon) 1603@kindex : @r{(colon)}
1610@findex mh-show-preferred-alternative 1604@findex mh-show-preferred-alternative
1611@item : (colon) 1605@item : (colon)
1612Display message with the default preferred alternative 1606Display message with the default preferred alternative
1613(@code{mh-show-preferred-alternative}). 1607(@code{mh-show-preferred-alternative}).
1614@c ------------------------- 1608@c -------------------------
1615@kindex ; (semicolon) 1609@kindex ; @r{(semicolon)}
1616@findex mh-toggle-mh-decode-mime-flag 1610@findex mh-toggle-mh-decode-mime-flag
1617@item ; (semicolon) 1611@item ; (semicolon)
1618Toggle the value of @code{mh-decode-mime-flag} 1612Toggle the value of @code{mh-decode-mime-flag}
1619(@code{mh-toggle-mh-decode-mime-flag}). 1613(@code{mh-toggle-mh-decode-mime-flag}).
1620@c ------------------------- 1614@c -------------------------
1621@kindex @key{SPC} 1615@kindex SPC
1622@findex mh-page-msg 1616@findex mh-page-msg
1623@item @key{SPC} 1617@item @key{SPC}
1624Display next page in message (@code{mh-page-msg}). 1618Display next page in message (@code{mh-page-msg}).
1625@c ------------------------- 1619@c -------------------------
1626@kindex @key{BS} 1620@kindex BS
1627@findex mh-previous-page 1621@findex mh-previous-page
1628@item @key{BS} 1622@item @key{BS}
1629Display previous page in message (@code{mh-previous-page}). 1623Display previous page in message (@code{mh-previous-page}).
@@ -1661,12 +1655,12 @@ Delete range (@code{mh-delete-msg}).
1661Display cheat sheet for the commands of the current prefix in 1655Display cheat sheet for the commands of the current prefix in
1662minibuffer (@code{mh-prefix-help}). 1656minibuffer (@code{mh-prefix-help}).
1663@c ------------------------- 1657@c -------------------------
1664@kindex D @key{SPC} 1658@kindex D SPC
1665@findex mh-page-digest 1659@findex mh-page-digest
1666@item D @key{SPC} 1660@item D @key{SPC}
1667Display next message in digest (@code{mh-page-digest}). 1661Display next message in digest (@code{mh-page-digest}).
1668@c ------------------------- 1662@c -------------------------
1669@kindex D @key{BS} 1663@kindex D BS
1670@findex mh-page-digest-backwards 1664@findex mh-page-digest-backwards
1671@item D @key{BS} 1665@item D @key{BS}
1672Display previous message in digest (@code{mh-page-digest-backwards}). 1666Display previous message in digest (@code{mh-page-digest-backwards}).
@@ -1697,12 +1691,12 @@ Delete messages with same subject or thread
1697Display cheat sheet for the commands of the current prefix in 1691Display cheat sheet for the commands of the current prefix in
1698minibuffer (@code{mh-prefix-help}). 1692minibuffer (@code{mh-prefix-help}).
1699@c ------------------------- 1693@c -------------------------
1700@kindex K @key{TAB} 1694@kindex K TAB
1701@findex mh-next-button 1695@findex mh-next-button
1702@item K @key{TAB} 1696@item K @key{TAB}
1703Go to the next button (@code{mh-next-button}). 1697Go to the next button (@code{mh-next-button}).
1704@c ------------------------- 1698@c -------------------------
1705@kindex K S-@key{TAB} 1699@kindex K S-TAB
1706@findex mh-prev-button 1700@findex mh-prev-button
1707@item K S-@key{TAB} 1701@item K S-@key{TAB}
1708Go to the previous button (@code{mh-prev-button}). 1702Go to the previous button (@code{mh-prev-button}).
@@ -1844,7 +1838,7 @@ Move point to mouse event and show message (@code{mh-show-mouse}).
1844Within the MH-Show buffer, the following command is defined. 1838Within the MH-Show buffer, the following command is defined.
1845 1839
1846@table @kbd 1840@table @kbd
1847@kindex @key{RET} 1841@kindex RET
1848@kindex mouse-1 1842@kindex mouse-1
1849@kindex mouse-2 1843@kindex mouse-2
1850@findex mh-press-button 1844@findex mh-press-button
@@ -2017,11 +2011,11 @@ detail in the following sections.
2017@findex mh-previous-page 2011@findex mh-previous-page
2018@findex mh-show 2012@findex mh-show
2019@findex mh-show-mouse 2013@findex mh-show-mouse
2020@kindex , (comma) 2014@kindex , @r{(comma)}
2021@kindex . (period) 2015@kindex . @r{(period)}
2022@kindex @key{BS} 2016@kindex BS
2023@kindex @key{RET} 2017@kindex RET
2024@kindex @key{SPC} 2018@kindex SPC
2025@kindex mouse-2 2019@kindex mouse-2
2026 2020
2027The command @key{RET} (@code{mh-show}) displays the message that the 2021The command @key{RET} (@code{mh-show}) displays the message that the
@@ -2101,9 +2095,9 @@ Emacs 21 and XEmacs. For more information, see
2101@uref{http://quimby.gnus.org/circus/face/}.}. 2095@uref{http://quimby.gnus.org/circus/face/}.}.
2102 2096
2103@cindex @command{uncompface} 2097@cindex @command{uncompface}
2104@cindex Emacs, packages, x-face 2098@cindex Emacs, packages, @samp{x-face}
2105@cindex Unix commands, @command{uncompface} 2099@cindex Unix commands, @command{uncompface}
2106@cindex x-face package 2100@cindex @samp{x-face} package
2107@vindex mh-show-xface 2101@vindex mh-show-xface
2108 2102
2109Next is the traditional @samp{X-Face:} header field@footnote{The 2103Next is the traditional @samp{X-Face:} header field@footnote{The
@@ -2200,7 +2194,7 @@ highlighting of citations entirely, choose @samp{None}.
2200@cindex highlighting email addresses 2194@cindex highlighting email addresses
2201@cindex links, following 2195@cindex links, following
2202@findex goto-address-at-point 2196@findex goto-address-at-point
2203@kindex C-c @key{RET} 2197@kindex C-c RET
2204@kindex mouse-2 2198@kindex mouse-2
2205@vindex goto-address-highlight-p 2199@vindex goto-address-highlight-p
2206 2200
@@ -2306,10 +2300,10 @@ System: type @kbd{M-! xterm -e mhshow @var{message-number}}. You can
2306leave out the @samp{xterm -e} if you use @command{mhlist} or 2300leave out the @samp{xterm -e} if you use @command{mhlist} or
2307@command{mhstore}.}. 2301@command{mhstore}.}.
2308 2302
2309@cindex Emacs, packages, mm-decode 2303@cindex Emacs, packages, @samp{mm-decode}
2310@cindex mm-decode package 2304@cindex @samp{mm-decode} package
2311@findex mh-toggle-mh-decode-mime-flag 2305@findex mh-toggle-mh-decode-mime-flag
2312@kindex ; (semicolon) 2306@kindex ; @r{(semicolon)}
2313@vindex mh-decode-mime-flag 2307@vindex mh-decode-mime-flag
2314 2308
2315MH-E can handle attachments as well if the Gnus @samp{mm-decode} 2309MH-E can handle attachments as well if the Gnus @samp{mm-decode}
@@ -2334,9 +2328,9 @@ Attachments in MH-E are indicated by @dfn{buttons} like this:
2334@findex mh-next-button 2328@findex mh-next-button
2335@findex mh-press-button 2329@findex mh-press-button
2336@findex mh-prev-button 2330@findex mh-prev-button
2337@kindex @key{RET} 2331@kindex RET
2338@kindex K @key{TAB} 2332@kindex K TAB
2339@kindex K S-@key{TAB} 2333@kindex K S-TAB
2340@kindex mouse-1 2334@kindex mouse-1
2341@kindex mouse-2 2335@kindex mouse-2
2342 2336
@@ -2490,7 +2484,7 @@ the option @code{mm-discouraged-alternatives}, and add
2490@samp{text/html}. The next best alternative, if any, will be shown. 2484@samp{text/html}. The next best alternative, if any, will be shown.
2491 2485
2492@findex mh-show-preferred-alternative 2486@findex mh-show-preferred-alternative
2493@kindex : (colon) 2487@kindex : @r{(colon)}
2494 2488
2495Occasionally, though, you might want to see the preferred alternative. 2489Occasionally, though, you might want to see the preferred alternative.
2496The command @kbd{:} (@code{mh-show-preferred-alternative}) displays 2490The command @kbd{:} (@code{mh-show-preferred-alternative}) displays
@@ -2688,10 +2682,10 @@ buffer, including HTML buffers.
2688@cindex digests 2682@cindex digests
2689@findex mh-page-digest 2683@findex mh-page-digest
2690@findex mh-page-digest-backwards 2684@findex mh-page-digest-backwards
2691@kindex D @key{BS} 2685@kindex D BS
2692@kindex D @key{SPC} 2686@kindex D SPC
2693@kindex @key{BS} 2687@kindex BS
2694@kindex @key{SPC} 2688@kindex SPC
2695 2689
2696A digest is a message that contains other messages. Special MH-E 2690A digest is a message that contains other messages. Special MH-E
2697commands let you read digests conveniently. You can use @key{SPC} and 2691commands let you read digests conveniently. You can use @key{SPC} and
@@ -2904,8 +2898,8 @@ Another related function is the command @kbd{P F}
2904faces and not. When faces are enabled, the printed message will look 2898faces and not. When faces are enabled, the printed message will look
2905very similar to the message in the MH-Show buffer. 2899very similar to the message in the MH-Show buffer.
2906 2900
2907@cindex ps-print package 2901@cindex @samp{ps-print} package
2908@cindex Emacs, packages, ps-print 2902@cindex Emacs, packages, @samp{ps-print}
2909 2903
2910MH-E uses the @samp{ps-print} package to do the printing, so you can 2904MH-E uses the @samp{ps-print} package to do the printing, so you can
2911customize the printing further by going to the @samp{ps-print} 2905customize the printing further by going to the @samp{ps-print}
@@ -2995,7 +2989,7 @@ like to change the initial default directory, customize the option
2995directory for storing the content of these messages. 2989directory for storing the content of these messages.
2996 2990
2997@findex mh-store-buffer 2991@findex mh-store-buffer
2998@kindex @key{RET} 2992@kindex RET
2999@kindex X s 2993@kindex X s
3000 2994
3001By the way, @kbd{X s} calls the Emacs Lisp function 2995By the way, @kbd{X s} calls the Emacs Lisp function
@@ -3045,7 +3039,7 @@ message with @kbd{M-<} (@code{mh-first-msg}) and @kbd{M->}
3045@findex previous-line 3039@findex previous-line
3046@kindex C-n 3040@kindex C-n
3047@kindex C-p 3041@kindex C-p
3048@kindex @key{RET} 3042@kindex RET
3049 3043
3050You can also use the Emacs commands @kbd{C-p} (@code{previous-line}) 3044You can also use the Emacs commands @kbd{C-p} (@code{previous-line})
3051and @kbd{C-n} (@code{next-line}) to move up and down the scan lines in 3045and @kbd{C-n} (@code{next-line}) to move up and down the scan lines in
@@ -3746,7 +3740,7 @@ The command @kbd{F p} runs @code{mh-pack-folder-hook} after
3746renumbering the messages. A variable that is useful with this hook 3740renumbering the messages. A variable that is useful with this hook
3747is @code{mh-current-folder}. 3741is @code{mh-current-folder}.
3748 3742
3749@kindex @key{TAB} 3743@kindex TAB
3750@vindex mh-recursive-folders-flag 3744@vindex mh-recursive-folders-flag
3751 3745
3752By default, operations on folders work only one level at a time. Set 3746By default, operations on folders work only one level at a time. Set
@@ -3850,16 +3844,15 @@ buffers that you would rather remove, you can use both
3850 3844
3851You can use dired to manipulate the folders themselves. For example, I 3845You can use dired to manipulate the folders themselves. For example, I
3852renamed my @samp{+out} folder to the more common @samp{+outbox} by 3846renamed my @samp{+out} folder to the more common @samp{+outbox} by
3853running dired on my mail directory (@kbd{M-x dired RET ~/Mail RET}), 3847running dired on my mail directory (@kbd{M-x dired @key{RET} ~/Mail
3854moving my cursor to @samp{out} and using the command @kbd{R} 3848@key{RET}}), moving my cursor to @samp{out} and using the command
3855(@code{dired-do-rename}). 3849@kbd{R} (@code{dired-do-rename}).
3856 3850
3857@node Sending Mail, Editing Drafts, Folders, Top 3851@node Sending Mail, Editing Drafts, Folders, Top
3858@chapter Sending Mail 3852@chapter Sending Mail
3859 3853
3860@cindex sending mail 3854@cindex sending mail
3861@findex mh-smail 3855@findex mh-smail
3862@kindex M-x mh-smail
3863 3856
3864You can send a mail message in several ways. You can call @kbd{M-x 3857You can send a mail message in several ways. You can call @kbd{M-x
3865mh-smail} directly, or from the command line like this: 3858mh-smail} directly, or from the command line like this:
@@ -4027,8 +4020,6 @@ more detail in the following sections.
4027@cindex sending mail 4020@cindex sending mail
4028@findex mh-smail 4021@findex mh-smail
4029@findex mh-smail-other-window 4022@findex mh-smail-other-window
4030@kindex M-x mh-smail
4031@kindex M-x mh-smail-other-window
4032 4023
4033Outside of an MH-Folder buffer, you must call either @kbd{M-x 4024Outside of an MH-Folder buffer, you must call either @kbd{M-x
4034mh-smail} or @kbd{M-x mh-smail-other-window} to compose a new message. 4025mh-smail} or @kbd{M-x mh-smail-other-window} to compose a new message.
@@ -4390,28 +4381,28 @@ commands in addition to the normal Emacs editing commands to help you
4390edit your draft. These can also be found in the @samp{Letter} menu. 4381edit your draft. These can also be found in the @samp{Letter} menu.
4391 4382
4392@table @kbd 4383@table @kbd
4393@kindex @key{SPC} 4384@kindex SPC
4394@findex mh-letter-complete-or-space 4385@findex mh-letter-complete-or-space
4395@item @key{SPC} 4386@item @key{SPC}
4396Perform completion or insert space (@code{mh-letter-complete-or-space}). 4387Perform completion or insert space (@code{mh-letter-complete-or-space}).
4397@c ------------------------- 4388@c -------------------------
4398@kindex M-@key{TAB} 4389@kindex M-TAB
4399@findex mh-letter-complete 4390@findex mh-letter-complete
4400@item M-@key{TAB} 4391@item M-@key{TAB}
4401Perform completion on header field or word preceding point 4392Perform completion on header field or word preceding point
4402(@code{mh-letter-complete}). 4393(@code{mh-letter-complete}).
4403@c ------------------------- 4394@c -------------------------
4404@kindex , (comma) 4395@kindex , @r{(comma)}
4405@findex mh-letter-confirm-address 4396@findex mh-letter-confirm-address
4406@item , (comma) 4397@item , (comma)
4407Flash alias expansion (@code{mh-letter-confirm-address}). 4398Flash alias expansion (@code{mh-letter-confirm-address}).
4408@c ------------------------- 4399@c -------------------------
4409@kindex @key{TAB} 4400@kindex TAB
4410@findex mh-letter-next-header-field-or-indent 4401@findex mh-letter-next-header-field-or-indent
4411@item @key{TAB} 4402@item @key{TAB}
4412Cycle to next field (@code{mh-letter-next-header-field-or-indent}). 4403Cycle to next field (@code{mh-letter-next-header-field-or-indent}).
4413@c ------------------------- 4404@c -------------------------
4414@kindex S-@key{TAB} 4405@kindex S-TAB
4415@findex mh-letter-previous-header-field 4406@findex mh-letter-previous-header-field
4416@item S-@key{TAB} 4407@item S-@key{TAB}
4417Cycle to the previous header field 4408Cycle to the previous header field
@@ -4816,8 +4807,8 @@ draft. @xref{Folder Selection}.
4816@findex indent-relative 4807@findex indent-relative
4817@findex mh-letter-next-header-field-or-indent 4808@findex mh-letter-next-header-field-or-indent
4818@findex mh-letter-previous-header-field 4809@findex mh-letter-previous-header-field
4819@kindex @key{TAB} 4810@kindex TAB
4820@kindex S-@key{TAB} 4811@kindex S-TAB
4821@vindex mh-compose-skipped-header-fields 4812@vindex mh-compose-skipped-header-fields
4822@vindex mh-letter-header-field 4813@vindex mh-letter-header-field
4823 4814
@@ -4842,9 +4833,9 @@ take point to the last field from anywhere in the body.
4842@findex mh-letter-complete 4833@findex mh-letter-complete
4843@findex mh-letter-complete-or-space 4834@findex mh-letter-complete-or-space
4844@findex mh-letter-confirm-address 4835@findex mh-letter-confirm-address
4845@kindex , (comma) 4836@kindex , @r{(comma)}
4846@kindex @key{SPC} 4837@kindex SPC
4847@kindex M-@key{TAB} 4838@kindex M-TAB
4848@vindex mh-alias-flash-on-comma 4839@vindex mh-alias-flash-on-comma
4849@vindex mh-compose-space-does-completion-flag 4840@vindex mh-compose-space-does-completion-flag
4850@vindex mh-letter-complete-function 4841@vindex mh-letter-complete-function
@@ -4997,8 +4988,8 @@ You can also turn on the @code{mh-delete-yanked-msg-window-flag}
4997option to delete the window containing the original message after 4988option to delete the window containing the original message after
4998yanking it to make more room on your screen for your reply. 4989yanking it to make more room on your screen for your reply.
4999 4990
5000@cindex Emacs, packages, supercite 4991@cindex Emacs, packages, @samp{supercite}
5001@cindex supercite package 4992@cindex @samp{supercite} package
5002@kindex r 4993@kindex r
5003@vindex mail-citation-hook 4994@vindex mail-citation-hook
5004@vindex mh-yank-behavior 4995@vindex mh-yank-behavior
@@ -5061,8 +5052,8 @@ and it should leave point and mark around the modified citation text
5061for the next hook function. The standard prefix 5052for the next hook function. The standard prefix
5062@code{mh-ins-buf-prefix} is not added if this hook is set. 5053@code{mh-ins-buf-prefix} is not added if this hook is set.
5063 5054
5064@cindex Emacs, packages, trivial-cite 5055@cindex Emacs, packages, @samp{trivial-cite}
5065@cindex trivial-cite package 5056@cindex @samp{trivial-cite} package
5066@vindex mh-yank-behavior 5057@vindex mh-yank-behavior
5067 5058
5068For example, if you use the hook function 5059For example, if you use the hook function
@@ -5499,7 +5490,7 @@ LyogWFBNICovCnN0YXRpYyBjaGFyICogc2V0aWF0aG9tZV94cG1bXSA9IHsKIjQ1IDQ1IDc2N
5499@end cartouche 5490@end cartouche
5500@i{MH-E @sc{mime} draft ready to send} 5491@i{MH-E @sc{mime} draft ready to send}
5501 5492
5502@cindex undo effects of mh-mml-to-mime 5493@cindex undo effects of @code{mh-mml-to-mime}
5503 5494
5504This action can be undone by running @kbd{C-_} (@code{undo}). 5495This action can be undone by running @kbd{C-_} (@code{undo}).
5505 5496
@@ -5507,7 +5498,7 @@ This action can be undone by running @kbd{C-_} (@code{undo}).
5507@cindex @command{mhn} 5498@cindex @command{mhn}
5508@cindex MH commands, @command{mhbuild} 5499@cindex MH commands, @command{mhbuild}
5509@cindex MH commands, @command{mhn} 5500@cindex MH commands, @command{mhn}
5510@cindex undo effects of mh-mh-to-mime 5501@cindex undo effects of @code{mh-mh-to-mime}
5511@findex mh-mh-to-mime 5502@findex mh-mh-to-mime
5512@findex mh-mh-to-mime-undo 5503@findex mh-mh-to-mime-undo
5513@kindex C-c C-e 5504@kindex C-c C-e
@@ -5723,12 +5714,12 @@ The following commands are available in MH-Letter mode with the
5723exception of @code{mh-alias-reload} which can be called from anywhere. 5714exception of @code{mh-alias-reload} which can be called from anywhere.
5724 5715
5725@table @kbd 5716@table @kbd
5726@kindex @key{SPC} 5717@kindex SPC
5727@findex mh-letter-complete-or-space 5718@findex mh-letter-complete-or-space
5728@item @key{SPC} 5719@item @key{SPC}
5729Perform completion or insert space (@code{mh-letter-complete-or-space}). 5720Perform completion or insert space (@code{mh-letter-complete-or-space}).
5730@c ------------------------- 5721@c -------------------------
5731@kindex M-@key{TAB} 5722@kindex M-TAB
5732@findex mh-letter-complete 5723@findex mh-letter-complete
5733@item M-@key{TAB} 5724@item M-@key{TAB}
5734Perform completion on header field or word preceding point 5725Perform completion on header field or word preceding point
@@ -5800,7 +5791,7 @@ Hook run by @code{mh-alias-reload} after loading aliases (default:
5800You can use aliases when you are adding recipients to a message. 5791You can use aliases when you are adding recipients to a message.
5801 5792
5802@findex minibuffer-complete 5793@findex minibuffer-complete
5803@kindex @key{TAB} 5794@kindex TAB
5804@vindex mh-alias-expand-aliases-flag 5795@vindex mh-alias-expand-aliases-flag
5805@vindex mh-compose-prompt-flag 5796@vindex mh-compose-prompt-flag
5806 5797
@@ -5814,8 +5805,8 @@ aliases to be expanded to their respective addresses in the draft.
5814 5805
5815@findex mh-letter-complete 5806@findex mh-letter-complete
5816@findex mh-letter-complete-or-space 5807@findex mh-letter-complete-or-space
5817@kindex @key{SPC} 5808@kindex SPC
5818@kindex M-@key{TAB} 5809@kindex M-TAB
5819 5810
5820Otherwise, you can complete aliases in the header of the draft with 5811Otherwise, you can complete aliases in the header of the draft with
5821@kbd{M-@key{TAB}} (@code{mh-letter-complete}) or @key{SPC} 5812@kbd{M-@key{TAB}} (@code{mh-letter-complete}) or @key{SPC}
@@ -5934,7 +5925,6 @@ executed to generate the password file. For example, use @samp{ypcat
5934passwd} to obtain the NIS password file. 5925passwd} to obtain the NIS password file.
5935 5926
5936@findex mh-alias-reload 5927@findex mh-alias-reload
5937@kindex M-x mh-alias-reload
5938@vindex mh-alias-reloaded-hook 5928@vindex mh-alias-reloaded-hook
5939 5929
5940Since aliases are updated frequently, MH-E reloads aliases 5930Since aliases are updated frequently, MH-E reloads aliases
@@ -5950,7 +5940,6 @@ listed in your @samp{Aliasfile:} profile component. MH-E provides
5950other methods for maintaining your alias file(s). 5940other methods for maintaining your alias file(s).
5951 5941
5952@findex mh-alias-add-alias 5942@findex mh-alias-add-alias
5953@kindex M-x mh-alias-add-alias
5954 5943
5955You can use the @kbd{M-x mh-alias-add-alias} command which will prompt 5944You can use the @kbd{M-x mh-alias-add-alias} command which will prompt
5956you for the alias and address that you would like to add. If the alias 5945you for the alias and address that you would like to add. If the alias
@@ -5985,9 +5974,6 @@ Using prefixes instead of postfixes helps you explore aliases during
5985completion. If you forget the name of an old dive buddy, you can enter 5974completion. If you forget the name of an old dive buddy, you can enter
5986@samp{div} and then @key{SPC} to get a listing of all your dive buddies. 5975@samp{div} and then @key{SPC} to get a listing of all your dive buddies.
5987 5976
5988@kindex M-x mh-alias-add-address-under-point
5989@kindex M-x mh-alias-grab-from-field
5990
5991An alias for the sender of the current message is added automatically 5977An alias for the sender of the current message is added automatically
5992by clicking on the @samp{Grab From alias} tool bar button or by running 5978by clicking on the @samp{Grab From alias} tool bar button or by running
5993the @kbd{M-x mh-alias-grab-from-field} command. Aliases for other 5979the @kbd{M-x mh-alias-grab-from-field} command. Aliases for other
@@ -6021,7 +6007,6 @@ more appropriate.
6021 6007
6022@cindex regular expressions, @code{mh-alias-apropos} 6008@cindex regular expressions, @code{mh-alias-apropos}
6023@findex mh-alias-apropos 6009@findex mh-alias-apropos
6024@kindex M-x mh-alias-apropos
6025 6010
6026If you can't quite remember an alias, you can use @kbd{M-x 6011If you can't quite remember an alias, you can use @kbd{M-x
6027mh-alias-apropos} to show all aliases or addresses that match a 6012mh-alias-apropos} to show all aliases or addresses that match a
@@ -6281,7 +6266,6 @@ containing the value for the field is given.
6281@cindex speedbar 6266@cindex speedbar
6282@findex mh-visit-folder 6267@findex mh-visit-folder
6283@kindex F v 6268@kindex F v
6284@kindex M-x speedbar
6285@kindex mouse-2 6269@kindex mouse-2
6286 6270
6287You can also use the speedbar 6271You can also use the speedbar
@@ -6623,12 +6607,12 @@ Another few commands are available in the MH-Folder buffer resulting
6623from a search. 6607from a search.
6624 6608
6625@table @kbd 6609@table @kbd
6626@kindex @key{TAB} 6610@kindex TAB
6627@findex mh-index-next-folder 6611@findex mh-index-next-folder
6628@item @key{TAB} 6612@item @key{TAB}
6629Jump to the next folder marker (@code{mh-index-next-folder}). 6613Jump to the next folder marker (@code{mh-index-next-folder}).
6630@c ------------------------- 6614@c -------------------------
6631@kindex S-@key{TAB} 6615@kindex S-TAB
6632@findex mh-index-previous-folder 6616@findex mh-index-previous-folder
6633@item S-@key{TAB} 6617@item S-@key{TAB}
6634Jump to the previous folder marker (@code{mh-index-previous-folder}). 6618Jump to the previous folder marker (@code{mh-index-previous-folder}).
@@ -6773,8 +6757,8 @@ method with the pick method by running the command @kbd{C-c C-p}
6773@cindex @samp{+mhe-index} 6757@cindex @samp{+mhe-index}
6774@findex mh-index-next-folder 6758@findex mh-index-next-folder
6775@findex mh-index-previous-folder 6759@findex mh-index-previous-folder
6776@kindex @key{TAB} 6760@kindex TAB
6777@kindex S-@key{TAB} 6761@kindex S-TAB
6778@vindex mh-search-folder 6762@vindex mh-search-folder
6779 6763
6780The messages that are found are put in a temporary sub-folder of 6764The messages that are found are put in a temporary sub-folder of
@@ -7514,7 +7498,6 @@ Mail}).
7514@cindex sequence, @samp{cur} 7498@cindex sequence, @samp{cur}
7515@cindex sequence, @samp{tick} 7499@cindex sequence, @samp{tick}
7516@findex mh-update-sequences 7500@findex mh-update-sequences
7517@kindex M-x mh-update-sequences
7518@kindex q 7501@kindex q
7519@kindex x 7502@kindex x
7520@vindex mh-tick-seq 7503@vindex mh-tick-seq
@@ -8001,7 +7984,6 @@ system.
8001@cindex MH-E version 7984@cindex MH-E version
8002@cindex @file{*MH-E Info*} 7985@cindex @file{*MH-E Info*}
8003@cindex version 7986@cindex version
8004@kindex M-x mh-version
8005 7987
8006One command worth noting is @kbd{M-x mh-version}. You can compare the 7988One command worth noting is @kbd{M-x mh-version}. You can compare the
8007version this command prints to the latest release (@pxref{Getting 7989version this command prints to the latest release (@pxref{Getting
@@ -8716,7 +8698,6 @@ I also point out some additional sources of information.
8716 8698
8717@cindex bugs 8699@cindex bugs
8718@cindex SourceForge 8700@cindex SourceForge
8719@kindex M-x mh-version
8720 8701
8721Bug reports should be filed at 8702Bug reports should be filed at
8722@uref{https://sourceforge.net/p/mh-e/bugs/, SourceForge}. You need to 8703@uref{https://sourceforge.net/p/mh-e/bugs/, SourceForge}. You need to
@@ -8792,7 +8773,6 @@ instead.
8792@cindex news 8773@cindex news
8793@cindex @samp{MH-E-NEWS} 8774@cindex @samp{MH-E-NEWS}
8794@cindex @samp{README} 8775@cindex @samp{README}
8795@kindex M-x mh-version
8796 8776
8797After you download and extract the MH-E tarball, read the 8777After you download and extract the MH-E tarball, read the
8798@file{README} file and @file{MH-E-NEWS}. These correspond to the 8778@file{README} file and @file{MH-E-NEWS}. These correspond to the
diff --git a/doc/misc/newsticker.texi b/doc/misc/newsticker.texi
index 43d248bc7dc..ac29ced8fb7 100644
--- a/doc/misc/newsticker.texi
+++ b/doc/misc/newsticker.texi
@@ -239,17 +239,17 @@ The position of groups and feeds within the tree can be changed with these
239commands: 239commands:
240 240
241@table @kbd 241@table @kbd
242@item M-up 242@item M-@key{UP}
243@itemx M-down 243@itemx M-@key{DOWN}
244@kindex M-up 244@kindex M-UP
245@kindex M-down 245@kindex M-DOWN
246@findex newsticker-group-shift-feed-up 246@findex newsticker-group-shift-feed-up
247@findex newsticker-group-shift-feed-down 247@findex newsticker-group-shift-feed-down
248Shift the currently selected feed up and down within its group. 248Shift the currently selected feed up and down within its group.
249@item M-S-up 249@item M-S-@key{UP}
250@itemx M-S-down 250@itemx M-S-@key{DOWN}
251@kindex M-S-up 251@kindex M-S-UP
252@kindex M-S-down 252@kindex M-S-DOWN
253@findex newsticker-group-shift-group-up 253@findex newsticker-group-shift-group-up
254@findex newsticker-group-shift-group-down 254@findex newsticker-group-shift-group-down
255Shift the currently selected group up and down within its parent group. 255Shift the currently selected group up and down within its parent group.
@@ -397,8 +397,8 @@ Mark current item as immortal. Immortal items are kept forever.
397@table @kbd 397@table @kbd
398@cindex Get News 398@cindex Get News
399@item v 399@item v
400@itemx RET 400@itemx @key{RET}
401@itemx <mouse-1> 401@itemx mouse-1
402@findex newsticker-treeview-browse-url 402@findex newsticker-treeview-browse-url
403Open the link to the full article (as contained in the current 403Open the link to the full article (as contained in the current
404headline) in your web browser @code{newsticker-treeview-browse-url}). 404headline) in your web browser @code{newsticker-treeview-browse-url}).
diff --git a/doc/misc/org.texi b/doc/misc/org.texi
index 17931905f1a..4434636b7f2 100644
--- a/doc/misc/org.texi
+++ b/doc/misc/org.texi
@@ -749,7 +749,7 @@ Specific header arguments
749 749
750Miscellaneous 750Miscellaneous
751 751
752* Completion:: M-TAB guesses completions 752* Completion:: M-@key{TAB} guesses completions
753* Easy templates:: Quick insertion of structural elements 753* Easy templates:: Quick insertion of structural elements
754* Speed keys:: Electric commands at the beginning of a headline 754* Speed keys:: Electric commands at the beginning of a headline
755* Code evaluation security:: Org mode files evaluate inline code 755* Code evaluation security:: Org mode files evaluate inline code
@@ -884,7 +884,8 @@ We @b{strongly recommend} to stick to a single installation method.
884@subsubheading Using Emacs packaging system 884@subsubheading Using Emacs packaging system
885 885
886Recent Emacs distributions include a packaging system which lets you install 886Recent Emacs distributions include a packaging system which lets you install
887Elisp libraries. You can install Org with @kbd{M-x package-install RET org}. 887Elisp libraries. You can install Org with @kbd{M-x package-install @key{RET}
888org}.
888 889
889@noindent @b{Important}: you need to do this in a session where no @code{.org} file has 890@noindent @b{Important}: you need to do this in a session where no @code{.org} file has
890been visited, i.e., where no Org built-in function have been loaded. 891been visited, i.e., where no Org built-in function have been loaded.
@@ -1011,10 +1012,10 @@ version of Org available---if you are running an outdated version, it is
1011quite possible that the bug has been fixed already. If the bug persists, 1012quite possible that the bug has been fixed already. If the bug persists,
1012prepare a report and provide as much information as possible, including the 1013prepare a report and provide as much information as possible, including the
1013version information of Emacs (@kbd{M-x emacs-version @key{RET}}) and Org 1014version information of Emacs (@kbd{M-x emacs-version @key{RET}}) and Org
1014(@kbd{M-x org-version RET}), as well as the Org related setup in the Emacs 1015(@kbd{M-x org-version @key{RET}}), as well as the Org related setup in the
1015init file. The easiest way to do this is to use the command 1016Emacs init file. The easiest way to do this is to use the command
1016@example 1017@example
1017@kbd{M-x org-submit-bug-report RET} 1018@kbd{M-x org-submit-bug-report @key{RET}}
1018@end example 1019@end example
1019@noindent which will put all this information into an Emacs mail buffer so 1020@noindent which will put all this information into an Emacs mail buffer so
1020that you only need to add your description. If you are not sending the Email 1021that you only need to add your description. If you are not sending the Email
@@ -1074,7 +1075,7 @@ Reload uncompiled versions of all Org mode Lisp files. The backtrace
1074contains much more information if it is produced with uncompiled code. 1075contains much more information if it is produced with uncompiled code.
1075To do this, use 1076To do this, use
1076@example 1077@example
1077@kbd{C-u M-x org-reload RET} 1078@kbd{C-u M-x org-reload @key{RET}}
1078@end example 1079@end example
1079@noindent 1080@noindent
1080or select @code{Org -> Refresh/Reload -> Reload Org uncompiled} from the 1081or select @code{Org -> Refresh/Reload -> Reload Org uncompiled} from the
@@ -1134,7 +1135,7 @@ accessing a functionality. Org mode often uses the same key for different
1134functions, depending on context. The command that is bound to such keys has 1135functions, depending on context. The command that is bound to such keys has
1135a generic name, like @code{org-metaright}. In the manual we will, wherever 1136a generic name, like @code{org-metaright}. In the manual we will, wherever
1136possible, give the function that is internally called by the generic command. 1137possible, give the function that is internally called by the generic command.
1137For example, in the chapter on document structure, @kbd{M-@key{right}} will 1138For example, in the chapter on document structure, @kbd{M-@key{RIGHT}} will
1138be listed to call @code{org-do-demote}, while in the chapter on tables, it 1139be listed to call @code{org-do-demote}, while in the chapter on tables, it
1139will be listed to call @code{org-table-move-column-right}. If you prefer, 1140will be listed to call @code{org-table-move-column-right}. If you prefer,
1140you can compile the manual without the command names by unsetting the flag 1141you can compile the manual without the command names by unsetting the flag
@@ -1340,9 +1341,9 @@ following lines anywhere in the buffer:
1340#+STARTUP: showeverything 1341#+STARTUP: showeverything
1341@end example 1342@end example
1342 1343
1343@cindex property, VISIBILITY 1344@cindex property, @code{VISIBILITY}
1344@noindent 1345@noindent
1345Furthermore, any entries with a @samp{VISIBILITY} property (@pxref{Properties 1346Furthermore, any entries with a @code{VISIBILITY} property (@pxref{Properties
1346and columns}) will get their visibility adapted accordingly. Allowed values 1347and columns}) will get their visibility adapted accordingly. Allowed values
1347for this property are @code{folded}, @code{children}, @code{content}, and 1348for this property are @code{folded}, @code{children}, @code{content}, and
1348@code{all}. 1349@code{all}.
@@ -1350,7 +1351,7 @@ for this property are @code{folded}, @code{children}, @code{content}, and
1350@table @asis 1351@table @asis
1351@orgcmd{C-u C-u @key{TAB},org-set-startup-visibility} 1352@orgcmd{C-u C-u @key{TAB},org-set-startup-visibility}
1352Switch back to the startup visibility of the buffer, i.e., whatever is 1353Switch back to the startup visibility of the buffer, i.e., whatever is
1353requested by startup options and @samp{VISIBILITY} properties in individual 1354requested by startup options and @code{VISIBILITY} properties in individual
1354entries. 1355entries.
1355@end table 1356@end table
1356 1357
@@ -1390,7 +1391,7 @@ you can use the following keys to find your destination:
1390@vindex org-goto-auto-isearch 1391@vindex org-goto-auto-isearch
1391@example 1392@example
1392@key{TAB} @r{Cycle visibility.} 1393@key{TAB} @r{Cycle visibility.}
1393@key{down} / @key{up} @r{Next/previous visible headline.} 1394@key{DOWN} / @key{UP} @r{Next/previous visible headline.}
1394@key{RET} @r{Select this location.} 1395@key{RET} @r{Select this location.}
1395@kbd{/} @r{Do a Sparse-tree search} 1396@kbd{/} @r{Do a Sparse-tree search}
1396@r{The following keys work if you turn off @code{org-goto-auto-isearch}} 1397@r{The following keys work if you turn off @code{org-goto-auto-isearch}}
@@ -1451,18 +1452,18 @@ In a new entry with no text yet, the first @key{TAB} demotes the entry to
1451become a child of the previous one. The next @key{TAB} makes it a parent, 1452become a child of the previous one. The next @key{TAB} makes it a parent,
1452and so on, all the way to top level. Yet another @key{TAB}, and you are back 1453and so on, all the way to top level. Yet another @key{TAB}, and you are back
1453to the initial level. 1454to the initial level.
1454@orgcmd{M-@key{left},org-do-promote} 1455@orgcmd{M-@key{LEFT},org-do-promote}
1455Promote current heading by one level. 1456Promote current heading by one level.
1456@orgcmd{M-@key{right},org-do-demote} 1457@orgcmd{M-@key{RIGHT},org-do-demote}
1457Demote current heading by one level. 1458Demote current heading by one level.
1458@orgcmd{M-S-@key{left},org-promote-subtree} 1459@orgcmd{M-S-@key{LEFT},org-promote-subtree}
1459Promote the current subtree by one level. 1460Promote the current subtree by one level.
1460@orgcmd{M-S-@key{right},org-demote-subtree} 1461@orgcmd{M-S-@key{RIGHT},org-demote-subtree}
1461Demote the current subtree by one level. 1462Demote the current subtree by one level.
1462@orgcmd{M-@key{up},org-move-subtree-up} 1463@orgcmd{M-@key{UP},org-move-subtree-up}
1463Move subtree up (swap with previous subtree of same 1464Move subtree up (swap with previous subtree of same
1464level). 1465level).
1465@orgcmd{M-@key{down},org-move-subtree-down} 1466@orgcmd{M-@key{DOWN},org-move-subtree-down}
1466Move subtree down (swap with next subtree of same level). 1467Move subtree down (swap with next subtree of same level).
1467@orgcmd{M-h,org-mark-element} 1468@orgcmd{M-h,org-mark-element}
1468Mark the element at point. Hitting repeatedly will mark subsequent elements 1469Mark the element at point. Hitting repeatedly will mark subsequent elements
@@ -1728,10 +1729,10 @@ one.
1728@end table 1729@end table
1729 1730
1730@table @kbd 1731@table @kbd
1731@kindex M-S-@key{RET} 1732@kindex M-S-RET
1732@item M-S-@key{RET} 1733@item M-S-@key{RET}
1733Insert a new item with a checkbox (@pxref{Checkboxes}). 1734Insert a new item with a checkbox (@pxref{Checkboxes}).
1734@kindex S-@key{down} 1735@kindex S-DOWN
1735@item S-up 1736@item S-up
1736@itemx S-down 1737@itemx S-down
1737@cindex shift-selection-mode 1738@cindex shift-selection-mode
@@ -1741,25 +1742,25 @@ Jump to the previous/next item in the current list@footnote{If you want to
1741cycle around items that way, you may customize 1742cycle around items that way, you may customize
1742@code{org-list-use-circular-motion}.}, but only if 1743@code{org-list-use-circular-motion}.}, but only if
1743@code{org-support-shift-select} is off. If not, you can still use paragraph 1744@code{org-support-shift-select} is off. If not, you can still use paragraph
1744jumping commands like @kbd{C-@key{up}} and @kbd{C-@key{down}} to quite 1745jumping commands like @kbd{C-@key{UP}} and @kbd{C-@key{DOWN}} to quite
1745similar effect. 1746similar effect.
1746@kindex M-@key{up} 1747@kindex M-UP
1747@kindex M-@key{down} 1748@kindex M-DOWN
1748@item M-up 1749@item M-up
1749@itemx M-down 1750@itemx M-down
1750Move the item including subitems up/down@footnote{See 1751Move the item including subitems up/down@footnote{See
1751@code{org-list-use-circular-motion} for a cyclic behavior.} (swap with 1752@code{org-list-use-circular-motion} for a cyclic behavior.} (swap with
1752previous/next item of same indentation). If the list is ordered, renumbering 1753previous/next item of same indentation). If the list is ordered, renumbering
1753is automatic. 1754is automatic.
1754@kindex M-@key{left} 1755@kindex M-LEFT
1755@kindex M-@key{right} 1756@kindex M-RIGHT
1756@item M-left 1757@item M-left
1757@itemx M-right 1758@itemx M-right
1758Decrease/increase the indentation of an item, leaving children alone. 1759Decrease/increase the indentation of an item, leaving children alone.
1759@kindex M-S-@key{left} 1760@kindex M-S-LEFT
1760@kindex M-S-@key{right} 1761@kindex M-S-RIGHT
1761@item M-S-@key{left} 1762@item M-S-@key{LEFT}
1762@itemx M-S-@key{right} 1763@itemx M-S-@key{RIGHT}
1763Decrease/increase the indentation of the item, including subitems. 1764Decrease/increase the indentation of the item, including subitems.
1764Initially, the item tree is selected based on current indentation. When 1765Initially, the item tree is selected based on current indentation. When
1765these commands are executed several times in direct succession, the initially 1766these commands are executed several times in direct succession, the initially
@@ -1797,9 +1798,9 @@ its location). @xref{Structure editing}, for a detailed explanation.
1797Turn the whole plain list into a subtree of the current heading. Checkboxes 1798Turn the whole plain list into a subtree of the current heading. Checkboxes
1798(@pxref{Checkboxes}) will become TODO (resp. DONE) keywords when unchecked 1799(@pxref{Checkboxes}) will become TODO (resp. DONE) keywords when unchecked
1799(resp. checked). 1800(resp. checked).
1800@kindex S-@key{left} 1801@kindex S-LEFT
1801@kindex S-@key{right} 1802@kindex S-RIGHT
1802@item S-left/right 1803@item S-@key{LEFT}/@key{RIGHT}
1803@vindex org-support-shift-select 1804@vindex org-support-shift-select
1804This command also cycles bullet styles when the cursor in on the bullet or 1805This command also cycles bullet styles when the cursor in on the bullet or
1805anywhere in an item line, details depending on 1806anywhere in an item line, details depending on
@@ -1817,7 +1818,7 @@ or by a custom function.
1817@cindex drawers 1818@cindex drawers
1818@cindex visibility cycling, drawers 1819@cindex visibility cycling, drawers
1819 1820
1820@cindex org-insert-drawer 1821@cindex @code{org-insert-drawer}
1821@kindex C-c C-x d 1822@kindex C-c C-x d
1822Sometimes you want to keep information associated with an entry, but you 1823Sometimes you want to keep information associated with an entry, but you
1823normally don't want to see it. For this, Org mode has @emph{drawers}. They 1824normally don't want to see it. For this, Org mode has @emph{drawers}. They
@@ -1873,7 +1874,7 @@ export output. Property drawers are not affected by this variable: configure
1873Org mode uses begin...end blocks for various purposes from including source 1874Org mode uses begin...end blocks for various purposes from including source
1874code examples (@pxref{Literal examples}) to capturing time logging 1875code examples (@pxref{Literal examples}) to capturing time logging
1875information (@pxref{Clocking work time}). These blocks can be folded and 1876information (@pxref{Clocking work time}). These blocks can be folded and
1876unfolded by pressing TAB in the begin line. You can also get all blocks 1877unfolded by pressing @key{TAB} in the begin line. You can also get all blocks
1877folded at startup by configuring the option @code{org-hide-block-startup} 1878folded at startup by configuring the option @code{org-hide-block-startup}
1878or on a per-file basis by using 1879or on a per-file basis by using
1879 1880
@@ -1997,7 +1998,7 @@ a separate window. The window can be closed by pressing @kbd{C-c '}.
1997If you like the intuitive way the Org mode structure editing and list 1998If you like the intuitive way the Org mode structure editing and list
1998formatting works, you might want to use these commands in other modes like 1999formatting works, you might want to use these commands in other modes like
1999Text mode or Mail mode as well. The minor mode @code{orgstruct-mode} makes 2000Text mode or Mail mode as well. The minor mode @code{orgstruct-mode} makes
2000this possible. Toggle the mode with @kbd{M-x orgstruct-mode RET}, or 2001this possible. Toggle the mode with @kbd{M-x orgstruct-mode @key{RET}}, or
2001turn it on by default, for example in Message mode, with one of: 2002turn it on by default, for example in Message mode, with one of:
2002 2003
2003@lisp 2004@lisp
@@ -2038,7 +2039,7 @@ file falls into one of the categories above.
2038To explore the abstract structure of an Org buffer, run this in a buffer: 2039To explore the abstract structure of an Org buffer, run this in a buffer:
2039 2040
2040@lisp 2041@lisp
2041M-: (org-element-parse-buffer) RET 2042M-: (org-element-parse-buffer) @key{RET}
2042@end lisp 2043@end lisp
2043 2044
2044It will output a list containing the buffer's content represented as an 2045It will output a list containing the buffer's content represented as an
@@ -2132,10 +2133,10 @@ table. But it is easier just to start typing, like
2132@orgcmd{C-c C-c,org-table-align} 2133@orgcmd{C-c C-c,org-table-align}
2133Re-align the table and don't move to another field. 2134Re-align the table and don't move to another field.
2134@c 2135@c
2135@orgcmd{C-c SPC,org-table-blank-field} 2136@orgcmd{C-c @key{SPC},org-table-blank-field}
2136Blank the field at point. 2137Blank the field at point.
2137@c 2138@c
2138@orgcmd{TAB,org-table-next-field} 2139@orgcmd{@key{TAB},org-table-next-field}
2139Re-align the table, move to the next field. Creates a new row if 2140Re-align the table, move to the next field. Creates a new row if
2140necessary. 2141necessary.
2141@c 2142@c
@@ -2153,22 +2154,22 @@ Move to beginning of the current table field, or on to the previous field.
2153Move to end of the current table field, or on to the next field. 2154Move to end of the current table field, or on to the next field.
2154 2155
2155@tsubheading{Column and row editing} 2156@tsubheading{Column and row editing}
2156@orgcmdkkcc{M-@key{left},M-@key{right},org-table-move-column-left,org-table-move-column-right} 2157@orgcmdkkcc{M-@key{LEFT},M-@key{RIGHT},org-table-move-column-left,org-table-move-column-right}
2157Move the current column left/right. 2158Move the current column left/right.
2158@c 2159@c
2159@orgcmd{M-S-@key{left},org-table-delete-column} 2160@orgcmd{M-S-@key{LEFT},org-table-delete-column}
2160Kill the current column. 2161Kill the current column.
2161@c 2162@c
2162@orgcmd{M-S-@key{right},org-table-insert-column} 2163@orgcmd{M-S-@key{RIGHT},org-table-insert-column}
2163Insert a new column to the left of the cursor position. 2164Insert a new column to the left of the cursor position.
2164@c 2165@c
2165@orgcmdkkcc{M-@key{up},M-@key{down},org-table-move-row-up,org-table-move-row-down} 2166@orgcmdkkcc{M-@key{UP},M-@key{DOWN},org-table-move-row-up,org-table-move-row-down}
2166Move the current row up/down. 2167Move the current row up/down.
2167@c 2168@c
2168@orgcmd{M-S-@key{up},org-table-kill-row} 2169@orgcmd{M-S-@key{UP},org-table-kill-row}
2169Kill the current row or horizontal line. 2170Kill the current row or horizontal line.
2170@c 2171@c
2171@orgcmd{M-S-@key{down},org-table-insert-row} 2172@orgcmd{M-S-@key{DOWN},org-table-insert-row}
2172Insert a new row above the current row. With a prefix argument, the line is 2173Insert a new row above the current row. With a prefix argument, the line is
2173created below the current one. 2174created below the current one.
2174@c 2175@c
@@ -2250,7 +2251,7 @@ window follow the cursor through the table and always show the current
2250field. The follow mode exits automatically when the cursor leaves the table, 2251field. The follow mode exits automatically when the cursor leaves the table,
2251or when you repeat this command with @kbd{C-u C-u C-c `}. 2252or when you repeat this command with @kbd{C-u C-u C-c `}.
2252@c 2253@c
2253@item M-x org-table-import RET 2254@item M-x org-table-import @key{RET}
2254Import a file as a table. The table should be TAB or whitespace 2255Import a file as a table. The table should be TAB or whitespace
2255separated. Use, for example, to import a spreadsheet table or data 2256separated. Use, for example, to import a spreadsheet table or data
2256from a database, because these programs generally can write 2257from a database, because these programs generally can write
@@ -2263,7 +2264,7 @@ Tables can also be imported by pasting tabular text into the Org
2263buffer, selecting the pasted text with @kbd{C-x C-x} and then using the 2264buffer, selecting the pasted text with @kbd{C-x C-x} and then using the
2264@kbd{C-c |} command (see above under @i{Creation and conversion}). 2265@kbd{C-c |} command (see above under @i{Creation and conversion}).
2265@c 2266@c
2266@item M-x org-table-export RET 2267@item M-x org-table-export @key{RET}
2267@findex org-table-export 2268@findex org-table-export
2268@vindex org-table-export-default-format 2269@vindex org-table-export-default-format
2269Export the table, by default as a TAB-separated file. Use for data 2270Export the table, by default as a TAB-separated file. Use for data
@@ -2388,11 +2389,11 @@ every vertical line you would like to have:
2388@cindex Orgtbl mode 2389@cindex Orgtbl mode
2389@cindex minor mode for tables 2390@cindex minor mode for tables
2390 2391
2391If you like the intuitive way the Org table editor works, you 2392If you like the intuitive way the Org table editor works, you might also want
2392might also want to use it in other modes like Text mode or Mail mode. 2393to use it in other modes like Text mode or Mail mode. The minor mode Orgtbl
2393The minor mode Orgtbl mode makes this possible. You can always toggle 2394mode makes this possible. You can always toggle the mode with @kbd{M-x
2394the mode with @kbd{M-x orgtbl-mode RET}. To turn it on by default, for 2395orgtbl-mode @key{RET}}. To turn it on by default, for example in Message
2395example in Message mode, use 2396mode, use
2396 2397
2397@lisp 2398@lisp
2398(add-hook 'message-mode-hook 'turn-on-orgtbl) 2399(add-hook 'message-mode-hook 'turn-on-orgtbl)
@@ -2565,7 +2566,7 @@ rows/columns.
2565@cindex references, named 2566@cindex references, named
2566@cindex name, of column or field 2567@cindex name, of column or field
2567@cindex constants, in calculations 2568@cindex constants, in calculations
2568@cindex #+CONSTANTS 2569@cindex @code{#+CONSTANTS}
2569 2570
2570@vindex org-table-formula-constants 2571@vindex org-table-formula-constants
2571@samp{$name} is interpreted as the name of a column, parameter or 2572@samp{$name} is interpreted as the name of a column, parameter or
@@ -2602,7 +2603,7 @@ numbers.
2602@cindex references, to a different table 2603@cindex references, to a different table
2603@cindex name, of column or field 2604@cindex name, of column or field
2604@cindex constants, in calculations 2605@cindex constants, in calculations
2605@cindex #+NAME, for table 2606@cindex @code{#+NAME}, for table
2606 2607
2607You may also reference constants, fields and ranges from a different table, 2608You may also reference constants, fields and ranges from a different table,
2608either in the current file or even in a different file. The syntax is 2609either in the current file or even in a different file. The syntax is
@@ -2824,8 +2825,8 @@ preceded by @samp{:=}, for example @samp{:=vsum(@@II..III)}. When you press
2824the formula will be stored as the formula for this field, evaluated, and the 2825the formula will be stored as the formula for this field, evaluated, and the
2825current field will be replaced with the result. 2826current field will be replaced with the result.
2826 2827
2827@cindex #+TBLFM 2828@cindex @code{#+TBLFM}
2828Formulas are stored in a special line starting with @samp{#+TBLFM:} directly 2829Formulas are stored in a special line starting with @code{#+TBLFM:} directly
2829below the table. If you type the equation in the 4th field of the 3rd data 2830below the table. If you type the equation in the 4th field of the 3rd data
2830line in the table, the formula will look like @samp{@@3$4=$1+$2}. When 2831line in the table, the formula will look like @samp{@@3$4=$1+$2}. When
2831inserting/deleting/swapping columns and rows with the appropriate commands, 2832inserting/deleting/swapping columns and rows with the appropriate commands,
@@ -2843,7 +2844,7 @@ command
2843@table @kbd 2844@table @kbd
2844@orgcmd{C-u C-c =,org-table-eval-formula} 2845@orgcmd{C-u C-c =,org-table-eval-formula}
2845Install a new formula for the current field. The command prompts for a 2846Install a new formula for the current field. The command prompts for a
2846formula with default taken from the @samp{#+TBLFM:} line, applies 2847formula with default taken from the @code{#+TBLFM:} line, applies
2847it to the current field, and stores it. 2848it to the current field, and stores it.
2848@end table 2849@end table
2849 2850
@@ -2890,7 +2891,7 @@ the formula will be stored as the formula for the current column, evaluated
2890and the current field replaced with the result. If the field contains only 2891and the current field replaced with the result. If the field contains only
2891@samp{=}, the previously stored formula for this column is used. For each 2892@samp{=}, the previously stored formula for this column is used. For each
2892column, Org will only remember the most recently used formula. In the 2893column, Org will only remember the most recently used formula. In the
2893@samp{#+TBLFM:} line, column formulas will look like @samp{$4=$1+$2}. The 2894@code{#+TBLFM:} line, column formulas will look like @samp{$4=$1+$2}. The
2894left-hand side of a column formula cannot be the name of column, it must be 2895left-hand side of a column formula cannot be the name of column, it must be
2895the numeric column reference or @code{$>}. 2896the numeric column reference or @code{$>}.
2896 2897
@@ -2901,7 +2902,7 @@ following command:
2901@orgcmd{C-c =,org-table-eval-formula} 2902@orgcmd{C-c =,org-table-eval-formula}
2902Install a new formula for the current column and replace current field with 2903Install a new formula for the current column and replace current field with
2903the result of the formula. The command prompts for a formula, with default 2904the result of the formula. The command prompts for a formula, with default
2904taken from the @samp{#+TBLFM} line, applies it to the current field and 2905taken from the @code{#+TBLFM} line, applies it to the current field and
2905stores it. With a numeric prefix argument(e.g., @kbd{C-5 C-c =}) the command 2906stores it. With a numeric prefix argument(e.g., @kbd{C-5 C-c =}) the command
2906will apply it to that many consecutive fields in the current column. 2907will apply it to that many consecutive fields in the current column.
2907@end table 2908@end table
@@ -3012,22 +3013,22 @@ formula, @key{TAB} re-indents just like in Emacs Lisp mode.
3012Complete Lisp symbols, just like in Emacs Lisp mode.@footnote{Many desktops 3013Complete Lisp symbols, just like in Emacs Lisp mode.@footnote{Many desktops
3013intercept @kbd{M-@key{TAB}} to switch windows. Use @kbd{C-M-i} or 3014intercept @kbd{M-@key{TAB}} to switch windows. Use @kbd{C-M-i} or
3014@kbd{@key{ESC} @key{TAB}} instead for completion (@pxref{Completion}).} 3015@kbd{@key{ESC} @key{TAB}} instead for completion (@pxref{Completion}).}
3015@kindex S-@key{up} 3016@kindex S-UP
3016@kindex S-@key{down} 3017@kindex S-DOWN
3017@kindex S-@key{left} 3018@kindex S-LEFT
3018@kindex S-@key{right} 3019@kindex S-RIGHT
3019@findex org-table-fedit-ref-up 3020@findex org-table-fedit-ref-up
3020@findex org-table-fedit-ref-down 3021@findex org-table-fedit-ref-down
3021@findex org-table-fedit-ref-left 3022@findex org-table-fedit-ref-left
3022@findex org-table-fedit-ref-right 3023@findex org-table-fedit-ref-right
3023@item S-@key{up}/@key{down}/@key{left}/@key{right} 3024@item S-@key{UP}/@key{DOWN}/@key{LEFT}/@key{RIGHT}
3024Shift the reference at point. For example, if the reference is 3025Shift the reference at point. For example, if the reference is
3025@code{B3} and you press @kbd{S-@key{right}}, it will become @code{C3}. 3026@code{B3} and you press @kbd{S-@key{RIGHT}}, it will become @code{C3}.
3026This also works for relative references and for hline references. 3027This also works for relative references and for hline references.
3027@orgcmdkkcc{M-S-@key{up},M-S-@key{down},org-table-fedit-line-up,org-table-fedit-line-down} 3028@orgcmdkkcc{M-S-@key{UP},M-S-@key{DOWN},org-table-fedit-line-up,org-table-fedit-line-down}
3028Move the test line for column formulas in the Org buffer up and 3029Move the test line for column formulas in the Org buffer up and
3029down. 3030down.
3030@orgcmdkkcc{M-@key{up},M-@key{down},org-table-fedit-scroll-down,org-table-fedit-scroll-up} 3031@orgcmdkkcc{M-@key{UP},M-@key{DOWN},org-table-fedit-scroll-down,org-table-fedit-scroll-up}
3031Scroll the window displaying the table. 3032Scroll the window displaying the table.
3032@kindex C-c @} 3033@kindex C-c @}
3033@findex org-table-toggle-coordinate-overlays 3034@findex org-table-toggle-coordinate-overlays
@@ -3037,25 +3038,25 @@ Turn the coordinate grid in the table on and off.
3037@end table 3038@end table
3038 3039
3039Making a table field blank does not remove the formula associated with 3040Making a table field blank does not remove the formula associated with
3040the field, because that is stored in a different line (the @samp{#+TBLFM} 3041the field, because that is stored in a different line (the @code{#+TBLFM}
3041line)---during the next recalculation the field will be filled again. 3042line)---during the next recalculation the field will be filled again.
3042To remove a formula from a field, you have to give an empty reply when 3043To remove a formula from a field, you have to give an empty reply when
3043prompted for the formula, or to edit the @samp{#+TBLFM} line. 3044prompted for the formula, or to edit the @code{#+TBLFM} line.
3044 3045
3045@kindex C-c C-c 3046@kindex C-c C-c
3046You may edit the @samp{#+TBLFM} directly and re-apply the changed 3047You may edit the @code{#+TBLFM} directly and re-apply the changed
3047equations with @kbd{C-c C-c} in that line or with the normal 3048equations with @kbd{C-c C-c} in that line or with the normal
3048recalculation commands in the table. 3049recalculation commands in the table.
3049 3050
3050@anchor{Using multiple #+TBLFM lines} 3051@anchor{Using multiple #+TBLFM lines}
3051@subsubheading Using multiple #+TBLFM lines 3052@subsubheading Using multiple @code{#+TBLFM} lines
3052@cindex #+TBLFM line, multiple 3053@cindex @code{#+TBLFM} line, multiple
3053@cindex #+TBLFM 3054@cindex @code{#+TBLFM}
3054@cindex #+TBLFM, switching 3055@cindex @code{#+TBLFM}, switching
3055@kindex C-c C-c 3056@kindex C-c C-c
3056 3057
3057You may apply the formula temporarily. This is useful when you 3058You may apply the formula temporarily. This is useful when you
3058switch the formula. Place multiple @samp{#+TBLFM} lines right 3059switch the formula. Place multiple @code{#+TBLFM} lines right
3059after the table, and then press @kbd{C-c C-c} on the formula to 3060after the table, and then press @kbd{C-c C-c} on the formula to
3060apply. Here is an example: 3061apply. Here is an example:
3061 3062
@@ -3082,7 +3083,7 @@ Pressing @kbd{C-c C-c} in the line of @samp{#+TBLFM: $2=$1*2} yields:
3082 3083
3083@noindent 3084@noindent
3084Note: If you recalculate this table (with @kbd{C-u C-c *}, for example), you 3085Note: If you recalculate this table (with @kbd{C-u C-c *}, for example), you
3085will get the following result of applying only the first @samp{#+TBLFM} line. 3086will get the following result of applying only the first @code{#+TBLFM} line.
3086 3087
3087@example 3088@example
3088| x | y | 3089| x | y |
@@ -3131,10 +3132,10 @@ hline are left alone, assuming that these are part of the table header.
3131Iterate the table by recomputing it until no further changes occur. 3132Iterate the table by recomputing it until no further changes occur.
3132This may be necessary if some computed fields use the value of other 3133This may be necessary if some computed fields use the value of other
3133fields that are computed @i{later} in the calculation sequence. 3134fields that are computed @i{later} in the calculation sequence.
3134@item M-x org-table-recalculate-buffer-tables RET 3135@item M-x org-table-recalculate-buffer-tables @key{RET}
3135@findex org-table-recalculate-buffer-tables 3136@findex org-table-recalculate-buffer-tables
3136Recompute all tables in the current buffer. 3137Recompute all tables in the current buffer.
3137@item M-x org-table-iterate-buffer-tables RET 3138@item M-x org-table-iterate-buffer-tables @key{RET}
3138@findex org-table-iterate-buffer-tables 3139@findex org-table-iterate-buffer-tables
3139Iterate all tables in the current buffer, in order to converge table-to-table 3140Iterate all tables in the current buffer, in order to converge table-to-table
3140dependencies. 3141dependencies.
@@ -3249,7 +3250,7 @@ functions.
3249@section Org-Plot 3250@section Org-Plot
3250@cindex graph, in tables 3251@cindex graph, in tables
3251@cindex plot tables using Gnuplot 3252@cindex plot tables using Gnuplot
3252@cindex #+PLOT 3253@cindex @code{#+PLOT}
3253 3254
3254Org-Plot can produce graphs of information stored in org tables, either 3255Org-Plot can produce graphs of information stored in org tables, either
3255graphically or in ASCII-art. 3256graphically or in ASCII-art.
@@ -3432,7 +3433,7 @@ internal structure of all links, use the menu entry
3432@cindex links, internal 3433@cindex links, internal
3433@cindex targets, for links 3434@cindex targets, for links
3434 3435
3435@cindex property, CUSTOM_ID 3436@cindex property, @code{CUSTOM_ID}
3436If the link does not look like a URL, it is considered to be internal in the 3437If the link does not look like a URL, it is considered to be internal in the
3437current file. The most important case is a link like 3438current file. The most important case is a link like
3438@samp{[[#my-custom-id]]} which will link to the entry with the 3439@samp{[[#my-custom-id]]} which will link to the entry with the
@@ -3448,7 +3449,7 @@ point to the corresponding headline. The preferred match for a text link is
3448a @i{dedicated target}: the same string in double angular brackets, like 3449a @i{dedicated target}: the same string in double angular brackets, like
3449@samp{<<My Target>>}. 3450@samp{<<My Target>>}.
3450 3451
3451@cindex #+NAME 3452@cindex @code{#+NAME}
3452If no dedicated target exists, the link will then try to match the exact name 3453If no dedicated target exists, the link will then try to match the exact name
3453of an element within the buffer. Naming is done with the @code{#+NAME} 3454of an element within the buffer. Naming is done with the @code{#+NAME}
3454keyword, which has to be put in the line before the element it refers to, as 3455keyword, which has to be put in the line before the element it refers to, as
@@ -3640,8 +3641,8 @@ removed from the link and result in a wrong link---you should avoid putting
3640timestamp in the headline.}. 3641timestamp in the headline.}.
3641 3642
3642@vindex org-id-link-to-org-use-id 3643@vindex org-id-link-to-org-use-id
3643@cindex property, CUSTOM_ID 3644@cindex property, @code{CUSTOM_ID}
3644@cindex property, ID 3645@cindex property, @code{ID}
3645If the headline has a @code{CUSTOM_ID} property, a link to this custom ID 3646If the headline has a @code{CUSTOM_ID} property, a link to this custom ID
3646will be stored. In addition or alternatively (depending on the value of 3647will be stored. In addition or alternatively (depending on the value of
3647@code{org-id-link-to-org-use-id}), a globally unique @code{ID} property will 3648@code{org-id-link-to-org-use-id}), a globally unique @code{ID} property will
@@ -3708,7 +3709,7 @@ becomes the default description.
3708@b{Inserting stored links}@* 3709@b{Inserting stored links}@*
3709All links stored during the 3710All links stored during the
3710current session are part of the history for this prompt, so you can access 3711current session are part of the history for this prompt, so you can access
3711them with @key{up} and @key{down} (or @kbd{M-p/n}). 3712them with @key{UP} and @key{DOWN} (or @kbd{M-p/n}).
3712 3713
3713@b{Completion support}@* Completion with @key{TAB} will help you to insert 3714@b{Completion support}@* Completion with @key{TAB} will help you to insert
3714valid link prefixes like @samp{https:}, including the prefixes 3715valid link prefixes like @samp{https:}, including the prefixes
@@ -3883,7 +3884,7 @@ what the Org author is doing besides Emacs hacking with
3883If you need special abbreviations just for a single Org buffer, you 3884If you need special abbreviations just for a single Org buffer, you
3884can define them in the file with 3885can define them in the file with
3885 3886
3886@cindex #+LINK 3887@cindex @code{#+LINK}
3887@example 3888@example
3888#+LINK: bugzilla http://10.1.2.9/bugzilla/show_bug.cgi?id= 3889#+LINK: bugzilla http://10.1.2.9/bugzilla/show_bug.cgi?id=
3889#+LINK: google http://www.google.com/search?q=%s 3890#+LINK: google http://www.google.com/search?q=%s
@@ -4041,9 +4042,9 @@ completion; otherwise force cycling through TODO states with no prompt. When
4041@code{org-use-fast-todo-selection} is set to @code{prefix}, use the fast 4042@code{org-use-fast-todo-selection} is set to @code{prefix}, use the fast
4042selection interface. 4043selection interface.
4043 4044
4044@kindex S-@key{right} 4045@kindex S-RIGHT
4045@kindex S-@key{left} 4046@kindex S-LEFT
4046@item S-@key{right} @ @r{/} @ S-@key{left} 4047@item S-@key{RIGHT} @ @r{/} @ S-@key{LEFT}
4047@vindex org-treat-S-cursor-todo-selection-as-state-change 4048@vindex org-treat-S-cursor-todo-selection-as-state-change
4048Select the following/preceding TODO state, similar to cycling. Useful 4049Select the following/preceding TODO state, similar to cycling. Useful
4049mostly if more than two TODO states are possible (@pxref{TODO 4050mostly if more than two TODO states are possible (@pxref{TODO
@@ -4124,7 +4125,7 @@ With this setup, the command @kbd{C-c C-t} will cycle an entry from TODO
4124to FEEDBACK, then to VERIFY, and finally to DONE and DELEGATED@. You may 4125to FEEDBACK, then to VERIFY, and finally to DONE and DELEGATED@. You may
4125also use a numeric prefix argument to quickly select a specific state. For 4126also use a numeric prefix argument to quickly select a specific state. For
4126example @kbd{C-3 C-c C-t} will change the state immediately to VERIFY@. 4127example @kbd{C-3 C-c C-t} will change the state immediately to VERIFY@.
4127Or you can use @kbd{S-@key{left}} to go backward through the sequence. If you 4128Or you can use @kbd{S-@key{LEFT}} to go backward through the sequence. If you
4128define many keywords, you can use in-buffer completion 4129define many keywords, you can use in-buffer completion
4129(@pxref{Completion}) or even a special one-key selection scheme 4130(@pxref{Completion}) or even a special one-key selection scheme
4130(@pxref{Fast access to TODO states}) to insert these words into the 4131(@pxref{Fast access to TODO states}) to insert these words into the
@@ -4190,23 +4191,23 @@ select the correct sequence. Besides the obvious ways like typing a
4190keyword or using completion, you may also apply the following commands: 4191keyword or using completion, you may also apply the following commands:
4191 4192
4192@table @kbd 4193@table @kbd
4193@kindex C-S-@key{right} 4194@kindex C-S-RIGHT
4194@kindex C-S-@key{left} 4195@kindex C-S-LEFT
4195@kindex C-u C-u C-c C-t 4196@kindex C-u C-u C-c C-t
4196@item C-u C-u C-c C-t 4197@item C-u C-u C-c C-t
4197@itemx C-S-@key{right} 4198@itemx C-S-@key{RIGHT}
4198@itemx C-S-@key{left} 4199@itemx C-S-@key{LEFT}
4199These keys jump from one TODO subset to the next. In the above example, 4200These keys jump from one TODO subset to the next. In the above example,
4200@kbd{C-u C-u C-c C-t} or @kbd{C-S-@key{right}} would jump from @code{TODO} or 4201@kbd{C-u C-u C-c C-t} or @kbd{C-S-@key{RIGHT}} would jump from @code{TODO} or
4201@code{DONE} to @code{REPORT}, and any of the words in the second row to 4202@code{DONE} to @code{REPORT}, and any of the words in the second row to
4202@code{CANCELED}. Note that the @kbd{C-S-} key binding conflict with 4203@code{CANCELED}. Note that the @kbd{C-S-} key binding conflict with
4203@code{shift-selection-mode} (@pxref{Conflicts}). 4204@code{shift-selection-mode} (@pxref{Conflicts}).
4204@kindex S-@key{right} 4205@kindex S-RIGHT
4205@kindex S-@key{left} 4206@kindex S-LEFT
4206@item S-@key{right} 4207@item S-@key{RIGHT}
4207@itemx S-@key{left} 4208@itemx S-@key{LEFT}
4208@kbd{S-@key{left}} and @kbd{S-@key{right}} and walk through @emph{all} 4209@kbd{S-@key{LEFT}} and @kbd{S-@key{RIGHT}} and walk through @emph{all}
4209keywords from all sets, so for example @kbd{S-@key{right}} would switch 4210keywords from all sets, so for example @kbd{S-@key{RIGHT}} would switch
4210from @code{DONE} to @code{REPORT} in the example above. See also 4211from @code{DONE} to @code{REPORT} in the example above. See also
4211@ref{Conflicts}, for a discussion of the interaction with 4212@ref{Conflicts}, for a discussion of the interaction with
4212@code{shift-selection-mode}. 4213@code{shift-selection-mode}.
@@ -4229,8 +4230,8 @@ each keyword, in parentheses@footnote{All characters are allowed except
4229@end lisp 4230@end lisp
4230 4231
4231@vindex org-fast-tag-selection-include-todo 4232@vindex org-fast-tag-selection-include-todo
4232If you then press @kbd{C-c C-t} followed by the selection key, the entry 4233If you then press @kbd{C-c C-t} followed by the selection key, the entry will
4233will be switched to this state. @kbd{SPC} can be used to remove any TODO 4234be switched to this state. @kbd{@key{SPC}} can be used to remove any TODO
4234keyword from an entry.@footnote{Check also the option 4235keyword from an entry.@footnote{Check also the option
4235@code{org-fast-tag-selection-include-todo}, it allows you to change the TODO 4236@code{org-fast-tag-selection-include-todo}, it allows you to change the TODO
4236state through the tags interface (@pxref{Setting tags}), in case you like to 4237state through the tags interface (@pxref{Setting tags}), in case you like to
@@ -4241,9 +4242,9 @@ unique keys across both sets of keywords.}
4241@subsection Setting up keywords for individual files 4242@subsection Setting up keywords for individual files
4242@cindex keyword options 4243@cindex keyword options
4243@cindex per-file keywords 4244@cindex per-file keywords
4244@cindex #+TODO 4245@cindex @code{#+TODO}
4245@cindex #+TYP_TODO 4246@cindex @code{#+TYP_TODO}
4246@cindex #+SEQ_TODO 4247@cindex @code{#+SEQ_TODO}
4247 4248
4248It can be very useful to use different aspects of the TODO mechanism in 4249It can be very useful to use different aspects of the TODO mechanism in
4249different files. For file-local settings, you need to add special lines to 4250different files. For file-local settings, you need to add special lines to
@@ -4269,7 +4270,7 @@ A setup for using several sets in parallel would be:
4269@end example 4270@end example
4270 4271
4271@cindex completion, of option keywords 4272@cindex completion, of option keywords
4272@kindex M-@key{TAB} 4273@kindex M-TAB
4273@noindent To make sure you are using the correct keyword, type 4274@noindent To make sure you are using the correct keyword, type
4274@samp{#+} into the buffer and then use @kbd{M-@key{TAB}} completion. 4275@samp{#+} into the buffer and then use @kbd{M-@key{TAB}} completion.
4275 4276
@@ -4318,7 +4319,7 @@ foreground or a background color.
4318@cindex TODO dependencies, NOBLOCKING 4319@cindex TODO dependencies, NOBLOCKING
4319 4320
4320@vindex org-enforce-todo-dependencies 4321@vindex org-enforce-todo-dependencies
4321@cindex property, ORDERED 4322@cindex property, @code{ORDERED}
4322The structure of Org files (hierarchy and lists) makes it easy to define TODO 4323The structure of Org files (hierarchy and lists) makes it easy to define TODO
4323dependencies. Usually, a parent TODO task should not be marked DONE until 4324dependencies. Usually, a parent TODO task should not be marked DONE until
4324all subtasks (defined as children tasks) are marked as DONE@. And sometimes 4325all subtasks (defined as children tasks) are marked as DONE@. And sometimes
@@ -4357,7 +4358,7 @@ property:
4357@table @kbd 4358@table @kbd
4358@orgcmd{C-c C-x o,org-toggle-ordered-property} 4359@orgcmd{C-c C-x o,org-toggle-ordered-property}
4359@vindex org-track-ordered-property-with-tag 4360@vindex org-track-ordered-property-with-tag
4360@cindex property, ORDERED 4361@cindex property, @code{ORDERED}
4361Toggle the @code{ORDERED} property of the current entry. A property is used 4362Toggle the @code{ORDERED} property of the current entry. A property is used
4362for this behavior because this should be local to the current entry, not 4363for this behavior because this should be local to the current entry, not
4363inherited like a tag. However, if you would like to @i{track} the value of 4364inherited like a tag. However, if you would like to @i{track} the value of
@@ -4419,7 +4420,7 @@ Then each time you turn an entry from a TODO (not-done) state into any of the
4419DONE states, a line @samp{CLOSED: [timestamp]} will be inserted just after 4420DONE states, a line @samp{CLOSED: [timestamp]} will be inserted just after
4420the headline. If you turn the entry back into a TODO item through further 4421the headline. If you turn the entry back into a TODO item through further
4421state cycling, that line will be removed again. If you turn the entry back 4422state cycling, that line will be removed again. If you turn the entry back
4422to a non-TODO state (by pressing @key{C-c C-t SPC} for example), that line 4423to a non-TODO state (by pressing @key{C-c C-t @key{SPC}} for example), that line
4423will also be removed, unless you set @code{org-closed-keep-when-no-todo} to 4424will also be removed, unless you set @code{org-closed-keep-when-no-todo} to
4424non-@code{nil}. If you want to record a note along with the timestamp, 4425non-@code{nil}. If you want to record a note along with the timestamp,
4425use@footnote{The corresponding in-buffer setting is: @code{#+STARTUP: 4426use@footnote{The corresponding in-buffer setting is: @code{#+STARTUP:
@@ -4439,7 +4440,7 @@ the entry with a @samp{Closing Note} heading.
4439 4440
4440@vindex org-log-states-order-reversed 4441@vindex org-log-states-order-reversed
4441@vindex org-log-into-drawer 4442@vindex org-log-into-drawer
4442@cindex property, LOG_INTO_DRAWER 4443@cindex property, @code{LOG_INTO_DRAWER}
4443When TODO keywords are used as workflow states (@pxref{Workflow states}), you 4444When TODO keywords are used as workflow states (@pxref{Workflow states}), you
4444might want to keep track of when a state change occurred and maybe take a 4445might want to keep track of when a state change occurred and maybe take a
4445note about this change. You can either record just a timestamp, or a 4446note about this change. You can either record just a timestamp, or a
@@ -4449,8 +4450,8 @@ headline as an itemized list, newest first@footnote{See the option
4449want to get the notes out of the way into a drawer (@pxref{Drawers}). 4450want to get the notes out of the way into a drawer (@pxref{Drawers}).
4450Customize @code{org-log-into-drawer} to get this behavior---the recommended 4451Customize @code{org-log-into-drawer} to get this behavior---the recommended
4451drawer for this is called @code{LOGBOOK}@footnote{Note that the 4452drawer for this is called @code{LOGBOOK}@footnote{Note that the
4452@code{LOGBOOK} drawer is unfolded when pressing @key{SPC} in the agenda to 4453@code{LOGBOOK} drawer is unfolded when pressing @kbd{@key{SPC}} in the agenda to
4453show an entry---use @key{C-u SPC} to keep it folded here}. You can also 4454show an entry---use @kbd{C-u @key{SPC}} to keep it folded here}. You can also
4454overrule the setting of this variable for a subtree by setting a 4455overrule the setting of this variable for a subtree by setting a
4455@code{LOG_INTO_DRAWER} property. 4456@code{LOG_INTO_DRAWER} property.
4456 4457
@@ -4493,12 +4494,12 @@ to a buffer:
4493#+TODO: TODO(t) WAIT(w@@/!) | DONE(d!) CANCELED(c@@) 4494#+TODO: TODO(t) WAIT(w@@/!) | DONE(d!) CANCELED(c@@)
4494@end example 4495@end example
4495 4496
4496@cindex property, LOGGING 4497@cindex property, @code{LOGGING}
4497In order to define logging settings that are local to a subtree or a 4498In order to define logging settings that are local to a subtree or a single
4498single item, define a LOGGING property in this entry. Any non-empty 4499item, define a @code{LOGGING} property in this entry. Any non-empty
4499LOGGING property resets all logging settings to @code{nil}. You may then turn 4500@code{LOGGING} property resets all logging settings to @code{nil}. You may
4500on logging for this specific tree using STARTUP keywords like 4501then turn on logging for this specific tree using @code{#+STARTUP} keywords
4501@code{lognotedone} or @code{logrepeat}, as well as adding state specific 4502like @code{lognotedone} or @code{logrepeat}, as well as adding state specific
4502settings like @code{TODO(!)}. For example 4503settings like @code{TODO(!)}. For example
4503 4504
4504@example 4505@example
@@ -4642,7 +4643,7 @@ items.
4642 4643
4643@table @kbd 4644@table @kbd
4644@item @kbd{C-c ,} 4645@item @kbd{C-c ,}
4645@kindex @kbd{C-c ,} 4646@kindex C-c ,
4646@findex org-priority 4647@findex org-priority
4647Set the priority of the current headline (@command{org-priority}). The 4648Set the priority of the current headline (@command{org-priority}). The
4648command prompts for a priority character @samp{A}, @samp{B} or @samp{C}. 4649command prompts for a priority character @samp{A}, @samp{B} or @samp{C}.
@@ -4650,7 +4651,7 @@ When you press @key{SPC} instead, the priority cookie is removed from the
4650headline. The priorities can also be changed ``remotely'' from the agenda 4651headline. The priorities can also be changed ``remotely'' from the agenda
4651buffer with the @kbd{,} command (@pxref{Agenda commands}). 4652buffer with the @kbd{,} command (@pxref{Agenda commands}).
4652@c 4653@c
4653@orgcmdkkcc{S-@key{up},S-@key{down},org-priority-up,org-priority-down} 4654@orgcmdkkcc{S-@key{UP},S-@key{DOWN},org-priority-up,org-priority-down}
4654@vindex org-priority-start-cycle-with-default 4655@vindex org-priority-start-cycle-with-default
4655Increase/decrease priority of current headline@footnote{See also the option 4656Increase/decrease priority of current headline@footnote{See also the option
4656@code{org-priority-start-cycle-with-default}.}. Note that these keys are 4657@code{org-priority-start-cycle-with-default}.}. Note that these keys are
@@ -4669,7 +4670,7 @@ these values (highest, lowest, default) like this (please make sure that
4669the highest priority is earlier in the alphabet than the lowest 4670the highest priority is earlier in the alphabet than the lowest
4670priority): 4671priority):
4671 4672
4672@cindex #+PRIORITIES 4673@cindex @code{#+PRIORITIES}
4673@example 4674@example
4674#+PRIORITIES: A C B 4675#+PRIORITIES: A C B
4675@end example 4676@end example
@@ -4698,7 +4699,7 @@ be updated each time the TODO status of a child changes, or when pressing
4698** DONE Talk to neighbor 4699** DONE Talk to neighbor
4699@end example 4700@end example
4700 4701
4701@cindex property, COOKIE_DATA 4702@cindex property, @code{COOKIE_DATA}
4702If a heading has both checkboxes and TODO children below it, the meaning of 4703If a heading has both checkboxes and TODO children below it, the meaning of
4703the statistics cookie become ambiguous. Set the property 4704the statistics cookie become ambiguous. Set the property
4704@code{COOKIE_DATA} to either @samp{checkbox} or @samp{todo} to resolve 4705@code{COOKIE_DATA} to either @samp{checkbox} or @samp{todo} to resolve
@@ -4770,7 +4771,7 @@ checked.
4770 4771
4771@cindex statistics, for checkboxes 4772@cindex statistics, for checkboxes
4772@cindex checkbox statistics 4773@cindex checkbox statistics
4773@cindex property, COOKIE_DATA 4774@cindex property, @code{COOKIE_DATA}
4774@vindex org-checkbox-hierarchical-statistics 4775@vindex org-checkbox-hierarchical-statistics
4775The @samp{[2/4]} and @samp{[1/3]} in the first and second line are cookies 4776The @samp{[2/4]} and @samp{[1/3]} in the first and second line are cookies
4776indicating how many checkboxes present in this entry have been checked off, 4777indicating how many checkboxes present in this entry have been checked off,
@@ -4792,7 +4793,7 @@ to either @samp{checkbox} or @samp{todo} to resolve this issue.
4792 4793
4793@cindex blocking, of checkboxes 4794@cindex blocking, of checkboxes
4794@cindex checkbox blocking 4795@cindex checkbox blocking
4795@cindex property, ORDERED 4796@cindex property, @code{ORDERED}
4796If the current outline node has an @code{ORDERED} property, checkboxes must 4797If the current outline node has an @code{ORDERED} property, checkboxes must
4797be checked off in sequence, and an error will be thrown if you try to check 4798be checked off in sequence, and an error will be thrown if you try to check
4798off a box while there are unchecked boxes above it. 4799off a box while there are unchecked boxes above it.
@@ -4829,7 +4830,7 @@ Insert a new item with a checkbox. This works only if the cursor is already
4829in a plain list item (@pxref{Plain lists}). 4830in a plain list item (@pxref{Plain lists}).
4830@orgcmd{C-c C-x o,org-toggle-ordered-property} 4831@orgcmd{C-c C-x o,org-toggle-ordered-property}
4831@vindex org-track-ordered-property-with-tag 4832@vindex org-track-ordered-property-with-tag
4832@cindex property, ORDERED 4833@cindex property, @code{ORDERED}
4833Toggle the @code{ORDERED} property of the entry, to toggle if checkboxes must 4834Toggle the @code{ORDERED} property of the entry, to toggle if checkboxes must
4834be checked off in sequence. A property is used for this behavior because 4835be checked off in sequence. A property is used for this behavior because
4835this should be local to the current entry, not inherited like a tag. 4836this should be local to the current entry, not inherited like a tag.
@@ -4897,7 +4898,7 @@ a hypothetical level zero that surrounds the entire file. Use a line like
4897this@footnote{As with all these in-buffer settings, pressing @kbd{C-c C-c} 4898this@footnote{As with all these in-buffer settings, pressing @kbd{C-c C-c}
4898activates any changes in the line.}: 4899activates any changes in the line.}:
4899 4900
4900@cindex #+FILETAGS 4901@cindex @code{#+FILETAGS}
4901@example 4902@example
4902#+FILETAGS: :Peter:Boss:Secret: 4903#+FILETAGS: :Peter:Boss:Secret:
4903@end example 4904@end example
@@ -4931,7 +4932,7 @@ can really speed up agenda generation.
4931@cindex setting tags 4932@cindex setting tags
4932@cindex tags, setting 4933@cindex tags, setting
4933 4934
4934@kindex M-@key{TAB} 4935@kindex M-TAB
4935Tags can simply be typed into the buffer at the end of a headline. 4936Tags can simply be typed into the buffer at the end of a headline.
4936After a colon, @kbd{M-@key{TAB}} offers completion on tags. There is 4937After a colon, @kbd{M-@key{TAB}} offers completion on tags. There is
4937also a special command for inserting tags: 4938also a special command for inserting tags:
@@ -4959,7 +4960,7 @@ currently used in the buffer. You may also globally specify a hard list
4959of tags with the variable @code{org-tag-alist}. Finally you can set 4960of tags with the variable @code{org-tag-alist}. Finally you can set
4960the default tags for a given file with lines like 4961the default tags for a given file with lines like
4961 4962
4962@cindex #+TAGS 4963@cindex @code{#+TAGS}
4963@example 4964@example
4964#+TAGS: @@work @@home @@tennisclub 4965#+TAGS: @@work @@home @@tennisclub
4965#+TAGS: laptop car pc sailboat 4966#+TAGS: laptop car pc sailboat
@@ -4978,7 +4979,7 @@ If you have a preferred set of tags that you would like to use in every file,
4978in addition to those defined on a per-file basis by TAGS option lines, then 4979in addition to those defined on a per-file basis by TAGS option lines, then
4979you may specify a list of tags with the variable 4980you may specify a list of tags with the variable
4980@code{org-tag-persistent-alist}. You may turn this off on a per-file basis 4981@code{org-tag-persistent-alist}. You may turn this off on a per-file basis
4981by adding a STARTUP option line to that file: 4982by adding a @code{#+STARTUP} option line to that file:
4982 4983
4983@example 4984@example
4984#+STARTUP: noptag 4985#+STARTUP: noptag
@@ -5062,17 +5063,17 @@ will turn off any other tags from that group.
5062In this interface, you can also use the following special keys: 5063In this interface, you can also use the following special keys:
5063 5064
5064@table @kbd 5065@table @kbd
5065@kindex @key{TAB} 5066@kindex TAB
5066@item @key{TAB} 5067@item @key{TAB}
5067Enter a tag in the minibuffer, even if the tag is not in the predefined 5068Enter a tag in the minibuffer, even if the tag is not in the predefined
5068list. You will be able to complete on all tags present in the buffer. 5069list. You will be able to complete on all tags present in the buffer.
5069You can also add several tags: just separate them with a comma. 5070You can also add several tags: just separate them with a comma.
5070 5071
5071@kindex @key{SPC} 5072@kindex SPC
5072@item @key{SPC} 5073@item @key{SPC}
5073Clear all tags for this line. 5074Clear all tags for this line.
5074 5075
5075@kindex @key{RET} 5076@kindex RET
5076@item @key{RET} 5077@item @key{RET}
5077Accept the modified set. 5078Accept the modified set.
5078 5079
@@ -5328,8 +5329,8 @@ publishers and the number of disks in a box like this:
5328 5329
5329If you want to set properties that can be inherited by any entry in a 5330If you want to set properties that can be inherited by any entry in a
5330file, use a line like 5331file, use a line like
5331@cindex property, _ALL 5332@cindex property, @code{_ALL}
5332@cindex #+PROPERTY 5333@cindex @code{#+PROPERTY}
5333@example 5334@example
5334#+PROPERTY: NDisks_ALL 1 2 3 4 5335#+PROPERTY: NDisks_ALL 1 2 3 4
5335@end example 5336@end example
@@ -5340,7 +5341,7 @@ buffer with @kbd{C-c C-c} to activate this change.
5340If you want to add to the value of an existing property, append a @code{+} to 5341If you want to add to the value of an existing property, append a @code{+} to
5341the property name. The following results in the property @code{var} having 5342the property name. The following results in the property @code{var} having
5342the value ``foo=1 bar=2''. 5343the value ``foo=1 bar=2''.
5343@cindex property, + 5344@cindex property, @code{+}
5344@example 5345@example
5345#+PROPERTY: var foo=1 5346#+PROPERTY: var foo=1
5346#+PROPERTY: var+ bar=2 5347#+PROPERTY: var+ bar=2
@@ -5349,7 +5350,7 @@ the value ``foo=1 bar=2''.
5349It is also possible to add to the values of inherited properties. The 5350It is also possible to add to the values of inherited properties. The
5350following results in the @code{genres} property having the value ``Classic 5351following results in the @code{genres} property having the value ``Classic
5351Baroque'' under the @code{Goldberg Variations} subtree. 5352Baroque'' under the @code{Goldberg Variations} subtree.
5352@cindex property, + 5353@cindex property, @code{+}
5353@example 5354@example
5354* CD collection 5355* CD collection
5355** Classic 5356** Classic
@@ -5383,8 +5384,8 @@ in the current file will be offered as possible completions.
5383@orgcmd{C-c C-x p,org-set-property} 5384@orgcmd{C-c C-x p,org-set-property}
5384Set a property. This prompts for a property name and a value. If 5385Set a property. This prompts for a property name and a value. If
5385necessary, the property drawer is created as well. 5386necessary, the property drawer is created as well.
5386@item C-u M-x org-insert-drawer RET 5387@item C-u M-x org-insert-drawer @key{RET}
5387@cindex org-insert-drawer 5388@cindex @code{org-insert-drawer}
5388Insert a property drawer into the current entry. The drawer will be 5389Insert a property drawer into the current entry. The drawer will be
5389inserted early in the entry, but after the lines with planning 5390inserted early in the entry, but after the lines with planning
5390information like deadlines. 5391information like deadlines.
@@ -5393,7 +5394,7 @@ With the cursor in a property drawer, this executes property commands.
5393@orgcmd{C-c C-c s,org-set-property} 5394@orgcmd{C-c C-c s,org-set-property}
5394Set a property in the current entry. Both the property and the value 5395Set a property in the current entry. Both the property and the value
5395can be inserted using completion. 5396can be inserted using completion.
5396@orgcmdkkcc{S-@key{right},S-@key{left},org-property-next-allowed-value,org-property-previous-allowed-value} 5397@orgcmdkkcc{S-@key{RIGHT},S-@key{LEFT},org-property-next-allowed-value,org-property-previous-allowed-value}
5397Switch property at point to the next/previous allowed value. 5398Switch property at point to the next/previous allowed value.
5398@orgcmd{C-c C-c d,org-delete-property} 5399@orgcmd{C-c C-c d,org-delete-property}
5399Remove a property from the current entry. 5400Remove a property from the current entry.
@@ -5415,20 +5416,20 @@ a column view (@pxref{Column view}), or to use them in queries. The
5415following property names are special and should not be used as keys in the 5416following property names are special and should not be used as keys in the
5416properties drawer: 5417properties drawer:
5417 5418
5418@cindex property, special, ALLTAGS 5419@cindex property, special, @code{ALLTAGS}
5419@cindex property, special, BLOCKED 5420@cindex property, special, @code{BLOCKED}
5420@cindex property, special, CLOCKSUM 5421@cindex property, special, @code{CLOCKSUM}
5421@cindex property, special, CLOCKSUM_T 5422@cindex property, special, @code{CLOCKSUM_T}
5422@cindex property, special, CLOSED 5423@cindex property, special, @code{CLOSED}
5423@cindex property, special, DEADLINE 5424@cindex property, special, @code{DEADLINE}
5424@cindex property, special, FILE 5425@cindex property, special, @code{FILE}
5425@cindex property, special, ITEM 5426@cindex property, special, @code{ITEM}
5426@cindex property, special, PRIORITY 5427@cindex property, special, @code{PRIORITY}
5427@cindex property, special, SCHEDULED 5428@cindex property, special, @code{SCHEDULED}
5428@cindex property, special, TAGS 5429@cindex property, special, @code{TAGS}
5429@cindex property, special, TIMESTAMP 5430@cindex property, special, @code{TIMESTAMP}
5430@cindex property, special, TIMESTAMP_IA 5431@cindex property, special, @code{TIMESTAMP_IA}
5431@cindex property, special, TODO 5432@cindex property, special, @code{TODO}
5432@example 5433@example
5433ALLTAGS @r{All tags, including inherited ones.} 5434ALLTAGS @r{All tags, including inherited ones.}
5434BLOCKED @r{"t" if task is currently blocked by children or siblings.} 5435BLOCKED @r{"t" if task is currently blocked by children or siblings.}
@@ -5508,7 +5509,7 @@ search will stop at this value and return @code{nil}.
5508Org mode has a few properties for which inheritance is hard-coded, at 5509Org mode has a few properties for which inheritance is hard-coded, at
5509least for the special applications for which they are used: 5510least for the special applications for which they are used:
5510 5511
5511@cindex property, COLUMNS 5512@cindex property, @code{COLUMNS}
5512@table @code 5513@table @code
5513@item COLUMNS 5514@item COLUMNS
5514The @code{:COLUMNS:} property defines the format of column view 5515The @code{:COLUMNS:} property defines the format of column view
@@ -5517,16 +5518,16 @@ where a @code{:COLUMNS:} property is defined is used as the starting
5517point for a column view table, independently of the location in the 5518point for a column view table, independently of the location in the
5518subtree from where columns view is turned on. 5519subtree from where columns view is turned on.
5519@item CATEGORY 5520@item CATEGORY
5520@cindex property, CATEGORY 5521@cindex property, @code{CATEGORY}
5521For agenda view, a category set through a @code{:CATEGORY:} property 5522For agenda view, a category set through a @code{:CATEGORY:} property
5522applies to the entire subtree. 5523applies to the entire subtree.
5523@item ARCHIVE 5524@item ARCHIVE
5524@cindex property, ARCHIVE 5525@cindex property, @code{ARCHIVE}
5525For archiving, the @code{:ARCHIVE:} property may define the archive 5526For archiving, the @code{:ARCHIVE:} property may define the archive
5526location for the entire subtree (@pxref{Moving subtrees}). 5527location for the entire subtree (@pxref{Moving subtrees}).
5527@item LOGGING 5528@item LOGGING
5528@cindex property, LOGGING 5529@cindex property, @code{LOGGING}
5529The LOGGING property may define logging settings for an entry or a 5530The @code{LOGGING} property may define logging settings for an entry or a
5530subtree (@pxref{Tracking TODO state changes}). 5531subtree (@pxref{Tracking TODO state changes}).
5531@end table 5532@end table
5532 5533
@@ -5571,7 +5572,7 @@ done by defining a column format line.
5571 5572
5572To define a column format for an entire file, use a line like 5573To define a column format for an entire file, use a line like
5573 5574
5574@cindex #+COLUMNS 5575@cindex @code{#+COLUMNS}
5575@example 5576@example
5576#+COLUMNS: %25ITEM %TAGS %PRIORITY %TODO 5577#+COLUMNS: %25ITEM %TAGS %PRIORITY %TODO
5577@end example 5578@end example
@@ -5723,17 +5724,17 @@ Same as @kbd{r}.
5723@orgcmd{q,org-columns-quit} 5724@orgcmd{q,org-columns-quit}
5724Exit column view. 5725Exit column view.
5725@tsubheading{Editing values} 5726@tsubheading{Editing values}
5726@item @key{left} @key{right} @key{up} @key{down} 5727@item @key{LEFT} @key{RIGHT} @key{UP} @key{DOWN}
5727Move through the column view from field to field. 5728Move through the column view from field to field.
5728@kindex S-@key{left} 5729@kindex S-LEFT
5729@kindex S-@key{right} 5730@kindex S-RIGHT
5730@item S-@key{left}/@key{right} 5731@item S-@key{LEFT}/@key{RIGHT}
5731Switch to the next/previous allowed value of the field. For this, you 5732Switch to the next/previous allowed value of the field. For this, you
5732have to have specified allowed values for a property. 5733have to have specified allowed values for a property.
5733@item 1..9,0 5734@item 1..9,0
5734Directly select the Nth allowed value, @kbd{0} selects the 10th value. 5735Directly select the Nth allowed value, @kbd{0} selects the 10th value.
5735@orgcmdkkcc{n,p,org-columns-next-allowed-value,org-columns-previous-allowed-value} 5736@orgcmdkkcc{n,p,org-columns-next-allowed-value,org-columns-previous-allowed-value}
5736Same as @kbd{S-@key{left}/@key{right}} 5737Same as @kbd{S-@key{LEFT}/@key{RIGHT}}
5737@orgcmd{e,org-columns-edit-value} 5738@orgcmd{e,org-columns-edit-value}
5738Edit the property at point. For the special properties, this will 5739Edit the property at point. For the special properties, this will
5739invoke the same interface that you normally use to change that 5740invoke the same interface that you normally use to change that
@@ -5752,9 +5753,9 @@ current column view.
5752@tsubheading{Modifying the table structure} 5753@tsubheading{Modifying the table structure}
5753@orgcmdkkcc{<,>,org-columns-narrow,org-columns-widen} 5754@orgcmdkkcc{<,>,org-columns-narrow,org-columns-widen}
5754Make the column narrower/wider by one character. 5755Make the column narrower/wider by one character.
5755@orgcmd{S-M-@key{right},org-columns-new} 5756@orgcmd{S-M-@key{RIGHT},org-columns-new}
5756Insert a new column, to the left of the current column. 5757Insert a new column, to the left of the current column.
5757@orgcmd{S-M-@key{left},org-columns-delete} 5758@orgcmd{S-M-@key{LEFT},org-columns-delete}
5758Delete the current column. 5759Delete the current column.
5759@end table 5760@end table
5760 5761
@@ -5766,7 +5767,7 @@ exported or printed directly. If you want to capture a column view, use
5766a @code{columnview} dynamic block (@pxref{Dynamic blocks}). The frame 5767a @code{columnview} dynamic block (@pxref{Dynamic blocks}). The frame
5767of this block looks like this: 5768of this block looks like this:
5768 5769
5769@cindex #+BEGIN, columnview 5770@cindex @code{#+BEGIN}, columnview
5770@example 5771@example
5771* The column view 5772* The column view
5772#+BEGIN: columnview :hlines 1 :id "label" 5773#+BEGIN: columnview :hlines 1 :id "label"
@@ -5782,7 +5783,7 @@ This is the most important parameter. Column view is a feature that is
5782often localized to a certain (sub)tree, and the capture block might be 5783often localized to a certain (sub)tree, and the capture block might be
5783at a different location in the file. To identify the tree whose view to 5784at a different location in the file. To identify the tree whose view to
5784capture, you can use 4 values: 5785capture, you can use 4 values:
5785@cindex property, ID 5786@cindex property, @code{ID}
5786@example 5787@example
5787local @r{use the tree in which the capture block is located} 5788local @r{use the tree in which the capture block is located}
5788global @r{make a global view, including all headings in the file} 5789global @r{make a global view, including all headings in the file}
@@ -5790,7 +5791,7 @@ global @r{make a global view, including all headings in the file}
5790 @r{run column view at the top of this file} 5791 @r{run column view at the top of this file}
5791"@var{ID}" @r{call column view in the tree that has an @code{:ID:}} 5792"@var{ID}" @r{call column view in the tree that has an @code{:ID:}}
5792 @r{property with the value @i{label}. You can use} 5793 @r{property with the value @i{label}. You can use}
5793 @r{@kbd{M-x org-id-copy RET} to create a globally unique ID for} 5794 @r{@kbd{M-x org-id-copy @key{RET}} to create a globally unique @code{ID} for}
5794 @r{the current entry and copy it to the kill-ring.} 5795 @r{the current entry and copy it to the kill-ring.}
5795@end example 5796@end example
5796@item :hlines 5797@item :hlines
@@ -5814,7 +5815,7 @@ The following commands insert or update the dynamic block:
5814@table @kbd 5815@table @kbd
5815@orgcmd{C-c C-x i,org-insert-columns-dblock} 5816@orgcmd{C-c C-x i,org-insert-columns-dblock}
5816Insert a dynamic block capturing a column view. You will be prompted 5817Insert a dynamic block capturing a column view. You will be prompted
5817for the scope or ID of the view. 5818for the scope or @code{ID} of the view.
5818@orgcmdkkc{C-c C-c,C-c C-x C-u,org-dblock-update} 5819@orgcmdkkc{C-c C-c,C-c C-x C-u,org-dblock-update}
5819Update dynamic block at point. 5820Update dynamic block at point.
5820@orgcmd{C-u C-c C-x C-u,org-update-all-dblocks} 5821@orgcmd{C-u C-c C-x C-u,org-update-all-dblocks}
@@ -6008,11 +6009,11 @@ instead.
6008Access the agenda for the date given by the timestamp or -range at 6009Access the agenda for the date given by the timestamp or -range at
6009point (@pxref{Weekly/daily agenda}). 6010point (@pxref{Weekly/daily agenda}).
6010@c 6011@c
6011@orgcmdkkcc{S-@key{left},S-@key{right},org-timestamp-down-day,org-timestamp-up-day} 6012@orgcmdkkcc{S-@key{LEFT},S-@key{RIGHT},org-timestamp-down-day,org-timestamp-up-day}
6012Change date at cursor by one day. These key bindings conflict with 6013Change date at cursor by one day. These key bindings conflict with
6013shift-selection and related modes (@pxref{Conflicts}). 6014shift-selection and related modes (@pxref{Conflicts}).
6014@c 6015@c
6015@orgcmdkkcc{S-@key{up},S-@key{down},org-timestamp-up,org-timestamp-down-down} 6016@orgcmdkkcc{S-@key{UP},S-@key{DOWN},org-timestamp-up,org-timestamp-down-down}
6016Change the item under the cursor in a timestamp. The cursor can be on a 6017Change the item under the cursor in a timestamp. The cursor can be on a
6017year, month, day, hour or minute. When the timestamp contains a time range 6018year, month, day, hour or minute. When the timestamp contains a time range
6018like @samp{15:30-16:30}, modifying the first time will also shift the second, 6019like @samp{15:30-16:30}, modifying the first time will also shift the second,
@@ -6136,25 +6137,25 @@ from the minibuffer:
6136@kindex M-v 6137@kindex M-v
6137@kindex C-v 6138@kindex C-v
6138@kindex mouse-1 6139@kindex mouse-1
6139@kindex S-@key{right} 6140@kindex S-RIGHT
6140@kindex S-@key{left} 6141@kindex S-LEFT
6141@kindex S-@key{down} 6142@kindex S-DOWN
6142@kindex S-@key{up} 6143@kindex S-UP
6143@kindex M-S-@key{right} 6144@kindex M-S-RIGHT
6144@kindex M-S-@key{left} 6145@kindex M-S-LEFT
6145@kindex @key{RET} 6146@kindex RET
6146@kindex M-S-@key{down} 6147@kindex M-S-DOWN
6147@kindex M-S-@key{up} 6148@kindex M-S-UP
6148 6149
6149@example 6150@example
6150@key{RET} @r{Choose date at cursor in calendar.} 6151@key{RET} @r{Choose date at cursor in calendar.}
6151mouse-1 @r{Select date by clicking on it.} 6152mouse-1 @r{Select date by clicking on it.}
6152S-@key{right}/@key{left} @r{One day forward/backward.} 6153S-@key{RIGHT}/@key{LEFT} @r{One day forward/backward.}
6153S-@key{down}/@key{up} @r{One week forward/backward.} 6154S-@key{DOWN}/@key{UP} @r{One week forward/backward.}
6154M-S-@key{right}/@key{left} @r{One month forward/backward.} 6155M-S-@key{RIGHT}/@key{LEFT} @r{One month forward/backward.}
6155> / < @r{Scroll calendar forward/backward by one month.} 6156> / < @r{Scroll calendar forward/backward by one month.}
6156M-v / C-v @r{Scroll calendar forward/backward by 3 months.} 6157M-v / C-v @r{Scroll calendar forward/backward by 3 months.}
6157M-S-@key{down}/@key{up} @r{Scroll calendar forward/backward by one year.} 6158M-S-@key{DOWN}/@key{UP} @r{Scroll calendar forward/backward by one year.}
6158@end example 6159@end example
6159 6160
6160@vindex org-read-date-display-live 6161@vindex org-read-date-display-live
@@ -6194,10 +6195,10 @@ following consequences:
6194You cannot place the cursor onto a timestamp anymore, only before or 6195You cannot place the cursor onto a timestamp anymore, only before or
6195after. 6196after.
6196@item 6197@item
6197The @kbd{S-@key{up}/@key{down}} keys can no longer be used to adjust 6198The @kbd{S-@key{UP}/@key{DOWN}} keys can no longer be used to adjust
6198each component of a timestamp. If the cursor is at the beginning of 6199each component of a timestamp. If the cursor is at the beginning of
6199the stamp, @kbd{S-@key{up}/@key{down}} will change the stamp by one day, 6200the stamp, @kbd{S-@key{UP}/@key{DOWN}} will change the stamp by one day,
6200just like @kbd{S-@key{left}/@key{right}}. At the end of the stamp, the 6201just like @kbd{S-@key{LEFT}/@key{RIGHT}}. At the end of the stamp, the
6201time will be changed by one minute. 6202time will be changed by one minute.
6202@item 6203@item
6203If the timestamp contains a range of clock times or a repeater, these 6204If the timestamp contains a range of clock times or a repeater, these
@@ -6222,7 +6223,7 @@ they refer to.
6222 6223
6223@table @var 6224@table @var
6224@item DEADLINE 6225@item DEADLINE
6225@cindex DEADLINE keyword 6226@cindex @code{DEADLINE} keyword
6226 6227
6227Meaning: the task (most likely a TODO item, though not necessarily) is supposed 6228Meaning: the task (most likely a TODO item, though not necessarily) is supposed
6228to be finished on that date. 6229to be finished on that date.
@@ -6248,7 +6249,7 @@ deactivated if the task gets scheduled and you set
6248@code{org-agenda-skip-deadline-prewarning-if-scheduled} to @code{t}. 6249@code{org-agenda-skip-deadline-prewarning-if-scheduled} to @code{t}.
6249 6250
6250@item SCHEDULED 6251@item SCHEDULED
6251@cindex SCHEDULED keyword 6252@cindex @code{SCHEDULED} keyword
6252 6253
6253Meaning: you are planning to start working on that task on the given 6254Meaning: you are planning to start working on that task on the given
6254date. 6255date.
@@ -6313,7 +6314,7 @@ an item:
6313@table @kbd 6314@table @kbd
6314@c 6315@c
6315@orgcmd{C-c C-d,org-deadline} 6316@orgcmd{C-c C-d,org-deadline}
6316Insert @samp{DEADLINE} keyword along with a stamp. Any CLOSED timestamp will 6317Insert @code{DEADLINE} keyword along with a stamp. Any CLOSED timestamp will
6317be removed. When called with a prefix arg, an existing deadline will be 6318be removed. When called with a prefix arg, an existing deadline will be
6318removed from the entry. Depending on the variable 6319removed from the entry. Depending on the variable
6319@code{org-log-redeadline}@footnote{with corresponding @code{#+STARTUP} 6320@code{org-log-redeadline}@footnote{with corresponding @code{#+STARTUP}
@@ -6322,7 +6323,7 @@ keywords @code{logredeadline}, @code{lognoteredeadline}, and
6322deadline. 6323deadline.
6323 6324
6324@orgcmd{C-c C-s,org-schedule} 6325@orgcmd{C-c C-s,org-schedule}
6325Insert @samp{SCHEDULED} keyword along with a stamp. Any CLOSED timestamp 6326Insert @code{SCHEDULED} keyword along with a stamp. Any CLOSED timestamp
6326will be removed. When called with a prefix argument, remove the scheduling 6327will be removed. When called with a prefix argument, remove the scheduling
6327date from the entry. Depending on the variable 6328date from the entry. Depending on the variable
6328@code{org-log-reschedule}@footnote{with corresponding @code{#+STARTUP} 6329@code{org-log-reschedule}@footnote{with corresponding @code{#+STARTUP}
@@ -6356,8 +6357,8 @@ to the previous week before any current timestamp.
6356@cindex tasks, repeated 6357@cindex tasks, repeated
6357@cindex repeated tasks 6358@cindex repeated tasks
6358 6359
6359Some tasks need to be repeated again and again. Org mode helps to 6360Some tasks need to be repeated again and again. Org mode helps to organize
6360organize such tasks using a so-called repeater in a DEADLINE, SCHEDULED, 6361such tasks using a so-called repeater in a @code{DEADLINE}, @code{SCHEDULED},
6361or plain timestamp. In the following example 6362or plain timestamp. In the following example
6362@example 6363@example
6363** TODO Pay the rent 6364** TODO Pay the rent
@@ -6374,18 +6375,18 @@ first and the warning period last: @code{DEADLINE: <2005-10-01 Sat +1m -3d>}.
6374@vindex org-todo-repeat-to-state 6375@vindex org-todo-repeat-to-state
6375Deadlines and scheduled items produce entries in the agenda when they are 6376Deadlines and scheduled items produce entries in the agenda when they are
6376over-due, so it is important to be able to mark such an entry as completed 6377over-due, so it is important to be able to mark such an entry as completed
6377once you have done so. When you mark a DEADLINE or a SCHEDULE with the TODO 6378once you have done so. When you mark a @code{DEADLINE} or a @code{SCHEDULED}
6378keyword DONE, it will no longer produce entries in the agenda. The problem 6379with the TODO keyword DONE, it will no longer produce entries in the agenda.
6379with this is, however, that then also the @emph{next} instance of the 6380The problem with this is, however, that then also the @emph{next} instance of
6380repeated entry will not be active. Org mode deals with this in the following 6381the repeated entry will not be active. Org mode deals with this in the
6381way: When you try to mark such an entry DONE (using @kbd{C-c C-t}), it will 6382following way: When you try to mark such an entry DONE (using @kbd{C-c C-t}),
6382shift the base date of the repeating timestamp by the repeater interval, and 6383it will shift the base date of the repeating timestamp by the repeater
6383immediately set the entry state back to TODO@footnote{In fact, the target 6384interval, and immediately set the entry state back to TODO@footnote{In fact,
6384state is taken from, in this sequence, the @code{REPEAT_TO_STATE} property or 6385the target state is taken from, in this sequence, the @code{REPEAT_TO_STATE}
6385the variable @code{org-todo-repeat-to-state}. If neither of these is 6386property or the variable @code{org-todo-repeat-to-state}. If neither of
6386specified, the target state defaults to the first state of the TODO state 6387these is specified, the target state defaults to the first state of the TODO
6387sequence.}. In the example above, setting the state to DONE would actually 6388state sequence.}. In the example above, setting the state to DONE would
6388switch the date like this: 6389actually switch the date like this:
6389 6390
6390@example 6391@example
6391** TODO Pay the rent 6392** TODO Pay the rent
@@ -6491,22 +6492,21 @@ what to do with it.
6491@orgcmd{C-c C-x C-i,org-clock-in} 6492@orgcmd{C-c C-x C-i,org-clock-in}
6492@vindex org-clock-into-drawer 6493@vindex org-clock-into-drawer
6493@vindex org-clock-continuously 6494@vindex org-clock-continuously
6494@cindex property, LOG_INTO_DRAWER 6495@cindex property, @code{LOG_INTO_DRAWER}
6495Start the clock on the current item (clock-in). This inserts the CLOCK 6496!Start the clock on the current item (clock-in). This inserts the
6496keyword together with a timestamp. If this is not the first clocking of 6497@code{CLOCK} keyword together with a timestamp. If this is not the first
6497this item, the multiple CLOCK lines will be wrapped into a 6498clocking of this item, the multiple @code{CLOCK} lines will be wrapped into a
6498@code{:LOGBOOK:} drawer (see also the variable 6499@code{:LOGBOOK:} drawer (see also the variable @code{org-clock-into-drawer}).
6499@code{org-clock-into-drawer}). You can also overrule 6500You can also overrule the setting of this variable for a subtree by setting a
6500the setting of this variable for a subtree by setting a 6501@code{CLOCK_INTO_DRAWER} or @code{LOG_INTO_DRAWER} property. When called
6501@code{CLOCK_INTO_DRAWER} or @code{LOG_INTO_DRAWER} property. 6502with a @kbd{C-u} prefix argument, select the task from a list of recently
6502When called with a @kbd{C-u} prefix argument, 6503clocked tasks. With two @kbd{C-u C-u} prefixes, clock into the task at point
6503select the task from a list of recently clocked tasks. With two @kbd{C-u 6504and mark it as the default task; the default task will then always be
6504C-u} prefixes, clock into the task at point and mark it as the default task; 6505available with letter @kbd{d} when selecting a clocking task. With three
6505the default task will then always be available with letter @kbd{d} when 6506@kbd{C-u C-u C-u} prefixes, force continuous clocking by starting the clock
6506selecting a clocking task. With three @kbd{C-u C-u C-u} prefixes, force 6507when the last clock stopped.@*
6507continuous clocking by starting the clock when the last clock stopped.@* 6508@cindex property, @code{CLOCK_MODELINE_TOTAL}
6508@cindex property: CLOCK_MODELINE_TOTAL 6509@cindex property, @code{LAST_REPEAT}
6509@cindex property: LAST_REPEAT
6510@vindex org-clock-modeline-total 6510@vindex org-clock-modeline-total
6511While the clock is running, the current clocking time is shown in the mode 6511While the clock is running, the current clocking time is shown in the mode
6512line, along with the title of the task. The clock time shown will be all 6512line, along with the title of the task. The clock time shown will be all
@@ -6554,7 +6554,7 @@ clock duration keeps the same.
6554@orgcmd{S-M-@key{up/down},org-timestamp-up/down} 6554@orgcmd{S-M-@key{up/down},org-timestamp-up/down}
6555On @code{CLOCK} log lines, increase/decrease the timestamp at point and 6555On @code{CLOCK} log lines, increase/decrease the timestamp at point and
6556the one of the previous (or the next clock) timestamp by the same duration. 6556the one of the previous (or the next clock) timestamp by the same duration.
6557For example, if you hit @kbd{S-M-@key{up}} to increase a clocked-out timestamp 6557For example, if you hit @kbd{S-M-@key{UP}} to increase a clocked-out timestamp
6558by five minutes, then the clocked-in timestamp of the next clock will be 6558by five minutes, then the clocked-in timestamp of the next clock will be
6559increased by five minutes. 6559increased by five minutes.
6560@orgcmd{C-c C-t,org-todo} 6560@orgcmd{C-c C-t,org-todo}
@@ -6605,7 +6605,7 @@ Update dynamic block at point.
6605@orgkey{C-u C-c C-x C-u} 6605@orgkey{C-u C-c C-x C-u}
6606Update all dynamic blocks (@pxref{Dynamic blocks}). This is useful if 6606Update all dynamic blocks (@pxref{Dynamic blocks}). This is useful if
6607you have several clock table blocks in a buffer. 6607you have several clock table blocks in a buffer.
6608@orgcmdkxkc{S-@key{left},S-@key{right},org-clocktable-try-shift} 6608@orgcmdkxkc{S-@key{LEFT},S-@key{RIGHT},org-clocktable-try-shift}
6609Shift the current @code{:block} interval and update the table. The cursor 6609Shift the current @code{:block} interval and update the table. The cursor
6610needs to be in the @code{#+BEGIN: clocktable} line for this command. If 6610needs to be in the @code{#+BEGIN: clocktable} line for this command. If
6611@code{:block} is @code{today}, it will be shifted to @code{today-1} etc. 6611@code{:block} is @code{today}, it will be shifted to @code{today-1} etc.
@@ -6615,7 +6615,7 @@ needs to be in the @code{#+BEGIN: clocktable} line for this command. If
6615Here is an example of the frame for a clock table as it is inserted into the 6615Here is an example of the frame for a clock table as it is inserted into the
6616buffer with the @kbd{C-c C-x C-r} command: 6616buffer with the @kbd{C-c C-x C-r} command:
6617 6617
6618@cindex #+BEGIN, clocktable 6618@cindex @code{#+BEGIN}, clocktable
6619@example 6619@example
6620#+BEGIN: clocktable :maxlevel 2 :emphasize nil :scope file 6620#+BEGIN: clocktable :maxlevel 2 :emphasize nil :scope file
6621#+END: clocktable 6621#+END: clocktable
@@ -6655,7 +6655,7 @@ be selected:
6655 thismonth, lastmonth, thismonth-@var{N} @r{a relative month} 6655 thismonth, lastmonth, thismonth-@var{N} @r{a relative month}
6656 thisyear, lastyear, thisyear-@var{N} @r{a relative year} 6656 thisyear, lastyear, thisyear-@var{N} @r{a relative year}
6657 untilnow 6657 untilnow
6658 @r{Use @kbd{S-@key{left}/@key{right}} keys to shift the time interval.} 6658 @r{Use @kbd{S-@key{LEFT}/@key{RIGHT}} keys to shift the time interval.}
6659:tstart @r{A time string specifying when to start considering times.} 6659:tstart @r{A time string specifying when to start considering times.}
6660 @r{Relative times like @code{"<-2w>"} can also be used. See} 6660 @r{Relative times like @code{"<-2w>"} can also be used. See}
6661 @r{@ref{Matching tags and properties} for relative time syntax.} 6661 @r{@ref{Matching tags and properties} for relative time syntax.}
@@ -6691,8 +6691,8 @@ but you can specify your own function using the @code{:formatter} parameter.
6691 @r{E.g., @code{:sort (1 . ?a)} sorts the first column alphabetically.} 6691 @r{E.g., @code{:sort (1 . ?a)} sorts the first column alphabetically.}
6692:compact @r{Abbreviation for @code{:level nil :indent t :narrow 40! :tcolumns 1}} 6692:compact @r{Abbreviation for @code{:level nil :indent t :narrow 40! :tcolumns 1}}
6693 @r{All are overwritten except if there is an explicit @code{:narrow}} 6693 @r{All are overwritten except if there is an explicit @code{:narrow}}
6694:timestamp @r{A timestamp for the entry, when available. Look for SCHEDULED,} 6694:timestamp @r{A timestamp for the entry, when available. Look for @code{SCHEDULED},}
6695 @r{DEADLINE, TIMESTAMP and TIMESTAMP_IA, in this order.} 6695 @r{@code{DEADLINE}, @code{TIMESTAMP} and @code{TIMESTAMP_IA}, in this order.}
6696:properties @r{List of properties that should be shown in the table. Each} 6696:properties @r{List of properties that should be shown in the table. Each}
6697 @r{property will get its own column.} 6697 @r{property will get its own column.}
6698:inherit-props @r{When this flag is @code{t}, the values for @code{:properties} will be inherited.} 6698:inherit-props @r{When this flag is @code{t}, the values for @code{:properties} will be inherited.}
@@ -6805,7 +6805,8 @@ identical to dealing with away time due to idleness; it is just happening due
6805to a recovery event rather than a set amount of idle time. 6805to a recovery event rather than a set amount of idle time.
6806 6806
6807You can also check all the files visited by your Org agenda for dangling 6807You can also check all the files visited by your Org agenda for dangling
6808clocks at any time using @kbd{M-x org-resolve-clocks RET} (or @kbd{C-c C-x C-z}). 6808clocks at any time using @kbd{M-x org-resolve-clocks @key{RET}} (or @kbd{C-c
6809C-x C-z}).
6809 6810
6810@subsubheading Continuous clocking 6811@subsubheading Continuous clocking
6811@cindex continuous clocking 6812@cindex continuous clocking
@@ -6823,7 +6824,7 @@ with @code{org-clock-in} and two @kbd{C-u C-u} with @code{org-clock-in-last}.
6823@section Effort estimates 6824@section Effort estimates
6824@cindex effort estimates 6825@cindex effort estimates
6825 6826
6826@cindex property, Effort 6827@cindex property, @code{EFFORT}
6827If you want to plan your work in a very detailed way, or if you need to 6828If you want to plan your work in a very detailed way, or if you need to
6828produce offers with quotations of the estimated work effort, you may want to 6829produce offers with quotations of the estimated work effort, you may want to
6829assign effort estimates to entries. If you are also clocking your work, you 6830assign effort estimates to entries. If you are also clocking your work, you
@@ -6861,7 +6862,7 @@ In particular if you want to use this setup also in the agenda, a global
6861setup may be advised. 6862setup may be advised.
6862 6863
6863The way to assign estimates to individual items is then to switch to column 6864The way to assign estimates to individual items is then to switch to column
6864mode, and to use @kbd{S-@key{right}} and @kbd{S-@key{left}} to change the 6865mode, and to use @kbd{S-@key{RIGHT}} and @kbd{S-@key{LEFT}} to change the
6865value. The values you enter will immediately be summed up in the hierarchy. 6866value. The values you enter will immediately be summed up in the hierarchy.
6866In the column next to it, any clocked time will be displayed. 6867In the column next to it, any clocked time will be displayed.
6867 6868
@@ -6965,7 +6966,7 @@ If your configuration depends on @file{org-remember.el}, you need to update
6965it and use the setup described below. To convert your 6966it and use the setup described below. To convert your
6966@code{org-remember-templates}, run the command 6967@code{org-remember-templates}, run the command
6967@example 6968@example
6968@kbd{M-x org-capture-import-remember-templates RET} 6969@kbd{M-x org-capture-import-remember-templates @key{RET}}
6969@end example 6970@end example
6970@noindent and then customize the new variable with @kbd{M-x 6971@noindent and then customize the new variable with @kbd{M-x
6971customize-variable org-capture-templates}, check the result, and save the 6972customize-variable org-capture-templates}, check the result, and save the
@@ -7041,7 +7042,7 @@ Visit the last stored capture item in its buffer.
7041@end table 7042@end table
7042 7043
7043@vindex org-capture-bookmark 7044@vindex org-capture-bookmark
7044@cindex org-capture-last-stored 7045@cindex @code{org-capture-last-stored}
7045You can also jump to the bookmark @code{org-capture-last-stored}, which will 7046You can also jump to the bookmark @code{org-capture-last-stored}, which will
7046automatically be created unless you set @code{org-capture-bookmark} to 7047automatically be created unless you set @code{org-capture-bookmark} to
7047@code{nil}. 7048@code{nil}.
@@ -7462,12 +7463,12 @@ Delete all of a task's attachments. A safer way is to open the directory in
7462@command{dired} and delete from there. 7463@command{dired} and delete from there.
7463 7464
7464@orgcmdtkc{s,C-c C-a s,org-attach-set-directory} 7465@orgcmdtkc{s,C-c C-a s,org-attach-set-directory}
7465@cindex property, ATTACH_DIR 7466@cindex property, @code{ATTACH_DIR}
7466Set a specific directory as the entry's attachment directory. This works by 7467Set a specific directory as the entry's attachment directory. This works by
7467putting the directory path into the @code{ATTACH_DIR} property. 7468putting the directory path into the @code{ATTACH_DIR} property.
7468 7469
7469@orgcmdtkc{i,C-c C-a i,org-attach-set-inherit} 7470@orgcmdtkc{i,C-c C-a i,org-attach-set-inherit}
7470@cindex property, ATTACH_DIR_INHERIT 7471@cindex property, @code{ATTACH_DIR_INHERIT}
7471Set the @code{ATTACH_DIR_INHERIT} property, so that children will use the 7472Set the @code{ATTACH_DIR_INHERIT} property, so that children will use the
7472same directory for attachments as the parent does. 7473same directory for attachments as the parent does.
7473@end table 7474@end table
@@ -7641,14 +7642,14 @@ javascript:location.href='org-protocol://open-source?&url='+
7641 encodeURIComponent(location.href) 7642 encodeURIComponent(location.href)
7642@end example 7643@end example
7643 7644
7644@cindex protocol, open-source, :base-url property 7645@cindex protocol, open-source, @code{:base-url} property
7645@cindex :base-url property in open-source protocol 7646@cindex @code{:base-url} property in open-source protocol
7646@cindex protocol, open-source, :working-directory property 7647@cindex protocol, open-source, @code{:working-directory} property
7647@cindex :working-directory property in open-source protocol 7648@cindex @code{:working-directory} property in open-source protocol
7648@cindex protocol, open-source, :online-suffix property 7649@cindex protocol, open-source, @code{:online-suffix} property
7649@cindex :online-suffix property in open-source protocol 7650@cindex @code{:online-suffix} property in open-source protocol
7650@cindex protocol, open-source, :working-suffix property 7651@cindex protocol, open-source, @code{:working-suffix} property
7651@cindex :working-suffix property in open-source protocol 7652@cindex @code{:working-suffix} property in open-source protocol
7652@vindex org-protocol-project-alist 7653@vindex org-protocol-project-alist
7653The variable @code{org-protocol-project-alist} maps URLs to local file names, 7654The variable @code{org-protocol-project-alist} maps URLs to local file names,
7654by stripping URL parameters from the end and replacing the @code{:base-url} 7655by stripping URL parameters from the end and replacing the @code{:base-url}
@@ -7685,8 +7686,8 @@ to something like
7685@code{open-source} handler probably cannot find a file named 7686@code{open-source} handler probably cannot find a file named
7686@file{/home/user/example/print/posters.html.php} and fails. 7687@file{/home/user/example/print/posters.html.php} and fails.
7687 7688
7688@cindex protocol, open-source, :rewrites property 7689@cindex protocol, open-source, @code{:rewrites} property
7689@cindex :rewrites property in open-source protocol 7690@cindex @code{:rewrites property} in open-source protocol
7690Such an entry in @code{org-protocol-project-alist} may hold an additional 7691Such an entry in @code{org-protocol-project-alist} may hold an additional
7691property @code{:rewrites}. This property is a list of cons cells, each of 7692property @code{:rewrites}. This property is a list of cons cells, each of
7692which maps a regular expression to a path relative to the 7693which maps a regular expression to a path relative to the
@@ -7837,12 +7838,12 @@ see the documentation string of the variable
7837 7838
7838There is also an in-buffer option for setting this variable, for example: 7839There is also an in-buffer option for setting this variable, for example:
7839 7840
7840@cindex #+ARCHIVE 7841@cindex @code{#+ARCHIVE}
7841@example 7842@example
7842#+ARCHIVE: %s_done:: 7843#+ARCHIVE: %s_done::
7843@end example 7844@end example
7844 7845
7845@cindex property, ARCHIVE 7846@cindex property, @code{ARCHIVE}
7846@noindent 7847@noindent
7847If you would like to have a special ARCHIVE location for a single entry 7848If you would like to have a special ARCHIVE location for a single entry
7848or a (sub)tree, give the entry an @code{:ARCHIVE:} property with the 7849or a (sub)tree, give the entry an @code{:ARCHIVE:} property with the
@@ -7909,7 +7910,7 @@ To do this, each subtree is checked for open TODO entries. If none are
7909found, the command offers to set the ARCHIVE tag for the child. If the 7910found, the command offers to set the ARCHIVE tag for the child. If the
7910cursor is @emph{not} on a headline when this command is invoked, the 7911cursor is @emph{not} on a headline when this command is invoked, the
7911level 1 trees will be checked. 7912level 1 trees will be checked.
7912@orgcmd{C-@kbd{TAB},org-force-cycle-archived} 7913@orgcmd{C-@key{TAB},org-force-cycle-archived}
7913Cycle a tree even if it is tagged with ARCHIVE. 7914Cycle a tree even if it is tagged with ARCHIVE.
7914@orgcmd{C-c C-x A,org-archive-to-archive-sibling} 7915@orgcmd{C-c C-x A,org-archive-to-archive-sibling}
7915Move the current entry to the @emph{Archive Sibling}. This is a sibling of 7916Move the current entry to the @emph{Archive Sibling}. This is a sibling of
@@ -8021,8 +8022,7 @@ Remove current file from the list of agenda files.
8021@orgcmd{C-',org-cycle-agenda-files} 8022@orgcmd{C-',org-cycle-agenda-files}
8022@itemx C-, 8023@itemx C-,
8023Cycle through agenda file list, visiting one file after the other. 8024Cycle through agenda file list, visiting one file after the other.
8024@kindex M-x org-iswitchb 8025@item M-x org-iswitchb @key{RET}
8025@item M-x org-iswitchb RET
8026Command to use an @code{iswitchb}-like interface to switch to and between Org 8026Command to use an @code{iswitchb}-like interface to switch to and between Org
8027buffers. 8027buffers.
8028@end table 8028@end table
@@ -8150,7 +8150,7 @@ The purpose of the weekly/daily @emph{agenda} is to act like a page of a
8150paper agenda, showing all the tasks for the current week or day. 8150paper agenda, showing all the tasks for the current week or day.
8151 8151
8152@table @kbd 8152@table @kbd
8153@cindex org-agenda, command 8153@cindex @code{org-agenda}, command
8154@orgcmd{C-c a a,org-agenda-list} 8154@orgcmd{C-c a a,org-agenda-list}
8155Compile an agenda for the current week from a list of Org files. The agenda 8155Compile an agenda for the current week from a list of Org files. The agenda
8156shows the entries for each day. With a numeric prefix@footnote{For backward 8156shows the entries for each day. With a numeric prefix@footnote{For backward
@@ -8637,7 +8637,7 @@ associated with the item.
8637@subsection Categories 8637@subsection Categories
8638 8638
8639@cindex category 8639@cindex category
8640@cindex #+CATEGORY 8640@cindex @code{#+CATEGORY}
8641The category is a broad label assigned to each agenda item. By default, the 8641The category is a broad label assigned to each agenda item. By default, the
8642category is simply derived from the file name, but you can also specify it 8642category is simply derived from the file name, but you can also specify it
8643with a special line in the buffer, like this: 8643with a special line in the buffer, like this:
@@ -8647,8 +8647,8 @@ with a special line in the buffer, like this:
8647@end example 8647@end example
8648 8648
8649@noindent 8649@noindent
8650@cindex property, CATEGORY 8650@cindex property, @code{CATEGORY}
8651If you would like to have a special CATEGORY for a single entry or a 8651If you would like to have a special @code{CATEGORY} for a single entry or a
8652(sub)tree, give the entry a @code{:CATEGORY:} property with the 8652(sub)tree, give the entry a @code{:CATEGORY:} property with the
8653special category you want to apply as the value. 8653special category you want to apply as the value.
8654 8654
@@ -8788,12 +8788,13 @@ excluding the next tag.
8788Org also supports automatic, context-aware tag filtering. If the variable 8788Org also supports automatic, context-aware tag filtering. If the variable
8789@code{org-agenda-auto-exclude-function} is set to a user-defined function, 8789@code{org-agenda-auto-exclude-function} is set to a user-defined function,
8790that function can decide which tags should be excluded from the agenda 8790that function can decide which tags should be excluded from the agenda
8791automatically. Once this is set, the @kbd{/} command then accepts @kbd{RET} 8791automatically. Once this is set, the @kbd{/} command then accepts
8792as a sub-option key and runs the auto exclusion logic. For example, let's 8792@kbd{@key{RET}} as a sub-option key and runs the auto exclusion logic. For
8793say you use a @code{Net} tag to identify tasks which need network access, an 8793example, let's say you use a @code{Net} tag to identify tasks which need
8794@code{Errand} tag for errands in town, and a @code{Call} tag for making phone 8794network access, an @code{Errand} tag for errands in town, and a @code{Call}
8795calls. You could auto-exclude these tags based on the availability of the 8795tag for making phone calls. You could auto-exclude these tags based on the
8796Internet, and outside of business hours, with something like this: 8796availability of the Internet, and outside of business hours, with something
8797like this:
8797 8798
8798@smalllisp 8799@smalllisp
8799@group 8800@group
@@ -8949,9 +8950,9 @@ the other commands, the cursor needs to be in the desired line.
8949@tsubheading{Motion} 8950@tsubheading{Motion}
8950@cindex motion commands in agenda 8951@cindex motion commands in agenda
8951@orgcmd{n,org-agenda-next-line} 8952@orgcmd{n,org-agenda-next-line}
8952Next line (same as @key{down} and @kbd{C-n}). 8953Next line (same as @key{DOWN} and @kbd{C-n}).
8953@orgcmd{p,org-agenda-previous-line} 8954@orgcmd{p,org-agenda-previous-line}
8954Previous line (same as @key{up} and @kbd{C-p}). 8955Previous line (same as @key{UP} and @kbd{C-p}).
8955@orgcmd{N,org-agenda-next-item} 8956@orgcmd{N,org-agenda-next-item}
8956Next item: same as next line, but only consider items. 8957Next item: same as next line, but only consider items.
8957@orgcmd{P,org-agenda-previous-item} 8958@orgcmd{P,org-agenda-previous-item}
@@ -9004,7 +9005,7 @@ Delete other windows.
9004@xorgcmd{v t,org-agenda-fortnight-view} 9005@xorgcmd{v t,org-agenda-fortnight-view}
9005@xorgcmd{v m,org-agenda-month-view} 9006@xorgcmd{v m,org-agenda-month-view}
9006@xorgcmd{v y,org-agenda-year-view} 9007@xorgcmd{v y,org-agenda-year-view}
9007@xorgcmd{v SPC,org-agenda-reset-view} 9008@xorgcmd{v @key{SPC},org-agenda-reset-view}
9008@vindex org-agenda-span 9009@vindex org-agenda-span
9009Switch to day/week/month/year view. When switching to day or week view, this 9010Switch to day/week/month/year view. When switching to day or week view, this
9010setting becomes the default for subsequent agenda refreshes. Since month and 9011setting becomes the default for subsequent agenda refreshes. Since month and
@@ -9102,8 +9103,8 @@ Toggle the time grid on and off. See also the variables
9102@c 9103@c
9103@orgcmd{r,org-agenda-redo} 9104@orgcmd{r,org-agenda-redo}
9104Recreate the agenda buffer, for example to reflect the changes after 9105Recreate the agenda buffer, for example to reflect the changes after
9105modification of the timestamps of items with @kbd{S-@key{left}} and 9106modification of the timestamps of items with @kbd{S-@key{LEFT}} and
9106@kbd{S-@key{right}}. When the buffer is the global TODO list, a prefix 9107@kbd{S-@key{RIGHT}}. When the buffer is the global TODO list, a prefix
9107argument is interpreted to create a selective list for a specific TODO 9108argument is interpreted to create a selective list for a specific TODO
9108keyword. 9109keyword.
9109@orgcmd{g,org-agenda-redo} 9110@orgcmd{g,org-agenda-redo}
@@ -9167,8 +9168,8 @@ both in the agenda buffer and in the remote buffer.
9167Change the TODO state of the item, both in the agenda and in the 9168Change the TODO state of the item, both in the agenda and in the
9168original org file. 9169original org file.
9169@c 9170@c
9170@orgcmd{C-S-@key{right},org-agenda-todo-nextset} 9171@orgcmd{C-S-@key{RIGHT},org-agenda-todo-nextset}
9171@orgcmd{C-S-@key{left},org-agenda-todo-previousset} 9172@orgcmd{C-S-@key{LEFT},org-agenda-todo-previousset}
9172Switch to the next/previous set of TODO keywords. 9173Switch to the next/previous set of TODO keywords.
9173@c 9174@c
9174@orgcmd{C-k,org-agenda-kill} 9175@orgcmd{C-k,org-agenda-kill}
@@ -9218,12 +9219,12 @@ the priority cookie is removed from the entry.
9218@orgcmd{P,org-agenda-show-priority} 9219@orgcmd{P,org-agenda-show-priority}
9219Display weighted priority of current item. 9220Display weighted priority of current item.
9220@c 9221@c
9221@orgcmdkkc{+,S-@key{up},org-agenda-priority-up} 9222@orgcmdkkc{+,S-@key{UP},org-agenda-priority-up}
9222Increase the priority of the current item. The priority is changed in 9223Increase the priority of the current item. The priority is changed in
9223the original buffer, but the agenda is not resorted. Use the @kbd{r} 9224the original buffer, but the agenda is not resorted. Use the @kbd{r}
9224key for this. 9225key for this.
9225@c 9226@c
9226@orgcmdkkc{-,S-@key{down},org-agenda-priority-down} 9227@orgcmdkkc{-,S-@key{DOWN},org-agenda-priority-down}
9227Decrease the priority of the current item. 9228Decrease the priority of the current item.
9228@c 9229@c
9229@orgcmdkkc{z,C-c C-z,org-agenda-add-note} 9230@orgcmdkkc{z,C-c C-z,org-agenda-add-note}
@@ -9241,19 +9242,19 @@ Schedule this item. With prefix arg remove the scheduling timestamp
9241@orgcmd{C-c C-d,org-agenda-deadline} 9242@orgcmd{C-c C-d,org-agenda-deadline}
9242Set a deadline for this item. With prefix arg remove the deadline. 9243Set a deadline for this item. With prefix arg remove the deadline.
9243@c 9244@c
9244@orgcmd{S-@key{right},org-agenda-do-date-later} 9245@orgcmd{S-@key{RIGHT},org-agenda-do-date-later}
9245Change the timestamp associated with the current line by one day into the 9246Change the timestamp associated with the current line by one day into the
9246future. If the date is in the past, the first call to this command will move 9247future. If the date is in the past, the first call to this command will move
9247it to today.@* 9248it to today.@*
9248With a numeric prefix argument, change it by that many days. For example, 9249With a numeric prefix argument, change it by that many days. For example,
9249@kbd{3 6 5 S-@key{right}} will change it by a year. With a @kbd{C-u} prefix, 9250@kbd{3 6 5 S-@key{RIGHT}} will change it by a year. With a @kbd{C-u} prefix,
9250change the time by one hour. If you immediately repeat the command, it will 9251change the time by one hour. If you immediately repeat the command, it will
9251continue to change hours even without the prefix arg. With a double @kbd{C-u 9252continue to change hours even without the prefix arg. With a double @kbd{C-u
9252C-u} prefix, do the same for changing minutes.@* 9253C-u} prefix, do the same for changing minutes.@*
9253The stamp is changed in the original Org file, but the change is not directly 9254The stamp is changed in the original Org file, but the change is not directly
9254reflected in the agenda buffer. Use @kbd{r} or @kbd{g} to update the buffer. 9255reflected in the agenda buffer. Use @kbd{r} or @kbd{g} to update the buffer.
9255@c 9256@c
9256@orgcmd{S-@key{left},org-agenda-do-date-earlier} 9257@orgcmd{S-@key{LEFT},org-agenda-do-date-earlier}
9257Change the timestamp associated with the current line by one day 9258Change the timestamp associated with the current line by one day
9258into the past. 9259into the past.
9259@c 9260@c
@@ -9423,7 +9424,7 @@ calendars.
9423@orgcmd{H,org-agenda-holidays} 9424@orgcmd{H,org-agenda-holidays}
9424Show holidays for three months around the cursor date. 9425Show holidays for three months around the cursor date.
9425 9426
9426@item M-x org-icalendar-combine-agenda-files RET 9427@item M-x org-icalendar-combine-agenda-files @key{RET}
9427Export a single iCalendar file containing entries from all agenda files. 9428Export a single iCalendar file containing entries from all agenda files.
9428This is a globally available command, and also available in the agenda menu. 9429This is a globally available command, and also available in the agenda menu.
9429 9430
@@ -9860,7 +9861,7 @@ does not have a specific format---defined in a property, or in its file---it
9860uses @code{org-columns-default-format}. 9861uses @code{org-columns-default-format}.
9861 9862
9862@item 9863@item
9863@cindex property, special, CLOCKSUM 9864@cindex property, special, @code{CLOCKSUM}
9864If any of the columns has a summary type defined (@pxref{Column attributes}), 9865If any of the columns has a summary type defined (@pxref{Column attributes}),
9865turning on column view in the agenda will visit all relevant agenda files and 9866turning on column view in the agenda will visit all relevant agenda files and
9866make sure that the computations of this property are up to date. This is 9867make sure that the computations of this property are up to date. This is
@@ -9884,7 +9885,7 @@ clocked time in the displayed period use clock table mode (press @kbd{R} in
9884the agenda). 9885the agenda).
9885 9886
9886@item 9887@item
9887@cindex property, special, CLOCKSUM_T 9888@cindex property, special, @code{CLOCKSUM_T}
9888When the column view in the agenda shows the @code{CLOCKSUM_T}, that is 9889When the column view in the agenda shows the @code{CLOCKSUM_T}, that is
9889always today's clocked time for this item. So even in the weekly agenda, the 9890always today's clocked time for this item. So even in the weekly agenda, the
9890clocksum listed in column view only originates from today. This lets you 9891clocksum listed in column view only originates from today. This lets you
@@ -9924,7 +9925,7 @@ To preserve the line breaks, indentation and blank lines in a region, but
9924otherwise use normal formatting, you can use this construct, which can also 9925otherwise use normal formatting, you can use this construct, which can also
9925be used to format poetry. 9926be used to format poetry.
9926 9927
9927@cindex #+BEGIN_VERSE 9928@cindex @code{#+BEGIN_VERSE}
9928@cindex verse blocks 9929@cindex verse blocks
9929@example 9930@example
9930#+BEGIN_VERSE 9931#+BEGIN_VERSE
@@ -9940,7 +9941,7 @@ When quoting a passage from another document, it is customary to format this
9940as a paragraph that is indented on both the left and the right margin. You 9941as a paragraph that is indented on both the left and the right margin. You
9941can include quotations in Org mode documents like this: 9942can include quotations in Org mode documents like this:
9942 9943
9943@cindex #+BEGIN_QUOTE 9944@cindex @code{#+BEGIN_QUOTE}
9944@cindex quote blocks 9945@cindex quote blocks
9945@example 9946@example
9946#+BEGIN_QUOTE 9947#+BEGIN_QUOTE
@@ -9950,7 +9951,7 @@ but not any simpler -- Albert Einstein
9950@end example 9951@end example
9951 9952
9952If you would like to center some text, do it like this: 9953If you would like to center some text, do it like this:
9953@cindex #+BEGIN_CENTER 9954@cindex @code{#+BEGIN_CENTER}
9954@cindex center blocks 9955@cindex center blocks
9955@example 9956@example
9956#+BEGIN_CENTER 9957#+BEGIN_CENTER
@@ -9994,8 +9995,8 @@ a horizontal line.
9994@section Images and Tables 9995@section Images and Tables
9995 9996
9996@cindex tables, markup rules 9997@cindex tables, markup rules
9997@cindex #+CAPTION 9998@cindex @code{#+CAPTION}
9998@cindex #+NAME 9999@cindex @code{#+NAME}
9999Both the native Org mode tables (@pxref{Tables}) and tables formatted with 10000Both the native Org mode tables (@pxref{Tables}) and tables formatted with
10000the @file{table.el} package will be exported properly. For Org mode tables, 10001the @file{table.el} package will be exported properly. For Org mode tables,
10001the lines before the first horizontal separator line will become table header 10002the lines before the first horizontal separator line will become table header
@@ -10046,7 +10047,7 @@ or may not be handled.
10046You can include literal examples that should not be subjected to 10047You can include literal examples that should not be subjected to
10047markup. Such examples will be typeset in monospace, so this is well suited 10048markup. Such examples will be typeset in monospace, so this is well suited
10048for source code and similar examples. 10049for source code and similar examples.
10049@cindex #+BEGIN_EXAMPLE 10050@cindex @code{#+BEGIN_EXAMPLE}
10050 10051
10051@example 10052@example
10052#+BEGIN_EXAMPLE 10053#+BEGIN_EXAMPLE
@@ -10085,7 +10086,7 @@ example@footnote{Code in @samp{src} blocks may also be evaluated either
10085interactively or on export. @xref{Working with source code}, for more 10086interactively or on export. @xref{Working with source code}, for more
10086information on evaluating code blocks.}, see @ref{Easy templates} for 10087information on evaluating code blocks.}, see @ref{Easy templates} for
10087shortcuts to easily insert code blocks. 10088shortcuts to easily insert code blocks.
10088@cindex #+BEGIN_SRC 10089@cindex @code{#+BEGIN_SRC}
10089 10090
10090@example 10091@example
10091#+BEGIN_SRC emacs-lisp 10092#+BEGIN_SRC emacs-lisp
@@ -10407,14 +10408,14 @@ To disable it, simply use
10407 10408
10408CD@LaTeX{} mode is a minor mode that is normally used in combination with a 10409CD@LaTeX{} mode is a minor mode that is normally used in combination with a
10409major @LaTeX{} mode like AUC@TeX{} in order to speed-up insertion of 10410major @LaTeX{} mode like AUC@TeX{} in order to speed-up insertion of
10410environments and math templates. Inside Org mode, you can make use of 10411environments and math templates. Inside Org mode, you can make use of some
10411some of the features of CD@LaTeX{} mode. You need to install 10412of the features of CD@LaTeX{} mode. You need to install @file{cdlatex.el}
10412@file{cdlatex.el} and @file{texmathp.el} (the latter comes also with 10413and @file{texmathp.el} (the latter comes also with AUC@TeX{}) from
10413AUC@TeX{}) from @url{https://staff.fnwi.uva.nl/c.dominik/Tools/cdlatex}. 10414@url{https://staff.fnwi.uva.nl/c.dominik/Tools/cdlatex}. Don't use
10414Don't use CD@LaTeX{} mode itself under Org mode, but use the light 10415CD@LaTeX{} mode itself under Org mode, but use the light version
10415version @code{org-cdlatex-mode} that comes as part of Org mode. Turn it 10416@code{org-cdlatex-mode} that comes as part of Org mode. Turn it on for the
10416on for the current buffer with @kbd{M-x org-cdlatex-mode RET}, or for all 10417current buffer with @kbd{M-x org-cdlatex-mode @key{RET}}, or for all Org
10417Org files with 10418files with
10418 10419
10419@lisp 10420@lisp
10420(add-hook 'org-mode-hook 'turn-on-org-cdlatex) 10421(add-hook 'org-mode-hook 'turn-on-org-cdlatex)
@@ -10427,7 +10428,7 @@ details see the documentation of CD@LaTeX{} mode):
10427@item 10428@item
10428Environment templates can be inserted with @kbd{C-c @{}. 10429Environment templates can be inserted with @kbd{C-c @{}.
10429@item 10430@item
10430@kindex @key{TAB} 10431@kindex TAB
10431The @key{TAB} key will do template expansion if the cursor is inside a 10432The @key{TAB} key will do template expansion if the cursor is inside a
10432@LaTeX{} fragment@footnote{Org mode has a method to test if the cursor is 10433@LaTeX{} fragment@footnote{Org mode has a method to test if the cursor is
10433inside such a fragment, see the documentation of the function 10434inside such a fragment, see the documentation of the function
@@ -10438,7 +10439,8 @@ the second brace. Even outside fragments, @key{TAB} will expand
10438environment abbreviations at the beginning of a line. For example, if 10439environment abbreviations at the beginning of a line. For example, if
10439you write @samp{equ} at the beginning of a line and press @key{TAB}, 10440you write @samp{equ} at the beginning of a line and press @key{TAB},
10440this abbreviation will be expanded to an @code{equation} environment. 10441this abbreviation will be expanded to an @code{equation} environment.
10441To get a list of all abbreviations, type @kbd{M-x cdlatex-command-help RET}. 10442To get a list of all abbreviations, type @kbd{M-x cdlatex-command-help
10443@key{RET}}.
10442@item 10444@item
10443@kindex _ 10445@kindex _
10444@kindex ^ 10446@kindex ^
@@ -10600,7 +10602,7 @@ Org document by adjusting outline visibility settings.
10600@section Export settings 10602@section Export settings
10601@cindex Export, settings 10603@cindex Export, settings
10602 10604
10603@cindex #+OPTIONS 10605@cindex @code{#+OPTIONS}
10604Export options can be set: globally with variables; for an individual file by 10606Export options can be set: globally with variables; for an individual file by
10605making variables buffer-local with in-buffer settings (@pxref{In-buffer 10607making variables buffer-local with in-buffer settings (@pxref{In-buffer
10606settings}), by setting individual keywords, or by specifying them in a 10608settings}), by setting individual keywords, or by specifying them in a
@@ -10608,7 +10610,7 @@ compact form with the @code{#+OPTIONS} keyword; or for a tree by setting
10608properties (@pxref{Properties and columns}). Options set at a specific level 10610properties (@pxref{Properties and columns}). Options set at a specific level
10609override options set at a more general level. 10611override options set at a more general level.
10610 10612
10611@cindex #+SETUPFILE 10613@cindex @code{#+SETUPFILE}
10612In-buffer settings may appear anywhere in the file, either directly or 10614In-buffer settings may appear anywhere in the file, either directly or
10613indirectly through a file included using @samp{#+SETUPFILE: filename or URL} 10615indirectly through a file included using @samp{#+SETUPFILE: filename or URL}
10614syntax. Option keyword sets tailored to a particular back-end can be 10616syntax. Option keyword sets tailored to a particular back-end can be
@@ -10616,37 +10618,37 @@ inserted from the export dispatcher (@pxref{The export dispatcher}) using the
10616@code{Insert template} command by pressing @key{#}. To insert keywords 10618@code{Insert template} command by pressing @key{#}. To insert keywords
10617individually, a good way to make sure the keyword is correct is to type 10619individually, a good way to make sure the keyword is correct is to type
10618@code{#+} and then to use @kbd{M-@key{TAB}}@footnote{Many desktops intercept 10620@code{#+} and then to use @kbd{M-@key{TAB}}@footnote{Many desktops intercept
10619@kbd{M-TAB} to switch windows. Use @kbd{C-M-i} or @kbd{@key{ESC} @key{TAB}} 10621@kbd{M-@key{TAB}} to switch windows. Use @kbd{C-M-i} or @kbd{@key{ESC}
10620instead.} for completion. 10622@key{TAB}} instead.} for completion.
10621 10623
10622The export keywords available for every back-end, and their equivalent global 10624The export keywords available for every back-end, and their equivalent global
10623variables, include: 10625variables, include:
10624 10626
10625@table @samp 10627@table @samp
10626@item AUTHOR 10628@item AUTHOR
10627@cindex #+AUTHOR 10629@cindex @code{#+AUTHOR}
10628@vindex user-full-name 10630@vindex user-full-name
10629The document author (@code{user-full-name}). 10631The document author (@code{user-full-name}).
10630 10632
10631@item CREATOR 10633@item CREATOR
10632@cindex #+CREATOR 10634@cindex @code{#+CREATOR}
10633@vindex org-export-creator-string 10635@vindex org-export-creator-string
10634Entity responsible for output generation (@code{org-export-creator-string}). 10636Entity responsible for output generation (@code{org-export-creator-string}).
10635 10637
10636@item DATE 10638@item DATE
10637@cindex #+DATE 10639@cindex @code{#+DATE}
10638@vindex org-export-date-timestamp-format 10640@vindex org-export-date-timestamp-format
10639A date or a time-stamp@footnote{The variable 10641A date or a time-stamp@footnote{The variable
10640@code{org-export-date-timestamp-format} defines how this time-stamp will be 10642@code{org-export-date-timestamp-format} defines how this time-stamp will be
10641exported.}. 10643exported.}.
10642 10644
10643@item EMAIL 10645@item EMAIL
10644@cindex #+EMAIL 10646@cindex @code{#+EMAIL}
10645@vindex user-mail-address 10647@vindex user-mail-address
10646The email address (@code{user-mail-address}). 10648The email address (@code{user-mail-address}).
10647 10649
10648@item LANGUAGE 10650@item LANGUAGE
10649@cindex #+LANGUAGE 10651@cindex @code{#+LANGUAGE}
10650@vindex org-export-default-language 10652@vindex org-export-default-language
10651Language to use for translating certain strings 10653Language to use for translating certain strings
10652(@code{org-export-default-language}). With @samp{#+LANGUAGE: fr}, for 10654(@code{org-export-default-language}). With @samp{#+LANGUAGE: fr}, for
@@ -10654,7 +10656,7 @@ example, Org translates @emph{Table of contents} to the French @emph{Table
10654des matières}. 10656des matières}.
10655 10657
10656@item SELECT_TAGS 10658@item SELECT_TAGS
10657@cindex #+SELECT_TAGS 10659@cindex @code{#+SELECT_TAGS}
10658@vindex org-export-select-tags 10660@vindex org-export-select-tags
10659The default value is @code{:export:}. When a tree is tagged with 10661The default value is @code{:export:}. When a tree is tagged with
10660@code{:export:} (@code{org-export-select-tags}), Org selects that tree and 10662@code{:export:} (@code{org-export-select-tags}), Org selects that tree and
@@ -10663,7 +10665,7 @@ see below. When selectively exporting files with @code{:export:} tags set,
10663Org does not export any text that appears before the first headline. 10665Org does not export any text that appears before the first headline.
10664 10666
10665@item EXCLUDE_TAGS 10667@item EXCLUDE_TAGS
10666@cindex #+EXCLUDE_TAGS 10668@cindex @code{#+EXCLUDE_TAGS}
10667@vindex org-export-exclude-tags 10669@vindex org-export-exclude-tags
10668The default value is @code{:noexport:}. When a tree is tagged with 10670The default value is @code{:noexport:}. When a tree is tagged with
10669@code{:noexport:} (@code{org-export-exclude-tags}), Org excludes that tree 10671@code{:noexport:} (@code{org-export-exclude-tags}), Org excludes that tree
@@ -10673,12 +10675,12 @@ unconditionally excluded from the export, even if they have an
10673code blocks contained in them. 10675code blocks contained in them.
10674 10676
10675@item TITLE 10677@item TITLE
10676@cindex #+TITLE 10678@cindex @code{#+TITLE}
10677@cindex document title 10679@cindex document title
10678Org displays this title. For long titles, use multiple @code{#+TITLE} lines. 10680Org displays this title. For long titles, use multiple @code{#+TITLE} lines.
10679 10681
10680@item EXPORT_FILE_NAME 10682@item EXPORT_FILE_NAME
10681@cindex #+EXPORT_FILE_NAME 10683@cindex @code{#+EXPORT_FILE_NAME}
10682The name of the output file to be generated. Otherwise, Org generates the 10684The name of the output file to be generated. Otherwise, Org generates the
10683file name based on the buffer name and the extension based on the back-end 10685file name based on the buffer name and the extension based on the back-end
10684format. 10686format.
@@ -10784,7 +10786,7 @@ Toggle inclusion of inlinetasks (@code{org-export-with-inlinetasks}).
10784 10786
10785@item num: 10787@item num:
10786@vindex org-export-with-section-numbers 10788@vindex org-export-with-section-numbers
10787@cindex property, UNNUMBERED 10789@cindex property, @code{UNNUMBERED}
10788Toggle section-numbers (@code{org-export-with-section-numbers}). When set to 10790Toggle section-numbers (@code{org-export-with-section-numbers}). When set to
10789number @samp{n}, Org numbers only those headlines at level @samp{n} or above. 10791number @samp{n}, Org numbers only those headlines at level @samp{n} or above.
10790Setting @code{UNNUMBERED} property to non-@code{nil} disables numbering of 10792Setting @code{UNNUMBERED} property to non-@code{nil} disables numbering of
@@ -10860,7 +10862,7 @@ respectively, @samp{EXPORT_DATE} and @samp{EXPORT_FILE_NAME}. Except for
10860@samp{SETUPFILE}, all other keywords listed above have an @samp{EXPORT_} 10862@samp{SETUPFILE}, all other keywords listed above have an @samp{EXPORT_}
10861equivalent. 10863equivalent.
10862 10864
10863@cindex #+BIND 10865@cindex @code{#+BIND}
10864@vindex org-export-allow-bind-keywords 10866@vindex org-export-allow-bind-keywords
10865If @code{org-export-allow-bind-keywords} is non-@code{nil}, Emacs variables 10867If @code{org-export-allow-bind-keywords} is non-@code{nil}, Emacs variables
10866can become buffer-local during export by using the BIND keyword. Its syntax 10868can become buffer-local during export by using the BIND keyword. Its syntax
@@ -10873,7 +10875,7 @@ settings that cannot be changed using keywords.
10873@cindex list of tables 10875@cindex list of tables
10874@cindex list of listings 10876@cindex list of listings
10875 10877
10876@cindex #+TOC 10878@cindex @code{#+TOC}
10877@vindex org-export-with-toc 10879@vindex org-export-with-toc
10878Org normally inserts the table of contents directly before the first headline 10880Org normally inserts the table of contents directly before the first headline
10879of the file. Org sets the TOC depth the same as the headline levels in the 10881of the file. Org sets the TOC depth the same as the headline levels in the
@@ -10919,7 +10921,7 @@ with captions.
10919#+TOC: tables @r{build a list of tables} 10921#+TOC: tables @r{build a list of tables}
10920@end example 10922@end example
10921 10923
10922@cindex property, ALT_TITLE 10924@cindex property, @code{ALT_TITLE}
10923Normally Org uses the headline for its entry in the table of contents. But 10925Normally Org uses the headline for its entry in the table of contents. But
10924with @code{ALT_TITLE} property, a different entry can be specified for the 10926with @code{ALT_TITLE} property, a different entry can be specified for the
10925table of contents. 10927table of contents.
@@ -10929,7 +10931,7 @@ table of contents.
10929@cindex include files, during export 10931@cindex include files, during export
10930Include other files during export. For example, to include your @file{.emacs} 10932Include other files during export. For example, to include your @file{.emacs}
10931file, you could use: 10933file, you could use:
10932@cindex #+INCLUDE 10934@cindex @code{#+INCLUDE}
10933 10935
10934@example 10936@example
10935#+INCLUDE: "~/.emacs" src emacs-lisp 10937#+INCLUDE: "~/.emacs" src emacs-lisp
@@ -11001,7 +11003,7 @@ Visit the include file at point.
11001@node Macro replacement 11003@node Macro replacement
11002@section Macro replacement 11004@section Macro replacement
11003@cindex macro replacement, during export 11005@cindex macro replacement, during export
11004@cindex #+MACRO 11006@cindex @code{#+MACRO}
11005 11007
11006@vindex org-export-global-macros 11008@vindex org-export-global-macros
11007Macros replace text snippets during export. Macros are defined globally in 11009Macros replace text snippets during export. Macros are defined globally in
@@ -11093,9 +11095,9 @@ Lines starting with zero or more whitespace characters followed by one
11093@samp{#} and a whitespace are treated as comments and, as such, are not 11095@samp{#} and a whitespace are treated as comments and, as such, are not
11094exported. 11096exported.
11095 11097
11096@cindex #+BEGIN_COMMENT 11098@cindex @code{#+BEGIN_COMMENT}
11097Likewise, regions surrounded by @samp{#+BEGIN_COMMENT} 11099Likewise, regions surrounded by @code{#+BEGIN_COMMENT}
11098... @samp{#+END_COMMENT} are not exported. 11100... @code{#+END_COMMENT} are not exported.
11099 11101
11100@cindex comment trees 11102@cindex comment trees
11101Finally, a @samp{COMMENT} keyword at the beginning of an entry, but after any 11103Finally, a @samp{COMMENT} keyword at the beginning of an entry, but after any
@@ -11151,7 +11153,7 @@ settings}).
11151 11153
11152@table @samp 11154@table @samp
11153@item SUBTITLE 11155@item SUBTITLE
11154@cindex #+SUBTITLE (ASCII) 11156@cindex @code{#+SUBTITLE} (ASCII)
11155The document subtitle. For long subtitles, use multiple @code{#+SUBTITLE} 11157The document subtitle. For long subtitles, use multiple @code{#+SUBTITLE}
11156lines in the Org file. Org prints them on one continuous line, wrapping into 11158lines in the Org file. Org prints them on one continuous line, wrapping into
11157multiple lines if necessary. 11159multiple lines if necessary.
@@ -11168,8 +11170,8 @@ where levels become lists, @pxref{Export settings}.
11168To insert text within the Org file by the ASCII back-end, use one the 11170To insert text within the Org file by the ASCII back-end, use one the
11169following constructs, inline, keyword, or export block: 11171following constructs, inline, keyword, or export block:
11170 11172
11171@cindex #+ASCII 11173@cindex @code{#+ASCII}
11172@cindex #+BEGIN_EXPORT ascii 11174@cindex @code{#+BEGIN_EXPORT ascii}
11173@example 11175@example
11174Inline text @@@@ascii:and additional text@@@@ within a paragraph. 11176Inline text @@@@ascii:and additional text@@@@ within a paragraph.
11175 11177
@@ -11181,7 +11183,7 @@ Org exports text in this block only when using ASCII back-end.
11181@end example 11183@end example
11182 11184
11183@subheading ASCII specific attributes 11185@subheading ASCII specific attributes
11184@cindex #+ATTR_ASCII 11186@cindex @code{#+ATTR_ASCII}
11185@cindex horizontal rules, in ASCII export 11187@cindex horizontal rules, in ASCII export
11186 11188
11187ASCII back-end recognizes only one attribute, @code{:width}, which specifies 11189ASCII back-end recognizes only one attribute, @code{:width}, which specifies
@@ -11195,8 +11197,8 @@ syntax for specifying widths is:
11195 11197
11196@subheading ASCII special blocks 11198@subheading ASCII special blocks
11197@cindex special blocks, in ASCII export 11199@cindex special blocks, in ASCII export
11198@cindex #+BEGIN_JUSTIFYLEFT 11200@cindex @code{#+BEGIN_JUSTIFYLEFT}
11199@cindex #+BEGIN_JUSTIFYRIGHT 11201@cindex @code{#+BEGIN_JUSTIFYRIGHT}
11200 11202
11201Besides @code{#+BEGIN_CENTER} blocks (@pxref{Paragraphs}), ASCII back-end has 11203Besides @code{#+BEGIN_CENTER} blocks (@pxref{Paragraphs}), ASCII back-end has
11202these two left and right justification blocks: 11204these two left and right justification blocks:
@@ -11254,7 +11256,7 @@ output. These keywords work similar to the general options settings
11254 11256
11255@table @samp 11257@table @samp
11256@item BEAMER_THEME 11258@item BEAMER_THEME
11257@cindex #+BEAMER_THEME 11259@cindex @code{#+BEAMER_THEME}
11258@vindex org-beamer-theme 11260@vindex org-beamer-theme
11259The Beamer layout theme (@code{org-beamer-theme}). Use square brackets for 11261The Beamer layout theme (@code{org-beamer-theme}). Use square brackets for
11260options. For example: 11262options. For example:
@@ -11263,24 +11265,24 @@ options. For example:
11263@end smallexample 11265@end smallexample
11264 11266
11265@item BEAMER_FONT_THEME 11267@item BEAMER_FONT_THEME
11266@cindex #+BEAMER_FONT_THEME 11268@cindex @code{#+BEAMER_FONT_THEME}
11267The Beamer font theme. 11269The Beamer font theme.
11268 11270
11269@item BEAMER_INNER_THEME 11271@item BEAMER_INNER_THEME
11270@cindex #+BEAMER_INNER_THEME 11272@cindex @code{#+BEAMER_INNER_THEME}
11271The Beamer inner theme. 11273The Beamer inner theme.
11272 11274
11273@item BEAMER_OUTER_THEME 11275@item BEAMER_OUTER_THEME
11274@cindex #+BEAMER_OUTER_THEME 11276@cindex @code{#+BEAMER_OUTER_THEME}
11275The Beamer outer theme. 11277The Beamer outer theme.
11276 11278
11277@item BEAMER_HEADER 11279@item BEAMER_HEADER
11278@cindex #+BEAMER_HEADER 11280@cindex @code{#+BEAMER_HEADER}
11279Arbitrary lines inserted in the preamble, just before the @samp{hyperref} 11281Arbitrary lines inserted in the preamble, just before the @samp{hyperref}
11280settings. 11282settings.
11281 11283
11282@item DESCRIPTION 11284@item DESCRIPTION
11283@cindex #+DESCRIPTION (Beamer) 11285@cindex @code{#+DESCRIPTION} (Beamer)
11284The document description. For long descriptions, use multiple 11286The document description. For long descriptions, use multiple
11285@code{#+DESCRIPTION} keywords. By default, @samp{hyperref} inserts 11287@code{#+DESCRIPTION} keywords. By default, @samp{hyperref} inserts
11286@code{#+DESCRIPTION} as metadata. Use @code{org-latex-hyperref-template} to 11288@code{#+DESCRIPTION} as metadata. Use @code{org-latex-hyperref-template} to
@@ -11288,7 +11290,7 @@ configure document metadata. Use @code{org-latex-title-command} to configure
11288typesetting of description as part of front matter. 11290typesetting of description as part of front matter.
11289 11291
11290@item KEYWORDS 11292@item KEYWORDS
11291@cindex #+KEYWORDS (Beamer) 11293@cindex @code{#+KEYWORDS} (Beamer)
11292The keywords for defining the contents of the document. Use multiple 11294The keywords for defining the contents of the document. Use multiple
11293@code{#+KEYWORDS} lines if necessary. By default, @samp{hyperref} inserts 11295@code{#+KEYWORDS} lines if necessary. By default, @samp{hyperref} inserts
11294@code{#+KEYWORDS} as metadata. Use @code{org-latex-hyperref-template} to 11296@code{#+KEYWORDS} as metadata. Use @code{org-latex-hyperref-template} to
@@ -11296,7 +11298,7 @@ configure document metadata. Use @code{org-latex-title-command} to configure
11296typesetting of keywords as part of front matter. 11298typesetting of keywords as part of front matter.
11297 11299
11298@item SUBTITLE 11300@item SUBTITLE
11299@cindex #+SUBTITLE (Beamer) 11301@cindex @code{#+SUBTITLE} (Beamer)
11300@vindex org-beamer-subtitle-format 11302@vindex org-beamer-subtitle-format
11301Document's subtitle. For typesetting, use @code{org-beamer-subtitle-format} 11303Document's subtitle. For typesetting, use @code{org-beamer-subtitle-format}
11302string. Use @code{org-latex-hyperref-template} to configure document 11304string. Use @code{org-latex-hyperref-template} to configure document
@@ -11318,7 +11320,7 @@ Org headlines become Beamer frames when the heading level in Org is equal to
11318@code{org-beamer-frame-level} or @code{H} value in an @code{OPTIONS} line 11320@code{org-beamer-frame-level} or @code{H} value in an @code{OPTIONS} line
11319(@pxref{Export settings}). 11321(@pxref{Export settings}).
11320 11322
11321@cindex property, BEAMER_ENV 11323@cindex property, @code{BEAMER_ENV}
11322Org overrides headlines to frames conversion for the current tree of an Org 11324Org overrides headlines to frames conversion for the current tree of an Org
11323file if it encounters the @code{BEAMER_ENV} property set to @code{frame} or 11325file if it encounters the @code{BEAMER_ENV} property set to @code{frame} or
11324@code{fullframe}. Org ignores whatever @code{org-beamer-frame-level} happens 11326@code{fullframe}. Org ignores whatever @code{org-beamer-frame-level} happens
@@ -11337,7 +11339,7 @@ aid and has no semantic relevance.}. For valid values see
11337@code{org-beamer-environments-extra}. 11339@code{org-beamer-environments-extra}.
11338 11340
11339@item 11341@item
11340@cindex property, BEAMER_REF 11342@cindex property, @code{BEAMER_REF}
11341If @code{BEAMER_ENV} is set to @code{appendix}, Org exports the entry as an 11343If @code{BEAMER_ENV} is set to @code{appendix}, Org exports the entry as an
11342appendix. When set to @code{note}, Org exports the entry as a note within 11344appendix. When set to @code{note}, Org exports the entry as a note within
11343the frame or between frames, depending on the entry's heading level. When 11345the frame or between frames, depending on the entry's heading level. When
@@ -11351,8 +11353,8 @@ not its content. This is useful for inserting content between frames. It is
11351also useful for properly closing a @code{column} environment. 11353also useful for properly closing a @code{column} environment.
11352@end itemize 11354@end itemize
11353 11355
11354@cindex property, BEAMER_ACT 11356@cindex property, @code{BEAMER_ACT}
11355@cindex property, BEAMER_OPT 11357@cindex property, @code{BEAMER_OPT}
11356When @code{BEAMER_ACT} is set for a headline, Org export translates that 11358When @code{BEAMER_ACT} is set for a headline, Org export translates that
11357headline as an overlay or action specification. When enclosed in square 11359headline as an overlay or action specification. When enclosed in square
11358brackets, Org export makes the overlay specification a default. Use 11360brackets, Org export makes the overlay specification a default. Use
@@ -11361,7 +11363,7 @@ or block. The Beamer export back-end wraps with appropriate angular or
11361square brackets. It also adds the @code{fragile} option for any code that may 11363square brackets. It also adds the @code{fragile} option for any code that may
11362require a verbatim block. 11364require a verbatim block.
11363 11365
11364@cindex property, BEAMER_COL 11366@cindex property, @code{BEAMER_COL}
11365To create a column on the Beamer slide, use the @code{BEAMER_COL} property 11367To create a column on the Beamer slide, use the @code{BEAMER_COL} property
11366for its headline in the Org file. Set the value of @code{BEAMER_COL} to a 11368for its headline in the Org file. Set the value of @code{BEAMER_COL} to a
11367decimal number representing the fraction of the total text width. Beamer 11369decimal number representing the fraction of the total text width. Beamer
@@ -11376,8 +11378,8 @@ needs, use the @code{BEAMER_ENV} property.
11376@node Beamer specific syntax 11378@node Beamer specific syntax
11377@subsection Beamer specific syntax 11379@subsection Beamer specific syntax
11378Since Org's Beamer export back-end is an extension of the @LaTeX{} back-end, 11380Since Org's Beamer export back-end is an extension of the @LaTeX{} back-end,
11379it recognizes other @LaTeX{} specific syntax---for example, @samp{#+LATEX:} 11381it recognizes other @LaTeX{} specific syntax---for example, @code{#+LATEX:}
11380or @samp{#+ATTR_LATEX:}. @xref{@LaTeX{} export}, for details. 11382or @code{#+ATTR_LATEX:}. @xref{@LaTeX{} export}, for details.
11381 11383
11382Beamer export wraps the table of contents generated with @code{toc:t} 11384Beamer export wraps the table of contents generated with @code{toc:t}
11383@code{OPTION} keyword in a @code{frame} environment. Beamer export does not 11385@code{OPTION} keyword in a @code{frame} environment. Beamer export does not
@@ -11390,8 +11392,8 @@ contents}). Use square brackets for specifying options.
11390 11392
11391Insert Beamer-specific code using the following constructs: 11393Insert Beamer-specific code using the following constructs:
11392 11394
11393@cindex #+BEAMER 11395@cindex @code{#+BEAMER}
11394@cindex #+BEGIN_EXPORT beamer 11396@cindex @code{#+BEGIN_EXPORT beamer}
11395@example 11397@example
11396#+BEAMER: \pause 11398#+BEAMER: \pause
11397 11399
@@ -11412,7 +11414,7 @@ this example:
11412A *@@@@beamer:<2->@@@@useful* feature 11414A *@@@@beamer:<2->@@@@useful* feature
11413@end example 11415@end example
11414 11416
11415@cindex #+ATTR_BEAMER 11417@cindex @code{#+ATTR_BEAMER}
11416Beamer export recognizes the @code{ATTR_BEAMER} keyword with the following 11418Beamer export recognizes the @code{ATTR_BEAMER} keyword with the following
11417attributes from Beamer configurations: @code{:environment} for changing local 11419attributes from Beamer configurations: @code{:environment} for changing local
11418Beamer environment, @code{:overlay} for specifying Beamer overlays in angular 11420Beamer environment, @code{:overlay} for specifying Beamer overlays in angular
@@ -11536,66 +11538,66 @@ described in @ref{Export settings}.
11536 11538
11537@table @samp 11539@table @samp
11538@item DESCRIPTION 11540@item DESCRIPTION
11539@cindex #+DESCRIPTION (HTML) 11541@cindex @code{#+DESCRIPTION} (HTML)
11540This is the document's description, which the HTML exporter inserts it as a 11542This is the document's description, which the HTML exporter inserts it as a
11541HTML meta tag in the HTML file. For long descriptions, use multiple 11543HTML meta tag in the HTML file. For long descriptions, use multiple
11542@code{#+DESCRIPTION} lines. The exporter takes care of wrapping the lines 11544@code{#+DESCRIPTION} lines. The exporter takes care of wrapping the lines
11543properly. 11545properly.
11544 11546
11545@item HTML_DOCTYPE 11547@item HTML_DOCTYPE
11546@cindex #+HTML_DOCTYPE 11548@cindex @code{#+HTML_DOCTYPE}
11547@vindex org-html-doctype 11549@vindex org-html-doctype
11548Specify the document type, for example: HTML5 (@code{org-html-doctype}). 11550Specify the document type, for example: HTML5 (@code{org-html-doctype}).
11549 11551
11550@item HTML_CONTAINER 11552@item HTML_CONTAINER
11551@cindex #+HTML_CONTAINER 11553@cindex @code{#+HTML_CONTAINER}
11552@vindex org-html-container-element 11554@vindex org-html-container-element
11553Specify the HTML container, such as @samp{div}, for wrapping sections and 11555Specify the HTML container, such as @samp{div}, for wrapping sections and
11554elements (@code{org-html-container-element}). 11556elements (@code{org-html-container-element}).
11555 11557
11556@item HTML_LINK_HOME 11558@item HTML_LINK_HOME
11557@cindex #+HTML_LINK_HOME 11559@cindex @code{#+HTML_LINK_HOME}
11558@vindex org-html-link-home 11560@vindex org-html-link-home
11559The URL for home link (@code{org-html-link-home}). 11561The URL for home link (@code{org-html-link-home}).
11560 11562
11561@item HTML_LINK_UP 11563@item HTML_LINK_UP
11562@cindex #+HTML_LINK_UP 11564@cindex @code{#+HTML_LINK_UP}
11563@vindex org-html-link-up 11565@vindex org-html-link-up
11564The URL for the up link of exported HTML pages (@code{org-html-link-up}). 11566The URL for the up link of exported HTML pages (@code{org-html-link-up}).
11565 11567
11566@item HTML_MATHJAX 11568@item HTML_MATHJAX
11567@cindex #+HTML_MATHJAX 11569@cindex @code{#+HTML_MATHJAX}
11568@vindex org-html-mathjax-options 11570@vindex org-html-mathjax-options
11569Options for MathJax (@code{org-html-mathjax-options}). MathJax is used to 11571Options for MathJax (@code{org-html-mathjax-options}). MathJax is used to
11570typeset @LaTeX{} math in HTML documents. @xref{Math formatting in HTML 11572typeset @LaTeX{} math in HTML documents. @xref{Math formatting in HTML
11571export}, for an example. 11573export}, for an example.
11572 11574
11573@item HTML_HEAD 11575@item HTML_HEAD
11574@cindex #+HTML_HEAD 11576@cindex @code{#+HTML_HEAD}
11575@vindex org-html-head 11577@vindex org-html-head
11576Arbitrary lines for appending to the HTML document's head 11578Arbitrary lines for appending to the HTML document's head
11577(@code{org-html-head}). 11579(@code{org-html-head}).
11578 11580
11579@item HTML_HEAD_EXTRA 11581@item HTML_HEAD_EXTRA
11580@cindex #+HTML_HEAD_EXTRA 11582@cindex @code{#+HTML_HEAD_EXTRA}
11581@vindex org-html-head-extra 11583@vindex org-html-head-extra
11582More arbitrary lines for appending to the HTML document's head 11584More arbitrary lines for appending to the HTML document's head
11583(@code{org-html-head-extra}). 11585(@code{org-html-head-extra}).
11584 11586
11585@item KEYWORDS 11587@item KEYWORDS
11586@cindex #+KEYWORDS (HTML) 11588@cindex @code{#+KEYWORDS} (HTML)
11587Keywords to describe the document's content. HTML exporter inserts these 11589Keywords to describe the document's content. HTML exporter inserts these
11588keywords as HTML meta tags. For long keywords, use multiple 11590keywords as HTML meta tags. For long keywords, use multiple
11589@code{#+KEYWORDS} lines. 11591@code{#+KEYWORDS} lines.
11590 11592
11591@item LATEX_HEADER 11593@item LATEX_HEADER
11592@cindex #+LATEX_HEADER (HTML) 11594@cindex @code{#+LATEX_HEADER} (HTML)
11593Arbitrary lines for appending to the preamble; HTML exporter appends when 11595Arbitrary lines for appending to the preamble; HTML exporter appends when
11594transcoding @LaTeX{} fragments to images (@pxref{Math formatting in HTML 11596transcoding @LaTeX{} fragments to images (@pxref{Math formatting in HTML
11595export}). 11597export}).
11596 11598
11597@item SUBTITLE 11599@item SUBTITLE
11598@cindex #+SUBTITLE (HTML) 11600@cindex @code{#+SUBTITLE} (HTML)
11599The document's subtitle. HTML exporter formats subtitle if document type is 11601The document's subtitle. HTML exporter formats subtitle if document type is
11600@samp{HTML5} and the CSS has a @samp{subtitle} class. 11602@samp{HTML5} and the CSS has a @samp{subtitle} class.
11601@end table 11603@end table
@@ -11729,14 +11731,13 @@ back-end can insert that HTML code in the output, use this inline syntax:
11729text@@@@html:</b>@@@@}. For larger raw HTML code blocks, use these HTML 11731text@@@@html:</b>@@@@}. For larger raw HTML code blocks, use these HTML
11730export code blocks: 11732export code blocks:
11731 11733
11732@cindex #+HTML 11734@cindex @code{#+HTML}
11733@cindex #+BEGIN_EXPORT html
11734@example 11735@example
11735#+HTML: Literal HTML code for export 11736#+HTML: Literal HTML code for export
11736@end example 11737@end example
11737 11738
11738@noindent or 11739@noindent or
11739@cindex #+BEGIN_EXPORT html 11740@cindex @code{#+BEGIN_EXPORT html}
11740 11741
11741@example 11742@example
11742#+BEGIN_EXPORT html 11743#+BEGIN_EXPORT html
@@ -11773,7 +11774,7 @@ example, by using @code{#+ATTR_HTML} lines to specify new format attributes
11773to @code{<a>} or @code{<img>} tags. This example shows changing the link's 11774to @code{<a>} or @code{<img>} tags. This example shows changing the link's
11774@code{title} and @code{style}: 11775@code{title} and @code{style}:
11775 11776
11776@cindex #+ATTR_HTML 11777@cindex @code{#+ATTR_HTML}
11777@example 11778@example
11778#+ATTR_HTML: :title The Org mode homepage :style color:red; 11779#+ATTR_HTML: :title The Org mode homepage :style color:red;
11779[[http://orgmode.org]] 11780[[http://orgmode.org]]
@@ -11789,8 +11790,8 @@ exporting Org tables to HTML. By default, the exporter does not draw frames
11789and cell borders. To change for this for a table, use the following lines 11790and cell borders. To change for this for a table, use the following lines
11790before the table in the Org file: 11791before the table in the Org file:
11791 11792
11792@cindex #+CAPTION 11793@cindex @code{#+CAPTION}
11793@cindex #+ATTR_HTML 11794@cindex @code{#+ATTR_HTML}
11794@example 11795@example
11795#+CAPTION: This is a table with lines around and between cells 11796#+CAPTION: This is a table with lines around and between cells
11796#+ATTR_HTML: :border 2 :rules all :frame border 11797#+ATTR_HTML: :border 2 :rules all :frame border
@@ -11863,8 +11864,8 @@ Org file. This example shows realignment to right, and adds @code{alt} and
11863@code{title} attributes in support of text viewers and modern web accessibility 11864@code{title} attributes in support of text viewers and modern web accessibility
11864standards. 11865standards.
11865 11866
11866@cindex #+CAPTION 11867@cindex @code{#+CAPTION}
11867@cindex #+ATTR_HTML 11868@cindex @code{#+ATTR_HTML}
11868@example 11869@example
11869#+CAPTION: A black cat stalking a spider 11870#+CAPTION: A black cat stalking a spider
11870#+ATTR_HTML: :alt cat/spider image :title Action! :align right 11871#+ATTR_HTML: :alt cat/spider image :title Action! :align right
@@ -11973,7 +11974,7 @@ p.creator @r{creator info, about org mode version}
11973.done @r{the DONE keywords, all states that count as done} 11974.done @r{the DONE keywords, all states that count as done}
11974.WAITING @r{each TODO keyword also uses a class named after itself} 11975.WAITING @r{each TODO keyword also uses a class named after itself}
11975.timestamp @r{timestamp} 11976.timestamp @r{timestamp}
11976.timestamp-kwd @r{keyword associated with a timestamp, like SCHEDULED} 11977.timestamp-kwd @r{keyword associated with a timestamp, like @code{SCHEDULED}}
11977.timestamp-wrapper @r{span around keyword plus timestamp} 11978.timestamp-wrapper @r{span around keyword plus timestamp}
11978.tag @r{tag in a headline} 11979.tag @r{tag in a headline}
11979._HOME @r{each tag uses itself as a class, "@@" replaced by "_"} 11980._HOME @r{each tag uses itself as a class, "@@" replaced by "_"}
@@ -12001,14 +12002,14 @@ p.footnote @r{footnote definition paragraph, containing a footnote}
12001@vindex org-html-head-include-default-style 12002@vindex org-html-head-include-default-style
12002@vindex org-html-head 12003@vindex org-html-head
12003@vindex org-html-head-extra 12004@vindex org-html-head-extra
12004@cindex #+HTML_INCLUDE_STYLE 12005@cindex @code{#+HTML_INCLUDE_STYLE}
12005The HTML export back-end includes a compact default style in each exported 12006The HTML export back-end includes a compact default style in each exported
12006HTML file. To override the default style with another style, use these 12007HTML file. To override the default style with another style, use these
12007keywords in the Org file. They will replace the global defaults the HTML 12008keywords in the Org file. They will replace the global defaults the HTML
12008exporter uses. 12009exporter uses.
12009 12010
12010@cindex #+HTML_HEAD 12011@cindex @code{#+HTML_HEAD}
12011@cindex #+HTML_HEAD_EXTRA 12012@cindex @code{#+HTML_HEAD_EXTRA}
12012@example 12013@example
12013#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="style1.css" /> 12014#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="style1.css" />
12014#+HTML_HEAD_EXTRA: <link rel="alternate stylesheet" type="text/css" href="style2.css" /> 12015#+HTML_HEAD_EXTRA: <link rel="alternate stylesheet" type="text/css" href="style2.css" />
@@ -12058,7 +12059,7 @@ it on your own web server.
12058 12059
12059To use this program, just add this line to the Org file: 12060To use this program, just add this line to the Org file:
12060 12061
12061@cindex #+INFOJS_OPT 12062@cindex @code{#+INFOJS_OPT}
12062@example 12063@example
12063#+INFOJS_OPT: view:info toc:nil 12064#+INFOJS_OPT: view:info toc:nil
12064@end example 12065@end example
@@ -12179,7 +12180,7 @@ The @LaTeX{} export back-end has several additional keywords for customizing
12179 12180
12180@table @samp 12181@table @samp
12181@item DESCRIPTION 12182@item DESCRIPTION
12182@cindex #+DESCRIPTION (@LaTeX{}) 12183@cindex @code{#+DESCRIPTION} (@LaTeX{})
12183The document's description. The description along with author name, 12184The document's description. The description along with author name,
12184keywords, and related file metadata are inserted in the output file by the 12185keywords, and related file metadata are inserted in the output file by the
12185@samp{hyperref} package. See @code{org-latex-hyperref-template} for 12186@samp{hyperref} package. See @code{org-latex-hyperref-template} for
@@ -12188,7 +12189,7 @@ typesetting description into the document's front matter. Use multiple
12188@code{#+DESCRIPTION} lines for long descriptions. 12189@code{#+DESCRIPTION} lines for long descriptions.
12189 12190
12190@item LATEX_CLASS 12191@item LATEX_CLASS
12191@cindex #+LATEX_CLASS 12192@cindex @code{#+LATEX_CLASS}
12192@vindex org-latex-default-class 12193@vindex org-latex-default-class
12193@vindex org-latex-classes 12194@vindex org-latex-classes
12194This is @LaTeX{} document class, such as @code{article}, @code{report}, 12195This is @LaTeX{} document class, such as @code{article}, @code{report},
@@ -12199,32 +12200,32 @@ default class name from the @code{org-latex-default-class} variable. Org has
12199element of @code{org-latex-classes}. 12200element of @code{org-latex-classes}.
12200 12201
12201@item LATEX_CLASS_OPTIONS 12202@item LATEX_CLASS_OPTIONS
12202@cindex #+LATEX_CLASS_OPTIONS 12203@cindex @code{#+LATEX_CLASS_OPTIONS}
12203Options the @LaTeX{} export back-end uses when calling the @LaTeX{} document 12204Options the @LaTeX{} export back-end uses when calling the @LaTeX{} document
12204class. 12205class.
12205 12206
12206@item LATEX_COMPILER 12207@item LATEX_COMPILER
12207@cindex #+LATEX_COMPILER 12208@cindex @code{#+LATEX_COMPILER}
12208@vindex org-latex-compiler 12209@vindex org-latex-compiler
12209The compiler, such as @samp{pdflatex}, @samp{xelatex}, @samp{lualatex}, for 12210The compiler, such as @samp{pdflatex}, @samp{xelatex}, @samp{lualatex}, for
12210producing the PDF (@code{org-latex-compiler}). 12211producing the PDF (@code{org-latex-compiler}).
12211 12212
12212@item LATEX_HEADER 12213@item LATEX_HEADER
12213@cindex #+LATEX_HEADER 12214@cindex @code{#+LATEX_HEADER}
12214@vindex org-latex-classes 12215@vindex org-latex-classes
12215Arbitrary lines to add to the document's preamble, before the @samp{hyperref} 12216Arbitrary lines to add to the document's preamble, before the @samp{hyperref}
12216settings. See @code{org-latex-classes} for adjusting the structure and order 12217settings. See @code{org-latex-classes} for adjusting the structure and order
12217of the @LaTeX{} headers. 12218of the @LaTeX{} headers.
12218 12219
12219@item LATEX_HEADER_EXTRA 12220@item LATEX_HEADER_EXTRA
12220@cindex #+LATEX_HEADER_EXTRA 12221@cindex @code{#+LATEX_HEADER_EXTRA}
12221@vindex org-latex-classes 12222@vindex org-latex-classes
12222Arbitrary lines to add to the document's preamble, before the @samp{hyperref} 12223Arbitrary lines to add to the document's preamble, before the @samp{hyperref}
12223settings. See @code{org-latex-classes} for adjusting the structure and order 12224settings. See @code{org-latex-classes} for adjusting the structure and order
12224of the @LaTeX{} headers. 12225of the @LaTeX{} headers.
12225 12226
12226@item KEYWORDS 12227@item KEYWORDS
12227@cindex #+KEYWORDS (@LaTeX{}) 12228@cindex @code{#+KEYWORDS} (@LaTeX{})
12228The keywords for the document. The description along with author name, 12229The keywords for the document. The description along with author name,
12229keywords, and related file metadata are inserted in the output file by the 12230keywords, and related file metadata are inserted in the output file by the
12230@samp{hyperref} package. See @code{org-latex-hyperref-template} for 12231@samp{hyperref} package. See @code{org-latex-hyperref-template} for
@@ -12233,7 +12234,7 @@ typesetting description into the document's front matter. Use multiple
12233@code{#+KEYWORDS} lines if necessary. 12234@code{#+KEYWORDS} lines if necessary.
12234 12235
12235@item SUBTITLE 12236@item SUBTITLE
12236@cindex #+SUBTITLE (@LaTeX{}) 12237@cindex @code{#+SUBTITLE} (@LaTeX{})
12237@vindex org-latex-subtitle-separate 12238@vindex org-latex-subtitle-separate
12238@vindex org-latex-subtitle-format 12239@vindex org-latex-subtitle-format
12239The document's subtitle. It is typeset as per 12240The document's subtitle. It is typeset as per
@@ -12275,10 +12276,10 @@ exporter splices the values of @code{org-latex-default-packages-alist} and
12275@code{org-latex-packages-alist}. Use the same three variables to define 12276@code{org-latex-packages-alist}. Use the same three variables to define
12276custom sectioning or custom classes. 12277custom sectioning or custom classes.
12277 12278
12278@cindex #+LATEX_CLASS 12279@cindex @code{#+LATEX_CLASS}
12279@cindex #+LATEX_CLASS_OPTIONS 12280@cindex @code{#+LATEX_CLASS_OPTIONS}
12280@cindex property, EXPORT_LATEX_CLASS 12281@cindex property, @code{EXPORT_LATEX_CLASS}
12281@cindex property, EXPORT_LATEX_CLASS_OPTIONS 12282@cindex property, @code{EXPORT_LATEX_CLASS_OPTIONS}
12282The @LaTeX{} export back-end sends the @code{LATEX_CLASS_OPTIONS} keyword and 12283The @LaTeX{} export back-end sends the @code{LATEX_CLASS_OPTIONS} keyword and
12283@code{EXPORT_LATEX_CLASS_OPTIONS} property as options to the @LaTeX{} 12284@code{EXPORT_LATEX_CLASS_OPTIONS} property as options to the @LaTeX{}
12284@code{\documentclass} macro. The options and the syntax for specifying them, 12285@code{\documentclass} macro. The options and the syntax for specifying them,
@@ -12288,8 +12289,8 @@ including enclosing them in square brackets, follow @LaTeX{} conventions.
12288#+LATEX_CLASS_OPTIONS: [a4paper,11pt,twoside,twocolumn] 12289#+LATEX_CLASS_OPTIONS: [a4paper,11pt,twoside,twocolumn]
12289@end example 12290@end example
12290 12291
12291@cindex #+LATEX_HEADER 12292@cindex @code{#+LATEX_HEADER}
12292@cindex #+LATEX_HEADER_EXTRA 12293@cindex @code{#+LATEX_HEADER_EXTRA}
12293The @LaTeX{} export back-end appends values from @code{LATEX_HEADER} and 12294The @LaTeX{} export back-end appends values from @code{LATEX_HEADER} and
12294@code{LATEX_HEADER_EXTRA} keywords to the @LaTeX{} header. The docstring for 12295@code{LATEX_HEADER_EXTRA} keywords to the @LaTeX{} header. The docstring for
12295@code{org-latex-classes} explains in more detail. Also note that @LaTeX{} 12296@code{org-latex-classes} explains in more detail. Also note that @LaTeX{}
@@ -12323,14 +12324,14 @@ Code embedded in-line @@@@latex:any arbitrary LaTeX code@@@@ in a paragraph.
12323@end example 12324@end example
12324 12325
12325Inserting as one or more keyword lines in the Org file: 12326Inserting as one or more keyword lines in the Org file:
12326@cindex #+LATEX 12327@cindex @code{#+LATEX}
12327@example 12328@example
12328#+LATEX: any arbitrary LaTeX code 12329#+LATEX: any arbitrary LaTeX code
12329@end example 12330@end example
12330 12331
12331Inserting as an export block in the Org file, where the back-end exports any 12332Inserting as an export block in the Org file, where the back-end exports any
12332code between begin and end markers: 12333code between begin and end markers:
12333@cindex #+BEGIN_EXPORT latex 12334@cindex @code{#+BEGIN_EXPORT latex}
12334@example 12335@example
12335#+BEGIN_EXPORT latex 12336#+BEGIN_EXPORT latex
12336any arbitrary LaTeX code 12337any arbitrary LaTeX code
@@ -12340,7 +12341,7 @@ any arbitrary LaTeX code
12340@node Tables in @LaTeX{} export 12341@node Tables in @LaTeX{} export
12341@subsection Tables in @LaTeX{} export 12342@subsection Tables in @LaTeX{} export
12342@cindex tables, in @LaTeX{} export 12343@cindex tables, in @LaTeX{} export
12343@cindex #+ATTR_LATEX, in tables 12344@cindex @code{#+ATTR_LATEX}, in tables
12344 12345
12345The @LaTeX{} export back-end can pass several @LaTeX{} attributes for table 12346The @LaTeX{} export back-end can pass several @LaTeX{} attributes for table
12346contents and layout. Besides specifying label and caption (@pxref{Images and 12347contents and layout. Besides specifying label and caption (@pxref{Images and
@@ -12444,7 +12445,7 @@ Set the caption with the @LaTeX{} command
12444@subsection Images in @LaTeX{} export 12445@subsection Images in @LaTeX{} export
12445@cindex images, inline in @LaTeX{} 12446@cindex images, inline in @LaTeX{}
12446@cindex inlining images in @LaTeX{} 12447@cindex inlining images in @LaTeX{}
12447@cindex #+ATTR_LATEX, in images 12448@cindex @code{#+ATTR_LATEX}, in images
12448 12449
12449The @LaTeX{} export back-end processes image links in Org files that do not 12450The @LaTeX{} export back-end processes image links in Org files that do not
12450have descriptions, such as these links @samp{[[file:img.jpg]]} or 12451have descriptions, such as these links @samp{[[file:img.jpg]]} or
@@ -12514,7 +12515,7 @@ Set the @code{:comment-include} attribute to non-@code{nil} value for the
12514@node Plain lists in @LaTeX{} export 12515@node Plain lists in @LaTeX{} export
12515@subsection Plain lists in @LaTeX{} export 12516@subsection Plain lists in @LaTeX{} export
12516@cindex plain lists, in @LaTeX{} export 12517@cindex plain lists, in @LaTeX{} export
12517@cindex #+ATTR_LATEX, in plain lists 12518@cindex @code{#+ATTR_LATEX}, in plain lists
12518 12519
12519The @LaTeX{} export back-end accepts the @code{:environment} and 12520The @LaTeX{} export back-end accepts the @code{:environment} and
12520@code{:options} attributes for plain lists. Both attributes work together 12521@code{:options} attributes for plain lists. Both attributes work together
@@ -12548,7 +12549,7 @@ four:
12548@node Source blocks in @LaTeX{} export 12549@node Source blocks in @LaTeX{} export
12549@subsection Source blocks in @LaTeX{} export 12550@subsection Source blocks in @LaTeX{} export
12550@cindex source blocks, in @LaTeX{} export 12551@cindex source blocks, in @LaTeX{} export
12551@cindex #+ATTR_LATEX, in source blocks 12552@cindex @code{#+ATTR_LATEX}, in source blocks
12552 12553
12553The @LaTeX{} export back-end can make source code blocks into floating 12554The @LaTeX{} export back-end can make source code blocks into floating
12554objects through the attributes @code{:float} and @code{:options}. For 12555objects through the attributes @code{:float} and @code{:options}. For
@@ -12595,7 +12596,7 @@ variables.
12595@subsection Example blocks in @LaTeX{} export 12596@subsection Example blocks in @LaTeX{} export
12596@cindex example blocks, in @LaTeX{} export 12597@cindex example blocks, in @LaTeX{} export
12597@cindex verbatim blocks, in @LaTeX{} export 12598@cindex verbatim blocks, in @LaTeX{} export
12598@cindex #+ATTR_LATEX, in example blocks 12599@cindex @code{#+ATTR_LATEX}, in example blocks
12599 12600
12600The @LaTeX{} export back-end wraps the contents of example blocks in a 12601The @LaTeX{} export back-end wraps the contents of example blocks in a
12601@samp{verbatim} environment. To change this behavior to use another 12602@samp{verbatim} environment. To change this behavior to use another
@@ -12615,7 +12616,7 @@ This sentence is false.
12615@cindex special blocks, in @LaTeX{} export 12616@cindex special blocks, in @LaTeX{} export
12616@cindex abstract, in @LaTeX{} export 12617@cindex abstract, in @LaTeX{} export
12617@cindex proof, in @LaTeX{} export 12618@cindex proof, in @LaTeX{} export
12618@cindex #+ATTR_LATEX, in special blocks 12619@cindex @code{#+ATTR_LATEX}, in special blocks
12619 12620
12620 12621
12621For other special blocks in the Org file, the @LaTeX{} export back-end makes 12622For other special blocks in the Org file, the @LaTeX{} export back-end makes
@@ -12663,7 +12664,7 @@ example:
12663@node Horizontal rules in @LaTeX{} export 12664@node Horizontal rules in @LaTeX{} export
12664@subsection Horizontal rules in @LaTeX{} export 12665@subsection Horizontal rules in @LaTeX{} export
12665@cindex horizontal rules, in @LaTeX{} export 12666@cindex horizontal rules, in @LaTeX{} export
12666@cindex #+ATTR_LATEX, in horizontal rules 12667@cindex @code{#+ATTR_LATEX}, in horizontal rules
12667 12668
12668The @LaTeX{} export back-end converts horizontal rules by the specified 12669The @LaTeX{} export back-end converts horizontal rules by the specified
12669@code{:width} and @code{:thickness} attributes. For example: 12670@code{:width} and @code{:thickness} attributes. For example:
@@ -12747,10 +12748,10 @@ executable. Without @file{zip}, export cannot finish.
12747@anchor{x-export-to-odt} 12748@anchor{x-export-to-odt}
12748@cindex region, active 12749@cindex region, active
12749@cindex active region 12750@cindex active region
12750@cindex transient-mark-mode 12751@cindex @code{transient-mark-mode}
12751@table @kbd 12752@table @kbd
12752@orgcmd{C-c C-e o o,org-odt-export-to-odt} 12753@orgcmd{C-c C-e o o,org-odt-export-to-odt}
12753@cindex property EXPORT_FILE_NAME 12754@cindex property, @code{EXPORT_FILE_NAME}
12754 12755
12755Export as OpenDocument Text file. 12756Export as OpenDocument Text file.
12756 12757
@@ -12787,13 +12788,13 @@ output. Setting these keywords works similar to the general options
12787 12788
12788@table @samp 12789@table @samp
12789@item DESCRIPTION 12790@item DESCRIPTION
12790@cindex #+DESCRIPTION (ODT) 12791@cindex @code{#+DESCRIPTION} (ODT)
12791This is the document's description, which the ODT export back-end inserts as 12792This is the document's description, which the ODT export back-end inserts as
12792document metadata. For long descriptions, use multiple @code{#+DESCRIPTION} 12793document metadata. For long descriptions, use multiple @code{#+DESCRIPTION}
12793lines. 12794lines.
12794 12795
12795@item KEYWORDS 12796@item KEYWORDS
12796@cindex #+KEYWORDS (ODT) 12797@cindex @code{#+KEYWORDS} (ODT)
12797The keywords for the document. The ODT export back-end inserts the 12798The keywords for the document. The ODT export back-end inserts the
12798description along with author name, keywords, and related file metadata as 12799description along with author name, keywords, and related file metadata as
12799metadata in the output file. Use multiple @code{#+KEYWORDS} lines if 12800metadata in the output file. Use multiple @code{#+KEYWORDS} lines if
@@ -12848,7 +12849,7 @@ generic commands:
12848@vindex org-odt-convert 12849@vindex org-odt-convert
12849@table @kbd 12850@table @kbd
12850 12851
12851@item M-x org-odt-convert RET 12852@item M-x org-odt-convert @key{RET}
12852Convert an existing document from one format to another. With a prefix 12853Convert an existing document from one format to another. With a prefix
12853argument, opens the newly produced file. 12854argument, opens the newly produced file.
12854@end table 12855@end table
@@ -12882,7 +12883,7 @@ Open one, modify, and save as either OpenDocument Text (@file{.odt}) or
12882OpenDocument Template (@file{.ott}) file. 12883OpenDocument Template (@file{.ott}) file.
12883 12884
12884@item 12885@item
12885@cindex #+ODT_STYLES_FILE 12886@cindex @code{#+ODT_STYLES_FILE}
12886@vindex org-odt-styles-file 12887@vindex org-odt-styles-file
12887Customize the variable @code{org-odt-styles-file} and point it to the 12888Customize the variable @code{org-odt-styles-file} and point it to the
12888newly created file. For additional configuration options 12889newly created file. For additional configuration options
@@ -12941,7 +12942,7 @@ back-end honors any table alignments and relative widths for columns
12941Note that the ODT export back-end interprets column widths as weighted 12942Note that the ODT export back-end interprets column widths as weighted
12942ratios, the default weight being 1. 12943ratios, the default weight being 1.
12943 12944
12944@cindex #+ATTR_ODT 12945@cindex @code{#+ATTR_ODT}
12945 12946
12946Specifying @code{:rel-width} property on an @code{#+ATTR_ODT} line controls 12947Specifying @code{:rel-width} property on an @code{#+ATTR_ODT} line controls
12947the width of the table. For example: 12948the width of the table. For example:
@@ -12998,7 +12999,7 @@ when clicked jumps to @uref{http://Orgmode.org} website, do the following
12998 12999
12999@subsubheading Sizing and scaling of embedded images 13000@subsubheading Sizing and scaling of embedded images
13000 13001
13001@cindex #+ATTR_ODT 13002@cindex @code{#+ATTR_ODT}
13002Control the size and scale of the embedded images with the @code{#+ATTR_ODT} 13003Control the size and scale of the embedded images with the @code{#+ATTR_ODT}
13003attribute. 13004attribute.
13004 13005
@@ -13054,7 +13055,7 @@ height:width ratio, do the following
13054 13055
13055@subsubheading Anchoring of images 13056@subsubheading Anchoring of images
13056 13057
13057@cindex #+ATTR_ODT 13058@cindex @code{#+ATTR_ODT}
13058The ODT export back-end can anchor images to @samp{"as-char"}, 13059The ODT export back-end can anchor images to @samp{"as-char"},
13059@samp{"paragraph"}, or @samp{"page"}. Set the preferred anchor using the 13060@samp{"paragraph"}, or @samp{"page"}. Set the preferred anchor using the
13060@code{:anchor} property of the @code{#+ATTR_ODT} line. 13061@code{:anchor} property of the @code{#+ATTR_ODT} line.
@@ -13123,10 +13124,10 @@ To quickly verify the reliability of the @LaTeX{}-to-MathML converter, use
13123the following commands: 13124the following commands:
13124 13125
13125@table @kbd 13126@table @kbd
13126@item M-x org-odt-export-as-odf RET 13127@item M-x org-odt-export-as-odf @key{RET}
13127Convert a @LaTeX{} math snippet to an OpenDocument formula (@file{.odf}) file. 13128Convert a @LaTeX{} math snippet to an OpenDocument formula (@file{.odf}) file.
13128 13129
13129@item M-x org-odt-export-as-odf-and-open RET 13130@item M-x org-odt-export-as-odf-and-open @key{RET}
13130Convert a @LaTeX{} math snippet to an OpenDocument formula (@file{.odf}) file 13131Convert a @LaTeX{} math snippet to an OpenDocument formula (@file{.odf}) file
13131and open the formula file with the system-registered application. 13132and open the formula file with the system-registered application.
13132@end table 13133@end table
@@ -13452,7 +13453,7 @@ This paragraph is specially formatted and uses bold text.
13452@subsubheading Customizing tables in ODT export 13453@subsubheading Customizing tables in ODT export
13453@cindex tables, in ODT export 13454@cindex tables, in ODT export
13454 13455
13455@cindex #+ATTR_ODT 13456@cindex @code{#+ATTR_ODT}
13456Override the default table format by specifying a custom table style with the 13457Override the default table format by specifying a custom table style with the
13457@code{#+ATTR_ODT} line. For a discussion on default formatting of tables 13458@code{#+ATTR_ODT} line. For a discussion on default formatting of tables
13458@pxref{Tables in ODT export}. 13459@pxref{Tables in ODT export}.
@@ -13696,52 +13697,52 @@ Texinfo output. Setting these keywords works similar to the general options
13696@table @samp 13697@table @samp
13697 13698
13698@item SUBTITLE 13699@item SUBTITLE
13699@cindex #+SUBTITLE (Texinfo) 13700@cindex @code{#+SUBTITLE} (Texinfo)
13700The document subtitle. 13701The document subtitle.
13701 13702
13702@item SUBAUTHOR 13703@item SUBAUTHOR
13703@cindex #+SUBAUTHOR 13704@cindex @code{#+SUBAUTHOR}
13704The document subauthor. 13705The document subauthor.
13705 13706
13706@item TEXINFO_FILENAME 13707@item TEXINFO_FILENAME
13707@cindex #+TEXINFO_FILENAME 13708@cindex @code{#+TEXINFO_FILENAME}
13708The Texinfo filename. 13709The Texinfo filename.
13709 13710
13710@item TEXINFO_CLASS 13711@item TEXINFO_CLASS
13711@cindex #+TEXINFO_CLASS 13712@cindex @code{#+TEXINFO_CLASS}
13712@vindex org-texinfo-default-class 13713@vindex org-texinfo-default-class
13713The default document class (@code{org-texinfo-default-class}), which must be 13714The default document class (@code{org-texinfo-default-class}), which must be
13714a member of @code{org-texinfo-classes}. 13715a member of @code{org-texinfo-classes}.
13715 13716
13716@item TEXINFO_HEADER 13717@item TEXINFO_HEADER
13717@cindex #+TEXINFO_HEADER 13718@cindex @code{#+TEXINFO_HEADER}
13718Arbitrary lines inserted at the end of the header. 13719Arbitrary lines inserted at the end of the header.
13719 13720
13720@item TEXINFO_POST_HEADER 13721@item TEXINFO_POST_HEADER
13721@cindex #+TEXINFO_POST_HEADER 13722@cindex @code{#+TEXINFO_POST_HEADER}
13722Arbitrary lines inserted after the end of the header. 13723Arbitrary lines inserted after the end of the header.
13723 13724
13724@item TEXINFO_DIR_CATEGORY 13725@item TEXINFO_DIR_CATEGORY
13725@cindex #+TEXINFO_DIR_CATEGORY 13726@cindex @code{#+TEXINFO_DIR_CATEGORY}
13726The directory category of the document. 13727The directory category of the document.
13727 13728
13728@item TEXINFO_DIR_TITLE 13729@item TEXINFO_DIR_TITLE
13729@cindex #+TEXINFO_DIR_TITLE 13730@cindex @code{#+TEXINFO_DIR_TITLE}
13730The directory title of the document. 13731The directory title of the document.
13731 13732
13732@item TEXINFO_DIR_DESC 13733@item TEXINFO_DIR_DESC
13733@cindex #+TEXINFO_DIR_DESC 13734@cindex @code{#+TEXINFO_DIR_DESC}
13734The directory description of the document. 13735The directory description of the document.
13735 13736
13736@item TEXINFO_PRINTED_TITLE 13737@item TEXINFO_PRINTED_TITLE
13737@cindex #+TEXINFO_PRINTED_TITLE 13738@cindex @code{#+TEXINFO_PRINTED_TITLE}
13738The printed title of the document. 13739The printed title of the document.
13739@end table 13740@end table
13740 13741
13741@node Texinfo file header 13742@node Texinfo file header
13742@subsection Texinfo file header 13743@subsection Texinfo file header
13743 13744
13744@cindex #+TEXINFO_FILENAME 13745@cindex @code{#+TEXINFO_FILENAME}
13745After creating the header for a Texinfo file, the Texinfo back-end 13746After creating the header for a Texinfo file, the Texinfo back-end
13746automatically generates a name and destination path for the Info file. To 13747automatically generates a name and destination path for the Info file. To
13747override this default with a more sensible path and name, specify the 13748override this default with a more sensible path and name, specify the
@@ -13749,8 +13750,8 @@ override this default with a more sensible path and name, specify the
13749 13750
13750@vindex org-texinfo-coding-system 13751@vindex org-texinfo-coding-system
13751@vindex org-texinfo-classes 13752@vindex org-texinfo-classes
13752@cindex #+TEXINFO_HEADER 13753@cindex @code{#+TEXINFO_HEADER}
13753@cindex #+TEXINFO_CLASS 13754@cindex @code{#+TEXINFO_CLASS}
13754Along with the output's file name, the Texinfo header also contains language 13755Along with the output's file name, the Texinfo header also contains language
13755details (@pxref{Export settings}) and encoding system as set in the 13756details (@pxref{Export settings}) and encoding system as set in the
13756@code{org-texinfo-coding-system} variable. Insert @code{#+TEXINFO_HEADER} 13757@code{org-texinfo-coding-system} variable. Insert @code{#+TEXINFO_HEADER}
@@ -13764,14 +13765,14 @@ setting the @code{#+TEXINFO_CLASS} keyword to that class.
13764@node Texinfo title and copyright page 13765@node Texinfo title and copyright page
13765@subsection Texinfo title and copyright page 13766@subsection Texinfo title and copyright page
13766 13767
13767@cindex #+TEXINFO_PRINTED_TITLE 13768@cindex @code{#+TEXINFO_PRINTED_TITLE}
13768The default template for hard copy output has a title page with 13769The default template for hard copy output has a title page with
13769@code{#+TITLE} and @code{#+AUTHOR} (@pxref{Export settings}). To replace the 13770@code{#+TITLE} and @code{#+AUTHOR} (@pxref{Export settings}). To replace the
13770regular @code{#+TITLE} with something different for the printed version, use 13771regular @code{#+TITLE} with something different for the printed version, use
13771the @code{#+TEXINFO_PRINTED_TITLE} and @code{#+SUBTITLE} keywords. Both 13772the @code{#+TEXINFO_PRINTED_TITLE} and @code{#+SUBTITLE} keywords. Both
13772expect raw Texinfo code for setting their values. 13773expect raw Texinfo code for setting their values.
13773 13774
13774@cindex #+SUBAUTHOR 13775@cindex @code{#+SUBAUTHOR}
13775If one @code{#+AUTHOR} is not sufficient, add multiple @code{#+SUBAUTHOR} 13776If one @code{#+AUTHOR} is not sufficient, add multiple @code{#+SUBAUTHOR}
13776keywords. They have to be set in raw Texinfo code. 13777keywords. They have to be set in raw Texinfo code.
13777 13778
@@ -13781,7 +13782,7 @@ keywords. They have to be set in raw Texinfo code.
13781#+TEXINFO_PRINTED_TITLE: This Long Title@@inlinefmt@{tex,@@*@} Is Broken in @@TeX@{@} 13782#+TEXINFO_PRINTED_TITLE: This Long Title@@inlinefmt@{tex,@@*@} Is Broken in @@TeX@{@}
13782@end example 13783@end example
13783 13784
13784@cindex property, COPYING 13785@cindex property, @code{COPYING}
13785Copying material is defined in a dedicated headline with a non-@code{nil} 13786Copying material is defined in a dedicated headline with a non-@code{nil}
13786@code{:COPYING:} property. The back-end inserts the contents within a 13787@code{:COPYING:} property. The back-end inserts the contents within a
13787@code{@@copying} command at the beginning of the document. The heading 13788@code{@@copying} command at the beginning of the document. The heading
@@ -13809,9 +13810,9 @@ Copyright information is printed on the back of the title page.
13809@cindex @code{install-info} parameters, in Texinfo export 13810@cindex @code{install-info} parameters, in Texinfo export
13810@cindex Texinfo export, @code{install-info} parameters 13811@cindex Texinfo export, @code{install-info} parameters
13811 13812
13812@cindex #+TEXINFO_DIR_CATEGORY 13813@cindex @code{#+TEXINFO_DIR_CATEGORY}
13813@cindex #+TEXINFO_DIR_TITLE 13814@cindex @code{#+TEXINFO_DIR_TITLE}
13814@cindex #+TEXINFO_DIR_DESC 13815@cindex @code{#+TEXINFO_DIR_DESC}
13815The end result of the Texinfo export process is the creation of an Info file. 13816The end result of the Texinfo export process is the creation of an Info file.
13816This Info file's metadata has variables for category, title, and description: 13817This Info file's metadata has variables for category, title, and description:
13817@code{#+TEXINFO_DIR_CATEGORY}, @code{#+TEXINFO_DIR_TITLE}, and 13818@code{#+TEXINFO_DIR_CATEGORY}, @code{#+TEXINFO_DIR_TITLE}, and
@@ -13831,7 +13832,7 @@ Here is an example that writes to the Info directory file:
13831 13832
13832@vindex org-texinfo-classes 13833@vindex org-texinfo-classes
13833@vindex org-texinfo-default-class 13834@vindex org-texinfo-default-class
13834@cindex #+TEXINFO_CLASS 13835@cindex @code{#+TEXINFO_CLASS}
13835The Texinfo export back-end uses a pre-defined scheme to convert Org 13836The Texinfo export back-end uses a pre-defined scheme to convert Org
13836headlines to an equivalent Texinfo structuring commands. A scheme like this 13837headlines to an equivalent Texinfo structuring commands. A scheme like this
13837maps top-level headlines to numbered chapters tagged as @code{@@chapter} and 13838maps top-level headlines to numbered chapters tagged as @code{@@chapter} and
@@ -13846,12 +13847,12 @@ If an Org headline's level has no associated Texinfo structuring command, or
13846is below a certain threshold (@pxref{Export settings}), then the Texinfo 13847is below a certain threshold (@pxref{Export settings}), then the Texinfo
13847export back-end makes it into a list item. 13848export back-end makes it into a list item.
13848 13849
13849@cindex property, APPENDIX 13850@cindex property, @code{APPENDIX}
13850The Texinfo export back-end makes any headline with a non-@code{nil} 13851The Texinfo export back-end makes any headline with a non-@code{nil}
13851@code{:APPENDIX:} property into an appendix. This happens independent of the 13852@code{:APPENDIX:} property into an appendix. This happens independent of the
13852Org headline level or the @code{#+TEXINFO_CLASS}. 13853Org headline level or the @code{#+TEXINFO_CLASS}.
13853 13854
13854@cindex property, DESCRIPTION 13855@cindex property, @code{DESCRIPTION}
13855The Texinfo export back-end creates a menu entry after the Org headline for 13856The Texinfo export back-end creates a menu entry after the Org headline for
13856each regular sectioning structure. To override this with a shorter menu 13857each regular sectioning structure. To override this with a shorter menu
13857entry, use the @code{:ALT_TITLE:} property (@pxref{Table of contents}). 13858entry, use the @code{:ALT_TITLE:} property (@pxref{Table of contents}).
@@ -13877,22 +13878,22 @@ Top Node,,texinfo}, for more information.
13877@node Indices 13878@node Indices
13878@subsection Indices 13879@subsection Indices
13879 13880
13880@cindex #+CINDEX 13881@cindex @code{#+CINDEX}
13881@cindex concept index, in Texinfo export 13882@cindex concept index, in Texinfo export
13882@cindex Texinfo export, index, concept 13883@cindex Texinfo export, index, concept
13883@cindex #+FINDEX 13884@cindex @code{#+FINDEX}
13884@cindex function index, in Texinfo export 13885@cindex function index, in Texinfo export
13885@cindex Texinfo export, index, function 13886@cindex Texinfo export, index, function
13886@cindex #+KINDEX 13887@cindex @code{#+KINDEX}
13887@cindex keystroke index, in Texinfo export 13888@cindex keystroke index, in Texinfo export
13888@cindex Texinfo export, keystroke index 13889@cindex Texinfo export, keystroke index
13889@cindex #+PINDEX 13890@cindex @code{#+PINDEX}
13890@cindex program index, in Texinfo export 13891@cindex program index, in Texinfo export
13891@cindex Texinfo export, program index 13892@cindex Texinfo export, program index
13892@cindex #+TINDEX 13893@cindex @code{#+TINDEX}
13893@cindex data type index, in Texinfo export 13894@cindex data type index, in Texinfo export
13894@cindex Texinfo export, data type index 13895@cindex Texinfo export, data type index
13895@cindex #+VINDEX 13896@cindex @code{#+VINDEX}
13896@cindex variable index, in Texinfo export 13897@cindex variable index, in Texinfo export
13897@cindex Texinfo export, variable index 13898@cindex Texinfo export, variable index
13898The Texinfo export back-end recognizes these indexing keywords if used in the 13899The Texinfo export back-end recognizes these indexing keywords if used in the
@@ -13905,7 +13906,7 @@ escaped with @samp{@@} if they not belong to a Texinfo command.
13905#+CINDEX: Defining indexing entries 13906#+CINDEX: Defining indexing entries
13906@end example 13907@end example
13907 13908
13908@cindex property, INDEX 13909@cindex property, @code{INDEX}
13909For the back-end to generate an index entry for a headline, set the 13910For the back-end to generate an index entry for a headline, set the
13910@code{:INDEX:} property to @samp{cp} or @samp{vr}. These abbreviations come 13911@code{:INDEX:} property to @samp{cp} or @samp{vr}. These abbreviations come
13911from Texinfo that stand for concept index and variable index. The Texinfo 13912from Texinfo that stand for concept index and variable index. The Texinfo
@@ -13925,8 +13926,8 @@ inserts the index after its contents.
13925 13926
13926Use any of the following three methods to insert or escape raw Texinfo code: 13927Use any of the following three methods to insert or escape raw Texinfo code:
13927 13928
13928@cindex #+TEXINFO 13929@cindex @code{#+TEXINFO}
13929@cindex #+BEGIN_EXPORT texinfo 13930@cindex @code{#+BEGIN_EXPORT texinfo}
13930@example 13931@example
13931Richard @@@@texinfo:@@sc@{@@@@Stallman@@@@texinfo:@}@@@@ commence' GNU. 13932Richard @@@@texinfo:@@sc@{@@@@Stallman@@@@texinfo:@}@@@@ commence' GNU.
13932 13933
@@ -13941,10 +13942,10 @@ This paragraph is preceded by...
13941 13942
13942@node Plain lists in Texinfo export 13943@node Plain lists in Texinfo export
13943@subsection Plain lists in Texinfo export 13944@subsection Plain lists in Texinfo export
13944@cindex #+ATTR_TEXINFO, in plain lists 13945@cindex @code{#+ATTR_TEXINFO}, in plain lists
13945@cindex Two-column tables, in Texinfo export 13946@cindex Two-column tables, in Texinfo export
13946 13947
13947@cindex :table-type attribute, in Texinfo export 13948@cindex @code{:table-type} attribute, in Texinfo export
13948The Texinfo export back-end by default converts description lists in the Org 13949The Texinfo export back-end by default converts description lists in the Org
13949file using the default command @code{@@table}, which results in a table with 13950file using the default command @code{@@table}, which results in a table with
13950two columns. To change this behavior, specify @code{:table-type} with 13951two columns. To change this behavior, specify @code{:table-type} with
@@ -13952,14 +13953,14 @@ two columns. To change this behavior, specify @code{:table-type} with
13952@inforef{Two-column Tables,,texinfo}. 13953@inforef{Two-column Tables,,texinfo}.
13953 13954
13954@vindex org-texinfo-table-default-markup 13955@vindex org-texinfo-table-default-markup
13955@cindex :indic attribute, in Texinfo export 13956@cindex @code{:indic} attribute, in Texinfo export
13956The Texinfo export back-end by default also applies a text highlight based on 13957The Texinfo export back-end by default also applies a text highlight based on
13957the defaults stored in @code{org-texinfo-table-default-markup}. To override 13958the defaults stored in @code{org-texinfo-table-default-markup}. To override
13958the default highlight command, specify another one with the @code{:indic} 13959the default highlight command, specify another one with the @code{:indic}
13959attribute. 13960attribute.
13960 13961
13961@cindex Multiple entries in two-column tables, in Texinfo export 13962@cindex Multiple entries in two-column tables, in Texinfo export
13962@cindex :sep attribute, in Texinfo export 13963@cindex @code{:sep} attribute, in Texinfo export
13963Org syntax is limited to one entry per list item. Nevertheless, the Texinfo 13964Org syntax is limited to one entry per list item. Nevertheless, the Texinfo
13964export back-end can split that entry according to any text provided through 13965export back-end can split that entry according to any text provided through
13965the @code{:sep} attribute. Each part then becomes a new entry in the first 13966the @code{:sep} attribute. Each part then becomes a new entry in the first
@@ -13985,7 +13986,7 @@ This is the common text for variables foo and bar.
13985 13986
13986@node Tables in Texinfo export 13987@node Tables in Texinfo export
13987@subsection Tables in Texinfo export 13988@subsection Tables in Texinfo export
13988@cindex #+ATTR_TEXINFO, in tables 13989@cindex @code{#+ATTR_TEXINFO}, in tables
13989 13990
13990When exporting tables, the Texinfo export back-end uses the widest cell width 13991When exporting tables, the Texinfo export back-end uses the widest cell width
13991in each column. To override this and instead specify as fractions of line 13992in each column. To override this and instead specify as fractions of line
@@ -13998,7 +13999,7 @@ length, use the @code{:columns} attribute. See example below.
13998 13999
13999@node Images in Texinfo export 14000@node Images in Texinfo export
14000@subsection Images in Texinfo export 14001@subsection Images in Texinfo export
14001@cindex #+ATTR_TEXINFO, in images 14002@cindex @code{#+ATTR_TEXINFO}, in images
14002 14003
14003Insert a file link to the image in the Org file, and the Texinfo export 14004Insert a file link to the image in the Org file, and the Texinfo export
14004back-end inserts the image. These links must have the usual supported image 14005back-end inserts the image. These links must have the usual supported image
@@ -14013,7 +14014,7 @@ the text using Texinfo code, as shown in the example:
14013 14014
14014@node Special blocks in Texinfo export 14015@node Special blocks in Texinfo export
14015@subsection Special blocks 14016@subsection Special blocks
14016@cindex #+ATTR_TEXINFO, in special blocks 14017@cindex @code{#+ATTR_TEXINFO}, in special blocks
14017 14018
14018The Texinfo export back-end converts special blocks to commands with the same 14019The Texinfo export back-end converts special blocks to commands with the same
14019name. It also adds any @code{:options} attributes to the end of the command, 14020name. It also adds any @code{:options} attributes to the end of the command,
@@ -14136,7 +14137,7 @@ configure the variable @code{org-icalendar-categories}. To assign clock
14136alarms based on time, configure the @code{org-icalendar-alarm-time} variable. 14137alarms based on time, configure the @code{org-icalendar-alarm-time} variable.
14137 14138
14138@vindex org-icalendar-store-UID 14139@vindex org-icalendar-store-UID
14139@cindex property, ID 14140@cindex property, @code{ID}
14140The iCalendar format standard requires globally unique identifier---UID---for 14141The iCalendar format standard requires globally unique identifier---UID---for
14141each entry. The iCalendar export back-end creates UIDs during export. To 14142each entry. The iCalendar export back-end creates UIDs during export. To
14142save a copy of the UID in the Org file set the variable 14143save a copy of the UID in the Org file set the variable
@@ -14165,26 +14166,27 @@ and write it to @code{org-icalendar-combined-agenda-file} file name.
14165 14166
14166@vindex org-use-property-inheritance 14167@vindex org-use-property-inheritance
14167@vindex org-icalendar-include-body 14168@vindex org-icalendar-include-body
14168@cindex property, SUMMARY 14169@cindex property, @code{SUMMARY}
14169@cindex property, DESCRIPTION 14170@cindex property, @code{DESCRIPTION}
14170@cindex property, LOCATION 14171@cindex property, @code{LOCATION}
14171@cindex property, TIMEZONE 14172@cindex property, @code{TIMEZONE}
14172The iCalendar export back-end includes SUMMARY, DESCRIPTION, LOCATION and 14173The iCalendar export back-end includes @code{SUMMARY}, @code{DESCRIPTION},
14173TIMEZONE properties from the Org entries when exporting. To force the 14174@code{LOCATION} and @code{TIMEZONE} properties from the Org entries when
14174back-end to inherit the LOCATION and TIMEZONE properties, configure the 14175exporting. To force the back-end to inherit the @code{LOCATION} and
14175@code{org-use-property-inheritance} variable. 14176@code{TIMEZONE} properties, configure the @code{org-use-property-inheritance}
14176 14177variable.
14177When Org entries do not have SUMMARY, DESCRIPTION and LOCATION properties, 14178
14178the iCalendar export back-end derives the summary from the headline, and 14179When Org entries do not have @code{SUMMARY}, @code{DESCRIPTION} and
14179derives the description from the body of the Org item. The 14180@code{LOCATION} properties, the iCalendar export back-end derives the summary
14180@code{org-icalendar-include-body} variable limits the maximum number of 14181from the headline, and derives the description from the body of the Org item.
14182The @code{org-icalendar-include-body} variable limits the maximum number of
14181characters of the content are turned into its description. 14183characters of the content are turned into its description.
14182 14184
14183The TIMEZONE property can be used to specify a per-entry time zone, and will 14185The @code{TIMEZONE} property can be used to specify a per-entry time zone,
14184be applied to any entry with timestamp information. Time zones should be 14186and will be applied to any entry with timestamp information. Time zones
14185specified as per the IANA time zone database format, e.g.@: ``Asia/Almaty''. 14187should be specified as per the IANA time zone database format, e.g.@:
14186Alternately, the property value can be ``UTC'', to force UTC time for this 14188``Asia/Almaty''. Alternately, the property value can be ``UTC'', to force
14187entry only. 14189UTC time for this entry only.
14188 14190
14189Exporting to iCalendar format depends in large part on the capabilities of 14191Exporting to iCalendar format depends in large part on the capabilities of
14190the destination application. Some are more lenient than others. Consult the 14192the destination application. Some are more lenient than others. Consult the
@@ -14429,7 +14431,7 @@ In-place conversions are particularly handy for quick conversion of tables
14429and lists in foreign buffers. For example, turn on the minor mode @code{M-x 14431and lists in foreign buffers. For example, turn on the minor mode @code{M-x
14430orgstruct-mode} in an HTML buffer, then use the convenient Org keyboard 14432orgstruct-mode} in an HTML buffer, then use the convenient Org keyboard
14431commands to create a list, select it, and covert it to HTML with @code{M-x 14433commands to create a list, select it, and covert it to HTML with @code{M-x
14432org-html-convert-region-to-html RET}. 14434org-html-convert-region-to-html @key{RET}}.
14433 14435
14434 14436
14435@node Publishing 14437@node Publishing
@@ -14473,7 +14475,7 @@ and many other properties of a project.
14473 14475
14474@node Project alist 14476@node Project alist
14475@subsection The variable @code{org-publish-project-alist} 14477@subsection The variable @code{org-publish-project-alist}
14476@cindex org-publish-project-alist 14478@cindex @code{org-publish-project-alist}
14477@cindex projects, for publishing 14479@cindex projects, for publishing
14478 14480
14479@vindex org-publish-project-alist 14481@vindex org-publish-project-alist
@@ -14929,7 +14931,7 @@ The file will be created when first publishing a project with the
14929"theindex.inc"}. You can then build around this include statement by adding 14931"theindex.inc"}. You can then build around this include statement by adding
14930a title, style information, etc. 14932a title, style information, etc.
14931 14933
14932@cindex #+INDEX 14934@cindex @code{#+INDEX}
14933Index entries are specified with @code{#+INDEX} keyword. An entry that 14935Index entries are specified with @code{#+INDEX} keyword. An entry that
14934contains an exclamation mark will create a sub item. 14936contains an exclamation mark will create a sub item.
14935 14937
@@ -15100,8 +15102,8 @@ such as not inside comments and fixed width areas. Here's a sample
15100#+END_SRC 15102#+END_SRC
15101@end example 15103@end example
15102 15104
15103Org can take the code in the block between the @samp{#+BEGIN_SRC} and 15105Org can take the code in the block between the @code{#+BEGIN_SRC} and
15104@samp{#+END_SRC} tags, and format, compile, execute, and show the results. 15106@code{#+END_SRC} tags, and format, compile, execute, and show the results.
15105Org can simplify many housekeeping tasks essential to modern code 15107Org can simplify many housekeeping tasks essential to modern code
15106maintenance. That's why these blocks in Org mode literature are sometimes 15108maintenance. That's why these blocks in Org mode literature are sometimes
15107referred to as @samp{live code} blocks (as compared to the static text and 15109referred to as @samp{live code} blocks (as compared to the static text and
@@ -15110,7 +15112,7 @@ block by tweaking the headers for compiling, execution, extraction.
15110 15112
15111Org's @samp{src} code block type is one of many block types, such as quote, 15113Org's @samp{src} code block type is one of many block types, such as quote,
15112export, verse, latex, example, and verbatim. This section pertains to 15114export, verse, latex, example, and verbatim. This section pertains to
15113@samp{src} code blocks between @samp{#+BEGIN_SRC} and @samp{#+END_SRC} 15115@code{src} code blocks between @code{#+BEGIN_SRC} and @code{#+END_SRC}
15114 15116
15115For editing @samp{src} code blocks, Org provides native Emacs major-modes. 15117For editing @samp{src} code blocks, Org provides native Emacs major-modes.
15116That leverages the latest Emacs features for that source code language mode. 15118That leverages the latest Emacs features for that source code language mode.
@@ -15172,8 +15174,8 @@ Details of Org's facilities for working with source code are shown next.
15172@section Structure of code blocks 15174@section Structure of code blocks
15173@cindex code block, structure 15175@cindex code block, structure
15174@cindex source code, block structure 15176@cindex source code, block structure
15175@cindex #+NAME 15177@cindex @code{#+NAME}
15176@cindex #+BEGIN_SRC 15178@cindex @code{#+BEGIN_SRC}
15177 15179
15178Org offers two ways to structure source code in Org documents: in a 15180Org offers two ways to structure source code in Org documents: in a
15179@samp{src} block, and directly inline. Both specifications are shown below. 15181@samp{src} block, and directly inline. Both specifications are shown below.
@@ -15215,7 +15217,7 @@ results. Code from other blocks, other files, and from table formulas
15215(@pxref{The spreadsheet}) can use the name to reference a @samp{src} block. 15217(@pxref{The spreadsheet}) can use the name to reference a @samp{src} block.
15216This naming serves the same purpose as naming Org tables. Org mode requires 15218This naming serves the same purpose as naming Org tables. Org mode requires
15217unique names. For duplicate names, Org mode's behavior is undefined. 15219unique names. For duplicate names, Org mode's behavior is undefined.
15218@cindex #+NAME 15220@cindex @code{#+NAME}
15219@item #+BEGIN_SRC 15221@item #+BEGIN_SRC
15220@item #+END_SRC 15222@item #+END_SRC
15221Mandatory. They mark the start and end of a block that Org requires. The 15223Mandatory. They mark the start and end of a block that Org requires. The
@@ -15426,7 +15428,7 @@ block header arguments: One, set @code{padline} (@pxref{padline}) to true
15426@section Evaluating code blocks 15428@section Evaluating code blocks
15427@cindex code block, evaluating 15429@cindex code block, evaluating
15428@cindex source code, evaluating 15430@cindex source code, evaluating
15429@cindex #+RESULTS 15431@cindex @code{#+RESULTS}
15430 15432
15431A note about security: With code evaluation comes the risk of harm. Org 15433A note about security: With code evaluation comes the risk of harm. Org
15432safeguards by prompting for user's permission before executing any code in 15434safeguards by prompting for user's permission before executing any code in
@@ -15449,7 +15451,7 @@ evaluation from the @kbd{C-c C-c} key binding.} calls the
15449@code{org-babel-execute-src-block} function, which executes the code in the 15451@code{org-babel-execute-src-block} function, which executes the code in the
15450block, collects the results, and inserts them in the buffer. 15452block, collects the results, and inserts them in the buffer.
15451 15453
15452@cindex #+CALL 15454@cindex @code{#+CALL}
15453By calling a named code block@footnote{Actually, the constructs call_<name>() 15455By calling a named code block@footnote{Actually, the constructs call_<name>()
15454and src_<lang>@{@} are not evaluated when they appear in a keyword line 15456and src_<lang>@{@} are not evaluated when they appear in a keyword line
15455(i.e. lines starting with @code{#+KEYWORD:}, @pxref{In-buffer settings}).} 15457(i.e. lines starting with @code{#+KEYWORD:}, @pxref{In-buffer settings}).}
@@ -15732,7 +15734,7 @@ each line. Note that Org currently accepts the plural spelling of
15732@code{#+HEADER:} only as a convenience for backward-compatibility. It may be 15734@code{#+HEADER:} only as a convenience for backward-compatibility. It may be
15733removed at some point. 15735removed at some point.
15734 15736
15735@cindex #+HEADER: 15737@cindex @code{#+HEADER:}
15736 15738
15737Multi-line header arguments on an unnamed @samp{src} code block: 15739Multi-line header arguments on an unnamed @samp{src} code block:
15738 15740
@@ -16146,7 +16148,7 @@ Interpreted as raw Org mode. Inserted directly into the buffer. Aligned if
16146it is a table. Usage example: @code{:results value raw}. 16148it is a table. Usage example: @code{:results value raw}.
16147@item @code{org} 16149@item @code{org}
16148Results enclosed in a @code{BEGIN_SRC org} block. For comma-escape, either 16150Results enclosed in a @code{BEGIN_SRC org} block. For comma-escape, either
16149@kbd{TAB} in the block, or export the file. Usage example: @code{:results 16151@key{TAB} in the block, or export the file. Usage example: @code{:results
16150value org}. 16152value org}.
16151@item @code{html} 16153@item @code{html}
16152Results enclosed in a @code{BEGIN_EXPORT html} block. Usage example: 16154Results enclosed in a @code{BEGIN_EXPORT html} block. Usage example:
@@ -16233,7 +16235,7 @@ output file, @code{:dir} specifies the default directory during @samp{src}
16233code block execution. If it is absent, then the directory associated with 16235code block execution. If it is absent, then the directory associated with
16234the current buffer is used. In other words, supplying @code{:dir path} 16236the current buffer is used. In other words, supplying @code{:dir path}
16235temporarily has the same effect as changing the current directory with 16237temporarily has the same effect as changing the current directory with
16236@kbd{M-x cd path RET}, and then not supplying @code{:dir}. Under the 16238@kbd{M-x cd path @key{RET}}, and then not supplying @code{:dir}. Under the
16237surface, @code{:dir} simply sets the value of the Emacs variable 16239surface, @code{:dir} simply sets the value of the Emacs variable
16238@code{default-directory}. 16240@code{default-directory}.
16239 16241
@@ -17127,10 +17129,10 @@ Active key bindings in code blocks:
17127@item @kbd{C-c C-c} @tab @code{org-babel-execute-src-block} 17129@item @kbd{C-c C-c} @tab @code{org-babel-execute-src-block}
17128@kindex C-c C-o 17130@kindex C-c C-o
17129@item @kbd{C-c C-o} @tab @code{org-babel-open-src-block-result} 17131@item @kbd{C-c C-o} @tab @code{org-babel-open-src-block-result}
17130@kindex M-up 17132@kindex M-UP
17131@item @kbd{M-@key{up}} @tab @code{org-babel-load-in-session} 17133@item @kbd{M-@key{UP}} @tab @code{org-babel-load-in-session}
17132@kindex M-down 17134@kindex M-DOWN
17133@item @kbd{M-@key{down}} @tab @code{org-babel-switch-to-session} 17135@item @kbd{M-@key{DOWN}} @tab @code{org-babel-switch-to-session}
17134@end multitable 17136@end multitable
17135 17137
17136Active key bindings in Org mode buffer: 17138Active key bindings in Org mode buffer:
@@ -17247,12 +17249,12 @@ emacs -Q --batch --eval "
17247@chapter Miscellaneous 17249@chapter Miscellaneous
17248 17250
17249@menu 17251@menu
17250* Completion:: M-TAB guesses completions 17252* Completion:: M-@key{TAB} guesses completions
17251* Easy templates:: Quick insertion of structural elements 17253* Easy templates:: Quick insertion of structural elements
17252* Speed keys:: Electric commands at the beginning of a headline 17254* Speed keys:: Electric commands at the beginning of a headline
17253* Code evaluation security:: Org mode files evaluate inline code 17255* Code evaluation security:: Org mode files evaluate inline code
17254* Customization:: Adapting Org to changing tastes 17256* Customization:: Adapting Org to changing tastes
17255* In-buffer settings:: Overview of the #+KEYWORDS 17257* In-buffer settings:: Overview of the @code{#+KEYWORDS}
17256* The very busy C-c C-c key:: When in doubt, press C-c C-c 17258* The very busy C-c C-c key:: When in doubt, press C-c C-c
17257* Clean view:: Getting rid of leading stars in the outline 17259* Clean view:: Getting rid of leading stars in the outline
17258* TTY keys:: Using Org on a tty 17260* TTY keys:: Using Org on a tty
@@ -17286,7 +17288,7 @@ is involved. Such mode-specific hot keys have become an integral part of
17286Emacs and Org provides several shortcuts. 17288Emacs and Org provides several shortcuts.
17287 17289
17288@table @kbd 17290@table @kbd
17289@kindex M-@key{TAB} 17291@kindex M-TAB
17290@item M-@key{TAB} 17292@item M-@key{TAB}
17291Complete word at point 17293Complete word at point
17292@itemize @bullet 17294@itemize @bullet
@@ -17300,7 +17302,7 @@ can be used in search links like @samp{[[*find this headline]]}.
17300@item 17302@item
17301After @samp{:} in a headline, complete tags. The list of tags is taken 17303After @samp{:} in a headline, complete tags. The list of tags is taken
17302from the variable @code{org-tag-alist} (possibly set through the 17304from the variable @code{org-tag-alist} (possibly set through the
17303@samp{#+TAGS} in-buffer option, @pxref{Setting tags}), or it is created 17305@code{#+TAGS} in-buffer option, @pxref{Setting tags}), or it is created
17304dynamically from all tags used in the current buffer. 17306dynamically from all tags used in the current buffer.
17305@item 17307@item
17306After @samp{:} and not in a headline, complete property keys. The list 17308After @samp{:} and not in a headline, complete property keys. The list
@@ -17313,7 +17315,7 @@ After @samp{#+}, complete the special keywords like @samp{TYP_TODO} or
17313file-specific @samp{OPTIONS}. After option keyword is complete, pressing 17315file-specific @samp{OPTIONS}. After option keyword is complete, pressing
17314@kbd{M-@key{TAB}} again will insert example settings for that option. 17316@kbd{M-@key{TAB}} again will insert example settings for that option.
17315@item 17317@item
17316After @samp{#+STARTUP: }, complete startup keywords. 17318After @code{#+STARTUP:}, complete startup keywords.
17317@item 17319@item
17318When the point is anywhere else, complete dictionary words using Ispell. 17320When the point is anywhere else, complete dictionary words using Ispell.
17319@end itemize 17321@end itemize
@@ -17457,8 +17459,8 @@ Org executes formulas in tables (@pxref{The spreadsheet}) either through the
17457@cindex variables, for customization 17459@cindex variables, for customization
17458 17460
17459Org has more than 500 variables for customization. They can be accessed 17461Org has more than 500 variables for customization. They can be accessed
17460through the usual @kbd{M-x org-customize RET} command. Or through the Org 17462through the usual @kbd{M-x org-customize @key{RET}} command. Or through the
17461menu, @code{Org->Customization->Browse Org Group}. Org also has per-file 17463Org menu, @code{Org->Customization->Browse Org Group}. Org also has per-file
17462settings for some variables (@pxref{In-buffer settings}). 17464settings for some variables (@pxref{In-buffer settings}).
17463 17465
17464@node In-buffer settings 17466@node In-buffer settings
@@ -17477,13 +17479,13 @@ reopening the Org file in Emacs also activates the changes.
17477@table @kbd 17479@table @kbd
17478@item #+ARCHIVE: %s_done:: 17480@item #+ARCHIVE: %s_done::
17479Sets the archive location of the agenda file. This location applies to the 17481Sets the archive location of the agenda file. This location applies to the
17480lines until the next @samp{#+ARCHIVE} line, if any, in the Org file. The 17482lines until the next @code{#+ARCHIVE} line, if any, in the Org file. The
17481first archive location in the Org file also applies to any entries before it. 17483first archive location in the Org file also applies to any entries before it.
17482The corresponding variable is @code{org-archive-location}. 17484The corresponding variable is @code{org-archive-location}.
17483@item #+CATEGORY: 17485@item #+CATEGORY:
17484Sets the category of the agenda file, which applies to the entire document. 17486Sets the category of the agenda file, which applies to the entire document.
17485@item #+COLUMNS: %25ITEM ... 17487@item #+COLUMNS: %25ITEM ...
17486@cindex property, COLUMNS 17488@cindex property, @code{COLUMNS}
17487Sets the default format for columns view. Org uses this format for column 17489Sets the default format for columns view. Org uses this format for column
17488views where there is no @code{COLUMNS} property. 17490views where there is no @code{COLUMNS} property.
17489@item #+CONSTANTS: name1=value1 ... 17491@item #+CONSTANTS: name1=value1 ...
@@ -17510,7 +17512,7 @@ have a lower ASCII number than the lowest priority.
17510@item #+PROPERTY: Property_Name Value 17512@item #+PROPERTY: Property_Name Value
17511This line sets a default inheritance value for entries in the current 17513This line sets a default inheritance value for entries in the current
17512buffer, most useful for specifying the allowed values of a property. 17514buffer, most useful for specifying the allowed values of a property.
17513@cindex #+SETUPFILE 17515@cindex @code{#+SETUPFILE}
17514@item #+SETUPFILE: file or URL 17516@item #+SETUPFILE: file or URL
17515The setup file or a URL pointing to such file is for additional in-buffer 17517The setup file or a URL pointing to such file is for additional in-buffer
17516settings. Org loads this file and parses it for any settings in it only when 17518settings. Org loads this file and parses it for any settings in it only when
@@ -17522,7 +17524,7 @@ parses the contents of this document as if it was included in the buffer. It
17522can be another Org file. To visit the file (not a URL), @kbd{C-c '} while 17524can be another Org file. To visit the file (not a URL), @kbd{C-c '} while
17523the cursor is on the line with the file name. 17525the cursor is on the line with the file name.
17524@item #+STARTUP: 17526@item #+STARTUP:
17525@cindex #+STARTUP 17527@cindex @code{#+STARTUP}
17526Startup options Org uses when first visiting a file. 17528Startup options Org uses when first visiting a file.
17527 17529
17528The first set of options deals with the initial visibility of the outline 17530The first set of options deals with the initial visibility of the outline
@@ -17703,7 +17705,7 @@ fnadjust @r{automatically renumber and sort footnotes}
17703nofnadjust @r{do not renumber and sort automatically} 17705nofnadjust @r{do not renumber and sort automatically}
17704@end example 17706@end example
17705 17707
17706@cindex org-hide-block-startup 17708@cindex @code{org-hide-block-startup}
17707To hide blocks on startup, use these keywords. The corresponding variable is 17709To hide blocks on startup, use these keywords. The corresponding variable is
17708@code{org-hide-block-startup}. 17710@code{org-hide-block-startup}.
17709@cindex @code{hideblocks}, STARTUP keyword 17711@cindex @code{hideblocks}, STARTUP keyword
@@ -17713,7 +17715,7 @@ hideblocks @r{Hide all begin/end blocks on startup}
17713nohideblocks @r{Do not hide blocks on startup} 17715nohideblocks @r{Do not hide blocks on startup}
17714@end example 17716@end example
17715 17717
17716@cindex org-pretty-entities 17718@cindex @code{org-pretty-entities}
17717The display of entities as UTF-8 characters is governed by the variable 17719The display of entities as UTF-8 characters is governed by the variable
17718@code{org-pretty-entities} and the keywords 17720@code{org-pretty-entities} and the keywords
17719@cindex @code{entitiespretty}, STARTUP keyword 17721@cindex @code{entitiespretty}, STARTUP keyword
@@ -17728,11 +17730,11 @@ entitiesplain @r{Leave entities plain}
17728These lines specify valid tags for this file. Org accepts multiple tags 17730These lines specify valid tags for this file. Org accepts multiple tags
17729lines. Tags could correspond to the @emph{fast tag selection} keys. The 17731lines. Tags could correspond to the @emph{fast tag selection} keys. The
17730corresponding variable is @code{org-tag-alist}. 17732corresponding variable is @code{org-tag-alist}.
17731@cindex #+TBLFM 17733@cindex @code{#+TBLFM}
17732@item #+TBLFM: 17734@item #+TBLFM:
17733This line is for formulas for the table directly above. A table can have 17735This line is for formulas for the table directly above. A table can have
17734multiple @samp{#+TBLFM:} lines. On table recalculation, Org applies only the 17736multiple @code{#+TBLFM:} lines. On table recalculation, Org applies only the
17735first @samp{#+TBLFM:} line. For details see @ref{Using multiple #+TBLFM 17737first @code{#+TBLFM:} line. For details see @ref{Using multiple #+TBLFM
17736lines} in @ref{Editing and debugging formulas}. 17738lines} in @ref{Editing and debugging formulas}.
17737@item #+TITLE:, #+AUTHOR:, #+EMAIL:, #+LANGUAGE:, #+DATE:, 17739@item #+TITLE:, #+AUTHOR:, #+EMAIL:, #+LANGUAGE:, #+DATE:,
17738@itemx #+OPTIONS:, #+BIND:, 17740@itemx #+OPTIONS:, #+BIND:,
@@ -17748,7 +17750,7 @@ The corresponding variable is @code{org-todo-keywords}.
17748@node The very busy C-c C-c key 17750@node The very busy C-c C-c key
17749@section The very busy C-c C-c key 17751@section The very busy C-c C-c key
17750@kindex C-c C-c 17752@kindex C-c C-c
17751@cindex C-c C-c, overview 17753@cindex @kbd{C-c C-c}, overview
17752 17754
17753The @kbd{C-c C-c} key in Org serves many purposes depending on the context. 17755The @kbd{C-c C-c} key in Org serves many purposes depending on the context.
17754It is probably the most over-worked, multi-purpose key combination in Org. 17756It is probably the most over-worked, multi-purpose key combination in Org.
@@ -17912,7 +17914,8 @@ one of the following lines:
17912@end example 17914@end example
17913 17915
17914To switch between single and double stars layouts, use @kbd{M-x 17916To switch between single and double stars layouts, use @kbd{M-x
17915org-convert-to-odd-levels RET} and @kbd{M-x org-convert-to-oddeven-levels}. 17917org-convert-to-odd-levels @key{RET}} and @kbd{M-x
17918org-convert-to-oddeven-levels @key{RET}}.
17916@end enumerate 17919@end enumerate
17917 17920
17918@node TTY keys 17921@node TTY keys
@@ -17929,23 +17932,23 @@ normal @kbd{S-@key{cursor}} for editing timestamp might be better with
17929@multitable @columnfractions 0.15 0.2 0.1 0.2 17932@multitable @columnfractions 0.15 0.2 0.1 0.2
17930@item @b{Default} @tab @b{Alternative 1} @tab @b{Speed key} @tab @b{Alternative 2} 17933@item @b{Default} @tab @b{Alternative 1} @tab @b{Speed key} @tab @b{Alternative 2}
17931@item @kbd{S-@key{TAB}} @tab @kbd{C-u @key{TAB}} @tab @kbd{C} @tab 17934@item @kbd{S-@key{TAB}} @tab @kbd{C-u @key{TAB}} @tab @kbd{C} @tab
17932@item @kbd{M-@key{left}} @tab @kbd{C-c C-x l} @tab @kbd{l} @tab @kbd{@key{Esc} @key{left}} 17935@item @kbd{M-@key{LEFT}} @tab @kbd{C-c C-x l} @tab @kbd{l} @tab @kbd{@key{Esc} @key{LEFT}}
17933@item @kbd{M-S-@key{left}} @tab @kbd{C-c C-x L} @tab @kbd{L} @tab 17936@item @kbd{M-S-@key{LEFT}} @tab @kbd{C-c C-x L} @tab @kbd{L} @tab
17934@item @kbd{M-@key{right}} @tab @kbd{C-c C-x r} @tab @kbd{r} @tab @kbd{@key{Esc} @key{right}} 17937@item @kbd{M-@key{RIGHT}} @tab @kbd{C-c C-x r} @tab @kbd{r} @tab @kbd{@key{Esc} @key{RIGHT}}
17935@item @kbd{M-S-@key{right}} @tab @kbd{C-c C-x R} @tab @kbd{R} @tab 17938@item @kbd{M-S-@key{RIGHT}} @tab @kbd{C-c C-x R} @tab @kbd{R} @tab
17936@item @kbd{M-@key{up}} @tab @kbd{C-c C-x u} @tab @kbd{ } @tab @kbd{@key{Esc} @key{up}} 17939@item @kbd{M-@key{UP}} @tab @kbd{C-c C-x u} @tab @kbd{ } @tab @kbd{@key{Esc} @key{UP}}
17937@item @kbd{M-S-@key{up}} @tab @kbd{C-c C-x U} @tab @kbd{U} @tab 17940@item @kbd{M-S-@key{UP}} @tab @kbd{C-c C-x U} @tab @kbd{U} @tab
17938@item @kbd{M-@key{down}} @tab @kbd{C-c C-x d} @tab @kbd{ } @tab @kbd{@key{Esc} @key{down}} 17941@item @kbd{M-@key{DOWN}} @tab @kbd{C-c C-x d} @tab @kbd{ } @tab @kbd{@key{Esc} @key{DOWN}}
17939@item @kbd{M-S-@key{down}} @tab @kbd{C-c C-x D} @tab @kbd{D} @tab 17942@item @kbd{M-S-@key{DOWN}} @tab @kbd{C-c C-x D} @tab @kbd{D} @tab
17940@item @kbd{S-@key{RET}} @tab @kbd{C-c C-x c} @tab @kbd{ } @tab 17943@item @kbd{S-@key{RET}} @tab @kbd{C-c C-x c} @tab @kbd{ } @tab
17941@item @kbd{M-@key{RET}} @tab @kbd{C-c C-x m} @tab @kbd{ } @tab @kbd{@key{Esc} @key{RET}} 17944@item @kbd{M-@key{RET}} @tab @kbd{C-c C-x m} @tab @kbd{ } @tab @kbd{@key{Esc} @key{RET}}
17942@item @kbd{M-S-@key{RET}} @tab @kbd{C-c C-x M} @tab @kbd{ } @tab 17945@item @kbd{M-S-@key{RET}} @tab @kbd{C-c C-x M} @tab @kbd{ } @tab
17943@item @kbd{S-@key{left}} @tab @kbd{C-c @key{left}} @tab @kbd{ } @tab 17946@item @kbd{S-@key{LEFT}} @tab @kbd{C-c @key{LEFT}} @tab @kbd{ } @tab
17944@item @kbd{S-@key{right}} @tab @kbd{C-c @key{right}} @tab @kbd{ } @tab 17947@item @kbd{S-@key{RIGHT}} @tab @kbd{C-c @key{RIGHT}} @tab @kbd{ } @tab
17945@item @kbd{S-@key{up}} @tab @kbd{C-c @key{up}} @tab @kbd{ } @tab 17948@item @kbd{S-@key{UP}} @tab @kbd{C-c @key{UP}} @tab @kbd{ } @tab
17946@item @kbd{S-@key{down}} @tab @kbd{C-c @key{down}} @tab @kbd{ } @tab 17949@item @kbd{S-@key{DOWN}} @tab @kbd{C-c @key{DOWN}} @tab @kbd{ } @tab
17947@item @kbd{C-S-@key{left}} @tab @kbd{C-c C-x @key{left}} @tab @kbd{ } @tab 17950@item @kbd{C-S-@key{LEFT}} @tab @kbd{C-c C-x @key{LEFT}} @tab @kbd{ } @tab
17948@item @kbd{C-S-@key{right}} @tab @kbd{C-c C-x @key{right}} @tab @kbd{ } @tab 17951@item @kbd{C-S-@key{RIGHT}} @tab @kbd{C-c C-x @key{RIGHT}} @tab @kbd{ } @tab
17949@end multitable 17952@end multitable
17950 17953
17951 17954
@@ -18058,9 +18061,9 @@ bindings in Org files, and in the agenda buffer (but not during date
18058selection). 18061selection).
18059 18062
18060@example 18063@example
18061S-UP @result{} M-p S-DOWN @result{} M-n 18064S-@key{UP} @result{} M-p S-@key{DOWN} @result{} M-n
18062S-LEFT @result{} M-- S-RIGHT @result{} M-+ 18065S-@key{LEFT} @result{} M-- S-@key{RIGHT} @result{} M-+
18063C-S-LEFT @result{} M-S-- C-S-RIGHT @result{} M-S-+ 18066C-S-@key{LEFT} @result{} M-S-- C-S-@key{RIGHT} @result{} M-S-+
18064@end example 18067@end example
18065 18068
18066@vindex org-disputed-keys 18069@vindex org-disputed-keys
@@ -18427,7 +18430,7 @@ the mode is C, then:
18427At the location of source, Org needs a special line to direct Orgtbl to 18430At the location of source, Org needs a special line to direct Orgtbl to
18428translate and to find the target for inserting the translated table. For 18431translate and to find the target for inserting the translated table. For
18429example: 18432example:
18430@cindex #+ORGTBL 18433@cindex @code{#+ORGTBL}
18431@example 18434@example
18432#+ORGTBL: SEND table_name translation_function arguments... 18435#+ORGTBL: SEND table_name translation_function arguments...
18433@end example 18436@end example
@@ -18465,7 +18468,7 @@ Put the table after an @samp{END} statement. For example @samp{\bye} in
18465@TeX{} and @samp{\end@{document@}} in @LaTeX{}. 18468@TeX{} and @samp{\end@{document@}} in @LaTeX{}.
18466@item 18469@item
18467Comment and uncomment each line of the table during edits. The @kbd{M-x 18470Comment and uncomment each line of the table during edits. The @kbd{M-x
18468orgtbl-toggle-comment RET} command makes toggling easy. 18471orgtbl-toggle-comment @key{RET}} command makes toggling easy.
18469@end itemize 18472@end itemize
18470 18473
18471@node A @LaTeX{} example 18474@node A @LaTeX{} example
@@ -18478,10 +18481,10 @@ provided by @file{comment.sty}. To activate it, put
18478radio table skeleton@footnote{By default this works only for @LaTeX{}, HTML, 18481radio table skeleton@footnote{By default this works only for @LaTeX{}, HTML,
18479and Texinfo. Configure the variable @code{orgtbl-radio-table-templates} to 18482and Texinfo. Configure the variable @code{orgtbl-radio-table-templates} to
18480install templates for other export formats.} with the command @kbd{M-x 18483install templates for other export formats.} with the command @kbd{M-x
18481orgtbl-insert-radio-table RET}, which prompts for a table name. For example, 18484orgtbl-insert-radio-table @key{RET}}, which prompts for a table name. For
18482if @samp{salesfigures} is the name, the template inserts: 18485example, if @samp{salesfigures} is the name, the template inserts:
18483 18486
18484@cindex #+ORGTBL, SEND 18487@cindex @code{#+ORGTBL}, @samp{SEND}
18485@example 18488@example
18486% BEGIN RECEIVE ORGTBL salesfigures 18489% BEGIN RECEIVE ORGTBL salesfigures
18487% END RECEIVE ORGTBL salesfigures 18490% END RECEIVE ORGTBL salesfigures
@@ -18497,7 +18500,7 @@ The line @code{#+ORGTBL: SEND} tells Orgtbl mode to use the function
18497@code{orgtbl-to-latex} to convert the table to @LaTeX{} format, then insert 18500@code{orgtbl-to-latex} to convert the table to @LaTeX{} format, then insert
18498the table at the target (receive) location named @code{salesfigures}. Now 18501the table at the target (receive) location named @code{salesfigures}. Now
18499the table is ready for data entry. It can even use spreadsheet 18502the table is ready for data entry. It can even use spreadsheet
18500features@footnote{If the @samp{#+TBLFM} line contains an odd number of dollar 18503features@footnote{If the @code{#+TBLFM} line contains an odd number of dollar
18501characters, this may cause problems with font-lock in @LaTeX{} mode. As 18504characters, this may cause problems with font-lock in @LaTeX{} mode. As
18502shown in the example you can fix this by adding an extra line inside the 18505shown in the example you can fix this by adding an extra line inside the
18503@code{comment} environment that is used to balance the dollar expressions. 18506@code{comment} environment that is used to balance the dollar expressions.
@@ -18628,14 +18631,14 @@ translator functions by posting them to the Org users mailing list,
18628@node Radio lists 18631@node Radio lists
18629@subsection Radio lists 18632@subsection Radio lists
18630@cindex radio lists 18633@cindex radio lists
18631@cindex org-list-insert-radio-list 18634@cindex @code{org-list-insert-radio-list}
18632 18635
18633Call the @code{org-list-insert-radio-list} function to insert a radio list 18636Call the @code{org-list-insert-radio-list} function to insert a radio list
18634template in HTML, @LaTeX{}, and Texinfo mode documents. Sending and 18637template in HTML, @LaTeX{}, and Texinfo mode documents. Sending and
18635receiving radio lists works is the same as for radio tables (@pxref{Radio 18638receiving radio lists works is the same as for radio tables (@pxref{Radio
18636tables}) except for these differences: 18639tables}) except for these differences:
18637 18640
18638@cindex #+ORGLST 18641@cindex @code{#+ORGLST}
18639@itemize @minus 18642@itemize @minus
18640@item 18643@item
18641Orgstruct mode must be active. 18644Orgstruct mode must be active.
@@ -18679,7 +18682,7 @@ time}).
18679Dynamic blocks can have names and function parameters. The syntax is similar 18682Dynamic blocks can have names and function parameters. The syntax is similar
18680to @samp{src} code block specifications: 18683to @samp{src} code block specifications:
18681 18684
18682@cindex #+BEGIN:dynamic block 18685@cindex @code{#+BEGIN}, dynamic block
18683@example 18686@example
18684#+BEGIN: myblock :parameter1 value1 :parameter2 value2 ... 18687#+BEGIN: myblock :parameter1 value1 :parameter2 value2 ...
18685 18688
@@ -18941,7 +18944,7 @@ priority-n @r{The computed numerical priority}
18941 18944
18942@noindent 18945@noindent
18943If the selection of the agenda item was based on a timestamp, including those 18946If the selection of the agenda item was based on a timestamp, including those
18944items with @samp{DEADLINE} and @samp{SCHEDULED} keywords, then Org includes 18947items with @code{DEADLINE} and @code{SCHEDULED} keywords, then Org includes
18945date and time in the output. 18948date and time in the output.
18946 18949
18947If the selection of the agenda item was based on a timestamp (or 18950If the selection of the agenda item was based on a timestamp (or
diff --git a/doc/misc/pcl-cvs.texi b/doc/misc/pcl-cvs.texi
index 1163530e7a2..4c61aed5b3e 100644
--- a/doc/misc/pcl-cvs.texi
+++ b/doc/misc/pcl-cvs.texi
@@ -63,10 +63,11 @@ modify this GNU manual.''
63@node Top 63@node Top
64@top PCL-CVS 64@top PCL-CVS
65 65
66This manual describes PCL-CVS, the GNU Emacs front-end to CVS@. It 66This manual describes PCL-CVS, the GNU Emacs front-end to CVS@. It is
67is nowhere near complete, so you are advised to use @kbd{M-x 67nowhere near complete, so you are advised to use @kbd{M-x
68customize-group RET pcl-cvs @key{RET}} and to look at the documentation strings 68customize-group @key{RET} pcl-cvs @key{RET}} and to look at the
69of the various commands and major modes for further information. 69documentation strings of the various commands and major modes for
70further information.
70@c This manual is updated to release 2.5 of PCL-CVS. 71@c This manual is updated to release 2.5 of PCL-CVS.
71 72
72@insertcopying 73@insertcopying
@@ -1109,7 +1110,7 @@ Tag all selected files by running @samp{cvs tag} on
1109them (@code{cvs-mode-tag}). It's usually preferable to tag a directory 1110them (@code{cvs-mode-tag}). It's usually preferable to tag a directory
1110at a time. Rather than selecting all files (which too often doesn't 1111at a time. Rather than selecting all files (which too often doesn't
1111select all files but only the few that are displayed), clear the 1112select all files but only the few that are displayed), clear the
1112selection with @kbd{M-DEL} (@code{cvs-mode-unmark-all-files}), position 1113selection with @kbd{M-@key{DEL}} (@code{cvs-mode-unmark-all-files}), position
1113the cursor on the directory you want to tag and hit @kbd{t}. 1114the cursor on the directory you want to tag and hit @kbd{t}.
1114@end table 1115@end table
1115 1116
diff --git a/doc/misc/reftex.texi b/doc/misc/reftex.texi
index 55060d09b8c..3803cb0eb7a 100644
--- a/doc/misc/reftex.texi
+++ b/doc/misc/reftex.texi
@@ -3335,7 +3335,7 @@ have to rescan the buffer in order to see it.
3335@findex reftex-arg-index 3335@findex reftex-arg-index
3336@findex TeX-arg-index@r{, AUCTeX function} 3336@findex TeX-arg-index@r{, AUCTeX function}
3337@findex TeX-insert-macro@r{, AUCTeX function} 3337@findex TeX-insert-macro@r{, AUCTeX function}
3338@kindex C-c @key{RET} 3338@kindex C-c RET
3339@b{@RefTeX{} supplies macro arguments}@* When you insert a macro 3339@b{@RefTeX{} supplies macro arguments}@* When you insert a macro
3340interactively with @kbd{C-c @key{RET}}, @AUCTeX{} normally prompts for 3340interactively with @kbd{C-c @key{RET}}, @AUCTeX{} normally prompts for
3341macro arguments. Internally, it uses the functions 3341macro arguments. Internally, it uses the functions
diff --git a/doc/misc/sem-user.texi b/doc/misc/sem-user.texi
index e82162621bd..8484a7bfe23 100644
--- a/doc/misc/sem-user.texi
+++ b/doc/misc/sem-user.texi
@@ -1145,7 +1145,7 @@ Typing @kbd{RET} on a reference line jumps to that reference.
1145 1145
1146@node MRU Bookmarks 1146@node MRU Bookmarks
1147@section MRU Bookmarks mode 1147@section MRU Bookmarks mode
1148@cindex semantic-mru-bookmark-mode 1148@cindex @code{semantic-mru-bookmark-mode}
1149 1149
1150Semantic MRU Bookmarks mode is a minor mode that keeps track of the 1150Semantic MRU Bookmarks mode is a minor mode that keeps track of the
1151tags you have edited, allowing you to quickly return to them later 1151tags you have edited, allowing you to quickly return to them later
@@ -1193,7 +1193,7 @@ declarations. Other possible tag classes are @code{variable},
1193 1193
1194@node Highlight Func Mode 1194@node Highlight Func Mode
1195@section Highlight Func Mode 1195@section Highlight Func Mode
1196@cindex semantic-highlight-func-mode 1196@cindex @code{semantic-highlight-func-mode}
1197 1197
1198Semantic Highlight Function minor mode highlights the declaration line 1198Semantic Highlight Function minor mode highlights the declaration line
1199of the current function or tag (that is to say, the first line that 1199of the current function or tag (that is to say, the first line that
@@ -1220,7 +1220,7 @@ Func mode.
1220 1220
1221@node Tag Decoration Mode 1221@node Tag Decoration Mode
1222@section Tag Decoration Mode 1222@section Tag Decoration Mode
1223@cindex semantic-decoration-mode 1223@cindex @code{semantic-decoration-mode}
1224 1224
1225Semantic Tag Decoration mode ``decorates'' each tag based on certain 1225Semantic Tag Decoration mode ``decorates'' each tag based on certain
1226arbitrary features of that tag. Decorations are specified using the 1226arbitrary features of that tag. Decorations are specified using the
diff --git a/doc/misc/ses.texi b/doc/misc/ses.texi
index 60963adcb21..aa4fe81ba52 100644
--- a/doc/misc/ses.texi
+++ b/doc/misc/ses.texi
@@ -209,7 +209,7 @@ remove blank cells from the returned list, which allows to use
209@findex keyboard-quit 209@findex keyboard-quit
210 210
211To create a new spreadsheet, visit a nonexistent file whose name ends 211To create a new spreadsheet, visit a nonexistent file whose name ends
212 with ".ses". For example, @kbd{C-x C-f test.ses RET}. 212with ".ses". For example, @kbd{C-x C-f test.ses @key{RET}}.
213 213
214 214
215A @dfn{cell identifier} is a symbol with a column letter and a row 215A @dfn{cell identifier} is a symbol with a column letter and a row
@@ -310,7 +310,7 @@ To enter something else (e.g., a vector), begin with a digit, then
310erase the digit and type whatever you want. 310erase the digit and type whatever you want.
311 311
312@table @kbd 312@table @kbd
313@item RET 313@item @key{RET}
314Edit the existing formula in the current cell (@code{ses-edit-cell}). 314Edit the existing formula in the current cell (@code{ses-edit-cell}).
315 315
316@item C-c C-c 316@item C-c C-c
@@ -357,7 +357,7 @@ Basic commands:
357@item w 357@item w
358(@code{ses-set-column-width}) 358(@code{ses-set-column-width})
359 359
360@item TAB 360@item @key{TAB}
361Moves point to the next rightward cell, or inserts a new column if 361Moves point to the next rightward cell, or inserts a new column if
362already at last cell on line, or inserts a new row if at endline 362already at last cell on line, or inserts a new row if at endline
363(@code{ses-forward-or-insert}). 363(@code{ses-forward-or-insert}).
@@ -639,7 +639,7 @@ or a non-string is displayed as an error by using @code{#} filling.
639These commands set both formula and printer to @code{nil}: 639These commands set both formula and printer to @code{nil}:
640 640
641@table @kbd 641@table @kbd
642@item DEL 642@item @key{DEL}
643Clear cell and move left (@code{ses-clear-cell-backward}). 643Clear cell and move left (@code{ses-clear-cell-backward}).
644 644
645@item C-d 645@item C-d
@@ -1282,10 +1282,10 @@ avoid virus warnings, each function used in a formula needs
1282 1282
1283@node Uses of defadvice in @acronym{SES} 1283@node Uses of defadvice in @acronym{SES}
1284@section Uses of defadvice in @acronym{SES} 1284@section Uses of defadvice in @acronym{SES}
1285@cindex defadvice 1285@findex defadvice
1286@cindex undo-more 1286@findex undo-more
1287@cindex copy-region-as-kill 1287@findex copy-region-as-kill
1288@cindex yank 1288@findex yank
1289 1289
1290@table @code 1290@table @code
1291@item undo-more 1291@item undo-more
diff --git a/doc/misc/sieve.texi b/doc/misc/sieve.texi
index 37bb707f63a..2d290b36885 100644
--- a/doc/misc/sieve.texi
+++ b/doc/misc/sieve.texi
@@ -123,7 +123,7 @@ bindings to manage Sieve scripts remotely. @xref{Managing Sieve}.
123 123
124@table @kbd 124@table @kbd
125 125
126@item C-c RET 126@item C-c @key{RET}
127@kindex C-c RET 127@kindex C-c RET
128@findex sieve-manage 128@findex sieve-manage
129@cindex manage remote sieve script 129@cindex manage remote sieve script
@@ -160,8 +160,8 @@ press RET on <new script> to create a new script.
160@end example 160@end example
161 161
162One of the scripts are highlighted, and standard point navigation 162One of the scripts are highlighted, and standard point navigation
163commands (@kbd{<up>}, @kbd{<down>} etc.)@: can be used to navigate the 163commands (@kbd{@key{UP}}, @kbd{@key{DOWN}} etc.)@: can be used to
164list. 164navigate the list.
165 165
166The following commands are available in the Manage Sieve buffer: 166The following commands are available in the Manage Sieve buffer:
167 167
@@ -187,7 +187,7 @@ Deactivates all scripts.
187@findex sieve-remove 187@findex sieve-remove
188Remove currently highlighted script. 188Remove currently highlighted script.
189 189
190@item RET 190@item @key{RET}
191@item mouse-2 191@item mouse-2
192@item f 192@item f
193@kindex RET 193@kindex RET
@@ -272,7 +272,7 @@ The @file{sieve-manage.el} library contains low-level functionality
272for talking to a server with the @sc{managesieve} protocol. 272for talking to a server with the @sc{managesieve} protocol.
273 273
274A number of user-visible variables exist, which all can be customized 274A number of user-visible variables exist, which all can be customized
275in the @code{sieve} group (@kbd{M-x customize-group RET sieve RET}): 275in the @code{sieve} group (@kbd{M-x customize-group @key{RET} sieve @key{RET}}):
276 276
277@table @code 277@table @code
278 278
diff --git a/doc/misc/smtpmail.texi b/doc/misc/smtpmail.texi
index 6da51f798d6..c3387054baf 100644
--- a/doc/misc/smtpmail.texi
+++ b/doc/misc/smtpmail.texi
@@ -354,7 +354,7 @@ directory to hold queued messages. It defaults to
354 The function @code{smtpmail-send-queued-mail} can be used to send 354 The function @code{smtpmail-send-queued-mail} can be used to send
355any queued mail when @code{smtpmail-queue-mail} is enabled. It is 355any queued mail when @code{smtpmail-queue-mail} is enabled. It is
356typically invoked interactively with @kbd{M-x 356typically invoked interactively with @kbd{M-x
357smtpmail-send-queued-mail RET} when you are connected to the internet. 357smtpmail-send-queued-mail @key{RET}} when you are connected to the internet.
358 358
359@node Server workarounds 359@node Server workarounds
360@chapter Server workarounds 360@chapter Server workarounds
diff --git a/doc/misc/speedbar.texi b/doc/misc/speedbar.texi
index 6286ac12a9e..1c1b014f54e 100644
--- a/doc/misc/speedbar.texi
+++ b/doc/misc/speedbar.texi
@@ -87,7 +87,7 @@ on. @xref{Basic Navigation}.
87@chapter Introduction 87@chapter Introduction
88@cindex introduction 88@cindex introduction
89 89
90To start using speedbar use the command @kbd{M-x speedbar RET} or 90To start using speedbar use the command @kbd{M-x speedbar @key{RET}} or
91select it from the @samp{Options->Show/Hide} sub-menu. This command 91select it from the @samp{Options->Show/Hide} sub-menu. This command
92will open a new frame to summarize the local files. On X Window 92will open a new frame to summarize the local files. On X Window
93systems or on MS-Windows, speedbar's frame is twenty characters wide, 93systems or on MS-Windows, speedbar's frame is twenty characters wide,
@@ -188,7 +188,7 @@ these are available, some additional common bindings are available.
188 188
189@cindex common keys 189@cindex common keys
190@table @kbd 190@table @kbd
191@item RET 191@item @key{RET}
192@itemx e 192@itemx e
193Edit/Open the current group or tag. This behavior is dependent on the 193Edit/Open the current group or tag. This behavior is dependent on the
194mode. In general, files or buffers are opened in the attached frame, 194mode. In general, files or buffers are opened in the attached frame,
diff --git a/doc/misc/srecode.texi b/doc/misc/srecode.texi
index afa3af10352..2987f629747 100644
--- a/doc/misc/srecode.texi
+++ b/doc/misc/srecode.texi
@@ -105,11 +105,11 @@ item should appear.
105To toggle @srecode{} minor mode on and off use: 105To toggle @srecode{} minor mode on and off use:
106 106
107@example 107@example
108M-x srecode-minor-mode RET 108M-x srecode-minor-mode @key{RET}
109@end example 109@end example
110or 110or
111@example 111@example
112M-x global-srecode-minor-mode RET 112M-x global-srecode-minor-mode @key{RET}
113@end example 113@end example
114 114
115or add 115or add
@@ -276,7 +276,8 @@ If the variable @code{srecode-insert-ask-variable-method} is set to
276instead create ``fields'' in the buffer. A field-editing layer 276instead create ``fields'' in the buffer. A field-editing layer
277provides simple interaction through the fields. Typing in a field 277provides simple interaction through the fields. Typing in a field
278will cause all variable locations that are the same to edit at the 278will cause all variable locations that are the same to edit at the
279same time. Pressing TAB on a field will move you to the next field. 279same time. Pressing @kbd{@key{TAB}} on a field will move you to the
280next field.
280 281
281@node SRecode Minor Mode 282@node SRecode Minor Mode
282@chapter SRecode Minor Mode 283@chapter SRecode Minor Mode
@@ -284,17 +285,17 @@ same time. Pressing TAB on a field will move you to the next field.
284The Semantic Recode minor mode enables a keymap and menu that provides 285The Semantic Recode minor mode enables a keymap and menu that provides
285simple access to different templates or template applications. 286simple access to different templates or template applications.
286 287
287The key prefix is @key{C-c /}. 288The key prefix is @kbd{C-c /}.
288 289
289If the variable @code{srecode-takeover-INS-key} is set, then the key 290If the variable @code{srecode-takeover-INS-key} is set, then the key
290@key{<insert>} can also be used. 291@kbd{@key{INSERT}} can also be used.
291 292
292The most important key is bound to @code{srecode-insert} which is 293The most important key is bound to @code{srecode-insert} which is
293@key{C-c / /}, or @key{insert insert}. @ref{Quick Start}. 294@kbd{C-c / /}, or @kbd{@key{INSERT} @key{INSERT}}. @ref{Quick Start}.
294 295
295Major keybindings are: 296Major keybindings are:
296 297
297@table @key 298@table @kbd
298@item C-c / / 299@item C-c / /
299Insert a template whose name is typed into the minibuffer. 300Insert a template whose name is typed into the minibuffer.
300@item C-c / <lower case letter> 301@item C-c / <lower case letter>
@@ -338,7 +339,7 @@ will not be prompted to fill in values while the template is
338inserted. Instead, short regions will be highlighted, and the cursor 339inserted. Instead, short regions will be highlighted, and the cursor
339placed in a field. Typing in the field will then fill in the value. 340placed in a field. Typing in the field will then fill in the value.
340Several fields might be linked together. In that case, typing in one 341Several fields might be linked together. In that case, typing in one
341area will modify the other linked areas. Pressing TAB will move 342area will modify the other linked areas. Pressing @key{TAB} will move
342between editable fields in the template. 343between editable fields in the template.
343 344
344Once the cursor moves out of the are inserted by the template, all the 345Once the cursor moves out of the are inserted by the template, all the
diff --git a/doc/misc/vhdl-mode.texi b/doc/misc/vhdl-mode.texi
index e94fba6fc6d..8fc75106d52 100644
--- a/doc/misc/vhdl-mode.texi
+++ b/doc/misc/vhdl-mode.texi
@@ -100,7 +100,7 @@ How to customize the indentation engine.
100The major version number was incremented to 3 with the addition of 100The major version number was incremented to 3 with the addition of
101many new features for editing VHDL code to the new indentation engine, 101many new features for editing VHDL code to the new indentation engine,
102which was introduced in major version 2. To find the minor revision 102which was introduced in major version 2. To find the minor revision
103number of this release, use @kbd{M-x vhdl-version RET}. 103number of this release, use @kbd{M-x vhdl-version @key{RET}}.
104 104
105A special word of thanks goes to Rod Whitby, who wrote the 105A special word of thanks goes to Rod Whitby, who wrote the
106VHDL Mode indentation engine, and to Barry Warsaw, who wrote 106VHDL Mode indentation engine, and to Barry Warsaw, who wrote
@@ -119,7 +119,7 @@ makes everything highly self-explaining.
119@cindex Getting Connected 119@cindex Getting Connected
120 120
121To get started, simply visit a @file{.vhd} file in Emacs; or type 121To get started, simply visit a @file{.vhd} file in Emacs; or type
122@kbd{M-x vhdl-mode RET}. 122@kbd{M-x vhdl-mode @key{RET}}.
123 123
124@node New Indentation Engine 124@node New Indentation Engine
125@chapter New Indentation Engine 125@chapter New Indentation Engine
@@ -302,11 +302,11 @@ being used.
302 302
303@vindex vhdl-echo-syntactic-information-p 303@vindex vhdl-echo-syntactic-information-p
304@vindex echo-syntactic-information-p @r{(vhdl-)} 304@vindex echo-syntactic-information-p @r{(vhdl-)}
305@cindex TAB 305@cindex @key{TAB}
306To help you configure VHDL Mode, you can set the variable 306To help you configure VHDL Mode, you can set the variable
307@code{vhdl-echo-syntactic-information-p} to non-@code{nil} so that the 307@code{vhdl-echo-syntactic-information-p} to non-@code{nil} so that the
308syntactic component list and calculated offset will always be echoed in 308syntactic component list and calculated offset will always be echoed in
309the minibuffer when you hit @kbd{TAB}. 309the minibuffer when you hit @kbd{@key{TAB}}.
310 310
311 311
312@ignore 312@ignore
@@ -322,7 +322,7 @@ the minibuffer when you hit @kbd{TAB}.
322@chapter Customizing Indentation 322@chapter Customizing Indentation
323@cindex Customizing Indentation 323@cindex Customizing Indentation
324 324
325@cindex vhdl-set-offset 325@cindex @code{vhdl-set-offset}
326@cindex set-offset (vhdl-) 326@cindex set-offset (vhdl-)
327The @code{vhdl-offsets-alist} variable is where you customize all your 327The @code{vhdl-offsets-alist} variable is where you customize all your
328indentations. You simply need to decide what additional offset you want 328indentations. You simply need to decide what additional offset you want
@@ -334,7 +334,7 @@ pre-defined styles will suit your needs, but if not, this section will
334describe how to set up basic editing configurations. @xref{Styles}, for 334describe how to set up basic editing configurations. @xref{Styles}, for
335an explanation of how to set up named styles. 335an explanation of how to set up named styles.
336 336
337@cindex vhdl-basic-offset 337@cindex @code{vhdl-basic-offset}
338@cindex basic-offset (vhdl-) 338@cindex basic-offset (vhdl-)
339As mentioned previously, the variable @code{vhdl-offsets-alist} is an 339As mentioned previously, the variable @code{vhdl-offsets-alist} is an
340association list between syntactic symbols and the offsets to be applied 340association list between syntactic symbols and the offsets to be applied
@@ -548,7 +548,7 @@ already built-in. These include:
548@findex vhdl-set-style 548@findex vhdl-set-style
549@findex set-style @r{(vhdl-)} 549@findex set-style @r{(vhdl-)}
550If you'd like to experiment with these built-in styles you can simply 550If you'd like to experiment with these built-in styles you can simply
551type @kbd{M-x vhdl-set-style RET} in a VHDL Mode buffer. 551type @kbd{M-x vhdl-set-style @key{RET}} in a VHDL Mode buffer.
552 552
553You will be prompted for one of the above styles (with completion). 553You will be prompted for one of the above styles (with completion).
554Enter one of the styles and hit @kbd{RET}. Note however that setting a 554Enter one of the styles and hit @kbd{RET}. Note however that setting a
diff --git a/doc/misc/vip.texi b/doc/misc/vip.texi
index af4c05d8e48..59df7492315 100644
--- a/doc/misc/vip.texi
+++ b/doc/misc/vip.texi
@@ -186,8 +186,8 @@ M-x vip-mode
186@node Modes in VIP 186@node Modes in VIP
187@section Modes in VIP 187@section Modes in VIP
188 188
189@kindex 032 @kbd{C-z} (@code{vip-change-mode-to-vi}) 189@kindex 032 C-z @r{(}@code{vip-change-mode-to-vi}@r{)}
190@kindex 0301 @kbd{C-x C-z} (@code{suspend-emacs}) 190@kindex 0301 C-x C-z @r{(}@code{suspend-emacs}@r{)}
191 191
192Loading VIP has the effect of globally binding @kbd{C-z} (@kbd{Control-z}) 192Loading VIP has the effect of globally binding @kbd{C-z} (@kbd{Control-z})
193to the function @code{vip-change-mode-to-vi}. The default binding of @kbd{C-z} 193to the function @code{vip-change-mode-to-vi}. The default binding of @kbd{C-z}
@@ -266,7 +266,7 @@ emacs mode vi mode insert mode
266@node Emacs Mode 266@node Emacs Mode
267@subsection Emacs Mode 267@subsection Emacs Mode
268 268
269@kindex 032 @kbd{C-z} (@code{vip-change-mode-to-vi}) 269@kindex 032 C-z @r{(}@code{vip-change-mode-to-vi}@r{)}
270 270
271You will be in this mode just after you loaded VIP@. You can do all 271You will be in this mode just after you loaded VIP@. You can do all
272normal Emacs editing in this mode. Note that the key @kbd{C-z} is globally 272normal Emacs editing in this mode. Note that the key @kbd{C-z} is globally
@@ -289,16 +289,16 @@ its content while you are in insert mode.
289 289
290@table @kbd 290@table @kbd
291@item @key{ESC} 291@item @key{ESC}
292@kindex 033 @kbd{ESC} (@code{vip-change-mode-to-vi}) (insert mode) 292@kindex 033 ESC @r{(}@code{vip-change-mode-to-vi}@r{) (insert mode)}
293This key will take you back to vi mode. 293This key will take you back to vi mode.
294@item C-h 294@item C-h
295@kindex 010 @kbd{C-h} (@code{vip-delete-backward-char}) (insert mode) 295@kindex 010 C-h @r{(}@code{vip-delete-backward-char}@r{) (insert mode)}
296Delete previous character. 296Delete previous character.
297@item C-w 297@item C-w
298@kindex 027 @kbd{C-w} (@code{vip-delete-backward-word}) (insert mode) 298@kindex 027 C-w @r{(}@code{vip-delete-backward-word}@r{) (insert mode)}
299Delete previous word. 299Delete previous word.
300@item C-z 300@item C-z
301@kindex 032 @kbd{C-z} (@code{vip-ESC}) (insert mode) 301@kindex 032 C-z @r{(}@code{vip-ESC}@r{) (insert mode)}
302Typing this key has the same effect as typing @key{ESC} in emacs mode. 302Typing this key has the same effect as typing @key{ESC} in emacs mode.
303Thus typing @kbd{C-z x} in insert mode will have the same effect as typing 303Thus typing @kbd{C-z x} in insert mode will have the same effect as typing
304@kbd{ESC x} in emacs mode. 304@kbd{ESC x} in emacs mode.
@@ -332,8 +332,8 @@ The major differences from Vi are explained below.
332@node Undoing 332@node Undoing
333@subsection Undoing 333@subsection Undoing
334 334
335@kindex 165 @kbd{u} (@code{vip-undo}) 335@kindex 165 u @r{(}@code{vip-undo}@r{)}
336@kindex 056 @kbd{.} (@code{vip-repeat}) 336@kindex 056 . @r{(}@code{vip-repeat}@r{)}
337 337
338You can repeat undoing by the @kbd{.} key. So, @kbd{u} will undo 338You can repeat undoing by the @kbd{.} key. So, @kbd{u} will undo
339a single change, while @kbd{u .@: .@: .@:}, for instance, will undo 4 previous 339a single change, while @kbd{u .@: .@: .@:}, for instance, will undo 4 previous
@@ -350,14 +350,14 @@ then VIP will prompt you for a new word in the minibuffer by the prompt
350@samp{foo => }. You can then enter @samp{bar} followed by @key{RET} or 350@samp{foo => }. You can then enter @samp{bar} followed by @key{RET} or
351@key{ESC} to complete the command. Before you enter @key{RET} or 351@key{ESC} to complete the command. Before you enter @key{RET} or
352@key{ESC} you can abort the command by typing @kbd{C-g}. In general, 352@key{ESC} you can abort the command by typing @kbd{C-g}. In general,
353@kindex 007 @kbd{C-g} (@code{vip-keyboard-quit}) 353@kindex 007 C-g @r{(}@code{vip-keyboard-quit})
354you can abort a partially formed command by typing @kbd{C-g}. 354you can abort a partially formed command by typing @kbd{C-g}.
355 355
356@node Searching 356@node Searching
357@subsection Searching 357@subsection Searching
358 358
359@kindex 057 @kbd{/} (@code{vip-search-forward}) 359@kindex 057 / @r{(}@code{vip-search-forward}@r{)}
360@kindex 077 @kbd{?} (@code{vip-search-backward}) 360@kindex 077 ? @r{(}@code{vip-search-backward}@r{)}
361 361
362As in Vi, searching is done by @kbd{/} and @kbd{?}. The string will be 362As in Vi, searching is done by @kbd{/} and @kbd{?}. The string will be
363searched literally by default. To invoke a regular expression search, 363searched literally by default. To invoke a regular expression search,
@@ -372,12 +372,12 @@ the buffer as in Vi. You can change this by rebinding the variable
372@node z Command 372@node z Command
373@subsection z Command 373@subsection z Command
374 374
375@kindex 1723 @kbd{z H} (@code{vip-line-to-top}) 375@kindex 1723 z H @r{(}@code{vip-line-to-top}@r{)}
376@kindex 1721 @kbd{z RET} (@code{vip-line-to-top}) 376@kindex 1721 z RET @r{(}@code{vip-line-to-top}@r{)}
377@kindex 1723 @kbd{z M} (@code{vip-line-to-middle}) 377@kindex 1723 z M @r{(}@code{vip-line-to-middle}@r{)}
378@kindex 1722 @kbd{z .} (@code{vip-line-to-middle}) 378@kindex 1722 z . @r{(}@code{vip-line-to-middle}@r{)}
379@kindex 1723 @kbd{z L} (@code{vip-line-to-bottom}) 379@kindex 1723 z L @r{(}@code{vip-line-to-bottom}@r{)}
380@kindex 1722 @kbd{z -} (@code{vip-line-to-bottom}) 380@kindex 1722 z - @r{(}@code{vip-line-to-bottom}@r{)}
381 381
382For those of you who cannot remember which of @kbd{z} followed by @key{RET}, 382For those of you who cannot remember which of @kbd{z} followed by @key{RET},
383@kbd{.}@: and @kbd{-} do what. You can also use @kbd{z} followed by @kbd{H}, 383@kbd{.}@: and @kbd{-} do what. You can also use @kbd{z} followed by @kbd{H},
@@ -392,21 +392,21 @@ Some Vi commands which do not accept a count now accept one
392@table @kbd 392@table @kbd
393@item p 393@item p
394@itemx P 394@itemx P
395@kindex 160 @kbd{p} (@code{vip-put-back}) 395@kindex 160 p @r{(}@code{vip-put-back}@r{)}
396@kindex 120 @kbd{P} (@code{vip-Put-back}) 396@kindex 120 P @r{(}@code{vip-Put-back}@r{)}
397Given counts, text will be yanked (in Vi's sense) that many times. Thus 397Given counts, text will be yanked (in Vi's sense) that many times. Thus
398@kbd{3 p} is the same as @kbd{p p p}. 398@kbd{3 p} is the same as @kbd{p p p}.
399@item o 399@item o
400@itemx O 400@itemx O
401@kindex 157 @kbd{o} (@code{vip-open-line}) 401@kindex 157 o @r{(}@code{vip-open-line}@r{)}
402@kindex 117 @kbd{O} (@code{vip-Open-line}) 402@kindex 117 O @r{(}@code{vip-Open-line}@r{)}
403Given counts, that many copies of text will be inserted. Thus 403Given counts, that many copies of text will be inserted. Thus
404@kbd{o a b c @key{ESC}} will insert 3 lines of @samp{abc} below the current 404@kbd{o a b c @key{ESC}} will insert 3 lines of @samp{abc} below the current
405line. 405line.
406@item / 406@item /
407@itemx ? 407@itemx ?
408@kindex 057 @kbd{/} (@code{vip-search-forward}) 408@kindex 057 / @r{(}@code{vip-search-forward}@r{)}
409@kindex 077 @kbd{?} (@code{vip-search-backward}) 409@kindex 077 ? @r{(}@code{vip-search-backward}@r{)}
410Given a count @var{n}, @var{n}-th occurrence will be searched. 410Given a count @var{n}, @var{n}-th occurrence will be searched.
411@end table 411@end table
412 412
@@ -417,7 +417,7 @@ Typing an @kbd{m} followed by a lower-case character @var{ch} marks the
417point to the register named @var{ch} as in Vi. In addition to these, we 417point to the register named @var{ch} as in Vi. In addition to these, we
418have following key bindings for marking. 418have following key bindings for marking.
419 419
420@kindex 155 @kbd{m} (@code{vip-mark-point}) 420@kindex 155 m @r{(}@code{vip-mark-point}@r{)}
421 421
422@table @kbd 422@table @kbd
423@item m < 423@item m <
@@ -451,34 +451,34 @@ Note that the keys below (except for @kbd{R}) are not used in Vi.
451 451
452@table @kbd 452@table @kbd
453@item C-a 453@item C-a
454@kindex 001 @kbd{C-a} (@code{vip-beginning-of-line}) 454@kindex 001 C-a @r{(}@code{vip-beginning-of-line}@r{)}
455Move point to the beginning of line. 455Move point to the beginning of line.
456@item C-n 456@item C-n
457@kindex 016 @kbd{C-n} (@code{vip-next-window}) 457@kindex 016 C-n @r{(}@code{vip-next-window}@r{)}
458If you have two or more windows in the screen, this key will move point to 458If you have two or more windows in the screen, this key will move point to
459the next window. 459the next window.
460@item C-o 460@item C-o
461@kindex 017 @kbd{C-o} (@code{vip-open-line-at-point}) 461@kindex 017 C-o @r{(}@code{vip-open-line-at-point}@r{)}
462Insert a newline and leave point before it, and then enter insert mode. 462Insert a newline and leave point before it, and then enter insert mode.
463@item C-r 463@item C-r
464@kindex 022 @kbd{C-r} (@code{isearch-backward}) 464@kindex 022 C-r @r{(}@code{isearch-backward}@r{)}
465Backward incremental search. 465Backward incremental search.
466@item C-s 466@item C-s
467@kindex 023 @kbd{C-s} (@code{isearch-forward}) 467@kindex 023 C-s @r{(}@code{isearch-forward}@r{)}
468Forward incremental search. 468Forward incremental search.
469@item C-c 469@item C-c
470@itemx C-x 470@itemx C-x
471@itemx @key{ESC} 471@itemx @key{ESC}
472@kindex 003 @kbd{C-c} (@code{vip-ctl-c}) 472@kindex 003 C-c @r{(}@code{vip-ctl-c}@r{)}
473@kindex 0300 @kbd{C-x} (@code{vip-ctl-x}) 473@kindex 0300 C-x @r{(}@code{vip-ctl-x}@r{)}
474@kindex 033 @kbd{ESC} (@code{vip-ESC}) 474@kindex 033 ESC @r{(}@code{vip-ESC}@r{)}
475These keys will exit from vi mode and return to emacs mode temporarily. If 475These keys will exit from vi mode and return to emacs mode temporarily. If
476you hit one of these keys, Emacs will be in emacs mode and will believe 476you hit one of these keys, Emacs will be in emacs mode and will believe
477that you hit that key in emacs mode. For example, if you hit @kbd{C-x} 477that you hit that key in emacs mode. For example, if you hit @kbd{C-x}
478followed by @kbd{2}, then the current window will be split into 2 and you 478followed by @kbd{2}, then the current window will be split into 2 and you
479will be in vi mode again. 479will be in vi mode again.
480@item \ 480@item \
481@kindex 134 @kbd{\} (@code{vip-escape-to-emacs}) 481@kindex 134 \ @r{(}@code{vip-escape-to-emacs}@r{)}
482Escape to emacs mode. Hitting @kbd{\} will take you to emacs mode, and you 482Escape to emacs mode. Hitting @kbd{\} will take you to emacs mode, and you
483can execute a single Emacs command. After executing the Emacs command you 483can execute a single Emacs command. After executing the Emacs command you
484will be in vi mode again. You can give a count before typing @kbd{\}. 484will be in vi mode again. You can give a count before typing @kbd{\}.
@@ -486,13 +486,13 @@ Thus @kbd{5 \ *}, as well as @kbd{\ C-u 5 *}, will insert @samp{*****}
486before point. Similarly @kbd{1 0 \ C-p} will move the point 10 lines above 486before point. Similarly @kbd{1 0 \ C-p} will move the point 10 lines above
487the current line. 487the current line.
488@item K 488@item K
489@kindex 113 @kbd{K} (@code{vip-kill-buffer}) 489@kindex 113 K @r{(}@code{vip-kill-buffer}@r{)}
490Kill current buffer if it is not modified. Useful when you selected a 490Kill current buffer if it is not modified. Useful when you selected a
491buffer which you did not want. 491buffer which you did not want.
492@item Q 492@item Q
493@itemx R 493@itemx R
494@kindex 121 @kbd{Q} (@code{vip-query-replace}) 494@kindex 121 Q @r{(}@code{vip-query-replace}@r{)}
495@kindex 122 @kbd{R} (@code{vip-replace-string}) 495@kindex 122 R @r{(}@code{vip-replace-string}@r{)}
496@kbd{Q} is for query replace and @kbd{R} is for replace. By default, 496@kbd{Q} is for query replace and @kbd{R} is for replace. By default,
497string to be replaced are treated literally. If you wish to do a regular 497string to be replaced are treated literally. If you wish to do a regular
498expression replace, first do replace with empty string as the string to be 498expression replace, first do replace with empty string as the string to be
@@ -500,39 +500,39 @@ replaced. In this way, you can toggle between vanilla and regular
500expression replacement. 500expression replacement.
501@item v 501@item v
502@itemx V 502@itemx V
503@kindex 166 @kbd{v} (@code{vip-find-file}) 503@kindex 166 v @r{(}@code{vip-find-file}@r{)}
504@kindex 126 @kbd{V} (@code{vip-find-file-other-window}) 504@kindex 126 V @r{(}@code{vip-find-file-other-window}@r{)}
505These keys are used to Visit files. @kbd{v} will switch to a buffer 505These keys are used to Visit files. @kbd{v} will switch to a buffer
506visiting file whose name can be entered in the minibuffer. @kbd{V} is 506visiting file whose name can be entered in the minibuffer. @kbd{V} is
507similar, but will use window different from the current window. 507similar, but will use window different from the current window.
508@item # 508@item #
509@kindex 0430 @kbd{#} (@code{vip-command-argument}) 509@kindex 0430 # @r{(}@code{vip-command-argument}@r{)}
510If followed by a certain character @var{ch}, it becomes an operator whose 510If followed by a certain character @var{ch}, it becomes an operator whose
511argument is the region determined by the motion command that follows. 511argument is the region determined by the motion command that follows.
512Currently, @var{ch} can be one of @kbd{c}, @kbd{C}, @kbd{g}, @kbd{q} and 512Currently, @var{ch} can be one of @kbd{c}, @kbd{C}, @kbd{g}, @kbd{q} and
513@kbd{s}. 513@kbd{s}.
514@item # c 514@item # c
515@kindex 0432 @kbd{# c} (@code{downcase-region}) 515@kindex 0432 # c @r{(}@code{downcase-region}@r{)}
516Change upper-case characters in the region to lower case 516Change upper-case characters in the region to lower case
517(@code{downcase-region}). 517(@code{downcase-region}).
518@item # C 518@item # C
519@kindex 0431 @kbd{# C} (@code{upcase-region}) 519@kindex 0431 # C @r{(}@code{upcase-region}@r{)}
520Change lower-case characters in the region to upper case. For instance, 520Change lower-case characters in the region to upper case. For instance,
521@kbd{# C 3 w} will capitalize 3 words from the current point 521@kbd{# C 3 w} will capitalize 3 words from the current point
522(@code{upcase-region}). 522(@code{upcase-region}).
523@item # g 523@item # g
524@kindex 0432 @kbd{# g} (@code{vip-global-execute}) 524@kindex 0432 # g @r{(}@code{vip-global-execute}@r{)}
525Execute last keyboard macro for each line in the region 525Execute last keyboard macro for each line in the region
526(@code{vip-global-execute}). 526(@code{vip-global-execute}).
527@item # q 527@item # q
528@kindex 0432 @kbd{# q} (@code{vip-quote-region}) 528@kindex 0432 # q @r{(}@code{vip-quote-region}@r{)}
529Insert specified string at the beginning of each line in the region 529Insert specified string at the beginning of each line in the region
530(@code{vip-quote-region}). 530(@code{vip-quote-region}).
531@item # s 531@item # s
532@kindex 0432 @kbd{# s} (@code{spell-region}) 532@kindex 0432 # s @r{(}@code{spell-region}@r{)}
533Check spelling of words in the region (@code{spell-region}). 533Check spelling of words in the region (@code{spell-region}).
534@item * 534@item *
535@kindex 052 @kbd{*} (@code{vip-call-last-kbd-macro}) 535@kindex 052 * @r{(}@code{vip-call-last-kbd-macro}@r{)}
536Call last keyboard macro. 536Call last keyboard macro.
537@end table 537@end table
538 538
@@ -548,21 +548,21 @@ details.
548@table @kbd 548@table @kbd
549@item C-g 549@item C-g
550@itemx g 550@itemx g
551@kindex 007 @kbd{C-g} (@code{vip-keyboard-quit}) 551@kindex 007 C-g @r{(}@code{vip-keyboard-quit}@r{)}
552@kindex 147 @kbd{g} (@code{vip-info-on-file}) 552@kindex 147 g @r{(}@code{vip-info-on-file}@r{)}
553In Vi, @kbd{C-g} is used to get information about the file associated to 553In Vi, @kbd{C-g} is used to get information about the file associated to
554the current buffer. Here, @kbd{g} will do that, and @kbd{C-g} is 554the current buffer. Here, @kbd{g} will do that, and @kbd{C-g} is
555used to abort a command (this is for compatibility with emacs mode.) 555used to abort a command (this is for compatibility with emacs mode.)
556@item SPC 556@item @key{SPC}
557@itemx @key{RET} 557@itemx @key{RET}
558@kindex 040 @kbd{SPC} (@code{vip-scroll}) 558@kindex 040 SPC @r{(}@code{vip-scroll}@r{)}
559@kindex 015 @kbd{RET} (@code{vip-scroll-back}) 559@kindex 015 RET @r{(}@code{vip-scroll-back}@r{)}
560Now these keys will scroll up and down the text of current window. 560Now these keys will scroll up and down the text of current window.
561Convenient for viewing the text. 561Convenient for viewing the text.
562@item s 562@item s
563@itemx S 563@itemx S
564@kindex 163 @kbd{s} (@code{vip-switch-to-buffer}) 564@kindex 163 s @r{(}@code{vip-switch-to-buffer}@r{)}
565@kindex 123 @kbd{S} (@code{vip-switch-to-buffer-other-window}) 565@kindex 123 S @r{(}@code{vip-switch-to-buffer-other-window}@r{)}
566They are used to switch to a specified buffer. Useful for switching to 566They are used to switch to a specified buffer. Useful for switching to
567already existing buffer since buffer name completion is provided. Also 567already existing buffer since buffer name completion is provided. Also
568a default buffer will be given as part of the prompt, to which you can 568a default buffer will be given as part of the prompt, to which you can
@@ -570,8 +570,8 @@ switch by just typing @key{RET} key. @kbd{s} is used to select buffer
570in the current window, while @kbd{S} selects buffer in another window. 570in the current window, while @kbd{S} selects buffer in another window.
571@item C 571@item C
572@itemx X 572@itemx X
573@kindex 103 @kbd{C} (@code{vip-ctl-c-equivalent}) 573@kindex 103 C @r{(}@code{vip-ctl-c-equivalent}@r{)}
574@kindex 1300 @kbd{X} (@code{vip-ctl-x-equivalent}) 574@kindex 1300 X @r{(}@code{vip-ctl-x-equivalent}@r{)}
575These keys will exit from vi mode and return to emacs mode temporarily. 575These keys will exit from vi mode and return to emacs mode temporarily.
576If you type @kbd{C} (@kbd{X}), Emacs will be in emacs mode and will believe 576If you type @kbd{C} (@kbd{X}), Emacs will be in emacs mode and will believe
577that you have typed @kbd{C-c} (@kbd{C-x}) in emacs mode. Moreover, 577that you have typed @kbd{C-c} (@kbd{C-x}) in emacs mode. Moreover,
@@ -588,7 +588,7 @@ vi mode again.
588 588
589In addition to these, @code{ctl-x-map} is slightly modified: 589In addition to these, @code{ctl-x-map} is slightly modified:
590 590
591@kindex 1301 @kbd{X 3} (@code{vip-buffer-in-two-windows}) 591@kindex 1301 X 3 @r{(}@code{vip-buffer-in-two-windows}@r{)}
592 592
593@table @kbd 593@table @kbd
594@item X 3 594@item X 3
@@ -604,19 +604,19 @@ basic functions related to windows, buffers and files.
604 604
605@table @kbd 605@table @kbd
606@item C-n 606@item C-n
607@kindex 016 @kbd{C-n} (@code{vip-next-window}) 607@kindex 016 C-n @r{(}@code{vip-next-window}@r{)}
608Switch to next window. 608Switch to next window.
609@item X 1 609@item X 1
610@itemx C-x 1 610@itemx C-x 1
611@kindex 1301 @kbd{X 1} (@code{delete-other-windows}) 611@kindex 1301 X 1 @r{(}@code{delete-other-windows}@r{)}
612Delete other windows. 612Delete other windows.
613@item X 2 613@item X 2
614@itemx C-x 2 614@itemx C-x 2
615@kindex 1301 @kbd{X 2} (@code{split-window-vertically}) 615@kindex 1301 X 2 @r{(}@code{split-window-vertically}@r{)}
616Split current window into two windows. 616Split current window into two windows.
617@item X 3 617@item X 3
618@itemx C-x 3 618@itemx C-x 3
619@kindex 1301 @kbd{X 3} (@code{vip-buffer-in-two-windows}) 619@kindex 1301 X 3 @r{(}@code{vip-buffer-in-two-windows}@r{)}
620Show current buffer in two windows. 620Show current buffer in two windows.
621@end table 621@end table
622 622
@@ -625,19 +625,19 @@ Show current buffer in two windows.
625 625
626@table @kbd 626@table @kbd
627@item s 627@item s
628@kindex 163 @kbd{s} (@code{vip-switch-to-buffer}) 628@kindex 163 s @r{(}@code{vip-switch-to-buffer}@r{)}
629Switch to the specified buffer in the current window 629Switch to the specified buffer in the current window
630(@code{vip-switch-to-buffer}). 630(@code{vip-switch-to-buffer}).
631@item S 631@item S
632@kindex 123 @kbd{S} (@code{vip-switch-to-buffer-other-window}) 632@kindex 123 S @r{(}@code{vip-switch-to-buffer-other-window}@r{)}
633Switch to the specified buffer in another window 633Switch to the specified buffer in another window
634(@code{vip-switch-to-buffer-other-window}). 634(@code{vip-switch-to-buffer-other-window}).
635@item K 635@item K
636@kindex 113 @kbd{K} (@code{vip-kill-buffer}) 636@kindex 113 K @r{(}@code{vip-kill-buffer}@r{)}
637Kill the current buffer if it is not modified. 637Kill the current buffer if it is not modified.
638@item X S 638@item X S
639@itemx C-x C-s 639@itemx C-x C-s
640@kindex 1302 @kbd{X S} (@code{save-buffer}) 640@kindex 1302 X S @r{(}@code{save-buffer}@r{)}
641Save the current buffer in the file associated to the buffer. 641Save the current buffer in the file associated to the buffer.
642@end table 642@end table
643 643
@@ -646,18 +646,18 @@ Save the current buffer in the file associated to the buffer.
646 646
647@table @kbd 647@table @kbd
648@item v 648@item v
649@kindex 166 @kbd{v} (@code{vip-find-file}) 649@kindex 166 v @r{(}@code{vip-find-file}@r{)}
650Visit specified file in the current window. 650Visit specified file in the current window.
651@item V 651@item V
652@kindex 126 @kbd{V} (@code{vip-find-file-other-window}) 652@kindex 126 V @r{(}@code{vip-find-file-other-window}@r{)}
653Visit specified file in another window. 653Visit specified file in another window.
654@item X W 654@item X W
655@itemx C-x C-w 655@itemx C-x C-w
656@kindex 1302 @kbd{X W} (@code{write-file}) 656@kindex 1302 X W @r{(}@code{write-file}@r{)}
657Write current buffer into the specified file. 657Write current buffer into the specified file.
658@item X I 658@item X I
659@itemx C-x C-i 659@itemx C-x C-i
660@kindex 1302 @kbd{X I} (@code{insert-file}) 660@kindex 1302 X I @r{(}@code{insert-file}@r{)}
661 661
662Insert specified file at point. 662Insert specified file at point.
663@end table 663@end table
@@ -668,18 +668,18 @@ Insert specified file at point.
668@table @kbd 668@table @kbd
669@item X ( 669@item X (
670@itemx C-x ( 670@itemx C-x (
671@kindex 1301 @kbd{X (} (@code{start-kbd-macro}) 671@kindex 1301 X ( @r{(}@code{start-kbd-macro}@r{)}
672Start remembering keyboard macro. 672Start remembering keyboard macro.
673@item X ) 673@item X )
674@itemx C-x ) 674@itemx C-x )
675@kindex 1301 @kbd{X )} (@code{end-kbd-macro}) 675@kindex 1301 X ) @r{(}@code{end-kbd-macro}@r{)}
676Finish remembering keyboard macro. 676Finish remembering keyboard macro.
677@item * 677@item *
678@kindex 052 @kbd{*} (@code{vip-call-last-kbd-macro}) 678@kindex 052 * @r{(}@code{vip-call-last-kbd-macro}@r{)}
679Call last remembered keyboard macro. 679Call last remembered keyboard macro.
680@item X Z 680@item X Z
681@itemx C-x C-z 681@itemx C-x C-z
682@kindex 1302 @kbd{X Z} (@code{suspend-emacs}) 682@kindex 1302 X Z @r{(}@code{suspend-emacs}@r{)}
683Suspend Emacs. 683Suspend Emacs.
684@item Z Z 684@item Z Z
685Exit Emacs. 685Exit Emacs.
@@ -715,15 +715,15 @@ commands described in this chapter are to be used in vi mode.
715 715
716@cindex numeric arguments 716@cindex numeric arguments
717@cindex count 717@cindex count
718@kindex 061 @kbd{1} (numeric argument) 718@kindex 061 1 @r{(numeric argument)}
719@kindex 062 @kbd{2} (numeric argument) 719@kindex 062 2 @r{(numeric argument)}
720@kindex 063 @kbd{3} (numeric argument) 720@kindex 063 3 @r{(numeric argument)}
721@kindex 064 @kbd{4} (numeric argument) 721@kindex 064 4 @r{(numeric argument)}
722@kindex 065 @kbd{5} (numeric argument) 722@kindex 065 5 @r{(numeric argument)}
723@kindex 066 @kbd{6} (numeric argument) 723@kindex 066 6 @r{(numeric argument)}
724@kindex 067 @kbd{7} (numeric argument) 724@kindex 067 7 @r{(numeric argument)}
725@kindex 068 @kbd{8} (numeric argument) 725@kindex 068 8 @r{(numeric argument)}
726@kindex 069 @kbd{9} (numeric argument) 726@kindex 069 9 @r{(numeric argument)}
727 727
728Most Vi commands accept a @dfn{numeric argument} which can be supplied as 728Most Vi commands accept a @dfn{numeric argument} which can be supplied as
729a prefix to the commands. A numeric argument is also called a @dfn{count}. 729a prefix to the commands. A numeric argument is also called a @dfn{count}.
@@ -739,10 +739,10 @@ functions are the same in any of emacs, vi and insert mode.
739 739
740@table @kbd 740@table @kbd
741@item C-g 741@item C-g
742@kindex 007 @kbd{C-g} (@code{vip-keyboard-quit}) 742@kindex 007 C-g (@code{vip-keyboard-quit}@r{)}
743Quit. Cancel running or partially typed command (@code{keyboard-quit}). 743Quit. Cancel running or partially typed command (@code{keyboard-quit}).
744@item C-l 744@item C-l
745@kindex 014 @kbd{C-l} (@code{recenter}) 745@kindex 014 C-l @r{(}@code{recenter}@r{)}
746Clear the screen and reprint everything (@code{recenter}). 746Clear the screen and reprint everything (@code{recenter}).
747@end table 747@end table
748 748
@@ -754,9 +754,9 @@ accessed from vi mode as easily as from emacs mode.
754@item C-x 754@item C-x
755@itemx C-c 755@itemx C-c
756@itemx @key{ESC} 756@itemx @key{ESC}
757@kindex 003 @kbd{C-c} (@code{vip-ctl-c}) 757@kindex 003 C-c @r{(}@code{vip-ctl-c}@r{)}
758@kindex 0300 @kbd{C-x} (@code{vip-ctl-x}) 758@kindex 0300 C-x @r{(}@code{vip-ctl-x}@r{)}
759@kindex 033 @kbd{ESC} (@code{vip-ESC}) 759@kindex 033 ESC @r{(}@code{vip-ESC}@r{)}
760Typing one of these keys have the same effect as typing it in emacs mode. 760Typing one of these keys have the same effect as typing it in emacs mode.
761Appropriate command will be executed according as the keys you type after 761Appropriate command will be executed according as the keys you type after
762it. You will be in vi mode again after the execution of the command. 762it. You will be in vi mode again after the execution of the command.
@@ -764,8 +764,8 @@ For instance, if you type @kbd{@key{ESC} <} (in vi mode) then the cursor will
764move to the beginning of the buffer and you will still be in vi mode. 764move to the beginning of the buffer and you will still be in vi mode.
765@item C 765@item C
766@itemx X 766@itemx X
767@kindex 103 @kbd{C} (@code{vip-ctl-c-equivalent}) 767@kindex 103 C @r{(}@code{vip-ctl-c-equivalent}@r{)}
768@kindex 1300 @kbd{X} (@code{vip-ctl-x-equivalent}) 768@kindex 1300 X @r{(}@code{vip-ctl-x-equivalent}@r{)}
769Typing one of these keys have the effect of typing the corresponding 769Typing one of these keys have the effect of typing the corresponding
770control character in emacs mode. Moreover, if you type an upper-case 770control character in emacs mode. Moreover, if you type an upper-case
771character following it, that character will also be translated to the 771character following it, that character will also be translated to the
@@ -773,7 +773,7 @@ corresponding control character. Thus typing @kbd{X W} in vi mode is the
773same as typing @kbd{C-x C-w} in emacs mode. You will be in vi mode again 773same as typing @kbd{C-x C-w} in emacs mode. You will be in vi mode again
774after the execution of a command. 774after the execution of a command.
775@item \ 775@item \
776@kindex 134 @kbd{\} (@code{vip-escape-to-emacs}) 776@kindex 134 \ @r{(}@code{vip-escape-to-emacs}@r{)}
777Escape to emacs mode. Hitting the @kbd{\} key will take you to emacs mode, 777Escape to emacs mode. Hitting the @kbd{\} key will take you to emacs mode,
778and you can execute a single Emacs command. After executing the 778and you can execute a single Emacs command. After executing the
779Emacs command you will be in vi mode again. You can give a count before 779Emacs command you will be in vi mode again. You can give a count before
@@ -810,31 +810,31 @@ We have the following commands related to windows and buffers.
810 810
811@table @kbd 811@table @kbd
812@item C-n 812@item C-n
813@kindex 016 @kbd{C-n} (@code{vip-next-window}) 813@kindex 016 C-n @r{(}@code{vip-next-window}@r{)}
814Move cursor to the next-window (@code{vip-next-window}). 814Move cursor to the next-window (@code{vip-next-window}).
815@item X 1 815@item X 1
816@kindex 1301 @kbd{X 1} (@code{delete-other-windows}) 816@kindex 1301 X 1 @r{(}@code{delete-other-windows}@r{)}
817Delete other windows and make the selected window fill the screen 817Delete other windows and make the selected window fill the screen
818@*(@code{delete-other-windows}). 818@*(@code{delete-other-windows}).
819@item X 2 819@item X 2
820@kindex 1301 @kbd{X 2} (@code{split-window-vertically}) 820@kindex 1301 X 2 @r{(}@code{split-window-vertically}@r{)}
821Split current window into two windows (@code{split-window-vertically}). 821Split current window into two windows (@code{split-window-vertically}).
822@item X 3 822@item X 3
823@kindex 1301 @kbd{X 3} (@code{vip-buffer-in-two-windows}) 823@kindex 1301 X 3 @r{(}@code{vip-buffer-in-two-windows}@r{)}
824Show current buffer in two windows. 824Show current buffer in two windows.
825@item s @var{buffer} @key{RET} 825@item s @var{buffer} @key{RET}
826@kindex 163 @kbd{s} (@code{vip-switch-to-buffer}) 826@kindex 163 s @r{(}@code{vip-switch-to-buffer}@r{)}
827Select or create a buffer named @var{buffer} (@code{vip-switch-to-buffer}). 827Select or create a buffer named @var{buffer} (@code{vip-switch-to-buffer}).
828@item S @var{buffer} @key{RET} 828@item S @var{buffer} @key{RET}
829@kindex 123 @kbd{S} (@code{vip-switch-to-buffer-other-window}) 829@kindex 123 S @r{(}@code{vip-switch-to-buffer-other-window}@r{)}
830Similar but select a buffer named @var{buffer} in another window 830Similar but select a buffer named @var{buffer} in another window
831@*(@code{vip-switch-to-buffer-other-window}). 831@*(@code{vip-switch-to-buffer-other-window}).
832@item K 832@item K
833@kindex 113 @kbd{K} (@code{vip-kill-buffer}) 833@kindex 113 K @r{(}@code{vip-kill-buffer}@r{)}
834Kill the current buffer if it is not modified or if it is not associated 834Kill the current buffer if it is not modified or if it is not associated
835with a file @*(@code{vip-kill-buffer}). 835with a file @*(@code{vip-kill-buffer}).
836@item X B 836@item X B
837@kindex 1302 @kbd{X B} (@code{list-buffers}) 837@kindex 1302 X B @r{(}@code{list-buffers}@r{)}
838List the existing buffers (@code{list-buffers}). 838List the existing buffers (@code{list-buffers}).
839@end table 839@end table
840 840
@@ -856,24 +856,24 @@ save and insert files.
856 856
857@table @kbd 857@table @kbd
858@item v @var{file} @key{RET} 858@item v @var{file} @key{RET}
859@kindex 166 @kbd{v} (@code{vip-find-file}) 859@kindex 166 v @r{(}@code{vip-find-file}@r{)}
860Visit specified file in the current window (@code{vip-find-file}). 860Visit specified file in the current window (@code{vip-find-file}).
861@item V @var{file} @key{RET} 861@item V @var{file} @key{RET}
862@kindex 126 @kbd{V} (@code{vip-find-file-other-window}) 862@kindex 126 V @r{(}@code{vip-find-file-other-window}@r{)}
863Visit specified file in another window (@code{vip-find-file-other-window}). 863Visit specified file in another window (@code{vip-find-file-other-window}).
864@item X S 864@item X S
865@kindex 1302 @kbd{X S} (@code{save-buffer}) 865@kindex 1302 X S @r{(}@code{save-buffer}@r{)}
866Save current buffer to the file associated with the buffer. If no file is 866Save current buffer to the file associated with the buffer. If no file is
867associated with the buffer, the name of the file to write out the content 867associated with the buffer, the name of the file to write out the content
868of the buffer will be asked in the minibuffer. 868of the buffer will be asked in the minibuffer.
869@item X W @var{file} @key{RET} 869@item X W @var{file} @key{RET}
870@kindex 1302 @kbd{X W} (@code{write-file}) 870@kindex 1302 X W @r{(}@code{write-file}@r{)}
871Write current buffer into a specified file. 871Write current buffer into a specified file.
872@item X I @var{file} @key{RET} 872@item X I @var{file} @key{RET}
873@kindex 1302 @kbd{X I} (@code{insert-file}) 873@kindex 1302 X I @r{(}@code{insert-file}@r{)}
874Insert a specified file at point. 874Insert a specified file at point.
875@item g 875@item g
876@kindex 147 @kbd{g} (@code{vip-info-on-file}) 876@kindex 147 g @r{(}@code{vip-info-on-file}@r{)}
877Give information on the file associated with the current buffer. Tell you 877Give information on the file associated with the current buffer. Tell you
878the name of the file associated with the buffer, the line number of the 878the name of the file associated with the buffer, the line number of the
879current point and total line numbers in the buffer. If no file is 879current point and total line numbers in the buffer. If no file is
@@ -940,29 +940,29 @@ buffer.
940@table @kbd 940@table @kbd
941@item @key{SPC} 941@item @key{SPC}
942@itemx C-f 942@itemx C-f
943@kindex 040 @kbd{SPC} (@code{vip-scroll}) 943@kindex 040 SPC @r{(}@code{vip-scroll}@r{)}
944@kindex 006 @kbd{C-f} (@code{vip-scroll-back}) 944@kindex 006 C-f @r{(}@code{vip-scroll-back}@r{)}
945Scroll text of current window upward almost full screen. You can go 945Scroll text of current window upward almost full screen. You can go
946@i{forward} in the buffer by this command (@code{vip-scroll}). 946@i{forward} in the buffer by this command (@code{vip-scroll}).
947@item @key{RET} 947@item @key{RET}
948@itemx C-b 948@itemx C-b
949@kindex 015 @kbd{RET} (@code{vip-scroll-back}) 949@kindex 015 RET @r{(}@code{vip-scroll-back}@r{)}
950@kindex 002 @kbd{C-b} (@code{vip-scroll-back}) 950@kindex 002 C-b @r{(}@code{vip-scroll-back}@r{)}
951Scroll text of current window downward almost full screen. You can go 951Scroll text of current window downward almost full screen. You can go
952@i{backward} in the buffer by this command (@code{vip-scroll-back}). 952@i{backward} in the buffer by this command (@code{vip-scroll-back}).
953@item C-d 953@item C-d
954@kindex 004 @kbd{C-d} (@code{vip-scroll-up}) 954@kindex 004 C-d @r{(}@code{vip-scroll-up}@r{)}
955Scroll text of current window upward half screen. You can go 955Scroll text of current window upward half screen. You can go
956@i{down} in the buffer by this command (@code{vip-scroll-down}). 956@i{down} in the buffer by this command (@code{vip-scroll-down}).
957@item C-u 957@item C-u
958@kindex 025 @kbd{C-u} (@code{vip-scroll-down}) 958@kindex 025 C-u @r{(}@code{vip-scroll-down}@r{)}
959Scroll text of current window downward half screen. You can go 959Scroll text of current window downward half screen. You can go
960@i{up} in the buffer by this command (@code{vip-scroll-up}). 960@i{up} in the buffer by this command (@code{vip-scroll-up}).
961@item C-y 961@item C-y
962@kindex 031 @kbd{C-y} (@code{vip-scroll-down-one}) 962@kindex 031 C-y @r{(}@code{vip-scroll-down-one}@r{)}
963Scroll text of current window upward by one line (@code{vip-scroll-down-one}). 963Scroll text of current window upward by one line (@code{vip-scroll-down-one}).
964@item C-e 964@item C-e
965@kindex 005 @kbd{C-e} (@code{vip-scroll-up-one}) 965@kindex 005 C-e @r{(}@code{vip-scroll-up-one}@r{)}
966Scroll text of current window downward by one line (@code{vip-scroll-up-one}). 966Scroll text of current window downward by one line (@code{vip-scroll-up-one}).
967@end table 967@end table
968@noindent 968@noindent
@@ -974,22 +974,22 @@ The following commands reposition point in the window.
974@table @kbd 974@table @kbd
975@item z H 975@item z H
976@itemx z @key{RET} 976@itemx z @key{RET}
977@kindex 1723 @kbd{z H} (@code{vip-line-to-top}) 977@kindex 1723 z H @r{(}@code{vip-line-to-top}@r{)}
978@kindex 1721 @kbd{z RET} (@code{vip-line-to-top}) 978@kindex 1721 z RET @r{(}@code{vip-line-to-top}@r{)}
979Put point on the top (@i{home}) line in the window. So the current line 979Put point on the top (@i{home}) line in the window. So the current line
980becomes the top line in the window. Given a count @var{n}, point will be 980becomes the top line in the window. Given a count @var{n}, point will be
981placed in the @var{n}-th line from top (@code{vip-line-to-top}). 981placed in the @var{n}-th line from top (@code{vip-line-to-top}).
982@item z M 982@item z M
983@itemx z . 983@itemx z .
984@kindex 1723 @kbd{z M} (@code{vip-line-to-middle}) 984@kindex 1723 z M @r{(}@code{vip-line-to-middle}@r{)}
985@kindex 1722 @kbd{z .} (@code{vip-line-to-middle}) 985@kindex 1722 z . @r{(}@code{vip-line-to-middle}@r{)}
986Put point on the @i{middle} line in the window. Given a count @var{n}, 986Put point on the @i{middle} line in the window. Given a count @var{n},
987point will be placed in the @var{n}-th line from the middle line 987point will be placed in the @var{n}-th line from the middle line
988(@code{vip-line-to-middle}). 988(@code{vip-line-to-middle}).
989@item z L 989@item z L
990@itemx z - 990@itemx z -
991@kindex 1723 @kbd{z L} (@code{vip-line-to-bottom}) 991@kindex 1723 z L @r{(}@code{vip-line-to-bottom}@r{)}
992@kindex 1722 @kbd{z -} (@code{vip-line-to-bottom}) 992@kindex 1722 z - @r{(}@code{vip-line-to-bottom}@r{)}
993Put point on the @i{bottom} line in the window. Given a count @var{n}, 993Put point on the @i{bottom} line in the window. Given a count @var{n},
994point will be placed in the @var{n}-th line from bottom 994point will be placed in the @var{n}-th line from bottom
995(@code{vip-line-to-bottom}). 995(@code{vip-line-to-bottom}).
@@ -1004,7 +1004,7 @@ The following commands are used to mark positions in the buffer.
1004 1004
1005@table @kbd 1005@table @kbd
1006@item m @var{ch} 1006@item m @var{ch}
1007@kindex 155 @kbd{m} (@code{vip-mark-point}) 1007@kindex 155 m @r{(}@code{vip-mark-point}@r{)}
1008Store current point in the register @var{ch}. @var{ch} must be a 1008Store current point in the register @var{ch}. @var{ch} must be a
1009lower-case @acronym{ASCII} letter. 1009lower-case @acronym{ASCII} letter.
1010@item m < 1010@item m <
@@ -1034,31 +1034,31 @@ to be described in the next section.
1034 1034
1035@table @kbd 1035@table @kbd
1036@item h 1036@item h
1037@kindex 150 @kbd{h} (@code{vip-backward-char}) 1037@kindex 150 h @r{(}@code{vip-backward-char}@r{)}
1038Move point backward by one character. Signal error if point is at the 1038Move point backward by one character. Signal error if point is at the
1039beginning of buffer, but (unlike Vi) do not complain otherwise 1039beginning of buffer, but (unlike Vi) do not complain otherwise
1040(@code{vip-backward-char}). 1040(@code{vip-backward-char}).
1041@item l 1041@item l
1042@kindex 154 @kbd{l} (@code{vip-forward-char}) 1042@kindex 154 l @r{(}@code{vip-forward-char}@r{)}
1043Move point backward by one character. Signal error if point is at the 1043Move point backward by one character. Signal error if point is at the
1044end of buffer, but (unlike Vi) do not complain otherwise 1044end of buffer, but (unlike Vi) do not complain otherwise
1045(@code{vip-forward-char}). 1045(@code{vip-forward-char}).
1046@item j 1046@item j
1047@kindex 152 @kbd{j} (@code{vip-next-line}) 1047@kindex 152 j @r{(}@code{vip-next-line}@r{)}
1048Move point to the next line keeping the current column. If point is on the 1048Move point to the next line keeping the current column. If point is on the
1049last line of the buffer, a new line will be created and point will move to 1049last line of the buffer, a new line will be created and point will move to
1050that line (@code{vip-next-line}). 1050that line (@code{vip-next-line}).
1051@item k 1051@item k
1052@kindex 153 @kbd{k} (@code{vip-previous-line}) 1052@kindex 153 k @r{(}@code{vip-previous-line}@r{)}
1053Move point to the previous line keeping the current column 1053Move point to the previous line keeping the current column
1054(@code{vip-next-line}). 1054(@code{vip-next-line}).
1055@item + 1055@item +
1056@kindex 053 @kbd{+} (@code{vip-next-line-at-bol}) 1056@kindex 053 + @r{(}@code{vip-next-line-at-bol}@r{)}
1057Move point to the next line at the first non-white character. If point is 1057Move point to the next line at the first non-white character. If point is
1058on the last line of the buffer, a new line will be created and point will 1058on the last line of the buffer, a new line will be created and point will
1059move to the beginning of that line (@code{vip-next-line-at-bol}). 1059move to the beginning of that line (@code{vip-next-line-at-bol}).
1060@item - 1060@item -
1061@kindex 055 @kbd{-} (@code{vip-previous-line-at-bol}) 1061@kindex 055 - @r{(}@code{vip-previous-line-at-bol}@r{)}
1062Move point to the previous line at the first non-white character 1062Move point to the previous line at the first non-white character
1063(@code{vip-previous-line-at-bol}). 1063(@code{vip-previous-line-at-bol}).
1064@end table 1064@end table
@@ -1068,17 +1068,17 @@ many times.
1068 1068
1069@table @kbd 1069@table @kbd
1070@item 0 1070@item 0
1071@kindex 060 @kbd{0} (@code{vip-beginning-of-line}) 1071@kindex 060 0 @r{(}@code{vip-beginning-of-line}@r{)}
1072Move point to the beginning of line (@code{vip-beginning-of-line}). 1072Move point to the beginning of line (@code{vip-beginning-of-line}).
1073@item ^ 1073@item ^
1074@kindex 136 @kbd{^} (@code{vip-bol-and-skip-white}) 1074@kindex 136 ^ @r{(}@code{vip-bol-and-skip-white}@r{)}
1075Move point to the first non-white character on the line 1075Move point to the first non-white character on the line
1076(@code{vip-bol-and-skip-white}). 1076(@code{vip-bol-and-skip-white}).
1077@item $ 1077@item $
1078@kindex 044 @kbd{$} (@code{vip-goto-eol}) 1078@kindex 044 $ @r{(}@code{vip-goto-eol}@r{)}
1079Move point to the end of line (@code{vip-goto-eol}). 1079Move point to the end of line (@code{vip-goto-eol}).
1080@item @var{n} | 1080@item @var{n} |
1081@kindex 174 @kbd{|} (@code{vip-goto-col}) 1081@kindex 174 | @r{(}@code{vip-goto-col}@r{)}
1082Move point to the @var{n}-th column on the line (@code{vip-goto-col}). 1082Move point to the @var{n}-th column on the line (@code{vip-goto-col}).
1083@end table 1083@end table
1084@noindent 1084@noindent
@@ -1088,25 +1088,25 @@ Except for the @kbd{|} command, these commands neglect a count.
1088 1088
1089@table @kbd 1089@table @kbd
1090@item w 1090@item w
1091@kindex 167 @kbd{w} (@code{vip-forward-word}) 1091@kindex 167 w @r{(}@code{vip-forward-word}@r{)}
1092Move point forward to the beginning of the next word 1092Move point forward to the beginning of the next word
1093(@code{vip-forward-word}). 1093(@code{vip-forward-word}).
1094@item W 1094@item W
1095@kindex 127 @kbd{W} (@code{vip-forward-Word}) 1095@kindex 127 W @r{(}@code{vip-forward-Word}@r{)}
1096Move point forward to the beginning of the next word, where a @dfn{word} is 1096Move point forward to the beginning of the next word, where a @dfn{word} is
1097considered as a sequence of non-white characters (@code{vip-forward-Word}). 1097considered as a sequence of non-white characters (@code{vip-forward-Word}).
1098@item b 1098@item b
1099@kindex 142 @kbd{b} (@code{vip-backward-word}) 1099@kindex 142 b @r{(}@code{vip-backward-word}@r{)}
1100Move point backward to the beginning of a word (@code{vip-backward-word}). 1100Move point backward to the beginning of a word (@code{vip-backward-word}).
1101@item B 1101@item B
1102@kindex 102 @kbd{B} (@code{vip-backward-Word}) 1102@kindex 102 B @r{(}@code{vip-backward-Word}@r{)}
1103Move point backward to the beginning of a word, where a @i{word} is 1103Move point backward to the beginning of a word, where a @i{word} is
1104considered as a sequence of non-white characters (@code{vip-forward-Word}). 1104considered as a sequence of non-white characters (@code{vip-forward-Word}).
1105@item e 1105@item e
1106@kindex 145 @kbd{e} (@code{vip-end-of-word}) 1106@kindex 145 e @r{(}@code{vip-end-of-word}@r{)}
1107Move point forward to the end of a word (@code{vip-end-of-word}). 1107Move point forward to the end of a word (@code{vip-end-of-word}).
1108@item E 1108@item E
1109@kindex 105 @kbd{E} (@code{vip-end-of-Word}) 1109@kindex 105 E @r{(}@code{vip-end-of-Word}@r{)}
1110Move point forward to the end of a word, where a @i{word} is 1110Move point forward to the end of a word, where a @i{word} is
1111considered as a sequence of non-white characters (@code{vip-end-of-Word}). 1111considered as a sequence of non-white characters (@code{vip-end-of-Word}).
1112@end table 1112@end table
@@ -1120,17 +1120,17 @@ details of syntax table.
1120 1120
1121@table @kbd 1121@table @kbd
1122@item H 1122@item H
1123@kindex 110 @kbd{H} (@code{vip-window-top}) 1123@kindex 110 H @r{(}@code{vip-window-top}@r{)}
1124Move point to the beginning of the @i{home} (top) line of the window. 1124Move point to the beginning of the @i{home} (top) line of the window.
1125Given a count @var{n}, go to the @var{n}-th line from top 1125Given a count @var{n}, go to the @var{n}-th line from top
1126(@code{vip-window-top}). 1126(@code{vip-window-top}).
1127@item M 1127@item M
1128@kindex 115 @kbd{M} (@code{vip-window-middle}) 1128@kindex 115 M @r{(}@code{vip-window-middle}@r{)}
1129Move point to the beginning of the @i{middle} line of the window. Given 1129Move point to the beginning of the @i{middle} line of the window. Given
1130a count @var{n}, go to the @var{n}-th line from the middle line 1130a count @var{n}, go to the @var{n}-th line from the middle line
1131(@code{vip-window-middle}). 1131(@code{vip-window-middle}).
1132@item L 1132@item L
1133@kindex 114 @kbd{L} (@code{vip-window-bottom}) 1133@kindex 114 L @r{(}@code{vip-window-bottom}@r{)}
1134Move point to the beginning of the @i{lowest} (bottom) line of the 1134Move point to the beginning of the @i{lowest} (bottom) line of the
1135window. Given count, go to the @var{n}-th line from bottom 1135window. Given count, go to the @var{n}-th line from bottom
1136(@code{vip-window-bottom}). 1136(@code{vip-window-bottom}).
@@ -1140,19 +1140,19 @@ These commands can be used to go to the desired line visible on the screen.
1140 1140
1141@table @kbd 1141@table @kbd
1142@item ( 1142@item (
1143@kindex 050 @kbd{(} (@code{vip-backward-sentence}) 1143@kindex 050 ( @r{(}@code{vip-backward-sentence}@r{)}
1144Move point backward to the beginning of the sentence 1144Move point backward to the beginning of the sentence
1145(@code{vip-backward-sentence}). 1145(@code{vip-backward-sentence}).
1146@item ) 1146@item )
1147@kindex 051 @kbd{)} (@code{vip-forward-sentence}) 1147@kindex 051 ) @r{(}@code{vip-forward-sentence}@r{)}
1148Move point forward to the end of the sentence 1148Move point forward to the end of the sentence
1149(@code{vip-forward-sentence}). 1149(@code{vip-forward-sentence}).
1150@item @{ 1150@item @{
1151@kindex 173 @kbd{@{} (@code{vip-backward-paragraph}) 1151@kindex 173 @{ @r{(}@code{vip-backward-paragraph}@r{)}
1152Move point backward to the beginning of the paragraph 1152Move point backward to the beginning of the paragraph
1153(@code{vip-backward-paragraph}). 1153(@code{vip-backward-paragraph}).
1154@item @} 1154@item @}
1155@kindex 175 @kbd{@}} (@code{vip-forward-paragraph}) 1155@kindex 175 @} @r{(}@code{vip-forward-paragraph}@r{)}
1156Move point forward to the end of the paragraph 1156Move point forward to the end of the paragraph
1157(@code{vip-forward-paragraph}). 1157(@code{vip-forward-paragraph}).
1158@end table 1158@end table
@@ -1161,25 +1161,25 @@ A count repeats the effect for these commands.
1161 1161
1162@table @kbd 1162@table @kbd
1163@item G 1163@item G
1164@kindex 107 @kbd{G} (@code{vip-goto-line}) 1164@kindex 107 G @r{(}@code{vip-goto-line}@r{)}
1165Given a count @var{n}, move point to the @var{n}-th line in the buffer on 1165Given a count @var{n}, move point to the @var{n}-th line in the buffer on
1166the first non-white character. Without a count, go to the end of the buffer 1166the first non-white character. Without a count, go to the end of the buffer
1167(@code{vip-goto-line}). 1167(@code{vip-goto-line}).
1168@item ` ` 1168@item ` `
1169@kindex 140 @kbd{`} (@code{vip-goto-mark}) 1169@kindex 140 ` @r{(}@code{vip-goto-mark}@r{)}
1170Exchange point and mark (@code{vip-goto-mark}). 1170Exchange point and mark (@code{vip-goto-mark}).
1171@item ` @var{ch} 1171@item ` @var{ch}
1172Move point to the position stored in the register @var{ch}. @var{ch} must 1172Move point to the position stored in the register @var{ch}. @var{ch} must
1173be a lower-case letter. 1173be a lower-case letter.
1174@item ' ' 1174@item ' '
1175@kindex 047 @kbd{'} (@code{vip-goto-mark-and-skip-white}) 1175@kindex 047 ' @r{(}@code{vip-goto-mark-and-skip-white}@r{)}
1176Exchange point and mark, and then move point to the first non-white 1176Exchange point and mark, and then move point to the first non-white
1177character on the line (@code{vip-goto-mark-and-skip-white}). 1177character on the line (@code{vip-goto-mark-and-skip-white}).
1178@item ' @var{ch} 1178@item ' @var{ch}
1179Move point to the position stored in the register @var{ch} and skip to the 1179Move point to the position stored in the register @var{ch} and skip to the
1180first non-white character on the line. @var{ch} must be a lower-case letter. 1180first non-white character on the line. @var{ch} must be a lower-case letter.
1181@item % 1181@item %
1182@kindex 045 @kbd{%} (@code{vip-paren-match}) 1182@kindex 045 % @r{(}@code{vip-paren-match}@r{)}
1183Move point to the matching parenthesis if point is looking at @kbd{(}, 1183Move point to the matching parenthesis if point is looking at @kbd{(},
1184@kbd{)}, @kbd{@{}, @kbd{@}}, @kbd{[} or @kbd{]} 1184@kbd{)}, @kbd{@{}, @kbd{@}}, @kbd{[} or @kbd{]}
1185@*(@code{vip-paren-match}). 1185@*(@code{vip-paren-match}).
@@ -1194,27 +1194,27 @@ will repeat the effect.
1194 1194
1195@table @kbd 1195@table @kbd
1196@item f @var{ch} 1196@item f @var{ch}
1197@kindex 146 @kbd{f} (@code{vip-find-char-forward}) 1197@kindex 146 f @r{(}@code{vip-find-char-forward}@r{)}
1198Move point forward to the character @var{ch} on the line. Signal error if 1198Move point forward to the character @var{ch} on the line. Signal error if
1199@var{ch} could not be found (@code{vip-find-char-forward}). 1199@var{ch} could not be found (@code{vip-find-char-forward}).
1200@item F @var{ch} 1200@item F @var{ch}
1201@kindex 106 @kbd{F} (@code{vip-find-char-backward}) 1201@kindex 106 F @r{(}@code{vip-find-char-backward}@r{)}
1202Move point backward to the character @var{ch} on the line. Signal error if 1202Move point backward to the character @var{ch} on the line. Signal error if
1203@var{ch} could not be found (@code{vip-find-char-backward}). 1203@var{ch} could not be found (@code{vip-find-char-backward}).
1204@item t @var{ch} 1204@item t @var{ch}
1205@kindex 164 @kbd{t} (@code{vip-goto-char-forward}) 1205@kindex 164 t @r{(}@code{vip-goto-char-forward}@r{)}
1206Move point forward upto the character @var{ch} on the line. Signal error if 1206Move point forward upto the character @var{ch} on the line. Signal error if
1207@var{ch} could not be found (@code{vip-goto-char-forward}). 1207@var{ch} could not be found (@code{vip-goto-char-forward}).
1208@item T @var{ch} 1208@item T @var{ch}
1209@kindex 124 @kbd{T} (@code{vip-goto-char-backward}) 1209@kindex 124 T @r{(}@code{vip-goto-char-backward}@r{)}
1210Move point backward upto the character @var{ch} on the line. Signal error if 1210Move point backward upto the character @var{ch} on the line. Signal error if
1211@var{ch} could not be found (@code{vip-goto-char-backward}). 1211@var{ch} could not be found (@code{vip-goto-char-backward}).
1212@item ; 1212@item ;
1213@kindex 073 @kbd{;} (@code{vip-repeat-find}) 1213@kindex 073 ; @r{(}@code{vip-repeat-find}@r{)}
1214Repeat previous @kbd{f}, @kbd{t}, @kbd{F} or @kbd{T} command 1214Repeat previous @kbd{f}, @kbd{t}, @kbd{F} or @kbd{T} command
1215(@code{vip-repeat-find}). 1215(@code{vip-repeat-find}).
1216@item , 1216@item ,
1217@kindex 054 @kbd{,} (@code{vip-repeat-find-opposite}) 1217@kindex 054 , @r{(}@code{vip-repeat-find-opposite}@r{)}
1218Repeat previous @kbd{f}, @kbd{t}, @kbd{F} or @kbd{T} command, in the 1218Repeat previous @kbd{f}, @kbd{t}, @kbd{F} or @kbd{T} command, in the
1219opposite direction (@code{vip-repeat-find-opposite}). 1219opposite direction (@code{vip-repeat-find-opposite}).
1220@end table 1220@end table
@@ -1228,7 +1228,7 @@ Following commands are available for searching and replacing.
1228 1228
1229@table @kbd 1229@table @kbd
1230@item / @var{string} @key{RET} 1230@item / @var{string} @key{RET}
1231@kindex 057 @kbd{/} (@code{vip-search-forward}) 1231@kindex 057 / @r{(}@code{vip-search-forward}@r{)}
1232Search the first occurrence of the string @var{string} forward starting 1232Search the first occurrence of the string @var{string} forward starting
1233from point. Given a count @var{n}, the @var{n}-th occurrence of 1233from point. Given a count @var{n}, the @var{n}-th occurrence of
1234@var{string} will be searched. If the variable @code{vip-re-search} has value 1234@var{string} will be searched. If the variable @code{vip-re-search} has value
@@ -1238,28 +1238,28 @@ empty string as @var{string} then the search mode will change from vanilla
1238search to regular expression search and vice versa 1238search to regular expression search and vice versa
1239(@code{vip-search-forward}). 1239(@code{vip-search-forward}).
1240@item ? @var{string} @key{RET} 1240@item ? @var{string} @key{RET}
1241@kindex 077 @kbd{?} (@code{vip-search-backward}) 1241@kindex 077 ? @r{(}@code{vip-search-backward}@r{)}
1242Same as @kbd{/}, except that search is done backward 1242Same as @kbd{/}, except that search is done backward
1243(@code{vip-search-backward}). 1243(@code{vip-search-backward}).
1244@item n 1244@item n
1245@kindex 156 @kbd{n} (@code{vip-search-next}) 1245@kindex 156 n @r{(}@code{vip-search-next}@r{)}
1246Search the previous search pattern in the same direction as before 1246Search the previous search pattern in the same direction as before
1247(@code{vip-search-next}). 1247(@code{vip-search-next}).
1248@item N 1248@item N
1249@kindex 116 @kbd{N} (@code{vip-search-Next}) 1249@kindex 116 N @r{(}@code{vip-search-Next}@r{)}
1250Search the previous search pattern in the opposite direction 1250Search the previous search pattern in the opposite direction
1251(@code{vip-search-Next}). 1251(@code{vip-search-Next}).
1252@item C-s 1252@item C-s
1253@kindex 023 @kbd{C-s} (@code{isearch-forward}) 1253@kindex 023 C-s @r{(}@code{isearch-forward}@r{)}
1254Search forward incrementally. See GNU Emacs Manual for details 1254Search forward incrementally. See GNU Emacs Manual for details
1255(@code{isearch-forward}). 1255(@code{isearch-forward}).
1256@item C-r 1256@item C-r
1257@kindex 022 @kbd{C-r} (@code{isearch-backward}) 1257@kindex 022 C-r @r{(}@code{isearch-backward}@r{)}
1258Search backward incrementally (@code{isearch-backward}). 1258Search backward incrementally (@code{isearch-backward}).
1259@cindex vanilla (replacement) 1259@cindex vanilla (replacement)
1260@cindex regular expression (replacement) 1260@cindex regular expression (replacement)
1261@item R @var{string} RET @var{newstring} 1261@item R @var{string} @key{RET} @var{newstring}
1262@kindex 122 @kbd{R} (@code{vip-replace-string}) 1262@kindex 122 R @r{(}@code{vip-replace-string}@r{)}
1263There are two modes of replacement, @dfn{vanilla} and @dfn{regular expression}. 1263There are two modes of replacement, @dfn{vanilla} and @dfn{regular expression}.
1264If the mode is @i{vanilla} you will get a prompt @samp{Replace string:}, 1264If the mode is @i{vanilla} you will get a prompt @samp{Replace string:},
1265and if the mode is @i{regular expression} you will ge a prompt 1265and if the mode is @i{regular expression} you will ge a prompt
@@ -1269,13 +1269,13 @@ vanilla, this command replaces every occurrence of @var{string} with
1269@var{newstring}. If the mode is regular expression, @var{string} is 1269@var{newstring}. If the mode is regular expression, @var{string} is
1270treated as a regular expression and every string matching the regular 1270treated as a regular expression and every string matching the regular
1271expression is replaced with @var{newstring} (@code{vip-replace-string}). 1271expression is replaced with @var{newstring} (@code{vip-replace-string}).
1272@item Q @var{string} RET @var{newstring} 1272@item Q @var{string} @key{RET} @var{newstring}
1273@kindex 121 @kbd{Q} (@code{vip-query-replace}) 1273@kindex 121 Q @r{(}@code{vip-query-replace}@r{)}
1274Same as @kbd{R} except that you will be asked form confirmation before each 1274Same as @kbd{R} except that you will be asked form confirmation before each
1275replacement 1275replacement
1276@*(@code{vip-query-replace}). 1276@*(@code{vip-query-replace}).
1277@item r @var{ch} 1277@item r @var{ch}
1278@kindex 162 @kbd{r} (@code{vip-replace-char}) 1278@kindex 162 r @r{(}@code{vip-replace-char}@r{)}
1279Replace the character point is looking at by the character @var{ch}. Give 1279Replace the character point is looking at by the character @var{ch}. Give
1280count, replace that many characters by @var{ch} (@code{vip-replace-char}). 1280count, replace that many characters by @var{ch} (@code{vip-replace-char}).
1281@end table 1281@end table
@@ -1326,7 +1326,7 @@ command.
1326 1326
1327@table @kbd 1327@table @kbd
1328@item d @var{motion-command} 1328@item d @var{motion-command}
1329@kindex 1440 @kbd{d} (@code{vip-command-argument}) 1329@kindex 1440 d @r{(}@code{vip-command-argument}@r{)}
1330Delete the region determined by the motion command @var{motion-command}. 1330Delete the region determined by the motion command @var{motion-command}.
1331@end table 1331@end table
1332@noindent 1332@noindent
@@ -1337,7 +1337,7 @@ end of the buffer, since @kbd{G} is a line command. A count given to the
1337command above will become the count for the associated motion command. 1337command above will become the count for the associated motion command.
1338Thus, @kbd{3 d w} will delete three words. 1338Thus, @kbd{3 d w} will delete three words.
1339 1339
1340@kindex 042 @kbd{"} (@code{vip-command-argument}) 1340@kindex 042 " @r{(}@code{vip-command-argument}@r{)}
1341It is also possible to save the deleted text into a register you specify. 1341It is also possible to save the deleted text into a register you specify.
1342For example, you can say @kbd{" t 3 d w} to delete three words and save it 1342For example, you can say @kbd{" t 3 d w} to delete three words and save it
1343to register @kbd{t}. The name of a register is a lower-case letter between 1343to register @kbd{t}. The name of a register is a lower-case letter between
@@ -1352,23 +1352,23 @@ We have more delete commands as below.
1352 1352
1353@table @kbd 1353@table @kbd
1354@item d d 1354@item d d
1355@kindex 1442 @kbd{d d} 1355@kindex 1442 d d
1356Delete a line. Given a count @var{n}, delete @var{n} lines. 1356Delete a line. Given a count @var{n}, delete @var{n} lines.
1357@item d r 1357@item d r
1358@kindex 1442 @kbd{d r} 1358@kindex 1442 d r
1359Delete current region. 1359Delete current region.
1360@item d R 1360@item d R
1361@kindex 1441 @kbd{d R} 1361@kindex 1441 d R
1362Expand current region and delete it. 1362Expand current region and delete it.
1363@item D 1363@item D
1364@kindex 104 @kbd{D} (@code{vip-kill-line}) 1364@kindex 104 D @r{(}@code{vip-kill-line}@r{)}
1365Delete to the end of a line (@code{vip-kill-line}). 1365Delete to the end of a line (@code{vip-kill-line}).
1366@item x 1366@item x
1367@kindex 170 @kbd{x} (@code{vip-delete-char}) 1367@kindex 170 x @r{(}@code{vip-delete-char}@r{)}
1368Delete a character after point. Given @var{n}, delete @var{n} characters 1368Delete a character after point. Given @var{n}, delete @var{n} characters
1369(@code{vip-delete-char}). 1369(@code{vip-delete-char}).
1370@item @key{DEL} 1370@item @key{DEL}
1371@kindex 177 @kbd{DEL} (@code{vip-delete-backward-char}) 1371@kindex 177 DEL @r{(}@code{vip-delete-backward-char}@r{)}
1372Delete a character before point. Given @var{n}, delete @var{n} characters 1372Delete a character before point. Given @var{n}, delete @var{n} characters
1373(@code{vip-delete-backward-char}). 1373(@code{vip-delete-backward-char}).
1374@end table 1374@end table
@@ -1385,7 +1385,7 @@ commands that put back the yanked text into the buffer.
1385 1385
1386@table @kbd 1386@table @kbd
1387@item y @var{motion-command} 1387@item y @var{motion-command}
1388@kindex 1710 @kbd{y} (@code{vip-command-argument}) 1388@kindex 1710 y @r{(}@code{vip-command-argument}@r{)}
1389Yank the region determined by the motion command @var{motion-command}. 1389Yank the region determined by the motion command @var{motion-command}.
1390@end table 1390@end table
1391@noindent 1391@noindent
@@ -1398,14 +1398,14 @@ Use the following command to yank consecutive lines of text.
1398@table @kbd 1398@table @kbd
1399@item y y 1399@item y y
1400@itemx Y 1400@itemx Y
1401@kindex 131 @kbd{Y} (@code{vip-yank-line}) 1401@kindex 131 Y @r{(}@code{vip-yank-line}@r{)}
1402@kindex 1712 @kbd{y y} (@code{vip-yank-line}) 1402@kindex 1712 y y @r{(}@code{vip-yank-line}@r{)}
1403Yank a line. Given @var{n}, yank @var{n} lines (@code{vip-yank-line}). 1403Yank a line. Given @var{n}, yank @var{n} lines (@code{vip-yank-line}).
1404@item y r 1404@item y r
1405@kindex 1712 @kbd{y r} 1405@kindex 1712 y r
1406Yank current region. 1406Yank current region.
1407@item y R 1407@item y R
1408@kindex 1711 @kbd{y R} 1408@kindex 1711 y R
1409Expand current region and yank it. 1409Expand current region and yank it.
1410@end table 1410@end table
1411 1411
@@ -1416,7 +1416,7 @@ below.
1416 1416
1417@table @kbd 1417@table @kbd
1418@item p 1418@item p
1419@kindex 160 @kbd{p} (@code{vip-put-back}) 1419@kindex 160 p @r{(}@code{vip-put-back}@r{)}
1420Insert, after the character point is looking at, most recently 1420Insert, after the character point is looking at, most recently
1421deleted/yanked text from anonymous register. Given a register name 1421deleted/yanked text from anonymous register. Given a register name
1422argument, the content of the named register will be put back. Given a 1422argument, the content of the named register will be put back. Given a
@@ -1424,7 +1424,7 @@ count, the command will be repeated that many times. This command also
1424checks if the text to put back ends with a new line character, and if so 1424checks if the text to put back ends with a new line character, and if so
1425the text will be put below the current line (@code{vip-put-back}). 1425the text will be put below the current line (@code{vip-put-back}).
1426@item P 1426@item P
1427@kindex 120 @kbd{P} (@code{vip-Put-back}) 1427@kindex 120 P @r{(}@code{vip-Put-back}@r{)}
1428Insert at point most recently deleted/yanked text from anonymous register. 1428Insert at point most recently deleted/yanked text from anonymous register.
1429Given a register name argument, the content of the named register will 1429Given a register name argument, the content of the named register will
1430be put back. Given a count, the command will be repeated that many times. 1430be put back. Given a count, the command will be repeated that many times.
@@ -1447,7 +1447,7 @@ Most commonly used change command takes the following form.
1447 1447
1448@table @kbd 1448@table @kbd
1449@item c @var{motion-command} 1449@item c @var{motion-command}
1450@kindex 1430 @kbd{c} (@code{vip-command-argument}) 1450@kindex 1430 c @r{(}@code{vip-command-argument}@r{)}
1451Replace the content of the region determined by the motion command 1451Replace the content of the region determined by the motion command
1452@var{motion-command} by the text you type. If the motion command is a 1452@var{motion-command} by the text you type. If the motion command is a
1453point command then you will type the text into minibuffer, and if the 1453point command then you will type the text into minibuffer, and if the
@@ -1463,13 +1463,13 @@ command.
1463 1463
1464@table @kbd 1464@table @kbd
1465@item c c 1465@item c c
1466@kindex 1432 @kbd{c c} 1466@kindex 1432 c c
1467Change a line. Given a count, that many lines are changed. 1467Change a line. Given a count, that many lines are changed.
1468@item c r 1468@item c r
1469@kindex 1432 @kbd{c r} 1469@kindex 1432 c r
1470Change current region. 1470Change current region.
1471@item c R 1471@item c R
1472@kindex 1431 @kbd{c R} 1472@kindex 1431 c R
1473Expand current region and change it. 1473Expand current region and change it.
1474@end table 1474@end table
1475 1475
@@ -1481,13 +1481,13 @@ it. It is also very easy to undo changes made by modifying commands.
1481 1481
1482@table @kbd 1482@table @kbd
1483@item u 1483@item u
1484@kindex 165 @kbd{u} (@code{vip-undo}) 1484@kindex 165 u @r{(}@code{vip-undo}@r{)}
1485Undo the last change. You can undo more by repeating undo by the repeat 1485Undo the last change. You can undo more by repeating undo by the repeat
1486command @samp{.}. For example, you can undo 5 previous changes by typing 1486command @samp{.}. For example, you can undo 5 previous changes by typing
1487@samp{u....}. If you type @samp{uu}, then the second @samp{u} undoes the 1487@samp{u....}. If you type @samp{uu}, then the second @samp{u} undoes the
1488first undo command (@code{vip-undo}). 1488first undo command (@code{vip-undo}).
1489@item . 1489@item .
1490@kindex 056 @kbd{.} (@code{vip-repeat}) 1490@kindex 056 . @r{(}@code{vip-repeat}@r{)}
1491Repeat the last modifying command. Given count @var{n} it becomes the new 1491Repeat the last modifying command. Given count @var{n} it becomes the new
1492count for the repeated command. Otherwise, the count for the last 1492count for the repeated command. Otherwise, the count for the last
1493modifying command is used again (@code{vip-repeat}). 1493modifying command is used again (@code{vip-repeat}).
@@ -1500,12 +1500,12 @@ Miscellaneous Vi commands are collected here.
1500 1500
1501@table @kbd 1501@table @kbd
1502@item Z Z 1502@item Z Z
1503@kindex 132 @kbd{Z Z} (@code{save-buffers-kill-emacs}) 1503@kindex 132 Z Z @r{(}@code{save-buffers-kill-emacs}@r{)}
1504Exit Emacs. If modified buffers exist, you will be asked whether you wish 1504Exit Emacs. If modified buffers exist, you will be asked whether you wish
1505to save them or not (@code{save-buffers-kill-emacs}). 1505to save them or not (@code{save-buffers-kill-emacs}).
1506@item !@: @var{motion-command} @var{format-command} 1506@item !@: @var{motion-command} @var{format-command}
1507@itemx @var{n} !@: !@: @var{format-command} 1507@itemx @var{n} !@: !@: @var{format-command}
1508@kindex 041 @kbd{!} (@code{vip-command-argument}) 1508@kindex 041 ! @r{(}@code{vip-command-argument}@r{)}
1509The region determined by the motion command @var{motion-command} will be 1509The region determined by the motion command @var{motion-command} will be
1510given to the shell command @var{format-command} and the region will be 1510given to the shell command @var{format-command} and the region will be
1511replaced by its output. If a count is given, it will be passed to 1511replaced by its output. If a count is given, it will be passed to
@@ -1514,30 +1514,30 @@ between point and the 3rd line. If @kbd{!} is used instead of
1514@var{motion-command} then @var{n} lines will be processed by 1514@var{motion-command} then @var{n} lines will be processed by
1515@var{format-command} (@code{vip-command-argument}). 1515@var{format-command} (@code{vip-command-argument}).
1516@item J 1516@item J
1517@kindex 112 @kbd{J} (@code{vip-join-lines}) 1517@kindex 112 J @r{(}@code{vip-join-lines}@r{)}
1518Join two lines. Given count, join that many lines. A space will be 1518Join two lines. Given count, join that many lines. A space will be
1519inserted at each junction (@code{vip-join-lines}). 1519inserted at each junction (@code{vip-join-lines}).
1520@item < @var{motion-command} 1520@item < @var{motion-command}
1521@itemx @var{n} < < 1521@itemx @var{n} < <
1522@kindex 074 @kbd{<} (@code{vip-command-argument}) 1522@kindex 074 < @r{(}@code{vip-command-argument}@r{)}
1523Shift region determined by the motion command @var{motion-command} to 1523Shift region determined by the motion command @var{motion-command} to
1524left by @var{shift-width} (default is 8). If @kbd{<} is used instead of 1524left by @var{shift-width} (default is 8). If @kbd{<} is used instead of
1525@var{motion-command} then shift @var{n} lines 1525@var{motion-command} then shift @var{n} lines
1526@*(@code{vip-command-argument}). 1526@*(@code{vip-command-argument}).
1527@item > @var{motion-command} 1527@item > @var{motion-command}
1528@itemx @var{n} > > 1528@itemx @var{n} > >
1529@kindex 076 @kbd{>} (@code{vip-command-argument}) 1529@kindex 076 > @r{(}@code{vip-command-argument}@r{)}
1530Shift region determined by the motion command @var{motion-command} to 1530Shift region determined by the motion command @var{motion-command} to
1531right by @var{shift-width} (default is 8). If @kbd{<} is used instead of 1531right by @var{shift-width} (default is 8). If @kbd{<} is used instead of
1532@var{motion-command} then shift @var{n} lines 1532@var{motion-command} then shift @var{n} lines
1533@*(@code{vip-command-argument}). 1533@*(@code{vip-command-argument}).
1534@item = @var{motion-command} 1534@item = @var{motion-command}
1535@kindex 075 @kbd{=} (@code{vip-command-argument}) 1535@kindex 075 = @r{(}@code{vip-command-argument}@r{)}
1536Indent region determined by the motion command @var{motion-command}. If 1536Indent region determined by the motion command @var{motion-command}. If
1537@kbd{=} is used instead of @var{motion-command} then indent @var{n} lines 1537@kbd{=} is used instead of @var{motion-command} then indent @var{n} lines
1538(@code{vip-command-argument}). 1538(@code{vip-command-argument}).
1539@item * 1539@item *
1540@kindex 052 @kbd{*} (@code{vip-call-last-kbd-macro}) 1540@kindex 052 * @r{(}@code{vip-call-last-kbd-macro}@r{)}
1541Call last remembered keyboard macro. 1541Call last remembered keyboard macro.
1542@item # 1542@item #
1543A new vi operator. @xref{New Commands}, for more details. 1543A new vi operator. @xref{New Commands}, for more details.
@@ -1546,14 +1546,14 @@ A new vi operator. @xref{New Commands}, for more details.
1546The following keys are reserved for future extensions, and currently 1546The following keys are reserved for future extensions, and currently
1547assigned to a function that just beeps (@code{vip-nil}). 1547assigned to a function that just beeps (@code{vip-nil}).
1548 1548
1549@kindex 046 @kbd{&} (@code{vip-nil}) 1549@kindex 046 & @r{(}@code{vip-nil}@r{)}
1550@kindex 100 @kbd{@@} (@code{vip-nil}) 1550@kindex 100 @@ @r{(}@code{vip-nil}@r{)}
1551@kindex 125 @kbd{U} (@code{vip-nil}) 1551@kindex 125 U @r{(}@code{vip-nil}@r{)}
1552@kindex 133 @kbd{[} (@code{vip-nil}) 1552@kindex 133 [ @r{(}@code{vip-nil}@r{)}
1553@kindex 135 @kbd{]} (@code{vip-nil}) 1553@kindex 135 ] @r{(}@code{vip-nil}@r{)}
1554@kindex 137 @kbd{_} (@code{vip-nil}) 1554@kindex 137 _ @r{(}@code{vip-nil}@r{)}
1555@kindex 161 @kbd{q} (@code{vip-nil}) 1555@kindex 161 q @r{(}@code{vip-nil}@r{)}
1556@kindex 176 @kbd{~} (@code{vip-nil}) 1556@kindex 176 ~ @r{(}@code{vip-nil}@r{)}
1557 1557
1558@example 1558@example
1559&, @@, U, [, ], _, q, ~ 1559&, @@, U, [, ], _, q, ~
@@ -1567,48 +1567,48 @@ keymap. See GNU Emacs Manual for details.
1567 1567
1568@table @kbd 1568@table @kbd
1569@item C-@@ 1569@item C-@@
1570@kindex 000 @kbd{C-@@} (@code{set-mark-command}) 1570@kindex 000 C-@@ @r{(}@code{set-mark-command}@r{)}
1571Set mark and push previous mark on mark ring (@code{set-mark-command}). 1571Set mark and push previous mark on mark ring (@code{set-mark-command}).
1572@item TAB 1572@item @key{TAB}
1573@kindex 011 TAB (@code{indent-for-tab-command}) 1573@kindex 011 TAB @r{(}@code{indent-for-tab-command}@r{)}
1574Indent line for current major mode (@code{indent-for-tab-command}). 1574Indent line for current major mode (@code{indent-for-tab-command}).
1575@item C-j 1575@item C-j
1576@kindex 012 @kbd{C-j} (@code{electric-newline-and-maybe-indent}) 1576@kindex 012 C-j @r{(}@code{electric-newline-and-maybe-indent}@r{)}
1577Insert a newline, and maybe indent according to mode. 1577Insert a newline, and maybe indent according to mode.
1578@item C-k 1578@item C-k
1579@kindex 013 @kbd{C-k} (@code{kill-line}) 1579@kindex 013 C-k @r{(}@code{kill-line}@r{)}
1580Kill the rest of the current line; before a newline, kill the newline. 1580Kill the rest of the current line; before a newline, kill the newline.
1581With a numeric argument, kill that many lines from point. Negative arguments 1581With a numeric argument, kill that many lines from point. Negative arguments
1582kill lines backward (@code{kill-line}). 1582kill lines backward (@code{kill-line}).
1583@item C-l 1583@item C-l
1584@kindex 014 @kbd{C-l} (@code{recenter}) 1584@kindex 014 C-l @r{(}@code{recenter}@r{)}
1585Clear the screen and reprint everything (@code{recenter}). 1585Clear the screen and reprint everything (@code{recenter}).
1586@item @var{n} C-p 1586@item @var{n} C-p
1587@kindex 020 @kbd{C-p} (@code{previous-line}) 1587@kindex 020 C-p @r{(}@code{previous-line}@r{)}
1588Move cursor vertically up @var{n} lines (@code{previous-line}). 1588Move cursor vertically up @var{n} lines (@code{previous-line}).
1589@item C-q 1589@item C-q
1590@kindex 021 @kbd{C-q} (@code{quoted-insert}) 1590@kindex 021 C-q @r{(}@code{quoted-insert}@r{)}
1591Read next input character and insert it. Useful for inserting control 1591Read next input character and insert it. Useful for inserting control
1592characters 1592characters
1593@*(@code{quoted-insert}). 1593@*(@code{quoted-insert}).
1594@item C-r 1594@item C-r
1595@kindex 022 @kbd{C-r} (@code{isearch-backward}) 1595@kindex 022 C-r @r{(}@code{isearch-backward}@r{)}
1596Search backward incrementally (@code{isearch-backward}). 1596Search backward incrementally (@code{isearch-backward}).
1597@item C-s 1597@item C-s
1598@kindex 023 @kbd{C-s} (@code{isearch-forward}) 1598@kindex 023 C-s @r{(}@code{isearch-forward}@r{)}
1599Search forward incrementally (@code{isearch-forward}). 1599Search forward incrementally (@code{isearch-forward}).
1600@item @var{n} C-t 1600@item @var{n} C-t
1601@kindex 024 @kbd{C-t} (@code{transpose-chars}) 1601@kindex 024 C-t @r{(}@code{transpose-chars}@r{)}
1602Interchange characters around point, moving forward one character. With 1602Interchange characters around point, moving forward one character. With
1603count @var{n}, take character before point and drag it forward past @var{n} 1603count @var{n}, take character before point and drag it forward past @var{n}
1604other characters. If no argument and at end of line, the previous two 1604other characters. If no argument and at end of line, the previous two
1605characters are exchanged (@code{transpose-chars}). 1605characters are exchanged (@code{transpose-chars}).
1606@item @var{n} C-v 1606@item @var{n} C-v
1607@kindex 026 @kbd{C-v} (@code{scroll-up}) 1607@kindex 026 C-v @r{(}@code{scroll-up}@r{)}
1608Scroll text upward @var{n} lines. If @var{n} is not given, scroll near 1608Scroll text upward @var{n} lines. If @var{n} is not given, scroll near
1609full screen (@code{scroll-up}). 1609full screen (@code{scroll-up}).
1610@item C-w 1610@item C-w
1611@kindex 027 @kbd{C-w} (@code{kill-region}) 1611@kindex 027 C-w @r{(}@code{kill-region}@r{)}
1612Kill between point and mark. The text is save in the kill ring. The 1612Kill between point and mark. The text is save in the kill ring. The
1613command @kbd{P} or @kbd{p} can retrieve it from kill ring 1613command @kbd{P} or @kbd{p} can retrieve it from kill ring
1614(@code{kill-region}). 1614(@code{kill-region}).
@@ -1624,29 +1624,29 @@ and you can repeat them by the repeat command @kbd{.} (@code{vip-repeat}).
1624 1624
1625@table @kbd 1625@table @kbd
1626@item i 1626@item i
1627@kindex 151 @kbd{i} (@code{vip-insert}) 1627@kindex 151 i @r{(}@code{vip-insert}@r{)}
1628Enter insert mode at point (@code{vip-insert}). 1628Enter insert mode at point (@code{vip-insert}).
1629@item I 1629@item I
1630@kindex 111 @kbd{I} (@code{vip-Insert}) 1630@kindex 111 I @r{(}@code{vip-Insert}@r{)}
1631Enter insert mode at the first non white character on the line 1631Enter insert mode at the first non white character on the line
1632(@code{vip-Insert}). 1632(@code{vip-Insert}).
1633@item a 1633@item a
1634@kindex 141 @kbd{a} (@code{vip-append}) 1634@kindex 141 a @r{(}@code{vip-append}@r{)}
1635Move point forward by one character and then enter insert mode 1635Move point forward by one character and then enter insert mode
1636(@code{vip-append}). 1636(@code{vip-append}).
1637@item A 1637@item A
1638@kindex 101 @kbd{A} (@code{vip-Append}) 1638@kindex 101 A @r{(}@code{vip-Append}@r{)}
1639Enter insert mode at end of line (@code{vip-Append}). 1639Enter insert mode at end of line (@code{vip-Append}).
1640@item o 1640@item o
1641@kindex 157 @kbd{o} (@code{vip-open-line}) 1641@kindex 157 o @r{(}@code{vip-open-line}@r{)}
1642Open a new line below the current line and enter insert mode 1642Open a new line below the current line and enter insert mode
1643(@code{vip-open-line}). 1643(@code{vip-open-line}).
1644@item O 1644@item O
1645@kindex 117 @kbd{O} (@code{vip-Open-line}) 1645@kindex 117 O @r{(}@code{vip-Open-line}@r{)}
1646Open a new line above the current line and enter insert mode 1646Open a new line above the current line and enter insert mode
1647(@code{vip-Open-line}). 1647(@code{vip-Open-line}).
1648@item C-o 1648@item C-o
1649@kindex 017 @kbd{C-o} (@code{vip-open-line-at-point}) 1649@kindex 017 C-o @r{(}@code{vip-open-line-at-point}@r{)}
1650Insert a newline and leave point before it, and then enter insert mode 1650Insert a newline and leave point before it, and then enter insert mode
1651@*(@code{vip-open-line-at-point}). 1651@*(@code{vip-open-line-at-point}).
1652@end table 1652@end table
@@ -1656,16 +1656,16 @@ differently from emacs mode.
1656 1656
1657@table @kbd 1657@table @kbd
1658@item @key{ESC} 1658@item @key{ESC}
1659@kindex 033 @kbd{ESC} (@code{vip-change-mode-to-vi}) (insert mode) 1659@kindex 033 ESC @r{(}@code{vip-change-mode-to-vi}@r{) (insert mode)}
1660This key will take you back to vi mode (@code{vip-change-mode-to-vi}). 1660This key will take you back to vi mode (@code{vip-change-mode-to-vi}).
1661@item C-h 1661@item C-h
1662@kindex 010 @kbd{C-h} (@code{delete-backward-char}) (insert mode) 1662@kindex 010 C-h @r{(}@code{delete-backward-char}@r{) (insert mode)}
1663Delete previous character (@code{delete-backward-char}). 1663Delete previous character (@code{delete-backward-char}).
1664@item C-w 1664@item C-w
1665@kindex 027 @kbd{C-w} (@code{vip-delete-backward-word}) (insert mode) 1665@kindex 027 C-w @r{(}@code{vip-delete-backward-word}@r{) (insert mode)}
1666Delete previous word (@code{vip-delete-backward-word}). 1666Delete previous word (@code{vip-delete-backward-word}).
1667@item C-z 1667@item C-z
1668@kindex 032 @kbd{C-z} (@code{vip-ESC}) (insert mode) 1668@kindex 032 C-z @r{(}@code{vip-ESC}@r{) (insert mode)}
1669This key simulates @key{ESC} key in emacs mode. For instance, typing 1669This key simulates @key{ESC} key in emacs mode. For instance, typing
1670@kbd{C-z x} in insert mode is the same as typing @kbd{ESC x} in emacs mode 1670@kbd{C-z x} in insert mode is the same as typing @kbd{ESC x} in emacs mode
1671(@code{vip-ESC}). 1671(@code{vip-ESC}).
@@ -1685,7 +1685,7 @@ commands while in insert mode.
1685@node Ex Commands 1685@node Ex Commands
1686@chapter Ex Commands 1686@chapter Ex Commands
1687 1687
1688@kindex 072 @kbd{:} (@code{vip-ex}) 1688@kindex 072 : @r{(}@code{vip-ex}@r{)}
1689 1689
1690In vi mode, you can execute an Ex command @var{ex-command} by typing: 1690In vi mode, you can execute an Ex command @var{ex-command} by typing:
1691@example 1691@example
diff --git a/doc/misc/viper.texi b/doc/misc/viper.texi
index 8948437632b..2b300f6493c 100644
--- a/doc/misc/viper.texi
+++ b/doc/misc/viper.texi
@@ -368,9 +368,9 @@ toggles Viperization of Emacs on and off.
368@node States in Viper 368@node States in Viper
369@section States in Viper 369@section States in Viper
370 370
371@kindex @kbd{C-z} 371@kindex C-z
372@kindex @key{ESC} 372@kindex ESC
373@kindex @kbd{i} 373@kindex i
374@cindex Emacs state 374@cindex Emacs state
375@cindex Vi state 375@cindex Vi state
376@cindex Insert state 376@cindex Insert state
@@ -474,7 +474,7 @@ to allow Emacs keys in Insert state.
474@node Emacs State 474@node Emacs State
475@subsection Emacs State 475@subsection Emacs State
476 476
477@kindex @kbd{C-z} 477@kindex C-z
478@cindex Emacs state 478@cindex Emacs state
479 479
480 480
@@ -514,7 +514,7 @@ exceptions are:
514 514
515@table @kbd 515@table @kbd
516@item C-x 516@item C-x
517@kindex @kbd{C-x} 517@kindex C-x
518@kbd{C-x} is used to invoke Emacs commands, mainly those that do window 518@kbd{C-x} is used to invoke Emacs commands, mainly those that do window
519management. @kbd{C-x 2} will split a window, @kbd{C-x 0} will close a 519management. @kbd{C-x 2} will split a window, @kbd{C-x 0} will close a
520window. @kbd{C-x 1} will close all other windows. @kbd{C-xb} is used to 520window. @kbd{C-x 1} will close all other windows. @kbd{C-xb} is used to
@@ -523,14 +523,14 @@ These are about the only necessary keystrokes.
523For the rest, see the GNU Emacs Manual. 523For the rest, see the GNU Emacs Manual.
524 524
525@item C-c 525@item C-c
526@kindex @kbd{C-c} 526@kindex C-c
527For user levels 2 and higher, this key serves as a prefix key for the key 527For user levels 2 and higher, this key serves as a prefix key for the key
528sequences used by various major modes. For users at Viper level 1, @kbd{C-c} 528sequences used by various major modes. For users at Viper level 1, @kbd{C-c}
529simply beeps. 529simply beeps.
530 530
531@item C-g and C-] 531@item C-g and C-]
532@kindex @kbd{C-g} 532@kindex C-g
533@kindex @kbd{C-]} 533@kindex C-]
534 534
535These are the Emacs @samp{quit} keys. 535These are the Emacs @samp{quit} keys.
536There will be cases where you will have to 536There will be cases where you will have to
@@ -543,7 +543,7 @@ Edit,Recursive Edit,emacs,The GNU Emacs Manual}.
543At user level 1, @kbd{C-g} is bound to @code{viper-info-on-file} 543At user level 1, @kbd{C-g} is bound to @code{viper-info-on-file}
544function instead. 544function instead.
545@item C-\ 545@item C-\
546@kindex @kbd{C-\} 546@kindex C-\
547@cindex Meta key 547@cindex Meta key
548 548
549Viper uses @key{ESC} as a switch between Insert and Vi states. Emacs uses 549Viper uses @key{ESC} as a switch between Insert and Vi states. Emacs uses
@@ -569,7 +569,7 @@ about are:
569 569
570@table @samp 570@table @samp
571@item Undo 571@item Undo
572@kindex @kbd{u} 572@kindex u
573@kbd{u} will undo. Undo can be repeated by the @kbd{.} key. Undo itself 573@kbd{u} will undo. Undo can be repeated by the @kbd{.} key. Undo itself
574can be undone. Another @kbd{u} will change the direction. The presence 574can be undone. Another @kbd{u} will change the direction. The presence
575of repeatable undo means that @kbd{U}, undoing lines, is not very 575of repeatable undo means that @kbd{U}, undoing lines, is not very
@@ -599,7 +599,7 @@ to case-insensitive and back.
599@cindex vanilla search 599@cindex vanilla search
600@cindex case-sensitive search 600@cindex case-sensitive search
601@cindex case-insensitive search 601@cindex case-insensitive search
602@kindex @kbd{C-c /} 602@kindex C-c /
603 603
604@item Ex commands 604@item Ex commands
605@cindex Ex commands 605@cindex Ex commands
@@ -1083,7 +1083,7 @@ remembered (This is called ``learn mode'' in some editors.)
1083where @samp{register} is any character from @samp{a} through @samp{z}. Then 1083where @samp{register} is any character from @samp{a} through @samp{z}. Then
1084you can execute this macro using @kbd{@@register}. It is, of course, 1084you can execute this macro using @kbd{@@register}. It is, of course,
1085possible to yank some text into a register and execute it using 1085possible to yank some text into a register and execute it using
1086@kbd{@@register}. Typing @kbd{@@@@}, @kbd{@@RET}, or @kbd{@@C-j} will 1086@kbd{@@register}. Typing @kbd{@@@@}, @kbd{@@@key{RET}}, or @kbd{@@C-j} will
1087execute the last macro that was executed using @kbd{@@register}. 1087execute the last macro that was executed using @kbd{@@register}.
1088 1088
1089Viper will automatically lowercase the register, so that pressing the 1089Viper will automatically lowercase the register, so that pressing the
@@ -1302,8 +1302,8 @@ These commands have no Vi analogs.
1302 1302
1303@table @kbd 1303@table @kbd
1304@item C-x, C-c 1304@item C-x, C-c
1305@kindex @kbd{C-x} 1305@kindex C-x
1306@kindex @kbd{C-c} 1306@kindex C-c
1307These two keys invoke many important Emacs functions. For example, if you 1307These two keys invoke many important Emacs functions. For example, if you
1308hit @kbd{C-x} followed by @kbd{2}, then the current window will be split 1308hit @kbd{C-x} followed by @kbd{2}, then the current window will be split
1309into 2. Except for novice users, @kbd{C-c} is also set to execute an Emacs 1309into 2. Except for novice users, @kbd{C-c} is also set to execute an Emacs
@@ -1313,11 +1313,11 @@ configure @key{ESC} as Meta by setting @code{viper-no-multiple-ESC} to
1313@kbd{C-\} in Insert, Replace, or Vi states will make Emacs think 1313@kbd{C-\} in Insert, Replace, or Vi states will make Emacs think
1314@kbd{Meta} has been hit. 1314@kbd{Meta} has been hit.
1315@item \ 1315@item \
1316@kindex @kbd{\} 1316@kindex \
1317Escape to Emacs to execute a single Emacs command. For instance, 1317Escape to Emacs to execute a single Emacs command. For instance,
1318@kbd{\ @key{ESC}} will act like a Meta key. 1318@kbd{\ @key{ESC}} will act like a Meta key.
1319@item Q 1319@item Q
1320@kindex @kbd{Q} 1320@kindex Q
1321@cindex query replace 1321@cindex query replace
1322@kbd{Q} is for query replace. By default, 1322@kbd{Q} is for query replace. By default,
1323each string to be replaced is treated as a regular expression. You can use 1323each string to be replaced is treated as a regular expression. You can use
@@ -1327,16 +1327,16 @@ that @kbd{:se nomagic} turns Regexps off completely, unlike Vi).
1327@item v 1327@item v
1328@itemx V 1328@itemx V
1329@itemx C-v 1329@itemx C-v
1330@kindex @kbd{v} 1330@kindex v
1331@kindex @kbd{V} 1331@kindex V
1332@kindex @kbd{C-v} 1332@kindex C-v
1333These keys are used to visit files. @kbd{v} will switch to a buffer 1333These keys are used to visit files. @kbd{v} will switch to a buffer
1334visiting file whose name can be entered in the minibuffer. @kbd{V} is 1334visiting file whose name can be entered in the minibuffer. @kbd{V} is
1335similar, but will use a window different from the current window. 1335similar, but will use a window different from the current window.
1336@kbd{C-v} is like @kbd{V}, except that a new frame (X window) will be used 1336@kbd{C-v} is like @kbd{V}, except that a new frame (X window) will be used
1337instead of a new Emacs window. 1337instead of a new Emacs window.
1338@item # 1338@item #
1339@kindex @kbd{#} 1339@kindex #
1340If followed by a certain character @var{ch}, it becomes an operator whose 1340If followed by a certain character @var{ch}, it becomes an operator whose
1341argument is the region determined by the motion command that follows 1341argument is the region determined by the motion command that follows
1342(indicated as <move>). 1342(indicated as <move>).
@@ -1344,34 +1344,34 @@ Currently, @var{ch} can be one of @kbd{c}, @kbd{C}, @kbd{g}, @kbd{q}, and
1344@kbd{s}. For instance, @kbd{#qr} will prompt you for a string and then 1344@kbd{s}. For instance, @kbd{#qr} will prompt you for a string and then
1345prepend this string to each line in the buffer. 1345prepend this string to each line in the buffer.
1346@item # c 1346@item # c
1347@kindex @kbd{#c<move>} 1347@kindex #c<move>
1348@cindex changing case 1348@cindex changing case
1349Change upper-case characters in the region to lower-case 1349Change upper-case characters in the region to lower-case
1350(@code{downcase-region}). 1350(@code{downcase-region}).
1351Emacs command @kbd{M-l} does the same for words. 1351Emacs command @kbd{M-l} does the same for words.
1352@item # C 1352@item # C
1353@kindex @kbd{#C<move>} 1353@kindex #C<move>
1354Change lower-case characters in the region to upper-case. For instance, 1354Change lower-case characters in the region to upper-case. For instance,
1355@kbd{# C 3 w} will capitalize 3 words from the current point 1355@kbd{# C 3 w} will capitalize 3 words from the current point
1356(@code{upcase-region}). 1356(@code{upcase-region}).
1357Emacs command @kbd{M-u} does the same for words. 1357Emacs command @kbd{M-u} does the same for words.
1358@item # g 1358@item # g
1359@kindex @kbd{#g<move>} 1359@kindex #g<move>
1360Execute last keyboard macro for each line in the region 1360Execute last keyboard macro for each line in the region
1361(@code{viper-global-execute}). 1361(@code{viper-global-execute}).
1362@item # q 1362@item # q
1363@kindex @kbd{#q<move>} 1363@kindex #q<move>
1364Insert specified string at the beginning of each line in the region 1364Insert specified string at the beginning of each line in the region
1365(@code{viper-quote-region}). The default string is composed of the comment 1365(@code{viper-quote-region}). The default string is composed of the comment
1366character(s) appropriate for the current major mode. 1366character(s) appropriate for the current major mode.
1367@item # s 1367@item # s
1368@kindex @kbd{#s<move>} 1368@kindex #s<move>
1369Check spelling of words in the region (@code{spell-region}). 1369Check spelling of words in the region (@code{spell-region}).
1370The function used for spelling is determined from the variable 1370The function used for spelling is determined from the variable
1371@code{viper-spell-function}. 1371@code{viper-spell-function}.
1372@vindex viper-spell-function 1372@vindex viper-spell-function
1373@item * 1373@item *
1374@kindex @kbd{*} 1374@kindex *
1375Call last keyboard macro. 1375Call last keyboard macro.
1376@item m . 1376@item m .
1377Set mark at point and push old mark off the ring 1377Set mark at point and push old mark off the ring
@@ -1382,41 +1382,41 @@ Set mark at beginning and end of buffer, respectively.
1382Jump to mark and pop mark off the ring. @xref{Mark,,Mark,emacs,The GNU 1382Jump to mark and pop mark off the ring. @xref{Mark,,Mark,emacs,The GNU
1383Emacs Manual}, for more info. 1383Emacs Manual}, for more info.
1384@item ] register 1384@item ] register
1385@kindex @kbd{]<a-z>} 1385@kindex ]<a-z>
1386View contents of register 1386View contents of register
1387@item [ textmarker 1387@item [ textmarker
1388@kindex @kbd{[<a-z>} 1388@kindex [<a-z>
1389View filename and position of textmarker 1389View filename and position of textmarker
1390@item @@# 1390@item @@#
1391@item @@register 1391@item @@register
1392@item @@! 1392@item @@!
1393@kindex @kbd{@@#} 1393@kindex @@#
1394@kindex @kbd{@@<a-z>} 1394@kindex @@<a-z>
1395@kindex @kbd{@@!} 1395@kindex @@!
1396@cindex keyboard macros 1396@cindex keyboard macros
1397@cindex register execution 1397@cindex register execution
1398 1398
1399Begin/end keyboard macro. @@register has a different meaning when used after 1399Begin/end keyboard macro. @@register has a different meaning when used after
1400a @kbd{@@#}. @xref{Macros and Registers}, for details 1400a @kbd{@@#}. @xref{Macros and Registers}, for details
1401@item [] 1401@item []
1402@kindex @kbd{[]} 1402@kindex []
1403Go to end of heading. 1403Go to end of heading.
1404@item g <@emph{movement command}> 1404@item g <@emph{movement command}>
1405Search buffer for text delimited by movement command. The canonical 1405Search buffer for text delimited by movement command. The canonical
1406example is @kbd{gw} to search for the word under the cursor. 1406example is @kbd{gw} to search for the word under the cursor.
1407@xref{Improved Search}, for details. 1407@xref{Improved Search}, for details.
1408@item C-g and C-] 1408@item C-g and C-]
1409@kindex @kbd{C-g} 1409@kindex C-g
1410@kindex @kbd{C-]} 1410@kindex C-]
1411Quit and Abort Recursive edit. These may be necessary on occasion. 1411Quit and Abort Recursive edit. These may be necessary on occasion.
1412@xref{Vi State}, for a reason. 1412@xref{Vi State}, for a reason.
1413@item C-c C-g 1413@item C-c C-g
1414@kindex @kbd{C-c C-g} 1414@kindex C-c C-g
1415Hitting @kbd{C-c} followed by @kbd{C-g} will display the information on the 1415Hitting @kbd{C-c} followed by @kbd{C-g} will display the information on the
1416current buffer. This is the same as hitting @kbd{C-g} in Vi, but, as 1416current buffer. This is the same as hitting @kbd{C-g} in Vi, but, as
1417explained above, @kbd{C-g} is needed for other purposes in Emacs. 1417explained above, @kbd{C-g} is needed for other purposes in Emacs.
1418@item C-c / 1418@item C-c /
1419@kindex @kbd{C-c /} 1419@kindex C-c /
1420Without a prefix argument, this command toggles 1420Without a prefix argument, this command toggles
1421case-sensitive/case-insensitive search modes and plain vanilla/regular 1421case-sensitive/case-insensitive search modes and plain vanilla/regular
1422expression search. With the prefix argument 1, i.e., 1422expression search. With the prefix argument 1, i.e.,
@@ -1429,21 +1429,21 @@ this function.
1429@cindex case-insensitive search 1429@cindex case-insensitive search
1430 1430
1431@item M-p and M-n 1431@item M-p and M-n
1432@kindex @kbd{M-p} 1432@kindex M-p
1433@kindex @kbd{M-n} 1433@kindex M-n
1434In the minibuffer, these commands navigate through the minibuffer 1434In the minibuffer, these commands navigate through the minibuffer
1435histories, such as the history of search strings, Ex commands, etc. 1435histories, such as the history of search strings, Ex commands, etc.
1436 1436
1437@item C-s 1437@item C-s
1438@kindex @kbd{C-s} 1438@kindex C-s
1439If the minibuffer is entered via a Viper search commands @kbd{/} or @kbd{?}, 1439If the minibuffer is entered via a Viper search commands @kbd{/} or @kbd{?},
1440then typing this key inserts the last search string used by the 1440then typing this key inserts the last search string used by the
1441Emacs incremental search command (that is bound to @kbd{C-s} everywhere 1441Emacs incremental search command (that is bound to @kbd{C-s} everywhere
1442except in this case). 1442except in this case).
1443 1443
1444@item C-c M-p and C-c M-n 1444@item C-c M-p and C-c M-n
1445@kindex @kbd{C-c M-p} 1445@kindex C-c M-p
1446@kindex @kbd{C-c M-n} 1446@kindex C-c M-n
1447@cindex Insertion history 1447@cindex Insertion history
1448@cindex Insertion ring 1448@cindex Insertion ring
1449@cindex Command history 1449@cindex Command history
@@ -2669,10 +2669,10 @@ purpose of mouse search and mouse insert. By default, this is set to
2669@code{double-click-time} in Emacs and to 2669@code{double-click-time} in Emacs and to
2670@code{mouse-track-multi-click-time} milliseconds in XEmacs. 2670@code{mouse-track-multi-click-time} milliseconds in XEmacs.
2671@end table 2671@end table
2672@kindex @kbd{S-mouse-1} 2672@kindex S-mouse-1
2673@kindex @kbd{S-mouse-2} 2673@kindex S-mouse-2
2674@kindex @kbd{meta shift button1up} 2674@kindex META SHIFT button1up
2675@kindex @kbd{meta shift button2up} 2675@kindex META SHIFT button2up
2676@vindex viper-multiclick-timeout 2676@vindex viper-multiclick-timeout
2677@findex viper-mouse-click-insert-word 2677@findex viper-mouse-click-insert-word
2678@findex viper-mouse-click-search-word 2678@findex viper-mouse-click-search-word
@@ -3383,60 +3383,60 @@ don't want this macro, put
3383in your Viper customization file. 3383in your Viper customization file.
3384 3384
3385@end table 3385@end table
3386@kindex @kbd{%} 3386@kindex %
3387@kindex @kbd{C-c /} 3387@kindex C-c /
3388@kindex @kbd{N} 3388@kindex N
3389@kindex @kbd{n} 3389@kindex n
3390@kindex @kbd{?<cr>} 3390@kindex ?<cr>
3391@kindex @kbd{/<cr>} 3391@kindex /<cr>
3392@kindex @kbd{?<string>} 3392@kindex ?<string>
3393@kindex @kbd{/<string>} 3393@kindex /<string>
3394@kindex @kbd{''} 3394@kindex ''
3395@kindex @kbd{``} 3395@kindex ``
3396@kindex @kbd{]<a-z>} 3396@kindex ]<a-z>
3397@kindex @kbd{[<a-z>} 3397@kindex [<a-z>
3398@kindex @kbd{'<a-z>} 3398@kindex '<a-z>
3399@kindex @kbd{`<a-z>} 3399@kindex `<a-z>
3400@kindex @kbd{m<a-z>} 3400@kindex m<a-z>
3401@kindex @kbd{[]} 3401@kindex []
3402@kindex @kbd{[[} 3402@kindex [[
3403@kindex @kbd{]]} 3403@kindex ]]
3404@kindex @kbd{@{} 3404@kindex @{
3405@kindex @kbd{@}} 3405@kindex @}
3406@kindex @kbd{(} 3406@kindex (
3407@kindex @kbd{)} 3407@kindex )
3408@kindex @kbd{M} 3408@kindex M
3409@kindex @kbd{L} 3409@kindex L
3410@kindex @kbd{H} 3410@kindex H
3411@kindex @kbd{G} 3411@kindex G
3412@kindex @kbd{E} 3412@kindex E
3413@kindex @kbd{e} 3413@kindex e
3414@kindex @kbd{B} 3414@kindex B
3415@kindex @kbd{b} 3415@kindex b
3416@kindex @kbd{W} 3416@kindex W
3417@kindex @kbd{w} 3417@kindex w
3418@kindex @kbd{,} 3418@kindex ,
3419@kindex @kbd{;} 3419@kindex ;
3420@kindex @kbd{T<char>} 3420@kindex T<char>
3421@kindex @kbd{F<char>} 3421@kindex F<char>
3422@kindex @kbd{t<char>} 3422@kindex t<char>
3423@kindex @kbd{f<char>} 3423@kindex f<char>
3424@kindex @kbd{|} 3424@kindex |
3425@kindex @kbd{0} 3425@kindex 0
3426@kindex @kbd{<cr>} 3426@kindex CR
3427@kindex @kbd{+} 3427@kindex +
3428@kindex @kbd{-} 3428@kindex -
3429@kindex @kbd{^} 3429@kindex ^
3430@kindex @kbd{$} 3430@kindex $
3431@kindex @kbd{C-p} 3431@kindex C-p
3432@kindex @kbd{<lf>} 3432@kindex LF
3433@kindex @kbd{<sp>} 3433@kindex SPC
3434@kindex @kbd{C-n} 3434@kindex C-n
3435@kindex @kbd{C-h} 3435@kindex C-h
3436@kindex @kbd{h} 3436@kindex h
3437@kindex @kbd{j} 3437@kindex j
3438@kindex @kbd{k} 3438@kindex k
3439@kindex @kbd{l} 3439@kindex l
3440@vindex viper-parse-sexp-ignore-comments 3440@vindex viper-parse-sexp-ignore-comments
3441 3441
3442@node Marking 3442@node Marking
@@ -3478,18 +3478,18 @@ Go to specified Viper mark.
3478@item `<a-z> 3478@item `<a-z>
3479Go to specified Viper mark and go to the first CHAR on line. 3479Go to specified Viper mark and go to the first CHAR on line.
3480@end table 3480@end table
3481@kindex @kbd{m<a-z>} 3481@kindex m<a-z>
3482@kindex @kbd{m.} 3482@kindex m.
3483@kindex @kbd{m>} 3483@kindex m>
3484@kindex @kbd{m<} 3484@kindex m<
3485@kindex @kbd{m,} 3485@kindex m,
3486@kindex @kbd{m^} 3486@kindex m^
3487@findex @kbd{Ex mark} 3487@findex @kbd{Ex mark}
3488@findex @kbd{Ex k} 3488@findex @kbd{Ex k}
3489@kindex @kbd{''} 3489@kindex ''
3490@kindex @kbd{``} 3490@kindex ``
3491@kindex @kbd{`<a-z>} 3491@kindex `<a-z>
3492@kindex @kbd{'<a-z>} 3492@kindex '<a-z>
3493 3493
3494@node Appending Text 3494@node Appending Text
3495@subsection Appending Text 3495@subsection Appending Text
@@ -3556,22 +3556,22 @@ Since typing the above sequences of keys may be tedious, the
3556functions doing the perusing can be bound to unused keyboard keys in the 3556functions doing the perusing can be bound to unused keyboard keys in the
3557Viper customization file. @xref{Viper Specials}, for details. 3557Viper customization file. @xref{Viper Specials}, for details.
3558@end table 3558@end table
3559@kindex @kbd{C-c M-p} 3559@kindex C-c M-p
3560@kindex @kbd{C-c M-n} 3560@kindex C-c M-n
3561@kindex @kbd{.} 3561@kindex .
3562@kindex @kbd{]<a-z>} 3562@kindex ]<a-z>
3563@kindex @kbd{[<a-z>} 3563@kindex [<a-z>
3564@kindex @kbd{P} 3564@kindex P
3565@kindex @kbd{p} 3565@kindex p
3566@kindex @kbd{"<a-z1-9>p} 3566@kindex "<a-z1-9>p
3567@kindex @kbd{"<a-z1-9>P} 3567@kindex "<a-z1-9>P
3568@kindex @kbd{>>} 3568@kindex >>
3569@kindex @kbd{><move>} 3569@kindex ><move>
3570@kindex @kbd{O} 3570@kindex O
3571@kindex @kbd{o} 3571@kindex o
3572@kindex @kbd{i} 3572@kindex i
3573@kindex @kbd{A} 3573@kindex A
3574@kindex @kbd{a} 3574@kindex a
3575 3575
3576@node Editing in Insert State 3576@node Editing in Insert State
3577@subsection Editing in Insert State 3577@subsection Editing in Insert State
@@ -3595,9 +3595,9 @@ Back to the begin of the change on the
3595current line. 3595current line.
3596 3596
3597@end table 3597@end table
3598@kindex @kbd{C-u} 3598@kindex C-u
3599@kindex @kbd{C-w} 3599@kindex C-w
3600@kindex @kbd{C-v} 3600@kindex C-v
3601 3601
3602@node Deleting Text 3602@node Deleting Text
3603@subsection Deleting Text 3603@subsection Deleting Text
@@ -3634,13 +3634,13 @@ shiftwidth to the left (layout!).
3634@item <count> << 3634@item <count> <<
3635Shift <count> lines one shiftwidth to the left. 3635Shift <count> lines one shiftwidth to the left.
3636@end table 3636@end table
3637@kindex @kbd{<<} 3637@kindex <<
3638@kindex @kbd{<<move>} 3638@kindex <<move>
3639@kindex @kbd{D} 3639@kindex D
3640@kindex @kbd{dd} 3640@kindex dd
3641@kindex @kbd{d<move>} 3641@kindex d<move>
3642@kindex @kbd{X} 3642@kindex X
3643@kindex @kbd{x} 3643@kindex x
3644 3644
3645@node Changing Text 3645@node Changing Text
3646@subsection Changing Text 3646@subsection Changing Text
@@ -3727,28 +3727,28 @@ In Vi state, these keys are bound to functions that peruse the history of
3727destructive Vi commands. 3727destructive Vi commands.
3728@xref{Viper Specials}, for details. 3728@xref{Viper Specials}, for details.
3729@end table 3729@end table
3730@kindex @kbd{C-c M-p} 3730@kindex C-c M-p
3731@kindex @kbd{C-c M-n} 3731@kindex C-c M-n
3732@kindex @kbd{#q<move> } 3732@kindex #q<move>
3733@kindex @kbd{#C<move>} 3733@kindex #C<move>
3734@kindex @kbd{#c<move>} 3734@kindex #c<move>
3735@kindex @kbd{&} 3735@kindex &
3736@kindex @kbd{\&} 3736@kindex \&
3737@findex @kbd{Ex substitute/<pat>/<repl>/<f>} 3737@findex @kbd{Ex substitute/<pat>/<repl>/<f>}
3738@findex @kbd{Ex s/<pat>/<repl>/<f>} 3738@findex @kbd{Ex s/<pat>/<repl>/<f>}
3739@findex @kbd{Ex copy [z]} 3739@findex @kbd{Ex copy [z]}
3740@findex @kbd{Ex t [z]} 3740@findex @kbd{Ex t [z]}
3741@findex @kbd{Ex move [z]} 3741@findex @kbd{Ex move [z]}
3742@kindex @kbd{J} 3742@kindex J
3743@kindex @kbd{~} 3743@kindex ~
3744@kindex @kbd{=<move>} 3744@kindex =<move>
3745@kindex @kbd{C} 3745@kindex C
3746@kindex @kbd{cc} 3746@kindex cc
3747@kindex @kbd{c<move>} 3747@kindex c<move>
3748@kindex @kbd{S} 3748@kindex S
3749@kindex @kbd{s} 3749@kindex s
3750@kindex @kbd{R} 3750@kindex R
3751@kindex @kbd{r<char>} 3751@kindex r<char>
3752 3752
3753@node Search and Replace 3753@node Search and Replace
3754@subsection Search and Replace 3754@subsection Search and Replace
@@ -3817,21 +3817,21 @@ Execute <ex-command> on all lines that match <pattern>.
3817@itemx :v /<pattern>/<ex-command> 3817@itemx :v /<pattern>/<ex-command>
3818Execute <ex-command> on all lines that do not match <pattern>. 3818Execute <ex-command> on all lines that do not match <pattern>.
3819@end table 3819@end table
3820@kindex @kbd{&} 3820@kindex &
3821@findex @kbd{Ex substitute/<pat>/<repl>/<f>} 3821@findex @kbd{Ex substitute/<pat>/<repl>/<f>}
3822@kindex @kbd{Q} 3822@kindex Q
3823@kindex @kbd{#g<move>} 3823@kindex #g<move>
3824@findex @kbd{Ex v} 3824@findex @kbd{Ex v}
3825@findex @kbd{Ex g} 3825@findex @kbd{Ex g}
3826@findex @kbd{Ex global} 3826@findex @kbd{Ex global}
3827@findex @kbd{Ex vglobal} 3827@findex @kbd{Ex vglobal}
3828@findex @kbd{Ex tag <name>} 3828@findex @kbd{Ex tag <name>}
3829@kindex @kbd{%} 3829@kindex %
3830@kindex @kbd{N} 3830@kindex N
3831@kindex @kbd{n} 3831@kindex n
3832@kindex @kbd{g<move>} 3832@kindex g<move>
3833@kindex @kbd{?<string>} 3833@kindex ?<string>
3834@kindex @kbd{/<string>} 3834@kindex /<string>
3835 3835
3836@node Yanking 3836@node Yanking
3837@subsection Yanking 3837@subsection Yanking
@@ -3865,19 +3865,19 @@ be automatically down-cased.
3865Put the contents of the (default undo) buffer 3865Put the contents of the (default undo) buffer
3866<count> times before the cursor. The register will 3866<count> times before the cursor. The register will
3867@end table 3867@end table
3868@kindex @kbd{P} 3868@kindex P
3869@kindex @kbd{p} 3869@kindex p
3870@kindex @kbd{"<a-z1-9>p} 3870@kindex "<a-z1-9>p
3871@kindex @kbd{"<a-z1-9>P} 3871@kindex "<a-z1-9>P
3872@kindex @kbd{]<a-z>} 3872@kindex ]<a-z>
3873@kindex @kbd{[<a-z>} 3873@kindex [<a-z>
3874@kindex @kbd{m<a-z>} 3874@kindex m<a-z>
3875@kindex @kbd{Y} 3875@kindex Y
3876@kindex @kbd{yy} 3876@kindex yy
3877@kindex @kbd{"<A-Z>y<move>} 3877@kindex "<A-Z>y<move>
3878@kindex @kbd{"<a-z>y<move>} 3878@kindex "<a-z>y<move>
3879@kindex @kbd{y<move>} 3879@kindex y<move>
3880@kindex @kbd{yank} 3880@kindex yank
3881@findex @kbd{Ex yank} 3881@findex @kbd{Ex yank}
3882 3882
3883@node Undoing 3883@node Undoing
@@ -3902,9 +3902,9 @@ that have a @samp{~} appended to them.
3902@findex @kbd{Ex rec} 3902@findex @kbd{Ex rec}
3903@findex @kbd{Ex e!} 3903@findex @kbd{Ex e!}
3904@findex @kbd{Ex q!} 3904@findex @kbd{Ex q!}
3905@kindex @kbd{.} 3905@kindex .
3906@kindex @kbd{U} 3906@kindex U
3907@kindex @kbd{u} 3907@kindex u
3908 3908
3909@node Display 3909@node Display
3910@section Display 3910@section Display
@@ -3948,21 +3948,21 @@ Put line <count> at the bottom of the window
3948Put line <count> in the center of the window 3948Put line <count> in the center of the window
3949(default the current line). 3949(default the current line).
3950@end table 3950@end table
3951@kindex @kbd{zM} 3951@kindex zM
3952@kindex @kbd{zL} 3952@kindex zL
3953@kindex @kbd{zH} 3953@kindex zH
3954@kindex @kbd{z<cr>} 3954@kindex z<cr>
3955@kindex @kbd{z.} 3955@kindex z.
3956@kindex @kbd{z-} 3956@kindex z-
3957@kindex @kbd{z<cr>} 3957@kindex z<cr>
3958@kindex @kbd{C-b} 3958@kindex C-b
3959@kindex @kbd{C-f} 3959@kindex C-f
3960@kindex @kbd{C-u} 3960@kindex C-u
3961@kindex @kbd{C-d} 3961@kindex C-d
3962@kindex @kbd{C-y} 3962@kindex C-y
3963@kindex @kbd{C-e} 3963@kindex C-e
3964@kindex @kbd{C-l} 3964@kindex C-l
3965@kindex @kbd{C-g} 3965@kindex C-g
3966 3966
3967 3967
3968@node File and Buffer Handling 3968@node File and Buffer Handling
@@ -4078,11 +4078,11 @@ Read the file <name> into the buffer after the line <address>.
4078Edit a file in current or another window, or in another frame. File name 4078Edit a file in current or another window, or in another frame. File name
4079is typed in minibuffer. File completion and history are supported. 4079is typed in minibuffer. File completion and history are supported.
4080@end table 4080@end table
4081@kindex @kbd{v} 4081@kindex v
4082@kindex @kbd{V} 4082@kindex V
4083@findex @kbd{Ex args} 4083@findex @kbd{Ex args}
4084@findex @kbd{Ex rew} 4084@findex @kbd{Ex rew}
4085@kindex @kbd{C-^} 4085@kindex C-^
4086@findex @kbd{Ex e!@: [<files>]} 4086@findex @kbd{Ex e!@: [<files>]}
4087@findex @kbd{Ex e [<files>]} 4087@findex @kbd{Ex e [<files>]}
4088@findex @kbd{Ex edit [<files>]} 4088@findex @kbd{Ex edit [<files>]}
@@ -4096,7 +4096,7 @@ is typed in minibuffer. File completion and history are supported.
4096@findex @kbd{Ex r} 4096@findex @kbd{Ex r}
4097@findex @kbd{Ex read} 4097@findex @kbd{Ex read}
4098@findex @kbd{Ex pre} 4098@findex @kbd{Ex pre}
4099@kindex @kbd{ZZ} 4099@kindex ZZ
4100@findex @kbd{Ex wq} 4100@findex @kbd{Ex wq}
4101@findex @kbd{Ex w <file>} 4101@findex @kbd{Ex w <file>}
4102@findex @kbd{Ex w!@: <file>} 4102@findex @kbd{Ex w!@: <file>}
@@ -4171,14 +4171,14 @@ Show contents of textmarker.
4171@item ]<a-z> 4171@item ]<a-z>
4172Show contents of register. 4172Show contents of register.
4173@end table 4173@end table
4174@kindex @kbd{]<a-z>} 4174@kindex ]<a-z>
4175@kindex @kbd{[<a-z>} 4175@kindex [<a-z>
4176@kindex @kbd{#g<move>} 4176@kindex #g<move>
4177@kindex @kbd{*} 4177@kindex *
4178@kindex @kbd{@@!<a-z>} 4178@kindex @@!<a-z>
4179@kindex @kbd{@@#} 4179@kindex @@#
4180@kindex @kbd{@@@@} 4180@kindex @@@@
4181@kindex @kbd{@@<a-z>} 4181@kindex @@<a-z>
4182@findex @kbd{Ex unmap <char>} 4182@findex @kbd{Ex unmap <char>}
4183@findex @kbd{Ex map <char> <seq>} 4183@findex @kbd{Ex map <char> <seq>}
4184@findex @kbd{Ex unmap!@: <char>} 4184@findex @kbd{Ex unmap!@: <char>}
@@ -4410,16 +4410,16 @@ Undoes the last @kbd{C-y} and puts another kill from the kill ring.
4410Using this command, you can try may different kills until you find the one 4410Using this command, you can try may different kills until you find the one
4411you need. 4411you need.
4412@end table 4412@end table
4413@kindex @kbd{M-y} 4413@kindex M-y
4414@kindex @kbd{C-y} 4414@kindex C-y
4415@kindex @kbd{C-xC-f} 4415@kindex C-x C-f
4416@kindex @kbd{C-xo} 4416@kindex C-x o
4417@kindex @kbd{C-x2} 4417@kindex C-x 2
4418@kindex @kbd{C-x1} 4418@kindex C-x 1
4419@kindex @kbd{C-x0} 4419@kindex C-x 0
4420@kindex @kbd{C-z} 4420@kindex C-z
4421@kindex @kbd{C-\} 4421@kindex C-\
4422@kindex @kbd{C-c\} 4422@kindex C-c\
4423 4423
4424@node Mouse-bound Commands 4424@node Mouse-bound Commands
4425@section Mouse-bound Commands 4425@section Mouse-bound Commands
@@ -4445,10 +4445,10 @@ Note: Viper sets this binding only if this mouse action is not
4445already bound to something else. 4445already bound to something else.
4446@xref{Viper Specials}, for more details. 4446@xref{Viper Specials}, for more details.
4447@end table 4447@end table
4448@kindex @kbd{S-mouse-1} 4448@kindex S-mouse-1
4449@kindex @kbd{S-mouse-2} 4449@kindex S-mouse-2
4450@kindex @kbd{meta button1up} 4450@kindex META button1up
4451@kindex @kbd{meta button2up} 4451@kindex META button2up
4452 4452
4453@node GNU Free Documentation License 4453@node GNU Free Documentation License
4454@appendix GNU Free Documentation License 4454@appendix GNU Free Documentation License
diff --git a/etc/NEWS.26 b/etc/NEWS.26
index a8880d0f323..cb4048dee4a 100644
--- a/etc/NEWS.26
+++ b/etc/NEWS.26
@@ -1219,7 +1219,7 @@ backend", which has been updated to benefit from the new UI features.
1219** Term 1219** Term
1220 1220
1221--- 1221---
1222*** `term-char-mode' now makes its buffer read-only. 1222*** 'term-char-mode' now makes its buffer read-only.
1223 1223
1224The buffer is made read-only to prevent changes from being made by 1224The buffer is made read-only to prevent changes from being made by
1225anything other than the process filter; and movements of point away 1225anything other than the process filter; and movements of point away
@@ -1228,8 +1228,8 @@ correct position after each command. This is needed to avoid states
1228which are inconsistent with the state of the terminal understood by 1228which are inconsistent with the state of the terminal understood by
1229the inferior process. 1229the inferior process.
1230 1230
1231New user options `term-char-mode-buffer-read-only' and 1231New user options 'term-char-mode-buffer-read-only' and
1232`term-char-mode-point-at-process-mark' control these behaviors, and 1232'term-char-mode-point-at-process-mark' control these behaviors, and
1233are non-nil by default. Customize these options to nil if you want 1233are non-nil by default. Customize these options to nil if you want
1234the previous behavior. 1234the previous behavior.
1235 1235
@@ -1747,6 +1747,10 @@ when a symbol's value is changed. This is used to implement the new
1747debugger command 'debug-on-variable-change'. 1747debugger command 'debug-on-variable-change'.
1748 1748
1749+++ 1749+++
1750** New variable 'print-escape-control-characters' causes 'prin1' and
1751'print' to output control characters as backslash sequences.
1752
1753+++
1750** Time conversion functions that accept a time zone rule argument now 1754** Time conversion functions that accept a time zone rule argument now
1751allow it to be OFFSET or a list (OFFSET ABBR), where the integer 1755allow it to be OFFSET or a list (OFFSET ABBR), where the integer
1752OFFSET is a count of seconds east of Universal Time, and the string 1756OFFSET is a count of seconds east of Universal Time, and the string
diff --git a/lisp/emulation/viper.el b/lisp/emulation/viper.el
index 7292fd58c1f..13a88ad11fa 100644
--- a/lisp/emulation/viper.el
+++ b/lisp/emulation/viper.el
@@ -300,6 +300,8 @@
300 300
301;;; Code: 301;;; Code:
302 302
303(require 'cl-lib)
304
303;; compiler pacifier 305;; compiler pacifier
304(defvar mark-even-if-inactive) 306(defvar mark-even-if-inactive)
305(defvar quail-mode) 307(defvar quail-mode)
diff --git a/src/fns.c b/src/fns.c
index 47457e44c8e..ff1c0495693 100644
--- a/src/fns.c
+++ b/src/fns.c
@@ -4953,6 +4953,9 @@ extract_data_from_object (Lisp_Object spec,
4953#endif 4953#endif
4954 } 4954 }
4955 4955
4956 if (!STRINGP (object))
4957 signal_error ("Invalid object argument",
4958 NILP (object) ? build_string ("nil") : object);
4956 return SSDATA (object); 4959 return SSDATA (object);
4957} 4960}
4958 4961