comparison man/misc.texi @ 89909:68c22ea6027c

Sync to HEAD

89908:ee1402f7b568

(@code{comint-dynamic-list-filename-completions}).

@item C-d
@kindex C-d @r{(Shell mode)}
@findex comint-delchar-or-maybe-eof
Either delete a character or send @sc{eof}
(@code{comint-delchar-or-maybe-eof}).  Typed at the end of the shell
buffer, @kbd{C-d} sends @sc{eof} to the subshell.  Typed at any other
position in the buffer, @kbd{C-d} deletes a character as usual.

@item C-c C-a
@kindex C-c C-a @r{(Shell mode)}
@findex comint-bol-or-process-mark

printer.  Thus, some of the characters in your buffer might not be
printable using the fonts built into your printer.  You can augment
the fonts supplied with the printer with those from the GNU Intlfonts
package, or you can instruct Emacs to use Intlfonts exclusively.  The
variable @code{ps-multibyte-buffer} controls this: the default value,
@code{nil}, is appropriate for printing ASCII and Latin-1
characters; a value of @code{non-latin-printer} is for printers which
have the fonts for ASCII, Latin-1, Japanese, and Korean
characters built into them.  A value of @code{bdf-font} arranges for
the BDF fonts from the Intlfonts package to be used for @emph{all}
characters.  Finally, a value of @code{bdf-font-except-latin}
instructs the printer to use built-in fonts for ASCII and Latin-1
characters, and Intlfonts BDF fonts for the rest.

@vindex bdf-directory-list
  To be able to use the BDF fonts, Emacs needs to know where to find
them.  The variable @code{bdf-directory-list} holds the list of

mark).  They divide the text of the region into many @dfn{sort records},
identify a @dfn{sort key} for each record, and then reorder the records
into the order determined by the sort keys.  The records are ordered so
that their keys are in alphabetical order, or, for numeric sorting, in
numeric order.  In alphabetic sorting, all upper-case letters `A' through
`Z' come before lower-case `a', in accord with the ASCII character
sequence.

  The various sort commands differ in how they divide the text into sort
records and in which part of each record is used as the sort key.  Most of
the commands make each line a separate sort record, but some commands use

@cindex restore session
@cindex remember editing session
@cindex reload files
@cindex desktop

  You can use the Desktop library to save the state of Emacs from one
session to another.  Saving the state means that Emacs starts up with
the same set of buffers, major modes, buffer positions, and so on that
the previous Emacs session had.

@vindex desktop-enable
  To use Desktop, you should use the Customization buffer (@pxref{Easy
Customization}) to set @code{desktop-enable} to a non-@code{nil} value,
or add these lines at the end of your @file{.emacs} file:

@example
(desktop-load-default)
(desktop-read)
@end example

@noindent
@findex desktop-save
The first time you save the state of the Emacs session, you must do it
manually, with the command @kbd{M-x desktop-save}.  Once you have done
that, exiting Emacs will save the state again---not only the present
Emacs session, but also subsequent sessions.  You can also save the
state at any time, without exiting Emacs, by typing @kbd{M-x
desktop-save} again.

  In order for Emacs to recover the state from a previous session, you
must start it with the same current directory as you used when you
started the previous session.  This is because @code{desktop-read} looks
in the current directory for the file to read.  This means that you can
have separate saved sessions in different directories; the directory in
which you start Emacs will control which saved session to use.

@vindex desktop-files-not-to-save
  The variable @code{desktop-files-not-to-save} controls which files are
excluded from state saving.  Its value is a regular expression that
matches the files to exclude.  By default, remote (ftp-accessed) files
are excluded; this is because visiting them again in the subsequent
session would be slow.  If you want to include these files in state
saving, set @code{desktop-files-not-to-save} to @code{"^$"}.
@xref{Remote Files}.

@vindex save-place
@cindex Saveplace
@findex toggle-save-place
  The Saveplace library provides a simpler feature that records your
position in each file when you kill its buffer (or kill Emacs), and
jumps to the same position when you visit the file again (even in
another Emacs session).  Use @kbd{M-x toggle-save-place} to turn on
place-saving in a given file.  Customize the option @code{save-place}
to turn it on for all files in each session.

@node Recursive Edit, Emulation, Saving Emacs Sessions, Top
@section Recursive Editing Levels
@cindex recursive editing level
@cindex editing level, recursive

  You can customize Browse-URL's behavior via various options in the
@code{browse-url} Customize group, particularly
@code{browse-url-browser-function}.  You can invoke actions dependent
on the type of URL by defining @code{browse-url-browser-function} as
an association list.  The package's commentary available via @kbd{C-h
p} provides more information.  Packages with facilities for following
URLs should always go through Browse-URL, so that the customization
options for Browse-URL will affect all browsing in Emacs.

@node Goto-address
@subsection Activating URLs
@findex goto-address
@cindex Goto-address

URL rather than a file name, the commands use @code{browse-url} to
view it.

  This feature is useful for following references in mail or news
buffers, @file{README} files, @file{MANIFEST} files, and so on.  The
@samp{ffap} package's commentary available via @kbd{C-h p} and the
@code{ffap} Custom group provide details.

@cindex FFAP minor mode
@findex ffap-mode
  You can turn on FFAP minor mode to make the following key bindings
and to install hooks for using @code{ffap} in Rmail, Gnus and VM
article buffers.

@table @kbd
@item C-x C-f @var{filename} @key{RET}
@kindex C-x C-f @r{(FFAP)}
Find @var{filename}, guessing a default from text around point

  When you are feeling strange, type @kbd{M-x yow}.

@findex zone
The command @kbd{M-x zone} plays games with the display when Emacs is
idle.

89909:68c22ea6027c

(@code{comint-dynamic-list-filename-completions}).

@item C-d
@kindex C-d @r{(Shell mode)}
@findex comint-delchar-or-maybe-eof
Either delete a character or send @acronym{EOF}
(@code{comint-delchar-or-maybe-eof}).  Typed at the end of the shell
buffer, @kbd{C-d} sends @acronym{EOF} to the subshell.  Typed at any other
position in the buffer, @kbd{C-d} deletes a character as usual.

@item C-c C-a
@kindex C-c C-a @r{(Shell mode)}
@findex comint-bol-or-process-mark

printer.  Thus, some of the characters in your buffer might not be
printable using the fonts built into your printer.  You can augment
the fonts supplied with the printer with those from the GNU Intlfonts
package, or you can instruct Emacs to use Intlfonts exclusively.  The
variable @code{ps-multibyte-buffer} controls this: the default value,
@code{nil}, is appropriate for printing @acronym{ASCII} and Latin-1
characters; a value of @code{non-latin-printer} is for printers which
have the fonts for @acronym{ASCII}, Latin-1, Japanese, and Korean
characters built into them.  A value of @code{bdf-font} arranges for
the BDF fonts from the Intlfonts package to be used for @emph{all}
characters.  Finally, a value of @code{bdf-font-except-latin}
instructs the printer to use built-in fonts for @acronym{ASCII} and Latin-1
characters, and Intlfonts BDF fonts for the rest.

@vindex bdf-directory-list
  To be able to use the BDF fonts, Emacs needs to know where to find
them.  The variable @code{bdf-directory-list} holds the list of

mark).  They divide the text of the region into many @dfn{sort records},
identify a @dfn{sort key} for each record, and then reorder the records
into the order determined by the sort keys.  The records are ordered so
that their keys are in alphabetical order, or, for numeric sorting, in
numeric order.  In alphabetic sorting, all upper-case letters `A' through
`Z' come before lower-case `a', in accord with the @acronym{ASCII} character
sequence.

  The various sort commands differ in how they divide the text into sort
records and in which part of each record is used as the sort key.  Most of
the commands make each line a separate sort record, but some commands use

@cindex restore session
@cindex remember editing session
@cindex reload files
@cindex desktop

   Use the desktop library to save the state of Emacs from one session
to another.  Once you save the Emacs @dfn{desktop}---the buffers,
their file names, major modes, buffer positions, and so on---then
subsequent Emacs sessions reload the saved desktop.

@findex desktop-save
@vindex desktop-save-mode
  You can save the desktop manually with the command @kbd{M-x
desktop-save}.  You can also enable automatical desktop saving when
you exit Emacs: use the Customization buffer (@pxref{Easy
Customization}) to set @code{desktop-save-mode} to @code{t} for future
sessions, or add this line in your @file{~/.emacs} file:

@example
(desktop-save-mode 1)
@end example

@findex desktop-change-dir
@findex desktop-revert
  When Emacs starts, it looks for a saved desktop in the current
directory.  Thus, you can have separate saved desktops in different
directories, and the starting directory determines which one Emacs
reloads.  You can save the current desktop and reload one saved in
another directory by typing @kbd{M-x desktop-change-dir}.  Typing
@kbd{M-x desktop-revert} reverts to the desktop previously reloaded.

  Specify the option @samp{--no-desktop} on the command line when you
don't want it to reload any saved desktop.

@findex desktop-clear
@vindex desktop-globals-to-clear
@vindex desktop-clear-preserve-buffers-regexp
  Type @kbd{M-x desktop-clear} to empty the Emacs desktop.  This kills
all buffers except for internal ones, and clears the global variables
listed in @code{desktop-globals-to-clear}.  If you want this to
preserve certain buffers, customize the variable
@code{desktop-clear-preserve-buffers-regexp}, whose value is a regular
expression matching the names of buffers not to kill.

@node Recursive Edit, Emulation, Saving Emacs Sessions, Top
@section Recursive Editing Levels
@cindex recursive editing level
@cindex editing level, recursive

  You can customize Browse-URL's behavior via various options in the
@code{browse-url} Customize group, particularly
@code{browse-url-browser-function}.  You can invoke actions dependent
on the type of URL by defining @code{browse-url-browser-function} as
an association list.  The package's commentary available via @kbd{C-h
p} under the @samp{hypermedia} keyword provides more information.
Packages with facilities for following URLs should always go through
Browse-URL, so that the customization options for Browse-URL will
affect all browsing in Emacs.

@node Goto-address
@subsection Activating URLs
@findex goto-address
@cindex Goto-address

URL rather than a file name, the commands use @code{browse-url} to
view it.

  This feature is useful for following references in mail or news
buffers, @file{README} files, @file{MANIFEST} files, and so on.  The
@samp{ffap} package's commentary available via @kbd{C-h p} under the
@samp{files} keyword and the @code{ffap} Custom group provide details.

@cindex FFAP minor mode
@findex ffap-mode
  You can turn on FFAP minor mode by calling @code{ffap-bindings} to
make the following key bindings and to install hooks for using
@code{ffap} in Rmail, Gnus and VM article buffers.

@table @kbd
@item C-x C-f @var{filename} @key{RET}
@kindex C-x C-f @r{(FFAP)}
Find @var{filename}, guessing a default from text around point

  When you are feeling strange, type @kbd{M-x yow}.

@findex zone
The command @kbd{M-x zone} plays games with the display when Emacs is
idle.

@ignore
   arch-tag: 8f094220-c0d5-4e9e-af7d-3e0da8187474
@end ignore