comparison man/misc.texi @ 90519:138ce2701550

Merge from emacs--devo--0 Patches applied: * emacs--devo--0 (patch 320-342) - Update from CVS - Merge from gnus--rel--5.10 - lisp/play/cookie1.el (cookie): Work properly when there's only one entry - Add note about "link" button-class to etc/TODO * gnus--rel--5.10 (patch 108-112) - Merge from emacs--devo--0 - Clean up merge mistakes - Update from CVS - Update from CVS: texi/gnus.texi (Summary Buffer Lines): Fix typo. Revision: [e-mail]/emacs--unicode--0--patch-86

90518:64c755511769

@node Invoking emacsclient,, Emacs Server, Emacs Server
@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:

@example
emacsclient @r{@{}@r{[}+@var{line}@r{[}@var{column}@r{]}@r{]} @var{filename}@r{@}}@dots{}
@end example

  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
always give you an editor, even if no Emacs server is running:

@example
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.

@pindex emacs.bash
  Alternatively, the file @file{etc/emacs.bash} defines a bash
function which will communicate with a running Emacs server, or start
one if none exists.

  @dfn{Narrowing} means focusing in on some portion of the buffer,
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}.

  Narrowing can make it easier to concentrate on a single subroutine or
paragraph by eliminating clutter.  It can also be used to restrict the
range of operation of a replace command or repeating keyboard macro.

@table @kbd
@item C-x n n
Narrow down to between point and mark (@code{narrow-to-region}).

90519:138ce2701550

@node Invoking emacsclient,, Emacs Server, Emacs Server
@subsection Invoking @code{emacsclient}

  To run the @code{emacsclient} program, specify file names as arguments,
and optionally line numbers as well, like this:

@example
emacsclient @r{@{}@r{[}+@var{line}@r{[}@var{column}@r{]}@r{]} @var{filename}@r{@}}@dots{}
@end example

  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}} 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
EDITOR="emacsclient --alternate-editor emacs +%d %s"
@end example

@noindent
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
function which will communicate with a running Emacs server, or start
one if none exists.

  @dfn{Narrowing} means focusing in on some portion of the buffer,
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 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 limit the
range of operation of a replace command or repeating keyboard macro.

@table @kbd
@item C-x n n
Narrow down to between point and mark (@code{narrow-to-region}).