===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/error/Attic/error.1,v
retrieving revision 1.7
retrieving revision 1.8
diff -c -r1.7 -r1.8
*** src/usr.bin/error/Attic/error.1	1999/07/04 11:53:53	1.7
--- src/usr.bin/error/Attic/error.1	1999/12/04 19:04:52	1.8
***************
*** 1,4 ****
! .\"	$OpenBSD: error.1,v 1.7 1999/07/04 11:53:53 aaron Exp $
  .\"	$NetBSD: error.1,v 1.3 1995/09/02 06:15:20 jtc Exp $
  .\"
  .\" Copyright (c) 1980, 1990, 1993
--- 1,4 ----
! .\"	$OpenBSD: error.1,v 1.8 1999/12/04 19:04:52 aaron Exp $
  .\"	$NetBSD: error.1,v 1.3 1995/09/02 06:15:20 jtc Exp $
  .\"
  .\" Copyright (c) 1980, 1990, 1993
***************
*** 50,64 ****
  .Op Fl I Ar ignorefile
  .Op Ar name
  .Sh DESCRIPTION
  .Nm
! analyzes and optionally disperses the diagnostic error messages
  produced by a number of compilers and language processors to the source
  file and line where the errors occurred.  It can replace the painful,
  traditional methods of scribbling abbreviations of errors on paper, and
  permits error messages and source code to be viewed simultaneously
  without machinations of multiple windows in a screen editor.
  .Pp
! Options are:
  .Bl -tag -width Ds
  .It Fl n
  Do
--- 50,65 ----
  .Op Fl I Ar ignorefile
  .Op Ar name
  .Sh DESCRIPTION
+ The
  .Nm
! utility analyzes and optionally disperses the diagnostic error messages
  produced by a number of compilers and language processors to the source
  file and line where the errors occurred.  It can replace the painful,
  traditional methods of scribbling abbreviations of errors on paper, and
  permits error messages and source code to be viewed simultaneously
  without machinations of multiple windows in a screen editor.
  .Pp
! The options are as follows:
  .Bl -tag -width Ds
  .It Fl n
  Do
***************
*** 69,75 ****
  The user is
  .Ar queried
  whether s/he wants to touch the file.
! A ``y'' or ``n'' to the question is necessary to continue.
  Absence of the
  .Fl q
  option implies that all referenced files
--- 70,80 ----
  The user is
  .Ar queried
  whether s/he wants to touch the file.
! A
! .Sq y
! or
! .Sq n
! to the question is necessary to continue.
  Absence of the
  .Fl q
  option implies that all referenced files
***************
*** 91,109 ****
  .It Fl t Ar suffixlist
  Take the following argument as a suffix list.
  Files whose suffixes do not appear in the suffix list are not touched.
! The suffix list is dot separated, and ``*'' wildcards work.
  Thus the suffix list:
  .Pp
  .Dl ".c.y.foo*.h"
  .Pp
  allows
  .Nm
! to touch files ending with ``.c'', ``.y'', ``.foo*'' and ``.h''.
  .It Fl s
  Print out
  .Em statistics
  regarding the error categorization.
  Not too useful.
  .El
  .Pp
  .Nm
--- 96,123 ----
  .It Fl t Ar suffixlist
  Take the following argument as a suffix list.
  Files whose suffixes do not appear in the suffix list are not touched.
! The suffix list is dot separated, and
! .Sq \&*
! wildcards work.
  Thus the suffix list:
  .Pp
  .Dl ".c.y.foo*.h"
  .Pp
  allows
  .Nm
! to touch files ending with
! .Sq \&.c ,
! .Sq \&.y ,
! .Sq \&.foo\&* ,
! and
! .Sq \&.h .
  .It Fl s
  Print out
  .Em statistics
  regarding the error categorization.
  Not too useful.
+ .It Fl I Ar ignorefile
+ Specifies a file containing a list of functions to ignore.
  .El
  .Pp
  .Nm
***************
*** 146,159 ****
  .Nm
  knows about the error messages produced by:
  .Xr make 1 ,
! .Xr \&cc 1 ,
  .Xr cpp 1 ,
  .Xr ccom 1 ,
! .Xr \&as 1 ,
! .Xr \&ld 1 ,
  .Xr lint 1 ,
! .Xr \&pi 1 ,
! .Xr \&pc 1 ,
  .Xr f77 1 ,
  and
  .Em DEC Western Research Modula\-2 .
--- 160,173 ----
  .Nm
  knows about the error messages produced by:
  .Xr make 1 ,
! .Xr cc 1 ,
  .Xr cpp 1 ,
  .Xr ccom 1 ,
! .Xr as 1 ,
! .Xr ld 1 ,
  .Xr lint 1 ,
! .Xr pi 1 ,
! .Xr pc 1 ,
  .Xr f77 1 ,
  and
  .Em DEC Western Research Modula\-2 .
***************
*** 236,244 ****
  Each error message is turned into a one line comment for the
  language,
  and is internally flagged
! with the string ``###'' at
! the beginning of the error,
! and ``%%%'' at the end of the error.
  This makes pattern searching for errors easier with an editor,
  and allows the messages to be easily removed.
  In addition, each error message contains the source line number
--- 250,261 ----
  Each error message is turned into a one line comment for the
  language,
  and is internally flagged
! with the string
! .Dq ###
! at the beginning of the error,
! and
! .Dq %%%
! at the end of the error.
  This makes pattern searching for errors easier with an editor,
  and allows the messages to be easily removed.
  In addition, each error message contains the source line number
***************
*** 288,300 ****
  .Pp
  .Nm error ,
  since it is purely mechanical,
! will not filter out subsequent errors caused by `floodgating'
  initiated by one syntactically trivial error.
  Humans are still much better at discarding these related errors.
  .Pp
  Pascal error messages belong after the lines affected
! (error puts them before).  The alignment of the `\\' marking
! the point of error is also disturbed by
  .Nm error .
  .Pp
  .Nm
--- 305,319 ----
  .Pp
  .Nm error ,
  since it is purely mechanical,
! will not filter out subsequent errors caused by
! .Dq floodgating
  initiated by one syntactically trivial error.
  Humans are still much better at discarding these related errors.
  .Pp
  Pascal error messages belong after the lines affected
! (error puts them before).  The alignment of the
! .Sq \e
! marking the point of error is also disturbed by
  .Nm error .
  .Pp
  .Nm