NAME

a.error − analyze and disperse error messages

FORMAT

a.error [options] [error_file]

DESCRIPTION

 
a.error is generally called from the ada command, but it can also be used separately.  a.error analyzes and optionally disperses diagnostic error messages produced by the VADS compiler. It looks at the specified error file or the standard input, determines the source file and line number to which the error refers, determines whether the error is to be ignored or not, and outputs the associated source line followed by the error line(s). 
 
a.error will also insert the error lines into the source file and invoke the vi(1) editor if the -v option is given. Error lines placed into files this way are of two types.  The first gives the position of the error and the second identifies it. Multiple errors on a single line are referenced by sequential alphabetic characters. 
 

     subtype T is range 1..1f;
------------------^A                               ###
----------------------------^B                     ###
--### A: syntax error: "identifier" inserted
--### B: lexical error: deleted

 
Because all error lines are flagged with ###, the vi editor command :g/###/d can be used to delete them. However, any source lines containing ### will also be deleted; consequently, do not use ### in any source with which a.error -v may be used. 

OPTIONS

-e  editor (editor) Insert the error messages in the source file and invoke the specified editor. 

-l (listing) Produce a listing on the standard output. 

-N (no) No line numbers. 

-tnumber (tabs) Change tab default setting (8).  (No space between -t and the following digit.) 

-v (vi) Embed error messages in the source file and invoke vi. 

-W (warnings) Ignore warnings. 

DIAGNOSTICS

a.error produces diagnostics indicating ‘no errors’ if -v is used and no errors were detected and ‘no such file or directory’ if invoked with an invalid file name. 

SEE ALSO

ada(1)

BUGS

If the vi command :g/###/d is used, any source lines containing ### will also be deleted. Consequently, it is not advisable to use ### in any source with which a.error -v may be used. 
 
In the case of source files with multiple links, a.error creates a new copy of the file with only one link to it.