===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/error/Attic/error.1,v
retrieving revision 1.4
retrieving revision 1.5
diff -c -r1.4 -r1.5
*** src/usr.bin/error/Attic/error.1	1998/08/30 22:45:17	1.4
--- src/usr.bin/error/Attic/error.1	1998/09/23 04:32:39	1.5
***************
*** 1,4 ****
! .\"	$OpenBSD: error.1,v 1.4 1998/08/30 22:45:17 deraadt 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.5 1998/09/23 04:32:39 aaron Exp $
  .\"	$NetBSD: error.1,v 1.3 1995/09/02 06:15:20 jtc Exp $
  .\"
  .\" Copyright (c) 1980, 1990, 1993
***************
*** 48,56 ****
  .Op Fl v
  .Op Fl t Ar suffixlist
  .Op Fl I Ar ignorefile
! .Op name
  .Sh DESCRIPTION
! .Nm Error
  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,
--- 48,56 ----
  .Op Fl v
  .Op Fl t Ar suffixlist
  .Op Fl I Ar ignorefile
! .Op Ar name
  .Sh DESCRIPTION
! .Nm error
  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,
***************
*** 88,94 ****
  or
  .Xr \&ed 1
  from standard places.
! .It Fl t
  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.
--- 88,94 ----
  or
  .Xr \&ed 1
  from standard places.
! .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.
***************
*** 106,130 ****
  Not too useful.
  .El
  .Pp
! .Nm Error
  looks at the error messages,
  either from the specified file
  .Ar name
  or from the standard input,
  and attempts to determine which
  language processor produced each error message,
! determines the source file and line number to which the error message refers,
! determines if the error message is to be ignored or not,
  and inserts the (possibly slightly modified) error message into
  the source file as a comment on the line preceding to which the
  line the error message refers.
  Error messages which can't be categorized by language processor
  or content are not inserted into any file,
  but are sent to the standard output.
! .Nm Error
  touches source files only after all input has been read.
  .Pp
! .Nm Error
  is intended to be run
  with its standard input
  connected via a pipe to the error message source.
--- 106,130 ----
  Not too useful.
  .El
  .Pp
! .Nm error
  looks at the error messages,
  either from the specified file
  .Ar name
  or from the standard input,
  and attempts to determine which
  language processor produced each error message,
! the source file and line number to which the error message refers,
! if the error message is to be ignored or not,
  and inserts the (possibly slightly modified) error message into
  the source file as a comment on the line preceding to which the
  line the error message refers.
  Error messages which can't be categorized by language processor
  or content are not inserted into any file,
  but are sent to the standard output.
! .Nm error
  touches source files only after all input has been read.
  .Pp
! .Nm error
  is intended to be run
  with its standard input
  connected via a pipe to the error message source.
***************
*** 143,149 ****
  .Xr make 1
  runs when making lint.
  .Pp
! .Nm Error
  knows about the error messages produced by:
  .Xr make 1 ,
  .Xr \&cc 1 ,
--- 143,149 ----
  .Xr make 1
  runs when making lint.
  .Pp
! .Nm error
  knows about the error messages produced by:
  .Xr make 1 ,
  .Xr \&cc 1 ,
***************
*** 157,182 ****
  .Xr f77 1 ,
  and
  .Em DEC Western Research Modula\-2 .
! .Nm Error
  knows a standard format for error messages produced by
  the language processors,
  so is sensitive to changes in these formats.
! For all languages except
! .Em Pascal ,
  error messages are restricted to be on one line.
  Some error messages refer to more than one line in more than
! one files;
  .Nm error
  will duplicate the error message and insert it at
  all of the places referenced.
  .Pp
! .Nm Error
  will do one of six things with error messages.
  .Bl -tag -width Em synchronize
  .It Em synchronize
  Some language processors produce short errors describing
  which file it is processing.
! .Nm Error
  uses these to determine the file name for languages that
  don't include the file name in each error message.
  These synchronization messages are consumed entirely by
--- 157,181 ----
  .Xr f77 1 ,
  and
  .Em DEC Western Research Modula\-2 .
! .Nm error
  knows a standard format for error messages produced by
  the language processors,
  so is sensitive to changes in these formats.
! For all languages except Pascal,
  error messages are restricted to be on one line.
  Some error messages refer to more than one line in more than
! one file;
  .Nm error
  will duplicate the error message and insert it at
  all of the places referenced.
  .Pp
! .Nm error
  will do one of six things with error messages.
  .Bl -tag -width Em synchronize
  .It Em synchronize
  Some language processors produce short errors describing
  which file it is processing.
! .Nm error
  uses these to determine the file name for languages that
  don't include the file name in each error message.
  These synchronization messages are consumed entirely by
***************
*** 189,195 ****
  libraries,
  .Pa /usr/libdata/lint/llib-lc
  and
! .Pa /usr/libdata/lint/llib-port
  are discarded,
  to prevent accidentally touching these libraries.
  Again, these error messages are consumed entirely by
--- 188,194 ----
  libraries,
  .Pa /usr/libdata/lint/llib-lc
  and
! .Pa /usr/libdata/lint/llib-port ,
  are discarded,
  to prevent accidentally touching these libraries.
  Again, these error messages are consumed entirely by
***************
*** 231,237 ****
  Other error messages are consumed entirely by
  .Nm error
  or are written to the standard output.
! .Nm Error
  inserts the error messages into the source file on the line
  preceding the line the language processor found in error.
  Each error message is turned into a one line comment for the
--- 230,236 ----
  Other error messages are consumed entirely by
  .Nm error
  or are written to the standard output.
! .Nm error
  inserts the error messages into the source file on the line
  preceding the line the language processor found in error.
  Each error message is turned into a one line comment for the
***************
*** 255,261 ****
  on the same line should be formatted
  so that language statements appear before comments.
  .Pp
! .Nm Error
  catches interrupt and terminate signals,
  and if in the insertion phase,
  will orderly terminate what it is doing.
--- 254,260 ----
  on the same line should be formatted
  so that language statements appear before comments.
  .Pp
! .Nm error
  catches interrupt and terminate signals,
  and if in the insertion phase,
  will orderly terminate what it is doing.
***************
*** 277,283 ****
  .Sh AUTHOR
  Robert Henry
  .Sh BUGS
- .Pp
  Opens the teletype directly to do user querying.
  .Pp
  Source files with links make a new copy of the file with
--- 276,281 ----
***************
*** 288,294 ****
  .Nm error
  to not understand the error message.
  .Pp
! .Nm Error ,
  since it is purely mechanical,
  will not filter out subsequent errors caused by `floodgating'
  initiated by one syntactically trivial error.
--- 286,292 ----
  .Nm error
  to not understand the error message.
  .Pp
! .Nm error ,
  since it is purely mechanical,
  will not filter out subsequent errors caused by `floodgating'
  initiated by one syntactically trivial error.
***************
*** 299,307 ****
  the point of error is also disturbed by
  .Nm error .
  .Pp
! .Nm Error
  was designed for work on
! .Tn CRT Ns 's
  at reasonably high speed.
  It is less pleasant on slow speed terminals, and has never been
  used on hardcopy terminals.
--- 297,305 ----
  the point of error is also disturbed by
  .Nm error .
  .Pp
! .Nm error
  was designed for work on
! .Tn CRT Ns s
  at reasonably high speed.
  It is less pleasant on slow speed terminals, and has never been
  used on hardcopy terminals.