]> code.delx.au - gnu-emacs/blobdiff - man/misc.texi
*** empty log message ***
[gnu-emacs] / man / misc.texi
index 4fd12965231a412d600ea4e7c2e6d2c17063fbfc..6f6d448bc7dfe36dde00d51bc203430550d9f359 100644 (file)
@@ -30,9 +30,9 @@ Usenet news.  It can also be used to read and respond to messages from a
 number of other sources---mail, remote directories, digests, and so on.
 
 Here we introduce Gnus and describe several basic features.
-@ifinfo
+@ifnottex
 For full details, see @ref{Top, Gnus,, gnus, The Gnus Manual}.
-@end ifinfo
+@end ifnottex
 @iftex
 For full details on Gnus, type @kbd{M-x info} and then select the Gnus
 manual.
@@ -238,10 +238,10 @@ for @var{regexp}.
 
 @c Too many references to the name of the manual if done with xref in TeX!
 Gnus is powerful and customizable.  Here are references to a few
-@ifinfo
+@ifnottex
 additional topics:
 
-@end ifinfo
+@end ifnottex
 @iftex
 additional topics in @cite{The Gnus Manual}:
 
@@ -274,7 +274,7 @@ Send an article to a newsgroup.@*
 See section ``Composing Messages.''
 @end itemize
 @end iftex
-@ifinfo
+@ifnottex
 @itemize @bullet
 @item
 Follow discussions on specific topics.@*
@@ -304,7 +304,7 @@ name, subject, or string in the body of the articles.@*
 Send an article to a newsgroup.@*
 @xref{Composing Messages, , , gnus, The Gnus Manual}.
 @end itemize
-@end ifinfo
+@end ifnottex
 @end ignore
 
 @node Shell, Emacs Server, Gnus, Top
@@ -825,7 +825,9 @@ same regexp used last time.
 
   When you find the previous input you want, you can resubmit it by
 typing @key{RET}, or you can edit it first and then resubmit it if you
-wish.
+wish.  Any partial input you were composing before navigating the
+history list is restored when you go to the beginning or end of the
+history ring.
 
   Often it is useful to reexecute several successive shell commands that
 were previously executed in sequence.  To do this, first find and
@@ -871,17 +873,21 @@ Move point to the previous prompt (@code{comint-previous-prompt}).
 Move point to the following prompt (@code{comint-next-prompt}).
 
 @kindex C-c RET @r{(Shell mode)}
-@findex comint-insert-input
+@findex comint-copy-old-input
 @item C-c @key{RET}
 Copy the input command which point is in, inserting the copy at the end
-of the buffer (@code{comint-insert-input}).  This is useful if you
+of the buffer (@code{comint-copy-old-input}).  This is useful if you
 move point back to a previous command.  After you copy the command, you
 can submit the copy as input with @key{RET}.  If you wish, you can
-edit the copy before resubmitting it.
+edit the copy before resubmitting it.  If you use this command on an
+output line, it copies that line to the end of the buffer.
 
 @item Mouse-2
-Copy the input command that you click on, inserting the copy at the end
-of the buffer.
+If @code{comint-use-prompt-regexp} is @code{nil} (the default), copy
+the old input command that you click on, inserting the copy at the end
+of the buffer (@code{comint-insert-input}).  If
+@code{comint-use-prompt-regexp} is non-@code{nil}, or if the click is
+not over old input, just yank as usual.
 @end table
 
   Moving to a previous input and then copying it with @kbd{C-c
@@ -967,14 +973,14 @@ current directory.
 @vindex comint-scroll-to-bottom-on-input
   If the variable @code{comint-scroll-to-bottom-on-input} is
 non-@code{nil}, insertion and yank commands scroll the selected window
-to the bottom before inserting.
+to the bottom before inserting.  The default is @code{nil}.
 
 @vindex comint-scroll-show-maximum-output
   If @code{comint-scroll-show-maximum-output} is non-@code{nil}, then
 arrival of output when point is at the end tries to place the last line of
 text at the bottom line of the window, so as to show as much useful
-text as possible.  (This mimics the scrolling behavior of many
-terminals.)  The default is @code{nil}.
+text as possible.  (This mimics the scrolling behavior of most
+terminals.)  The default is @code{t}.
 
 @vindex comint-move-point-for-output
   By setting @code{comint-move-point-for-output}, you can opt for
@@ -1325,7 +1331,7 @@ automatically when you finish with them.
 @subsection Invoking @code{emacsclient}
 
   To run the @code{emacsclient} program, specify file names as arguments,
-and optionally line numbers as well.  Do it like this:
+and optionally line numbers as well, like this:
 
 @example
 emacsclient @r{@{}@r{[}+@var{line}@r{[}@var{column}@r{]}@r{]} @var{filename}@r{@}}@dots{}
@@ -1342,14 +1348,19 @@ in the line.
 Emacs sends a message to the @code{emacsclient} program telling it to
 return.
 
+  If you invoke @code{emacsclient} for more than one file, the
+additional client buffers are buried at the bottom of the buffer list
+(@pxref{Buffers}).  If you call @kbd{C-x #} after you are done editing
+a client buffer, the next client buffer is automatically selected.
+
   But if you use the option @samp{-n} or @samp{--no-wait} when running
 @code{emacsclient}, then it returns immediately.  (You can take as
 long as you like to edit the files in Emacs.)
 
-  The option @samp{--alternate-editor=@var{command}} is useful when
-running @code{emacsclient} in a script.  It specifies a command to run
-if @code{emacsclient} fails to contact Emacs.  For example, the
-following setting for the @var{EDITOR} environment variable will
+  The option @samp{--alternate-editor=@var{command}} specifies a
+command to run if @code{emacsclient} fails to contact Emacs.  This is
+useful when running @code{emacsclient} in a script.  For example, the
+following setting for the @env{EDITOR} environment variable will
 always give you an editor, even if no Emacs server is running:
 
 @example
@@ -1357,8 +1368,8 @@ EDITOR="emacsclient --alternate-editor emacs +%d %s"
 @end example
 
 @noindent
-The environment variable @var{ALTERNATE_EDITOR} has the same effect, but
-the value of the @samp{--alternate-editor} takes precedence.
+The environment variable @env{ALTERNATE_EDITOR} has the same effect, with
+the value of the @samp{--alternate-editor} option taking precedence.
 
 @pindex emacs.bash
   Alternatively, the file @file{etc/emacs.bash} defines a bash
@@ -1501,9 +1512,9 @@ rendition of the current buffer as a cursive handwritten document.  It
 can be customized in group @code{handwrite}.  This function only
 supports ISO 8859-1 characters.
 
-@ifinfo
+@ifnottex
   The following section describes variables for customizing these commands.
-@end ifinfo
+@end ifnottex
 
 @node PostScript Variables, Printing Package, PostScript, Printing
 @section Variables for PostScript Hardcopy
@@ -1770,11 +1781,11 @@ rectangle moves along with the text inside the rectangle.
 making the rest temporarily inaccessible.  The portion which you can
 still get to is called the @dfn{accessible portion}.  Canceling the
 narrowing, which makes the entire buffer once again accessible, is
-called @dfn{widening}.  The amount of narrowing in effect in a buffer at
-any time is called the buffer's @dfn{restriction}.
+called @dfn{widening}.  The bounds of narrowing in effect in a buffer
+are called the buffer's @dfn{restriction}.
 
   Narrowing can make it easier to concentrate on a single subroutine or
-paragraph by eliminating clutter.  It can also be used to restrict the
+paragraph by eliminating clutter.  It can also be used to limit the
 range of operation of a replace command or repeating keyboard macro.
 
 @table @kbd
@@ -2366,9 +2377,9 @@ or through an external viewer.
   To enter Tumme, type @kbd{M-x tumme}.  It prompts for a directory;
 specify one that has images files.  This creates thumbnails for all
 the images in that directory, and displays them all in the ``thumbnail
-buffer''.  This takes a long time if the directory contains many image
-files, and it won't operate if the number of image files exceeds
-@code{tumme-show-all-from-dir-max-files}.
+buffer.''  This takes a long time if the directory contains many image
+files, and it asks for confirmation if the number of image files
+exceeds @code{tumme-show-all-from-dir-max-files}.
 
 @kindex C-t d @r{(Tumme)}
 @findex tumme-display-thumbs
@@ -2381,7 +2392,7 @@ a buffer containing thumbnails, corresponding to the marked files.
 (@code{tumme-display-thumbnail-original-image}) to display a sized
 version of it in another window.  This sizes the image to fit the
 window.  Use the arrow keys to move around in the buffer.  For easy
-browing, type @kbd{SPC} (@code{tumme-display-next-thumbnail-original})
+browsing, type @kbd{SPC} (@code{tumme-display-next-thumbnail-original})
 to advance and display the next image.  Typing @kbd{DEL}
 (@code{tumme-display-previous-thumbnail-original}) backs up to the
 previous thumbnail and displays that instead.