src/usr.bin/error/error.1 - diff

Return to error.1 CVS log

Up to [local] / src / usr.bin / error

Diff for /src/usr.bin/error/Attic/error.1 between version 1.7 and 1.8

version 1.7, 1999/07/04 11:53:53

version 1.8, 1999/12/04 19:04:52

Line 50

.Op Fl I Ar ignorefile

.Op Ar name

.Sh DESCRIPTION

The

.Nm

analyzes and optionally disperses the diagnostic error messages

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

Options are:

The options are as follows:

.Bl -tag -width Ds

.It Fl n

Line 69

Line 70

The user is

.Ar queried

whether s/he wants to touch the file.

A ``y'' or ``n'' to the question is necessary to continue.

.Sq y

.Sq n

to the question is necessary to continue.

Absence of the

.Fl q

option implies that all referenced files

Line 91

Line 96

.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.

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 ``.c'', ``.y'', ``.foo*'' and ``.h''.

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

Line 146

Line 160

.Nm

knows about the error messages produced by:

.Xr make 1 ,

.Xr \&cc 1 ,

.Xr cc 1 ,

.Xr cpp 1 ,

.Xr ccom 1 ,

.Xr \&as 1 ,

.Xr as 1 ,

.Xr \&ld 1 ,

.Xr ld 1 ,

.Xr lint 1 ,

.Xr \&pi 1 ,

.Xr pi 1 ,

.Xr \&pc 1 ,

.Xr pc 1 ,

.Xr f77 1 ,

and

.Em DEC Western Research Modula\-2 .

Line 236

Line 250

Each error message is turned into a one line comment for the

language,

and is internally flagged

with the string ``###'' at

with the string

the beginning of the error,

.Dq ###

and ``%%%'' at the end of the error.

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

Line 288

Line 305

.Pp

.Nm error ,

since it is purely mechanical,

will not filter out subsequent errors caused by `floodgating'

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 `\\' marking

(error puts them before). The alignment of the

the point of error is also disturbed by

.Sq \e

marking the point of error is also disturbed by

.Nm error .

.Pp

.Nm