into another language, under the above conditions for modified versions.
@end ignore
-@node History Top
+@node History Top,,,
+@appendix Command Line History
@ifinfo
This file is meant to be an inclusion in the documentation of programs
that use the history library features. There is also a standalone
document, entitled @file{history.texinfo}.
@end ifinfo
-This chapter describes the GNU History library, a programming tool that
+This Appendix describes the GNU History library, a programming tool that
provides a consistent user interface for recalling lines of previously
typed input.
is available which provides for a consistent user interface across many
different programs.
-The end-user using programs written with the History library has the
-benifit of a consistent user interface, with a set of well-known
+When you use programs written with the History library, you have the
+benefit of a consistent user interface, with a set of well-known
commands for manipulating the text of previous lines and using that text
in new commands. The basic history manipulation commands are similar to
the history substitution used by Csh.
-If the programmer desires, he can use the Readline library, which
-includes history manipulation by default, and has the added advantage of
-Emacs style command line editing.
+GNU programs often also use the Readline library, which includes history
+manipulation by default, and has the added advantage of Emacs style
+command line editing.
@node History Interaction, , Introduction to History, Top
@appendixsec History Interaction
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.
+used by the Bash shell, so that several words surrounded by quotes are
+treated as if they were a single word.
@menu
* Event Designators:: How to specify which history line to use. *
@item @code{!}
Start a history subsititution, except when followed by a space, tab, or
-the end of the line... @kbd{=} or @kbd{(}.
+the end of the line; or by @samp{=} or @samp{(}.
@item @code{!!}
Refer to the previous command. This is a synonym for @code{!-1}.
-@item @code{!n}
+@item @code{!@var{n}}
Refer to command line @var{n}.
-@item @code{!-n}
+@item @code{!-@var{n}}
Refer to the command line @var{n} lines back.
-@item @code{!string}
+@item @code{!@var{string}}
Refer to the most recent command starting with @var{string}.
-@item @code{!?string}[@code{?}]
+@item @code{!?@var{string}}[@code{?}]
Refer to the most recent command containing @var{string}.
@end table
@node Word Designators, Modifiers, Event Designators, History Interaction
@appendixsubsec Word Designators
-A @kbd{:} separates the event specification from the word designator. It
-can be omitted if the word designator begins with a @kbd{^}, @kbd{$},
-@kbd{*} or @kbd{%}. Words are numbered from the beginning of the line,
+A @samp{:} separates the event specification from the word designator. It
+can be omitted if the word designator begins with a @samp{^}, @samp{$},
+@samp{*} or @samp{%}. Words are numbered from the beginning of the line,
with the first word being denoted by a 0 (zero).
@table @code
The last argument.
@item %
-The word matched by the most recent @code{?string?} search.
+The word matched by the most recent @code{?@var{string}?} search.
-@item x-y
-A range of words; @code{-@var{y}} Abbreviates @code{0-@var{y}}.
+@item @var{x}-@var{y}
+A range of words; @code{-@var{y}} abbreviates @code{0-@var{y}}.
@item *
-All of the words, excepting the zero'th. This is a synonym for @code{1-$}.
-It is not an error to use @kbd{*} if there is just one word in the event.
+All of the words, excepting the zero'th. This is a synonym for @samp{1-$}.
+It is not an error to use @samp{*} if there is just one word in the event.
The empty string is returned in that case.
@end table
@appendixsubsec Modifiers
After the optional word designator, you can add a sequence of one or more
-of the following modifiers, each preceded by a @kbd{:}.
+of the following modifiers, each preceded by a @samp{:}.
@table @code
Remove a trailing pathname component, leaving only the head.
@item r
-Remove a trailing suffix of the form @samp{.}@var{suffix}, leaving the basename.
+Remove a trailing suffix of the form @samp{.@var{suffix}}, leaving the basename.
@item e
Remove all but the suffix.
projects / deliverable / binutils-gdb.git / blobdiff