Merge from emacs-23; up to 2010-06-08T03:06:47Z!dann@ics.uci.edu.
[bpt/emacs.git] / etc / compilation.txt
1 * Introduction -*-compilation-*- (Copyright information at end of file)
2
3 This shows the different kinds of messages compile recognizes by default and
4 how they are rendered. It is intended both to help you decide which matchers
5 you need and as a test of the matchers. Move the mouse over a colored part or
6 use `compilation-message-face', to see how much text was actually matched.
7
8 Note that the following example line should NOT be highlighted:
9 Compilation started at Sat Jul 8 15:19:25
10
11 The important part is the symbol(s) line at the beginning of each entry.
12 These are the symbols you can customize `compilation-error-regexp-alist' for,
13 to match the messages shown in that entry. A few complex cases have more than
14 one symbol, which should be selected together.
15
16
17 * Absoft FORTRAN 77 Compiler 3.1.3
18
19 symbol: absoft
20
21 Error on line 3 of t.f: Execution error unclassifiable statement
22 Line 45 of "foo.c": bloofle undefined
23 error on line 19 of fplot.f: spelling error?
24 warning on line 17 of fplot.f: data type is undefined for variable d
25
26
27 * Ada & Mpatrol (memory leak debugger)
28
29 symbol: ada
30
31 This matches only the end of line, the beginning is covered by GNU style.
32
33 foo.adb:61:11: [...] in call to size declared at foo.ads:11
34 0x8008621 main+16 at error.c:17
35
36
37 * IBM AIX PS/2 C version 1.1
38
39 symbol: aix
40
41 ****** Error number 140 in line 8 of file errors.c ******
42
43
44 * Ant Java: works at least for jikes and javac
45
46 symbol: ant
47
48 The regexps found on http://ant.apache.org/faq.html, and since integrated in
49 both Emacsen, were hairy. Why so many numbers for jikes -- is one a column
50 number?
51
52 [javac] /src/DataBaseTestCase.java:27: unreported exception ...
53 [javac] /src/DataBaseTestCase.java:49: warning: finally clause cannot complete normally
54 [jikes] foo.java:3:5:7:9: blah blah
55
56
57 * Bash v2
58
59 symbol: bash
60
61 a.sh: line 1: ls-l: command not found
62
63
64 * Borland C++, C++Builder
65
66 symbol: borland
67
68 Error ping.c 15: Unable to open include file 'sys/types.h'
69 Warning ping.c 68: Call to function 'func' with no prototype
70 Error E2010 ping.c 15: Unable to open include file 'sys/types.h'
71 Warning W1022 ping.c 68: Call to function 'func' with no prototype
72
73
74 * Caml & Python
75
76 symbol: caml
77
78 File "foobar.ml", lines 5-8, characters 20-155: blah blah
79 File "F:\ocaml\sorting.ml", line 65, characters 2-145:
80 Warning: this expression should have type unit.
81 File "/usr/share/gdesklets/display/TargetGauge.py", line 41, in add_children
82 File \lib\python\Products\PythonScripts\PythonScript.py, line 302, in _exec
83 File "/tmp/foo.py", line 10
84
85
86 * Apollo cc, 4.3BSD fc & IBM RS6000/AIX xlc compiler & Microtec mcc68k & GNAT (July 94)
87
88 symbol: comma
89
90 "foo.f", line 3: Error: syntax error near end of statement
91 "vvouch.c", line 19.5: 1506-046 (S) Syntax error.
92 "foo.c", line 32 pos 1; (E) syntax error; unexpected symbol: "lossage"
93 "foo.adb", line 2(11): warning: file name does not match ...
94 "src/swapping.c", line 30.34: 1506-342 (W) "/*" detected in comment.
95
96 * Cucumber
97
98 symbol: cucumber
99
100 Feature: This is an example for backtrace.
101
102 Scenario: undefined step # features/cucumber.feature:3
103 Given this is undefined # features/cucumber.feature:4
104
105 Scenario: assertion false (Test::Unit) # foo/bar.feature:6
106 Given this will generate 'assert false' # foo/bar.rb:1
107 <false> is not true. (Test::Unit::AssertionFailedError)
108 /home/gusev/.rvm/foo/bar.rb:48:in `assert_block'
109 /home/gusev/.rvm/foo/bar.rb:500:in `_wrap_assertion'
110 features/cucumber.feature:7:in `Given this will generate 'assert false''
111
112 Scenario: assertion false (RSpec) # foo/bar.feature:9
113 Given this will generate 'should be_true' # foo/bar.rb:5
114 expected true to be false (Spec::Expectations::ExpectationNotMetError)
115 ./foo/bar/baz.rb:6:in `/^this will generate 'should be_true'$/'
116 foo/bar.feature:10:in `Given this will generate 'should be_true''
117
118 Scenario: backtrace in step definition # foo/bar.feature:12
119 Given this will generate backtrace # foo/sbar.rb:9
120 (RuntimeError)
121 ./foo/bar.rb:10:in `/^this will generate backtrace$/'
122 foo/bar.feature:13:in `Given this will generate backtrace'
123
124 Failing Scenarios:
125 cucumber foo/cucumber.feature:6 # Scenario: assertion false (Test::Unit)
126 cucumber foo/cucumber.feature:9 # Scenario: assertion false (RSpec)
127 cucumber foo/cucumber.feature:12 # Scenario: backtrace in step definition
128 cucumber foo/cucumber.feature:15 # Scenario: deeep backtrace in step definition
129
130 5 scenarios (4 failed, 1 undefined)
131 5 steps (4 failed, 1 undefined)
132 0m0.007s
133
134 * EDG C/C++
135
136 symbol: edg-1 edg-2
137
138 build/intel/debug/../../../struct.cpp(42): error: identifier "foo" is undefined
139 build/intel/debug/../../../struct.cpp(44): warning #1011: missing return statement at end of ...
140 build/intel/debug/../../../iptr.h(302): remark #981: operands are evaluated in unspecified order
141 detected during ... at line 62 of "build/intel/debug/../../../trace.h"
142
143
144 * EPC F90 compiler
145
146 symbol: epc
147
148 Error 24 at (2:progran.f90) : syntax error
149
150
151 * Fortran checker
152
153 symbols: ftnchek
154
155 Dummy arg W in module SUBA line 8 file arrayclash.f is array
156 L4 used at line 55 file test/assign.f; never set
157 Warning near line 10 file arrayclash.f: Module contains no executable
158 Nonportable usage near line 31 col 9 file assign.f: mixed default and explicit
159
160
161 * IAR Systems C Compiler
162
163 symbol: iar
164
165 "foo.c",3 Error[32]: Error message
166 "foo.c",3 Warning[32]: Error message
167
168
169 * IBM C/C++ Tools 2.01
170
171 symbol: ibm
172
173 foo.c(2:0) : informational EDC0804: Function foo is not referenced.
174 foo.c(3:8) : warning EDC0833: Implicit return statement encountered.
175 foo.c(5:5) : error EDC0350: Syntax error.
176
177
178 * Ultrix MIPS RISC CC, DEC AXP OSF/1 cc, IRIX 5.2 & NAG Fortran
179
180 symbol: irix
181
182 ccom: Error: foo.c, line 2: syntax error
183 cc: Severe: /src/Python-2.3.3/Modules/_curses_panel.c, line 17: Cannot find file <panel.h> ...
184 cc: Info: foo.c, line 27: ...
185 cfe: Warning 712: foo.c, line 2: illegal combination of pointer and ...
186 cfe: Warning 600: xfe.c: 170: Not in a conditional directive while ...
187 /usr/lib/cmplrs/cc/cfe: Error: foo.c: 1: blah blah
188 /usr/lib/cmplrs/cc/cfe: warning: foo.c: 1: blah blah
189 foo bar: baz.f, line 27: ...
190
191
192 * Java Exception & Valgrind (memory debugger for x86 GNU/Linux)
193
194 symbol: java
195
196 Register 6 contains wrong type
197 at org.foo.ComponentGateway.doGet(ComponentGateway.java:172)
198 at javax.servlet.http.HttpServlet.service(HttpServlet.java:740)
199 ==1332== Invalid write of size 1
200 ==1332== at 0x4040743C: System::getErrorString() (../src/Lib/System.cpp:217)
201 ==1332== by 0x8008621: main (vtest.c:180)
202
203
204 * IBM jikes
205
206 symbols: jikes-file jikes-line
207
208 Jikes separates file names from the actual error messages. For visual
209 feedback the underline and the word "Error" on the 3rd line is fontified like
210 a file name would be.
211
212 Found 2 semantic errors compiling "../javax/swing/BorderFactory.java":
213
214 150. case '{':
215 <->
216 *** Error: The type of this expression, "char", is not ...
217
218 312. return new CompoundBorder(outside, inside);
219 <--------------------------------->
220 *** Error: No match was found for constructor ...
221
222 Issued 1 semantic warning compiling "java/awt/Toolkit.java":
223
224 504. void imgProduceImage( ImageNativeProducer prod, Ptr imgData);
225 <----------------->
226 *** Warning: The type "ImageNativeProducer" is defined ...
227
228
229 * GCC include message
230
231 symbol: gcc-include
232
233 The last file, i.e. the one you are compiling, is the interesting one.
234
235 In file included from /usr/include/c++/3.3/backward/warn.h:4,
236 from /usr/include/c++/3.3/backward/iostream.h:31:0,
237 from test_clt.cc:1:
238
239
240 * GNU style
241
242 symbol: gnu
243
244 foo.c:8: message
245 ../foo.c:8: W: message
246 /tmp/foo.c:8:warning message
247 foo/bar.py:8: FutureWarning message
248 foo.py:8: RuntimeWarning message
249 foo.c:8:I: message
250 foo.c:8.23: note: message
251 foo.c:8.23: info: message
252 foo.c:8:23:information: message
253 foo.c:8.23-45: Informational: message
254 foo.c:8-23: message
255 foo.c:8-45.3: message
256 foo.c:8.23-9.1: message
257 jade:dbcommon.dsl:133:17:E: missing argument for function call
258 G:/cygwin/dev/build-myproj.xml:54: Compiler Adapter 'javac' can't be found.
259 file:G:/cygwin/dev/build-myproj.xml:54: Compiler Adapter 'javac' can't be found.
260 {standard input}:27041: Warning: end of file not at end of a line; newline inserted
261
262
263 * Lucid Compiler, lcc 3.x
264
265 symbol: lcc
266
267 E, file.cc(35,52) Illegal operation on pointers
268 W, file.cc(36,52) blah blah
269
270
271 * makepp 1.20
272
273 symbol: makepp
274
275 makepp: Scanning `/foo/bar.c'
276 makepp: warning: bla bla `/foo/bar.c' and `/foo/bar.h'
277 makepp: bla bla `/foo/Makeppfile:12' bla
278 makepp: bla bla `/foo/bar.c' and `/foo/bar.h'
279
280
281 * maven 2.0.9
282
283 symbol: maven
284
285 FooBar.java:[111,53] no interface expected here
286
287
288 * MIPS lint; looks good for SunPro lint also
289
290 symbols: mips-1 mips-2
291
292 This can match multiple times on a line.
293
294 TrimMask (255) in solomon.c may be indistinguishable from TrimMasks (93) in solomon.c due to truncation
295 name defined but never used: LinInt in cmap_calc.c(199)
296
297
298 * Microsoft C/C++
299
300 symbol: msft
301
302 This used to be less selective and allowed characters other than parens around
303 the line number, but that caused confusion for GNU-style error messages. This
304 used to reject spaces and dashes in file names, but they are valid now; so I
305 made it more strict about the error message that follows.
306
307 keyboard handler.c(537) : warning C4005: 'min' : macro redefinition
308 d:\tmp\test.c(23) : error C2143: syntax error : missing ';' before 'if'
309 d:\tmp\test.c(1145) : see declaration of 'nsRefPtr'
310
311
312 * Open Watcom
313
314 symbol: watcom
315
316 ..\src\ctrl\lister.c(109): Error! E1009: Expecting ';' but found '{'
317 ..\src\ctrl\lister.c(120): Warning! W201: Unreachable code
318
319
320 * Oracle pro*c
321
322 symbol: oracle
323
324 This stupid precompiler wraps lines at column 80 in the middle of a file name.
325 There is no obvious way of detecting this or turning it off. But if you
326 delete the newline (probably needs M-x toggle-read-only), the file name will
327 automatically be reparsed, so that you can then go there.
328
329 Semantic error at line 528, column 5, file erosacqdb.pc:
330 Error at line 41, column 10 in file /usr/src/sb/ODBI_BHP.hpp
331 PCC-02150: error at line 49, column 27 in file /usr/src/sb/ODBI_dxfgh.pc
332 PCC-00003: invalid SQL Identifier at column name in line 12 of file /usr/src/sb/ODBI_BHP.hpp
333 PCC-00004: mismatched IF/ELSE/ENDIF block at line 27 in file /usr/src/sb/ODBI_BHP.hpp
334 PCC-02151: line 21 column 40 file /usr/src/sb/ODBI_BHP.hpp:
335
336
337 * Perl
338
339 symbol: perl
340
341 The second sample, from the Perl-Glib module, is a Glib message put
342 through Perl warn() to get "at FILENAME line N".
343
344 syntax error at automake line 922, near "':'"
345 Died at test.pl line 27.
346 store::odrecall('File_A', 'x2') called at store.pm line 90
347 (in cleanup) something bad at foo.pl line 3 during global destruction.
348
349 GLib-GObject-WARNING **: /build/buildd/glib2.0-2.14.5/gobject/gsignal.c:1741: instance `0x8206790' has no handler with id `1234' at t-compilation-perl-gtk.pl line 3.
350
351 * PHP
352
353 symbol: php
354
355 Parse error: parse error, unexpected $ in main.php on line 59
356 Fatal error: Call to undefined function: mysql_pconnect() in db.inc on line 66
357
358 * Ruby
359
360 symbol: ruby
361
362 plain-exception.rb:7:in `fun': unhandled exception
363 from plain-exception.rb:3:in `proxy'
364 from plain-exception.rb:12
365
366 * Ruby (Test::Unit)
367
368 symbol: ruby-Test::Unit
369
370 Loaded suite examples/test-unit
371 Started
372 FFFE
373 Finished in 0.023173 seconds.
374
375 1) Failure:
376 test_a_deep_assert(BacktracesTest)
377 [examples/test-unit.rb:28:in `here_is_a_deep_assert'
378 examples/test-unit.rb:19:in `test_a_deep_assert']:
379 <false> is not true.
380
381 2) Failure:
382 test_assert(BacktracesTest) [examples/test-unit.rb:5]:
383 <false> is not true.
384
385 3) Failure:
386 test_assert_raise(BacktracesTest) [examples/test-unit.rb:9]:
387 Exception raised:
388 Class: <RuntimeError>
389 Message: <"">
390 ---Backtrace---
391 examples/test-unit.rb:10:in `test_assert_raise'
392 examples/test-unit.rb:9:in `test_assert_raise'
393 ---------------
394
395 4) Error:
396 test_backtrace(BacktracesTest):
397 NoMethodError: undefined method `not_exists' for nil:NilClass
398 examples/test-unit.rb:24:in `some_function_call_from_nil'
399 examples/test-unit.rb:15:in `test_backtrace'
400
401 4 tests, 3 assertions, 3 failures, 1 errors
402
403 * RXP
404
405 symbol: rxp
406
407 GPL XML validator at http://www.cogsci.ed.ac.uk/~richard/rxp.html
408
409 Error: Mismatched end tag: expected </geroup>, got </group>
410 in unnamed entity at line 71 char 8 of file:///home/reto/test/group.xml
411 Warning: Start tag for undeclared element geroup
412 in unnamed entity at line 4 char 8 of file:///home/reto/test/group.xml
413
414
415 * Sparc Pascal
416
417 symbols: sparc-pascal-file sparc-pascal-line sparc-pascal-example
418
419 These messages don't contain a file name. Instead the compiler gives a
420 message whenever the file being compiled is changed. For visual feedback the
421 error code is fontified like a file name would be.
422
423 Thu May 14 10:46:12 1992 mom3.p:
424 20 linjer : array[1..4] of linje;
425 w 18480-----------^--- Inserted ';'
426 20 linjer : array[1..4] of linje;
427 e 18480-----------^--- Inserted ';'
428 w 18520 line 61 - 0 is undefined
429 E 18520 line 61 - 0 is undefined
430
431
432 * SGI IRIX MipsPro 7.3 & Sun F90 & Cray C
433
434 symbol: sun
435
436 cc-1020 CC: REMARK File = CUI_App.h, Line = 735
437 cc-1070 cc: WARNING File = linkl.c, Line = 38
438 cf90-113 f90comp: ERROR NSE, File = Hoved.f90, Line = 16, Column = 3
439
440
441 * Sun Ada (VADS, Solaris)
442
443 symbol: sun-ada
444
445 /home3/xdhar/rcds_rc/main.a, line 361, char 6:syntax error: "," inserted
446
447
448 * 4.3BSD grep, cc, lint
449
450 symbol: 4bsd
451
452 /usr/src/foo/foo.c(8): warning: w may be used before set
453 /usr/src/foo/foo.c(9): error: w is used before set
454 strcmp: variable # of args. llib-lc(359) :: /usr/src/foo/foo.c(8)
455 bloofle defined( /users/wolfgang/foo.c(4) ), but never used
456
457
458 * GCOV (test coverage program)
459
460 symbol: gcov-file gcov-bb-file gcov-never-called-line gcov-called-line
461
462 -: 0:Source:foo.c
463 -: 0:Object:foo.bb
464 -: 1:/* $ gcc -fprofile-arcs -ftest-coverage foo.c
465 -: 2: $ ./a.out
466 -: 3: $ gcov foo.c
467 -: 4: LANG=C gcov foo.c
468 -: 5: 62.50% of 8 lines executed in file foo.c
469 -: 6: Creating foo.c.gcov.*/
470 -: 7:int
471 -: 8:main(int argc, char ** argv)
472 1: 9:{
473 1: 10: int r;
474 1: 11: if (argc == 1)
475 1: 12: r = 1;
476 #####: 13: else if (argc == 2)
477 #####: 14: r = 2;
478 -: 15: else
479 #####: 16: r = 0;
480 1: 17: return r;
481 -: 18:}
482
483
484 * Podchecker error messages, per Pod::Checker
485
486 symbol: perl--Pod::Checker
487
488 *** ERROR: Spurious text after =cut at line 193 in file foo.pm
489 *** ERROR: =over on line 37 without closing =back at line EOF in file bar.pm
490 *** ERROR: =over on line 1 without closing =back (at head1) at line 3 in file x.pod
491
492
493 * Perl Test module error messages
494
495 symbol: perl--Test
496
497 # Failed test 1 in foo.t at line 6
498
499
500 * Perl Test::Harness output
501
502 symbol: perl--Test::Harness
503
504 NOK 1# Test 1 got: "1234" (t/foo.t at line 46)
505
506
507 * Perl HTML::Lint::Error::as_string()
508
509 symbol: weblint
510
511 index.html (13:1) Unknown element <fdjsk>
512
513
514 * Directory tracking
515
516 Directories are matched via `compilation-directory-matcher'. Files which are
517 not shown as full paths are searched for relative to the directory where the
518 message was issued.
519
520 Entering directory `/a/b/c'
521 Leaving directory `/a/b/c'
522 gmake[2]: Entering directory `/a/b/c'
523 makepp: Leaving directory `/a/b/c'
524
525
526 * Miscellaneous
527
528 These are not messages that can be gone to. They are only highlighted via
529 `compilation-mode-font-lock-keywords' to recognize some useful information at
530 a glance.
531
532 checking dynamic linker characteristics... GNU/Linux ld.so
533 checking if libtool supports shared libraries... yes
534 checking whether to build shared libraries... yes
535 checking whether -lc should be explicitly linked in... (cached) no
536 checking For GLIB - version >= 2.0.0... yes (version 2.1.0)
537 checking FONTCONFIG_CFLAGS...
538 g++ -o foo.o foo.cc
539 tool1 -output=foo foo.x
540 tool2 --outfile foo foo.y
541
542 Compilation started at Wed Jul 20 12:20:10
543 Compilation interrupt at Wed Jul 20 12:20:10
544 Compilation killed at Wed Jul 20 12:20:10
545 Compilation terminated at Wed Jul 20 12:20:10
546 Compilation exited abnormally with code 1 at Wed Jul 20 12:21:12
547 Compilation segmentation fault at Thu Jul 13 10:55:49
548 Compilation finished at Thu Jul 21 15:02:15
549
550 \f
551 Copyright (C) 2004-2011 Free Software Foundation, Inc.
552
553 COPYING PERMISSIONS:
554
555 This document is free software: you can redistribute it and/or modify
556 it under the terms of the GNU General Public License as published by
557 the Free Software Foundation, either version 3 of the License, or
558 (at your option) any later version.
559
560 This program is distributed in the hope that it will be useful,
561 but WITHOUT ANY WARRANTY; without even the implied warranty of
562 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
563 GNU General Public License for more details.
564
565 You should have received a copy of the GNU General Public License
566 along with this program. If not, see <http://www.gnu.org/licenses/>.