diff options
author | Nick Clifton <nickc@redhat.com> | 2016-01-20 16:21:34 +0000 |
---|---|---|
committer | Nick Clifton <nickc@redhat.com> | 2016-01-20 16:21:34 +0000 |
commit | 72e0b2547dfcc466751ee4c5daf113d533140f66 (patch) | |
tree | 70d26afb8229fcce34e6c35cc03053e8acd3dbc5 /gas/doc | |
parent | fdbd3e95ee4b35c9b3f61cab71f339513ca326dc (diff) | |
download | gdb-72e0b2547dfcc466751ee4c5daf113d533140f66.zip gdb-72e0b2547dfcc466751ee4c5daf113d533140f66.tar.gz gdb-72e0b2547dfcc466751ee4c5daf113d533140f66.tar.bz2 |
Upda the documentation on assembler error message generation.
PR 19499
* doc/as.texinfo (Errors): Correct documentation describing the
interaction of .file and .line with warning and error messages.
Diffstat (limited to 'gas/doc')
-rw-r--r-- | gas/doc/as.texinfo | 35 |
1 files changed, 27 insertions, 8 deletions
diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo index efb7f46..aede5d3 100644 --- a/gas/doc/as.texinfo +++ b/gas/doc/as.texinfo @@ -2043,23 +2043,42 @@ file_name:@b{NNN}:Warning Message Text @end smallexample @noindent -@cindex line numbers, in warnings/errors -(where @b{NNN} is a line number). If a logical file name has been given -(@pxref{File,,@code{.file}}) it is used for the filename, otherwise the name of -the current input file is used. If a logical line number was given +@cindex file names and line numbers, in warnings/errors +(where @b{NNN} is a line number). If both a logical file name +(@pxref{File,,@code{.file}}) and a logical line number @ifset GENERIC (@pxref{Line,,@code{.line}}) @end ifset -then it is used to calculate the number printed, -otherwise the actual line in the current source file is printed. The -message text is intended to be self explanatory (in the grand Unix -tradition). +have been given then they will be used, otherwise the file name and line number +in the current assembler source file will be used. The message text is +intended to be self explanatory (in the grand Unix tradition). + +Note the file name must be set via the logical version of the @code{.file} +directive, not the DWARF2 version of the @code{.file} directive. For example: + +@smallexample + .file 2 "bar.c" + error_assembler_source + .file "foo.c" + .line 30 + error_c_source +@end smallexample + +produces this output: + +@smallexample + Assembler messages: + asm.s:2: Error: no such instruction: `error_assembler_source' + foo.c:31: Error: no such instruction: `error_c_source' +@end smallexample @cindex format of error messages Error messages have the format + @smallexample file_name:@b{NNN}:FATAL:Error Message Text @end smallexample + The file name and line number are derived as for warning messages. The actual message text may be rather less explanatory because many of them aren't supposed to happen. |