This is the mail archive of the binutils@sourceware.org mailing list for the binutils project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[committed] Relocate slipped paragraph in objcopy docs.


    Hi all,

  Some new paragraphs got inserted between the docs for --only-keep-debug and
its usage example at some point in the past, as reported just now on the
cygwin list(*).  I committed the attached trivial patch to relocate the
paragraph up to where it belongs.

binutils/ChangeLog:

	* doc/binutils.texi (--only-keep-debug): Relocate stray para here ...
	(--subsystem): ... from here.


  Tested by "make info dvi html pdf" and manual inspection of the generated
files on i686-pc-cygwin.

    cheers,
      DaveK
-- 
(*) - http://cygwin.com/ml/cygwin/2009-08/msg00816.html
Index: binutils/doc/binutils.texi
===================================================================
RCS file: /cvs/src/src/binutils/doc/binutils.texi,v
retrieving revision 1.151
diff -p -u -r1.151 binutils.texi
--- binutils/doc/binutils.texi	23 Jul 2009 13:00:26 -0000	1.151
+++ binutils/doc/binutils.texi	27 Aug 2009 14:49:51 -0000
@@ -1553,6 +1553,39 @@ distribution and the second a debugging 
 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 val
 @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:

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]