share/vim/vim73/tools/ccfilter_README.txt

   1 COMPILING AND INSTALLING:
   2 =========================
   3
   4 To compile ccfilter, you can just do a plain:
   5     cc ccfilter.c -o ccfilter
   6 Though, it may be wise to have your default compiler defined,
   7 so 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
  14 You can then copy ccfilter to it's target destination (i.e: /usr/local/bin).
  15 The man page ccfilter.1 has to be copied to somewhere in your MANPATH,
  16 under a man1 directory (i.e: /usr/local/man/man1).
  17
  18
  19 SUPPORTED COMPILERS/PORTING NOTES:
  20 ==================================
  21
  22 The supported formats for the different compilers are described below:
  23 In this section, meta-names are used as place-holders in the line
  24 formats: <FILE> <ROW> <COL> <SEVERITY> <REASON> <>
  25 The <> denotes ignored text.
  26 Line formats are delimited by the ^ (caret) symbol.
  27
  28 0)  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
  36 1)  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
  48 2)  AIX:
  49     Recognized lines are of the format:
  50     - ^"<FILE>", line <ROW>.<COL>: <> (<SEVERITY>) <REASON>",
  51
  52
  53 3)  HPUX:
  54     Recognized lines are of the format:
  55     - ^cc: "<FILE>", line <ROW>: <SEVERITY>: <REASON>^
  56       <COL> is always '0'
  57
  58
  59 4)  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
  70 5)  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
  84 6)  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>.