inc-hist.texi: gdb manual up to date for 95q3

rluser.texinfo:
This commit is contained in:
Victoria Mixon 1995-06-22 21:30:02 +00:00
parent af215b1a6a
commit f9e903ee03
2 changed files with 46 additions and 43 deletions

View File

@ -41,18 +41,18 @@ from a user's standpoint.
@section History Interaction
@cindex expansion
The History library provides a history expansion feature that is similar
to the history expansion in Csh. The following text describes the sytax
that you use to manipulate the history information.
The History library provides a history expansion feature similar
to the history expansion in @code{csh}. The following text describes the
syntax you use to manipulate history information.
History expansion takes place in two parts. The first is to determine
which line from the previous history should be used during substitution.
The second is to select portions of that line for inclusion into the
current one. The line selected from the previous history is called the
@dfn{event}, and the portions of that line that are acted upon are
called @dfn{words}. The line is broken into words in the same fashion
that the Bash shell does, so that several English (or Unix) words
surrounded by quotes are considered as one word.
History expansion takes two parts. In the first part, determine
which line from the previous history will be used for substitution.
This line is called the @dfn{event}.
In the second part, select portions of that line for inclusion into the
current line. These portions are called @dfn{words}.
@value{GDBN} breaks the line into words in the same
way that the Bash shell does, so that several English (or Unix) words
surrounded by quotes are considered one word.
@menu
* Event Designators:: How to specify which history line to use.
@ -64,7 +64,7 @@ surrounded by quotes are considered as one word.
@subsection Event Designators
@cindex event designators
An event designator is a reference to a command line entry in the
An @dfn{event designator} is a reference to a command line entry in the
history list.
@table @asis
@ -93,8 +93,8 @@ Refer to the most recent command containing @var{string}.
@node Word Designators
@subsection Word Designators
A @key{:} separates the event specification from the word designator. It
can be omitted if the word designator begins with a @key{^}, @key{$},
A @key{:} separates the event designator from the @dfn{word designator}.
It can be omitted if the word designator begins with a @key{^}, @key{$},
@key{*} or @key{%}. Words are numbered from the beginning of the line,
with the first word being denoted by a 0 (zero).
@ -129,14 +129,18 @@ The empty string is returned in that case.
@subsection Modifiers
After the optional word designator, you can add a sequence of one or more
of the following modifiers, each preceded by a @key{:}.
of the following @dfn{modifiers}, each preceded by a @key{:}.
@table @code
@item #
The entire command line typed so far. This means the current command,
not the previous command, so it really isn't a word designator, and doesn't
belong in this section.
not the previous command.
@c
@c FIXME: If it doesn't belong here, let's put it where it does.
@c
@c so it technically isn't a word designator and doesn't belong in
@c this section.
@item h
Remove a trailing pathname component, leaving only the head.

View File

@ -73,8 +73,8 @@ as you type it in, allowing you to just fix your typo, and not forcing
you to retype the majority of the line. Using these editing commands,
you move the cursor to the place that needs correction, and delete or
insert the text of the corrections. Then, when you are satisfied with
the line, you simply press @key{RETURN}. You do not have to be at the
end of the line to press @key{RETURN}; the entire line is accepted
the line, you simply press @key{RET}. You do not have to be at the
end of the line to press @key{RET}; the entire line is accepted
regardless of the location of the cursor within the line.
@menu
@ -176,8 +176,7 @@ Kill from the cursor to the previous whitespace. This is different than
@end table
And, here is how to @dfn{yank} the text back into the line. Yanking
is
And, here is how to @dfn{yank} the text back into the line.
@table @key
@item C-y
@ -216,7 +215,7 @@ the @key{C-d} command an argument of 10, you could type @key{M-1 0 C-d}.
@node Readline Init File
@section Readline Init File
Although the Readline library comes with a set of Emacs-like
Although the Readline library comes with a set of @sc{gnu} Emacs-like
keybindings, it is possible that you would like to use a different set
of keybindings. You can customize programs that use Readline by putting
commands in an @dfn{init} file in your home directory. The name of this
@ -230,7 +229,7 @@ incorporating any changes that you might have made to it.
@menu
* Readline Init Syntax:: Syntax for the commands in @file{~/.inputrc}.
* Readline Vi Mode:: Switching to @code{vi} mode in Readline.
* Readline vi Mode:: Switching to @code{vi} mode in Readline.
@end menu
@node Readline Init Syntax
@ -243,7 +242,7 @@ file:
@item Variable Settings
You can change the state of a few variables in Readline. You do this by
using the @code{set} command within the init file. Here is how you
would specify that you wish to use Vi line editing commands:
would specify that you wish to use @code{vi} line editing commands:
@example
set editing-mode vi
@ -257,7 +256,7 @@ fact, that we just iterate them here:
@item editing-mode
@vindex editing-mode
The @code{editing-mode} variable controls which editing mode you are
using. By default, GNU Readline starts up in Emacs editing mode, where
using. By default, @sc{gnu} Readline starts up in Emacs editing mode, where
the keystrokes are most similar to Emacs. This variable can either be
set to @code{emacs} or @code{vi}.
@ -312,7 +311,7 @@ expressed on the right hand side (that is, to insert the text
@item @w{"@var{keyseq}": @var{function-name} or @var{macro}}
@var{keyseq} differs from @var{keyname} above in that strings denoting
an entire key sequence can be specified. Simply place the key sequence
in double quotes. GNU Emacs style key escapes can be used, as in the
in double quotes. @sc{gnu} Emacs style key escapes can be used, as in the
following example:
@example
@ -387,7 +386,7 @@ Move `down' through the history list.
Move to the first line in the history.
@item end-of-history (@key{M->})
Move to the end of the input history, i.e., the line you are entering!
Move to the end of the input history, i.e., the line you are entering.
@item reverse-search-history (@key{C-r})
Search backward starting at the current line and moving `up' through
@ -410,7 +409,7 @@ beginning of the line, and there are no characters in the line, and
the last character typed was not @key{C-d}, then return EOF.
@item backward-delete-char (Rubout)
Delete the character behind the cursor. A numeric arg says to kill
Delete the character behind the cursor. A numeric argument says to kill
the characters instead of deleting them.
@item quoted-insert (@key{C-q}, @key{C-v})
@ -426,7 +425,7 @@ Insert yourself.
@item transpose-chars (@key{C-t})
Drag the character before point forward over the character at point.
Point moves forward as well. If point is at the end of the line, then
transpose the two characters before point. Negative args don't work.
transpose the two characters before point. Negative arguments don't work.
@item transpose-words (@key{M-t})
Drag the word behind the cursor past the word in front of the cursor
@ -465,13 +464,13 @@ words, to the end of the next word.
Kill the word behind the cursor.
@item unix-line-discard (@key{C-u})
Do what @key{C-u} used to do in Unix line input. We save the killed text on
the kill-ring, though.
Kill the whole line the way @key{C-u} used to in Unix line input.
The killed text is saved on the kill-ring.
@item unix-word-rubout (@key{C-w})
Do what @key{C-w} used to do in Unix line input. The killed text is saved
on the kill-ring. This is different than backward-kill-word because
the word boundaries differ.
Kill the word the way @key{C-w} used to in Unix line input.
The killed text is saved on the kill-ring. This is different than
backward-kill-word because the word boundaries differ.
@item yank (@key{C-y})
Yank the top of the kill ring into the buffer at point.
@ -492,7 +491,7 @@ Add this digit to the argument already accumulating, or start a new
argument. @key{M--} starts a negative argument.
@item universal-argument ()
Do what @key{C-u} does in emacs. By default, this is not bound.
Do what @key{C-u} does in @sc{gnu} Emacs. By default, this is not bound.
@end ftable
@ -507,7 +506,7 @@ implementation defined. Generally, if you are typing a filename
argument, you can do filename completion; if you are typing a command,
you can do command completion, if you are typing in a symbol to GDB, you
can do symbol name completion, if you are typing in a variable to Bash,
you can do variable name completion...
you can do variable name completion.
@item possible-completions (M-?)
List the possible completions of the text before point.
@ -548,20 +547,20 @@ command enough times to get back to the beginning.
@end ftable
@need 2000
@node Readline Vi Mode
@subsection Readline Vi Mode
@node Readline vi Mode
@subsection Readline @code{vi} Mode
@cindex @code{vi} style command editing
@kindex toggle-editing-mode
While the Readline library does not have a full set of Vi editing
While the Readline library does not have a full set of @code{vi} editing
functions, it does contain enough to allow simple editing of the line.
In order to switch interactively between Emacs and Vi editing modes, use
the command @key{M-C-j} (toggle-editing-mode).
In order to switch interactively between @sc{gnu} Emacs and @code{vi}
editing modes, use the command @key{M-C-j} (toggle-editing-mode).
When you enter a line in Vi mode, you are already placed in `insertion'
When you enter a line in @code{vi} mode, you are already placed in `insertion'
mode, as if you had typed an `i'. Pressing @key{ESC} switches you into
`edit' mode, where you can edit the text of the line with the standard
Vi movement keys, move to previous history lines with `k', and following
@code{vi} movement keys, move to previous history lines with `k', and following
lines with `j', and so forth.