Package: binutils
Version: 2.15-5
The manpage for objcopy renders contains this section:
> --only-keep-debug
> Strip a file, removing any sections that would be stripped
> by --strip-debug and leaving the debugging sections.
>
> The intention is that this option will be used in
> conjunction with --add-gnu-debuglink to create a two part
> executable. One a stripped binary which will occupy less
> space in RAM and in a 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:
>
> 1.<Link the executable as normal. Assuming that is is called>
> "foo" then...
>
> 1.<Run "objcopy --only-keep-debug foo foo.dbg" to>
> create a file containing the debugging info.
>
> 1.<Run "objcopy --strip-debug foo" to create a>
> stripped executable.
>
> 1.<Run "objcopy --add-gnu-debuglink=foo.dbg foo">
> to add a link to the debugging info into the stripped
> executable.
>
> Note - the choice of ".dbg" as an extension for the debug
> info file is arbitrary. Also the "--only-keep-debug" step is
> optional. You could instead do this:
>
> 1.<Link the executable as normal.>
> 1.<Copy "foo" to "foo.full">
> 1.<Run "objcopy --strip-debug foo">
> 1.<Run "objcopy --add-gnu-debuglink=foo.full foo">
>
> ie the file pointed to by the --add-gnu-debuglink can be the
> full executable. It does not have to be a file created by
> the --only-keep-debug switch.
The lists are broken in that they have several first items and that the first
line, although nothing special, is still put in angled brackets. Should be
obvious, right?
The first typo is in the first list the first item, there it should probably
be '..assuming it is called "foo"...'. The second one is the spelling of
'i.e.' in the last paragraph. Although I'm not 100% sure this is not the
right way, it is at least inconsistent with another occurence in the same
manpage.
A last thing is the introductory sentence:
> Strip a file, removing any sections that would be stripped
> by --strip-debug and leaving the debugging sections.
Isn't that simply contradictory and wrong? I'd rather say
Strip a file, leaving only the sections that would be stripped by
--strip-debug.
cheers
Uli
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
