patches to history.1

patches to history.1

[Arnold Robbins]

Here are some patches that improve the history.1 man page.

Arnold
----------------------
*** history.1.dist	Wed Jul 31 14:31:29 1991
--- history.1	Wed Jul 31 15:08:19 1991
***************
*** 105,139 ****
  ..
  .TH HISTORY 1 "30 July 1991"
  .SH NAME
! \-, \-\-, \-p, \--p \- shell history programs
  .SH SYNOPSIS
  .B \-
! .I [ pattern, substitutions ]
  .SH DESCRIPTION
  This set of programs provides a crude history mechanism for the shell
  .IR rc (1).
! It is based on the AT&T v8 programs =, ==, etc.
  .PP
  The program
  .I \-
  runs the shell on the command it is requested to find.
  The program
! .I \--
  edits that command first.
  .I \-p
  and
! .I \--p
! similar, except that they print the final command on their standard
  output instead of running the shell.
  .PP
  The commands work by looking for a file named by the environment variable
! .Cr HISTORY ,
  and by searching for previous commands in this file.
  Old commands can be edited, or simply re-executed according to the rules
  below:
  .PP
  A command is searched for by examining the lines in
! .Cr $HISTORY
  in reverse order. If one or more
  .I pattern
  is supplied on the command line, then the patterns are used as a means of
--- 105,143 ----
  ..
  .TH HISTORY 1 "30 July 1991"
  .SH NAME
! \-, \-\-, \-p, \-\-p \- shell history programs
  .SH SYNOPSIS
  .B \-
! [
! .I pattern
! ] [
! .I substitutions
! ]
  .SH DESCRIPTION
  This set of programs provides a crude history mechanism for the shell
  .IR rc (1).
! It is based on the V8 Unix programs =, ==, etc.
  .PP
  The program
  .I \-
  runs the shell on the command it is requested to find.
  The program
! .I \-\-
  edits that command first.
  .I \-p
  and
! .I \-\-p
! are similar, except that they print the final command on their standard
  output instead of running the shell.
  .PP
  The commands work by looking for a file named by the environment variable
! .Cr history ,
  and by searching for previous commands in this file.
  Old commands can be edited, or simply re-executed according to the rules
  below:
  .PP
  A command is searched for by examining the lines in
! .Cr $history
  in reverse order. If one or more
  .I pattern
  is supplied on the command line, then the patterns are used as a means of
***************
*** 175,180 ****
--- 179,185 ----
  .B $
  Deletes the rest of the line from that character on, and replaces
  it with the rest of the typed line.
+ .TP
  .B \-
  Backs up to a previous command satisfying the same matching
  constraints.
***************
*** 187,193 ****
  reinterpretation:
  .Ds
  .Cr "fn - -- {
! .Cr "	comm = `{$0^p $*}
  .Cr "	if (! ~ $#comm 0) {
  .Cr "		echo $comm
  .Cr "		eval $comm
--- 192,198 ----
  reinterpretation:
  .Ds
  .Cr "fn - -- {
! .Cr "	comm = \`{$0^p $*}
  .Cr "	if (! ~ $#comm 0) {
  .Cr "		echo $comm
  .Cr "		eval $comm