userdoc.texi

gcc-2.95.3 Linux下最常用的C编译器

@kindex p
@findex prev-node
Selects the `Prev' node.

@item @code{u} (@code{up-node})
@kindex u
@findex up-node
Selects the `Up' node.
@end table

You can easily select a node that you have already viewed in this window
by using the @samp{l} command -- this name stands for "last", and
actually moves through the list of already visited nodes for this
window.  @samp{l} with a negative numeric argument moves forward through
the history of nodes for this window, so you can quickly step between
two adjacent (in viewing history) nodes.

@table @asis
@item @code{l} (@code{history-node})
@kindex l
@findex history-node
Selects the most recently selected node in this window.
@end table

Two additional commands make it easy to select the most commonly
selected nodes; they are @samp{t} and @samp{d}.

@table @asis
@item @code{t} (@code{top-node})
@kindex t
@findex top-node
Selects the node @samp{Top} in the current info file.

@item @code{d} (@code{dir-node})
@kindex d
@findex dir-node
Selects the directory node (i.e., the node @samp{(dir)}).
@end table

Here are some other commands which immediately result in the selection
of a different node in the current window:

@table @asis
@item @code{<} (@code{first-node})
@kindex <
@findex first-node
Selects the first node which appears in this file.  This node is most
often @samp{Top}, but it doesn't have to be.

@item @code{>} (@code{last-node})
@kindex >
@findex last-node
Selects the last node which appears in this file.

@item @code{]} (@code{global-next-node})
@kindex ]
@findex global-next-node
Moves forward or down through node structure.  If the node that you are
currently viewing has a @samp{Next} pointer, that node is selected.
Otherwise, if this node has a menu, the first menu item is selected.  If
there is no @samp{Next} and no menu, the same process is tried with the
@samp{Up} node of this node.

@item @code{[} (@code{global-prev-node})
@kindex [
@findex global-prev-node
Moves backward or up through node structure.  If the node that you are
currently viewing has a @samp{Prev} pointer, that node is selected.
Otherwise, if the node has an @samp{Up} pointer, that node is selected,
and if it has a menu, the last item in the menu is selected.
@end table

You can get the same behaviour as @code{global-next-node} and
@code{global-prev-node} while simply scrolling through the file with
@key{SPC} and @key{DEL}; @xref{Variables, @code{scroll-behaviour}}, for
more information.

@table @asis
@item @code{g} (@code{goto-node})
@kindex g
@findex goto-node
Reads the name of a node and selects it.  No completion is done while
reading the node name, since the desired node may reside in a separate
file.  The node must be typed exactly as it appears in the info file.  A
file name may be included as with any node specification, for example

@example
@code{g(emacs)Buffers}
@end example

finds the node @samp{Buffers} in the info file @file{emacs}.

@item @code{C-x k} (@code{kill-node})
@kindex C-x k
@findex kill-node
Kills a node.  The node name is prompted for in the echo area, with a
default of the current node.  @dfn{Killing} a node means that Info tries
hard to forget about it, removing it from the list of history nodes kept
for the window where that node is found.  Another node is selected in
the window which contained the killed node.

@item @code{C-x C-f} (@code{view-file})
@kindex C-x C-f
@findex view-file
Reads the name of a file and selects the entire file.  The command
@example
@code{C-x C-f @var{filename}}
@end example
is equivalent to typing
@example
@code{g(@var{filename})*}
@end example

@item @code{C-x C-b} (@code{list-visited-nodes})
@kindex C-x C-b
@findex list-visited-nodes
Makes a window containing a menu of all of the currently visited nodes.
This window becomes the selected window, and you may use the standard
Info commands within it.

@item @code{C-x b} (@code{select-visited-node})
@kindex C-x b
@findex select-visited-node
Selects a node which has been previously visited in a visible window.
This is similar to @samp{C-x C-b} followed by @samp{m}, but no window is
created.
@end table

@node Searching Commands
@chapter Searching an Info File
@cindex searching

GNU Info allows you to search for a sequence of characters throughout an
entire info file, search through the indices of an info file, or find
areas within an info file which discuss a particular topic.

@table @asis
@item @code{s} (@code{search})
@kindex s
@findex search
Reads a string in the echo area and searches for it.

@item @code{C-s} (@code{isearch-forward})
@kindex C-s
@findex isearch-forward
Interactively searches forward through the info file for a string as you
type it.

@item @code{C-r} (@code{isearch-backward})
@kindex C-r
@findex isearch-backward
Interactively searches backward through the info file for a string as
you type it.

@item @code{i} (@code{index-search})
@kindex i
@findex index-search
Looks up a string in the indices for this info file, and selects a node
where the found index entry points to.

@item @code{,} (@code{next-index-match})
@kindex ,
@findex next-index-match
Moves to the node containing the next matching index item from the last
@samp{i} command.
@end table

The most basic searching command is @samp{s} (@code{search}).  The
@samp{s} command prompts you for a string in the echo area, and then
searches the remainder of the info file for an ocurrence of that string.
If the string is found, the node containing it is selected, and the
cursor is left positioned at the start of the found string.  Subsequent
@samp{s} commands show you the default search string within @samp{[} and
@samp{]}; pressing @key{RET} instead of typing a new string will use the
default search string.

@dfn{Incremental searching} is similar to basic searching, but the
string is looked up while you are typing it, instead of waiting until
the entire search string has been specified.

@node Xref Commands
@chapter Selecting Cross References

We have already discussed the @samp{Next}, @samp{Prev}, and @samp{Up}
pointers which appear at the top of a node.  In addition to these
pointers, a node may contain other pointers which refer you to a
different node, perhaps in another info file.  Such pointers are called
@dfn{cross references}, or @dfn{xrefs} for short.

@menu
* Parts of an Xref::	What a cross reference is made of.
* Selecting Xrefs::	Commands for selecting menu or note items.
@end menu

@node Parts of an Xref
@section Parts of an Xref

Cross references have two major parts: the first part is called the
@dfn{label}; it is the name that you can use to refer to the cross
reference, and the second is the @dfn{target}; it is the full name of
the node that the cross reference points to.

The target is separated from the label by a colon @samp{:}; first the
label appears, and then the target.  For example, in the sample menu
cross reference below, the single colon separates the label from the
target.

@example
* Foo Label: Foo Target.	More information about Foo.
@end example

Note the @samp{.} which ends the name of the target.  The @samp{.} is
not part of the target; it serves only to let Info know where the target
name ends.

A shorthand way of specifying references allows two adjacent colons to
stand for a target name which is the same as the label name:

@example
* Foo Commands::		Commands pertaining to Foo.
@end example

In the above example, the name of the target is the same as the name of
the label, in this case @code{Foo Commands}.

You will normally see two types of cross references while viewing nodes:
@dfn{menu} references, and @dfn{note} references.  Menu references
appear within a node's menu; they begin with a @samp{*} at the beginning
of a line, and continue with a label, a target, and a comment which
describes what the contents of the node pointed to contains.

Note references appear within the body of the node text; they begin with
@code{*Note}, and continue with a label and a target.

Like @samp{Next}, @samp{Prev} and @samp{Up} pointers, cross references
can point to any valid node.  They are used to refer you to a place
where more detailed information can be found on a particular subject.
Here is a cross reference which points to a node within the Texinfo
documentation:  @xref{xref, , Writing an Xref, texinfo, the Texinfo
Manual}, for more information on creating your own texinfo cross
references.

@node Selecting Xrefs
@section Selecting Xrefs

The following table lists the Info commands which operate on menu items.

@table @asis
@item @code{1} (@code{menu-digit})
@itemx @code{2} @dots{} @code{9}
@cindex 1 @dots{} 9, in Info windows
@kindex 1 @dots{} 9, in Info windows
@findex menu-digit
Within an Info window, pressing a single digit, (such as @samp{1}),
selects that menu item, and places its node in the current window.
For convenience, there is one exception; pressing @samp{0} selects the
@emph{last} item in the node's menu.

@item @code{0} (@code{last-menu-item})
@kindex 0, in Info windows
@findex last-menu-item
Select the last item in the current node's menu.

@item @code{m} (@code{menu-item})
@kindex m
@findex menu-item
Reads the name of a menu item in the echo area and selects its node.
Completion is available while reading the menu label.

@item @code{M-x find-menu}
@findex find-menu
Moves the cursor to the start of this node's menu.
@end table

This table lists the Info commands which operate on note cross references.

@table @asis
@item @code{f} (@code{xref-item})
@itemx @code{r}
@kindex f
@kindex r
@findex xref-item
Reads the name of a note cross reference in the echo area and selects
its node.  Completion is available while reading the cross reference
label.
@end table

Finally, the next few commands operate on menu or note references alike:

@table @asis
@item @code{TAB} (@code{move-to-next-xref})
@kindex TAB, in Info windows
@findex move-to-next-xref
Moves the cursor to the start of the next nearest menu item or note
reference in this node.  You can then use @key{RET}
(@code{select-reference-this-line} to select the menu or note reference.

@item @code{M-TAB} (@code{move-to-prev-xref})
@kindex M-TAB, in Info windows
@findex move-to-prev-xref
Moves the cursor the start of the nearest previous menu item or note
reference in this node.

@item @code{RET} (@code{select-reference-this-line})
@kindex RET, in Info windows
@findex select-reference-this-line
Selects the menu item or note reference appearing on this line.
@end table

@node Window Commands
@chapter Manipulating Multiple Windows
@cindex windows, manipulating

A @dfn{window} is a place to show the text of a node.  Windows have a
view area where the text of the node is displayed, and an associated
@dfn{mode line}, which briefly describes the node being viewed.

GNU Info supports multiple windows appearing in a single screen; each