annotate runtime/tools/ccfilter_README.txt @ 9038:515717037fc1

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