1COMPILING AND INSTALLING:
2=========================
3
4To compile ccfilter, you can just do a plain:
5    cc ccfilter.c -o ccfilter
6Though, it may be wise to have your default compiler defined,
7so you would normally compile it with one of the following:
8    cc -D_GCC     ccfilter.c -o ccfilter
9    cc -D_AIX     ccfilter.c -o ccfilter
10    cc -D_ATT     ccfilter.c -o ccfilter
11    cc -D_IRIX    ccfilter.c -o ccfilter
12    cc -D_SOLARIS ccfilter.c -o ccfilter
13    cc -D_HPUX    ccfilter.c -o ccfilter
14You can then copy ccfilter to its target destination (i.e: /usr/local/bin).
15The man page ccfilter.1 has to be copied to somewhere in your MANPATH,
16under a man1 directory (i.e: /usr/local/man/man1).
17
18
19SUPPORTED COMPILERS/PORTING NOTES:
20==================================
21
22The supported formats for the different compilers are described below:
23In this section, meta-names are used as place-holders in the line
24formats: <FILE> <ROW> <COL> <SEVERITY> <REASON> <>
25The <> denotes ignored text.
26Line formats are delimited by the ^ (caret) symbol.
27
280)  Special case: "gmake directory change" lines:
29    Lines with a format like:
30      ^gmake[<NUM>]: Entering directory `<DIR>'^
31    are used to follow the directory changes during the make process,
32    providing in the <FILE> part, a relative (if possible) directory
33    path to the erroneous file.
34
35
361)  GCC:
37    Recognized lines are of the format:
38    - ^In file included from <FILE>:<ROW>:^
39      Line following this one is used as <REASON>
40      <SEVERITY> is always 'e' (error)
41      <COL> is always '0'
42
43    - ^<FILE>:<ROW>:<REASON>^
44      <SEVERITY> is always 'e' (error)
45      <COL> is always '0'
46
47
482)  AIX:
49    Recognized lines are of the format:
50    - ^"<FILE>", line <ROW>.<COL>: <> (<SEVERITY>) <REASON>",
51
52
533)  HPUX:
54    Recognized lines are of the format:
55    - ^cc: "<FILE>", line <ROW>: <SEVERITY>: <REASON>^
56      <COL> is always '0'
57
58
594)  SOLARIS:
60    Recognized lines are of the format:
61    - ^"<FILE>", line <ROW>: warning: <REASON>^
62      This assumes <SEVERITY> is "W"
63      <COL> is always '0'
64
65    - ^"<FILE>", line <ROW>: <REASON>^
66      This assumes <SEVERITY> is "E"
67      <COL> is always '0'
68
69
705)  ATT / NCR:
71    Recognized lines are of the format:
72    - ^<SEVERITY> "<FILE>",L<ROW>/C<COL><>:<REASON>^
73			 or
74    - ^<SEVERITY> "<FILE>",L<ROW>/C<COL>:<REASON>^
75      Following lines beginning with a pipe (|) are continuation
76      lines, and are therefore appended to the <REASON>
77
78    - ^<SEVERITY> "<FILE>",L<ROW>:<REASON>^
79      <COL> is '0'
80      Following lines beginning with a pipe (|) are continuation
81      lines, and are therefore appended to the <REASON>
82
83
846)  SGI-IRIX:
85    Recognized lines are of the format:
86    - ^cfe: <SEVERITY>: <FILE>: <ROW>: <REASON>^
87			 or
88      ^cfe: <SEVERITY>: <FILE>, line <ROW>: <REASON>^
89      Following lines beginning with a dash (-) are "column-bar"
90      that end with a caret in the column of the error. These lines
91      are analyzed to generate the <COL>.
92