Thu Jul 4 14:47:06 1991 John Gilmore (gnu at cygint.cygnus.com)

[binutils.git] / readline / inc-history.texinfo

diff --git a/readline/inc-history.texinfo b/readline/inc-history.texinfo
index a32e70d2edc0cdf61ced2d2e88540ca7a8df49ae..9bbb575d40779e9165fc2d8af890d4404cad7004 100755 (executable)
--- a/readline/inc-history.texinfo
+++ b/readline/inc-history.texinfo
@@ -58,15 +58,15 @@ on the stack directly.  In addition, a history @dfn{expansion} function
 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
@@ -82,8 +82,8 @@ 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.
+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.  *
@@ -102,21 +102,21 @@ history list.
 
 @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
@@ -124,9 +124,9 @@ Refer to the most recent command containing @var{string}.
 @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
@@ -144,14 +144,14 @@ The first argument.  that is, word 1.
 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
@@ -160,7 +160,7 @@ The empty string is returned in that case.
 @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
 
@@ -173,7 +173,7 @@ belong in this section.
 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.