aboutsummaryrefslogtreecommitdiff
path: root/gas/doc
diff options
context:
space:
mode:
authorNick Clifton <nickc@redhat.com>2003-10-08 14:37:20 +0000
committerNick Clifton <nickc@redhat.com>2003-10-08 14:37:20 +0000
commit05da4302188949f1752cb1fa5def4b010450dbe4 (patch)
tree8d257fbd257ce60a4a7969a65e74ec216d74df61 /gas/doc
parente62eb3ee7e4f8b4821b2f029d0f9d2dbbc462b44 (diff)
downloadfsf-binutils-gdb-05da4302188949f1752cb1fa5def4b010450dbe4.zip
fsf-binutils-gdb-05da4302188949f1752cb1fa5def4b010450dbe4.tar.gz
fsf-binutils-gdb-05da4302188949f1752cb1fa5def4b010450dbe4.tar.bz2
* as.c (use_gnu_debug_info_extensions) : New variable.
(parse_args) : Accept new --gstabs+ option, and set `use_gnu_debug_info_extensions'. (show_usage) : Document --gstabs+ option. * as.h (use_gnu_debug_info_extensions) : New extern declaration. * stabs.c (stabs_generate_asm_file) : If `use_gnu_debug_info_extensions' is set add the compilation directory to the stabs debug info. * doc/as.texinfo : Document --gstabs+ option. * NEWS: Mention new feature.
Diffstat (limited to 'gas/doc')
-rw-r--r--gas/doc/as.texinfo13
1 files changed, 10 insertions, 3 deletions
diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo
index f7b4085..e9f5a5b 100644
--- a/gas/doc/as.texinfo
+++ b/gas/doc/as.texinfo
@@ -263,8 +263,8 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}.
@smallexample
@c man begin SYNOPSIS
@value{AS} [@b{-a}[@b{cdhlns}][=@var{file}]] [@b{-D}] [@b{--defsym} @var{sym}=@var{val}]
- [@b{-f}] [@b{--gstabs}] [@b{--gdwarf2}] [@b{--help}] [@b{-I} @var{dir}]
- [@b{-J}] [@b{-K}] [@b{-L}]
+ [@b{-f}] [@b{--gstabs}] [@b{--gstabs+}] [@b{--gdwarf2}] [@b{--help}]
+ [@b{-I} @var{dir}] [@b{-J}] [@b{-K}] [@b{-L}]
[@b{--listing-lhs-width}=@var{NUM}] [@b{--listing-lhs-width2}=@var{NUM}]
[@b{--listing-rhs-width}=@var{NUM}] [@b{--listing-cont-lines}=@var{NUM}]
[@b{--keep-locals}] [@b{-o} @var{objfile}] [@b{-R}] [@b{--statistics}] [@b{-v}]
@@ -514,6 +514,13 @@ compiler output).
Generate stabs debugging information for each assembler line. This
may help debugging assembler code, if the debugger can handle it.
+@item --gstabs+
+Generate stabs debugging information for each assembler line, with GNU
+extensions that probably only gdb can handle, and that could make other
+debuggers crash or refuse to read your program. This
+may help debugging assembler code. Currently the only GNU extension is
+the location of the current working directory at assembling time.
+
@item --gdwarf2
Generate DWARF2 debugging information for each assembler line. This
may help debugging assembler code, if the debugger can handle it. Note---this
@@ -4326,7 +4333,7 @@ in @sc{ieee} format.
@cindex @code{func} directive
@code{.func} emits debugging information to denote function @var{name}, and
is ignored unless the file is assembled with debugging enabled.
-Only @samp{--gstabs} is currently supported.
+Only @samp{--gstabs[+]} is currently supported.
@var{label} is the entry point of the function and if omitted @var{name}
prepended with the @samp{leading char} is used.
@samp{leading char} is usually @code{_} or nothing, depending on the target.