summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCharles Crayne <chuck@thor.crayne.org>2007-10-24 15:30:17 -0700
committerCharles Crayne <chuck@thor.crayne.org>2007-10-24 15:30:17 -0700
commit650dc9d004ce3db685d68f20a38a174aa1408145 (patch)
treeea8af530dccd3fac572728e0698e9ac4c88420e8
parentf6816b25bf1c4852765a15564df3bc6a5081dfe1 (diff)
downloadnasm-650dc9d004ce3db685d68f20a38a174aa1408145.tar.gz
Update sections about debug info formats
-rw-r--r--doc/nasmdoc.src16
1 files changed, 12 insertions, 4 deletions
diff --git a/doc/nasmdoc.src b/doc/nasmdoc.src
index 66eaf10c..02cd8af3 100644
--- a/doc/nasmdoc.src
+++ b/doc/nasmdoc.src
@@ -537,8 +537,8 @@ of this switch does \e{not} enable output of the selected debug info format.
Use \c{-g}, see \k{opt-g}, to enable output.
A complete list of the available debug file formats for an output format
-can be seen by issuing the command \i\c{nasm -f <format> -y}. (only
-"borland" in "-f obj", as of 0.98.35, but "watch this space")
+can be seen by issuing the command \i\c{nasm -f <format> -y}. (As of 0.99.05,
+only "-f elf32", "-f elf64", "-f ieee", and "-f obj" provide debug information.)
See: \k{opt-y}.
This should not be confused with the "-f dbg" output format option which
@@ -862,8 +862,8 @@ You will need the version number if you report a bug.
Typing \c{nasm -f <option> -y} will display a list of the available
debug info formats for the given output format. The default format
-is indicated by an asterisk. E.g. \c{nasm -f obj -y} yields \c{* borland}.
-(as of 0.98.35, the \e{only} debug info format implemented).
+is indicated by an asterisk. E.g. \c{nasm -f elf -y} yields \c{* stabs}.
+(as of 0.99.05, the \e{only} debug info format implemented for this output format).
\S{opt-pfix} The \i\c{--prefix} and \i\c{--postfix} Options.
@@ -4578,6 +4578,14 @@ be linked as ELF using GNU \c{ld}. If NASM is used with the
\c{-w+gnu-elf-extensions} option, a warning is issued when one of
these relocations is generated.
+\S{elfdbg} Debug formats and ELF
+\I{ELF, Debug formats and}
+
+\c{ELF32} and \c{ELF64} provide debug information in \c{STABS} format.
+As of 0.99.05, this information is generated only for the ".text" section.
+However, in more recent versions, all executable sections are included.
+(Note that only the ".text" section is executable by default.)
+
\H{aoutfmt} \i\c{aout}: Linux \I{a.out, Linux version}\I{linux, a.out}\c{a.out} Object Files
The \c{aout} format generates \c{a.out} object files, in the form used