=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/error/Attic/error.1,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- src/usr.bin/error/Attic/error.1 1999/06/05 01:21:24 1.6 +++ src/usr.bin/error/Attic/error.1 1999/07/04 11:53:53 1.7 @@ -1,4 +1,4 @@ -.\" $OpenBSD: error.1,v 1.6 1999/06/05 01:21:24 aaron Exp $ +.\" $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 @@ -50,7 +50,7 @@ .Op Fl I Ar ignorefile .Op Ar name .Sh DESCRIPTION -.Nm error +.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, @@ -97,7 +97,7 @@ .Dl ".c.y.foo*.h" .Pp allows -.Nm error +.Nm to touch files ending with ``.c'', ``.y'', ``.foo*'' and ``.h''. .It Fl s Print out @@ -106,7 +106,7 @@ Not too useful. .El .Pp -.Nm error +.Nm looks at the error messages, either from the specified file .Ar name @@ -121,10 +121,10 @@ 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 +.Nm touches source files only after all input has been read. .Pp -.Nm error +.Nm is intended to be run with its standard input connected via a pipe to the error message source. @@ -143,7 +143,7 @@ .Xr make 1 runs when making lint. .Pp -.Nm error +.Nm knows about the error messages produced by: .Xr make 1 , .Xr \&cc 1 , @@ -157,7 +157,7 @@ .Xr f77 1 , and .Em DEC Western Research Modula\-2 . -.Nm error +.Nm knows a standard format for error messages produced by the language processors, so is sensitive to changes in these formats. @@ -165,17 +165,17 @@ 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 +.Nm will duplicate the error message and insert it at all of the places referenced. .Pp -.Nm error +.Nm 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 +.Nm 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 @@ -228,9 +228,9 @@ Only true error messages are candidates for inserting into the file they refer to. Other error messages are consumed entirely by -.Nm error +.Nm or are written to the standard output. -.Nm error +.Nm 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 @@ -254,7 +254,7 @@ on the same line should be formatted so that language statements appear before comments. .Pp -.Nm error +.Nm catches interrupt and terminate signals, and if in the insertion phase, will orderly terminate what it is doing. @@ -269,7 +269,7 @@ .El .Sh HISTORY The -.Nm error +.Nm command appeared in .Bx 4.0 . @@ -283,7 +283,7 @@ .Pp Changing a language processor's format of error messages may cause -.Nm error +.Nm to not understand the error message. .Pp .Nm error , @@ -297,7 +297,7 @@ the point of error is also disturbed by .Nm error . .Pp -.Nm error +.Nm was designed for work on .Tn CRT Ns s at reasonably high speed.