@section Numeric Arguments
@cindex numeric arguments
@cindex prefix arguments
-@cindex arguments, numeric
-@cindex arguments, prefix
+@cindex arguments to commands
In mathematics and computer usage, the word @dfn{argument} means
``data provided to a function or operation.'' You can give any Emacs
@end table
@kindex C-x C-q
-@findex vc-toggle-read-only
+@c Don't index vc-toggle-read-only here, it is indexed in files.texi,
+@c in the node "Basic VC Editing".
+@c @findex vc-toggle-read-only
@vindex buffer-read-only
@cindex read-only buffer
A buffer can be @dfn{read-only}, which means that commands to change
@cindex astronomical day numbers
Astronomers use a simple counting of days elapsed since noon, Monday,
January 1, 4713 B.C. on the Julian calendar. The number of days elapsed
-is called the @emph{Julian day number} or the @emph{Astronomical day number}.
+is called the @dfn{Julian day number} or the @dfn{Astronomical day number}.
@cindex Hebrew calendar
The Hebrew calendar is used by tradition in the Jewish religion. The
@section Keys and Commands
@cindex binding
-@cindex function
@cindex command
@cindex function definition
This manual is full of passages that tell you what particular keys
@node Hooks
@subsection Hooks
@cindex hook
-@cindex hook function
@cindex running a hook
@dfn{Hooks} are an important mechanism for customization of Emacs. A
@node Rebinding
@subsection Changing Key Bindings Interactively
@cindex key rebinding, this session
-@cindex rebinding keys, this session
+@cindex redefining keys, this session
The way to redefine an Emacs key is to change its entry in a keymap.
You can change the global keymap, in which case the change is effective in
@findex dired-do-chgrp
@kindex G @r{(Dired)}
-@cindex changing file group ownership (in Dired)
+@cindex changing file group (in Dired)
@item G @var{newgroup} @key{RET}
Change the group of the specified files to @var{newgroup}
(@code{dired-do-chgrp}).
This command is a variant of @code{tags-query-replace}. If you exit the
query replace loop, you can use @kbd{M-,} to resume the scan and replace
more matches. @xref{Tags Search}.
-
-@kindex a @r{(Dired)}
-@findex dired-do-apply
-@cindex apply arbitrary function to many files
-@item a @var{function} @kbd{RET}
-Apply an arbitrary Lisp function to the name of each marked file
-(@code{dired-do-apply}).
@end table
@kindex + @r{(Dired)}
@code{find} what condition to test. To use this command, you need to
know how to use @code{find}.
-@pindex locate
@findex locate
@findex locate-with-filter
@cindex file database (locate)
@node Selective Display
@section Selective Display
+@cindex selective display
@findex set-selective-display
@kindex C-x $
variable @code{x-stretch-cursor} to a non-@code{nil} value.
@cindex cursor in non-selected windows
+@vindex show-cursor-in-non-selected-windows
@vindex cursor-in-non-selected-windows
- Normally, the cursor in non-selected windows is shown as a hollow
-box. To turn off cursor display in non-selected windows, set the
-variable @code{cursor-in-non-selected-windows} to @code{nil}.
+ Normally, the cursor in non-selected windows is shown as a hollow box.
+To turn off cursor display in non-selected windows, customize the option
+@code{show-cursor-in-non-selected-windows}, or set the variable
+@code{cursor-in-non-selected-windows} to @code{nil}.
@end table
@cindex files, visiting and saving
-@cindex visiting files
@cindex saving files
@dfn{Visiting} a file means copying its contents into an Emacs buffer
so you can edit them. Emacs makes a new buffer for each file that you
a file name that contains @samp{$}. However, the @samp{/:} must be at
the beginning of the buffer in order to quote @samp{$}.
-@cindex wildcard characters in file names
You can also quote wildcard characters with @samp{/:}, for visiting.
For example, @file{/:/tmp/foo*bar} visits the file @file{/tmp/foo*bar}.
However, in most cases you can simply type the wildcard characters for
@findex transpose-lines
@kindex M-t
@findex transpose-words
-@kindex C-M-t
-@findex transpose-sexps
+@c Don't index C-M-t and transpose-sexps here, they are indexed in
+@c programs.texi, in the "List Commands" node.
+@c @kindex C-M-t
+@c @findex transpose-sexps
@kbd{M-t} (@code{transpose-words}) transposes the word before point
with the word after point. It moves point forward over a word, dragging
the word preceding or containing point forward as well. The punctuation
@section Font Lock mode
@cindex Font Lock mode
@cindex mode, Font Lock
-@cindex syntax highlighting
-@cindex syntax coloring
+@cindex syntax highlighting and coloring
Font Lock mode is a minor mode, always local to a particular
buffer, which highlights (or ``fontifies'') using various faces
@table @kbd
@item C-x w h @var{regexp} @key{RET} @var{face} @key{RET}
-@kindex C-x w i
+@kindex C-x w h
@findex highlight-regexp
-Highlight text that matches Highlight all strings that match
+Highlight text that matches
@var{regexp} using face @var{face} (@code{highlight-regexp}).
By using this command more than once, you can highlight various
parts of the text in different ways.
@node Mac Input
@section Keyboard Input on the Mac
-@cindex Meta (under Mac OS)
-@cindex Mac keyboard coding
+@cindex Meta (Mac OS)
+@cindex keyboard coding (Mac OS)
@vindex mac-command-key-is-meta
@vindex mac-keyboard-text-encoding
@node Mac International
@section International Character Set Support on the Mac
@cindex Mac Roman coding system
-@cindex Mac clipboard support
+@cindex clipboard support (Mac OS)
The Mac uses a non-standard encoding for the upper 128 single-byte
characters. It also deviates from the ISO 2022 standard by using code
@node Mac Environment Variables
@section Environment Variables and Command Line Arguments.
-@cindex Mac environment variables
+@cindex environment variables (Mac OS)
Environment variables and command line arguments for Emacs can be set
by modifying the @samp{STR#} resources 128 and 129, respectively. A common
@node Mac Directories
@section Volumes and Directories on the Mac
-@cindex file names under Mac OS
+@cindex file names (Mac OS)
The directory structure in the Mac OS is seen by Emacs as
@node Mac Font Specs
@section Specifying Fonts on the Mac
-@cindex font names under Mac OS
+@cindex font names (Mac OS)
Fonts are specified to Emacs on the Mac in the form of a standard X
font name. I.e.,
@node Mac Functions
@section Mac-Specific Lisp Functions
-@cindex Lisp functions on the Mac OS
+@cindex Lisp functions specific to Mac OS
@findex do-applescript
The function @code{do-applescript} takes a string argument,
@item @key{RET}
@kindex RET @r{(Shell mode)}
@findex comint-send-input
-@cindex prompt, shell
At end of buffer send line as input; otherwise, copy current line to
end of buffer and send it (@code{comint-send-input}). When a line is
copied, any prompt at the beginning if the line (text output by
@cindex other editors
@cindex EDT
@cindex vi
-@cindex CRiSP
-@cindex Brief
@cindex PC keybindings
@cindex scrolling all windows
@cindex PC selecion
@findex scroll-all-mode
@cindex CRiSP mode
@cindex Brief emulation
+@cindex emulation of Brief
@cindex mode, CRiSP
You can turn on keybindings to emulate the CRiSP/Brief editor with
@kbd{M-x crisp-mode}. Note that this rebinds @kbd{M-x} to exit Emacs
@section Hyperlinking and Navigation Features
@cindex hyperlinking
-@cindex URLs
@cindex navigation
Various modes documented elsewhere have hypertext features so that
you can follow links, usually by clicking @kbd{Mouse-2} on the link or
@node FFAP
@subsection Finding Files and URLs at Point
-@findex ffap
@findex find-file-at-point
@findex ffap
@findex ffap-dired-at-point
@findex ffap-next
@findex ffap-menu
-@cindex FFAP
@cindex finding file at point
FFAP mode replaces certain key bindings for finding files, including
MS-DOS software. To use any of these systems, you need to create it
with @kbd{M-x codepage-setup}. @xref{MS-DOS and MULE}.
-@cindex end-of-line conversion
In addition to converting various representations of non-ASCII
characters, a coding system can perform end-of-line conversion. Emacs
handles three different conventions for how to separate lines in a file:
@cindex accented characters
@cindex ISO Latin character sets
@cindex Unibyte operation
-@vindex enable-multibyte-characters
The ISO 8859 Latin-@var{n} character sets define character codes in
the range 160 to 255 to handle the accented letters and punctuation
needed by various European languages (and some non-European ones).
@itemize @bullet
@cindex 8-bit input
@item
-@findex set-keyboard-coding-system
-@vindex keyboard-coding-system
If your keyboard can generate character codes 128 and up, representing
non-ASCII you can type those character codes directly.
provide useful chunks of text for the paragraph commands to work
on.
-@cindex selective display
-@cindex outline
-@cindex folding
-@findex outline-minor-mode
-@cindex outlines
The selective display feature is useful for looking at the overall
structure of a function (@pxref{Selective Display}). This feature
hides the lines that are indented more than a specified amount.
The commands to move to the beginning and end of the current defun are
@kbd{C-M-a} (@code{beginning-of-defun}) and @kbd{C-M-e} (@code{end-of-defun}).
+@kindex C-M-h @r{(C mode)}
@findex c-mark-function
If you wish to operate on the current defun, use @kbd{C-M-h}
(@code{mark-defun}) which puts point at the beginning and mark at the end
and they have no additional characters in common, a list of all possible
completions is displayed in another window.
-@cindex completion using tags
-@cindex tags completion
+@cindex tags-based completion
@cindex Info index completion
@findex complete-symbol
In most programming language major modes, @kbd{M-@key{TAB}} runs the
functions of your language, and only if it is installed at your site.
@cindex Lisp symbol completion
-@cindex completion in Lisp
+@cindex completion (Lisp symbols)
@findex lisp-complete-symbol
In Emacs-Lisp mode, the name space for completion normally consists of
nontrivial symbols present in Emacs---those that have function
@table @kbd
@item C-M-h
-@findex c-mark-function
-@kindex C-M-h @r{(C mode)}
Put mark at the end of a function definition, and put point at the
beginning (@code{c-mark-function}).
are unlike those of other languages. Built-in abbrevs optionally save
typing when you insert Fortran keywords.
-@findex fortran-mode
Use @kbd{M-x fortran-mode} to switch to this major mode. This command
runs the hook @code{fortran-mode-hook} (@pxref{Hooks}).
-@cindex Fortran77
-@cindex Fortran90
+@cindex Fortran77 and Fortran90
@findex f90-mode
@findex fortran-mode
Fortan mode is meant for editing Fortran77 ``fixed format'' source
POP mail when @code{rmail-pop-password} and
@code{rmail-pop-password-required} are unset.
-@cindex POP inboxes in reverse order
+@cindex reverse order in POP inboxes
Some POP servers store messages in reverse order. If your server does
this, and you would rather read your mail in the order in which it was
received, you can tell @code{movemail} to reverse the order of
@node Regexps, Search Case, Regexp Search, Search
@section Syntax of Regular Expressions
-@cindex regexp syntax
+@cindex syntax of regexps
Regular expressions have a syntax in which a few characters are
special constructs and the rest are @dfn{ordinary}. An ordinary
result, you don't get a warning if you try to send the same message
twice.
-@vindex sendmail-coding-system
+@c This is indexed in mule.texi, node "Recognize Coding".
+@c @vindex sendmail-coding-system
When you send a message that contains non-ASCII characters, they need
to be encoded with a coding system (@pxref{Coding Systems}). Usually
the coding system is specified automatically by your chosen language
environment (@pxref{Language Environments}). You can explicitly specify
the coding system for outgoing mail by setting the variable
-@code{sendmail-coding-system}.
+@code{sendmail-coding-system} (@pxref{Recognize Coding}).
If the coding system thus determined does not handle the characters in
a particular message, Emacs asks you to select the coding system to use,
not the comma and the space, use @kbd{M-b M-d} instead of
@kbd{M-@key{DEL}}.)
-@kindex M-t
-@findex transpose-words
+@c Don't index M-t and transpose-words here, they are indexed in
+@c fixit.texi, in the node "Transpose".
+@c @kindex M-t
+@c @findex transpose-words
@kbd{M-t} (@code{transpose-words}) exchanges the word before or
containing point with the following word. The delimiter characters between
the words do not move. For example, @w{@samp{FOO, BAR}} transposes into
@section Outline Mode
@cindex Outline mode
@cindex mode, Outline
-@cindex selective display
@cindex invisible lines
@findex outline-mode
these commands to @kbd{S-right} etc. (Not all terminals support shifted
arrow keys, however.)
-@cindex Follow mode
-@cindex mode, Follow
-@findex follow-mode
-@cindex windows, synchronizing
-@cindex synchronizing windows
Follow minor mode (@kbd{M-x follow-mode}) synchronizes several
windows on the same buffer so that they always display adjacent
-sections of that buffer. Also if point moves outside a window, it
-moves automatically to another window which shows that part of the
-buffer, if any. Thus, the windows act like one large window on
-the buffer.
-
- One use of this feature is to effectively double the number of lines
-in a given screen height, using side-by-side windows on the same
-buffer. First split a window into side-by-side windows with @kbd{C-x
-3}, then use @kbd{M-x follow-mode} to synchronize the windows.
+sections of that buffer. @xref{Follow Mode}.
@vindex scroll-all-mode
@cindex scrolling windows together