summaryrefslogtreecommitdiffstats
path: root/binutils/doc
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/doc
parent600b868636d607493c2c995cc6fc36454a91ca1e (diff)
downloadppe42-binutils-b96fec5e9946372e442ab5fac1e3af11f4cc48ad.tar.gz
ppe42-binutils-b96fec5e9946372e442ab5fac1e3af11f4cc48ad.zip
* doc/binutils.texi (--only-keep-debug): Relocate stray para here ...
(--subsystem): ... from here.
Diffstat (limited to 'binutils/doc')
-rw-r--r--binutils/doc/binutils.texi66
1 files changed, 33 insertions, 33 deletions
diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi
index a5856b2b12..6353fd1fd9 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:
OpenPOWER on IntegriCloud