aboutsummaryrefslogtreecommitdiff
path: root/binutils
diff options
context:
space:
mode:
authorDave Korn <dave.korn@artimi.com>2009-08-27 14:58:08 +0000
committerDave Korn <dave.korn@artimi.com>2009-08-27 14:58:08 +0000
commitb96fec5e9946372e442ab5fac1e3af11f4cc48ad (patch)
tree135a1ae08a8b87504869fa0f39936d7a2ec5df61 /binutils
parent600b868636d607493c2c995cc6fc36454a91ca1e (diff)
downloadgdb-b96fec5e9946372e442ab5fac1e3af11f4cc48ad.zip
gdb-b96fec5e9946372e442ab5fac1e3af11f4cc48ad.tar.gz
gdb-b96fec5e9946372e442ab5fac1e3af11f4cc48ad.tar.bz2
* doc/binutils.texi (--only-keep-debug): Relocate stray para here ...
(--subsystem): ... from here.
Diffstat (limited to 'binutils')
-rw-r--r--binutils/ChangeLog5
-rw-r--r--binutils/doc/binutils.texi66
2 files changed, 38 insertions, 33 deletions
diff --git a/binutils/ChangeLog b/binutils/ChangeLog
index b939b6f..987d47f 100644
--- a/binutils/ChangeLog
+++ b/binutils/ChangeLog
@@ -1,3 +1,8 @@
+2009-08-27 Dave Korn <dave.korn.cygwin@gmail.com>
+
+ * doc/binutils.texi (--only-keep-debug): Relocate stray para here ...
+ (--subsystem): ... from here.
+
2009-08-24 Cary Coutant <ccoutant@google.com>
* objdump.c (find_symbol_for_address): Avoid costly call to
diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi
index a5856b2..6353fd1 100644
--- a/binutils/doc/binutils.texi
+++ b/binutils/doc/binutils.texi
@@ -1553,6 +1553,39 @@ distribution and the second a debugging information file which is only
needed if debugging abilities are required. The suggested procedure
to create these files is as follows:
+@enumerate
+@item Link the executable as normal. Assuming that is is called
+@code{foo} then...
+@item Run @code{objcopy --only-keep-debug foo foo.dbg} to
+create a file containing the debugging info.
+@item Run @code{objcopy --strip-debug foo} to create a
+stripped executable.
+@item Run @code{objcopy --add-gnu-debuglink=foo.dbg foo}
+to add a link to the debugging info into the stripped executable.
+@end enumerate
+
+Note---the choice of @code{.dbg} as an extension for the debug info
+file is arbitrary. Also the @code{--only-keep-debug} step is
+optional. You could instead do this:
+
+@enumerate
+@item Link the executable as normal.
+@item Copy @code{foo} to @code{foo.full}
+@item Run @code{objcopy --strip-debug foo}
+@item Run @code{objcopy --add-gnu-debuglink=foo.full foo}
+@end enumerate
+
+i.e., the file pointed to by the @option{--add-gnu-debuglink} can be the
+full executable. It does not have to be a file created by the
+@option{--only-keep-debug} switch.
+
+Note---this switch is only intended for use on fully linked files. It
+does not make sense to use it on object files where the debugging
+information may be incomplete. Besides the gnu_debuglink feature
+currently only supports the presence of one filename containing
+debugging information, not multiple filenames on a one-per-object-file
+basis.
+
@item --file-alignment @var{num}
Specify the file alignment. Sections in the file will always begin at
file offsets which are multiples of this number. This defaults to
@@ -1596,39 +1629,6 @@ the subsystem version also. Numeric values are also accepted for
@var{which}.
[This option is specific to PE targets.]
-@enumerate
-@item Link the executable as normal. Assuming that is is called
-@code{foo} then...
-@item Run @code{objcopy --only-keep-debug foo foo.dbg} to
-create a file containing the debugging info.
-@item Run @code{objcopy --strip-debug foo} to create a
-stripped executable.
-@item Run @code{objcopy --add-gnu-debuglink=foo.dbg foo}
-to add a link to the debugging info into the stripped executable.
-@end enumerate
-
-Note---the choice of @code{.dbg} as an extension for the debug info
-file is arbitrary. Also the @code{--only-keep-debug} step is
-optional. You could instead do this:
-
-@enumerate
-@item Link the executable as normal.
-@item Copy @code{foo} to @code{foo.full}
-@item Run @code{objcopy --strip-debug foo}
-@item Run @code{objcopy --add-gnu-debuglink=foo.full foo}
-@end enumerate
-
-i.e., the file pointed to by the @option{--add-gnu-debuglink} can be the
-full executable. It does not have to be a file created by the
-@option{--only-keep-debug} switch.
-
-Note---this switch is only intended for use on fully linked files. It
-does not make sense to use it on object files where the debugging
-information may be incomplete. Besides the gnu_debuglink feature
-currently only supports the presence of one filename containing
-debugging information, not multiple filenames on a one-per-object-file
-basis.
-
@item --extract-symbol
Keep the file's section flags and symbols but remove all section data.
Specifically, the option: