FreeChainXenon/binutils-gdb
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

1999-10-08 Ben Elliston <bje@cygnus.com>

Browse source 
* binutils.texi: Some rewording and clarifications.
This commit is contained in:
Ian Lance Taylor 1999-10-08 13:56:33 +00:00
parent 0af9979518
commit f20a759a4d
2 changed files with 19 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
binutils/ChangeLog
View file

@ -1,3 +1,7 @@
1999-10-08 Ben Elliston <bje@cygnus.com>
* binutils.texi: Some rewording and clarifications.
1999-09-15 Ulrich Drepper <drepper@cygnus.com> 1999-09-15 Ulrich Drepper <drepper@cygnus.com>
* readelf.c (dynamic_segment_parisc_val): Print 0 for DLD_FLAGS if * readelf.c (dynamic_segment_parisc_val): Print 0 for DLD_FLAGS if

29
binutils/binutils.texi
View file

@ -641,7 +641,7 @@ nm [ -a | --debug-syms ] [ -g | --extern-only ]
@end smallexample @end smallexample
@sc{gnu} @code{nm} lists the symbols from object files @var{objfile}@dots{}. @sc{gnu} @code{nm} lists the symbols from object files @var{objfile}@dots{}.
If no object files are listed as arguments, @code{nm} assumes If no object files are listed as arguments, @code{nm} assumes the file
@file{a.out}. @file{a.out}.
For each symbol, @code{nm} shows: For each symbol, @code{nm} shows:
@ -731,7 +731,7 @@ equivalent.
@cindex input file name @cindex input file name
@cindex file name @cindex file name
@cindex source file name @cindex source file name
Precede each symbol by the name of the input file (or archive element) Precede each symbol by the name of the input file (or archive member)
in which it was found, rather than identifying the input file once only, in which it was found, rather than identifying the input file once only,
before all of its symbols. before all of its symbols.
@ -908,12 +908,12 @@ the load address of the lowest section copied into the output file.
When generating an S-record or a raw binary file, it may be helpful to When generating an S-record or a raw binary file, it may be helpful to
use @samp{-S} to remove sections containing debugging information. In use @samp{-S} to remove sections containing debugging information. In
some cases @samp{-R} will be useful to remove sections which contain some cases @samp{-R} will be useful to remove sections which contain
information which is not needed by the binary file. information that is not needed by the binary file.
@table @code @table @code
@item @var{infile} @item @var{infile}
@itemx @var{outfile} @itemx @var{outfile}
The source and output files, respectively. The input and output files, respectively.
If you do not specify @var{outfile}, @code{objcopy} creates a If you do not specify @var{outfile}, @code{objcopy} creates a
temporary file and destructively renames the result with temporary file and destructively renames the result with
the name of @var{infile}. the name of @var{infile}.
@ -1024,7 +1024,7 @@ done by increasing the size of the last section. The extra space is
filled in with the value specified by @samp{--gap-fill} (default zero). filled in with the value specified by @samp{--gap-fill} (default zero).
@item --set-start @var{val} @item --set-start @var{val}
Set the address of the new file to @var{val}. Not all object file Set the start address of the new file to @var{val}. Not all object file
formats support setting the start address. formats support setting the start address.
@item --change-start @var{incr} @item --change-start @var{incr}
@ -1465,6 +1465,7 @@ The @sc{gnu} @code{ranlib} program is another form of @sc{gnu} @code{ar}; runnin
@table @code @table @code
@item -v @item -v
@itemx -V @itemx -V
@itemx --version
Show the version number of @code{ranlib}. Show the version number of @code{ranlib}.
@end table @end table
@ -1508,7 +1509,7 @@ Berkeley's.
Here is an example of the Berkeley (default) format of output from Here is an example of the Berkeley (default) format of output from
@code{size}: @code{size}:
@smallexample @smallexample
size --format=Berkeley ranlib size $ size --format=Berkeley ranlib size
text data bss dec hex filename text data bss dec hex filename
294880 81920 11592 388392 5ed28 ranlib 294880 81920 11592 388392 5ed28 ranlib
294880 81920 11888 388688 5ee50 size 294880 81920 11888 388688 5ee50 size
@ -1518,7 +1519,7 @@ text data bss dec hex filename
This is the same data, but displayed closer to System V conventions: This is the same data, but displayed closer to System V conventions:
@smallexample @smallexample
size --format=SysV ranlib size $ size --format=SysV ranlib size
ranlib : ranlib :
section size addr section size addr
.text 294880 8192 .text 294880 8192
@ -1859,7 +1860,7 @@ information in the executable to figure out which file name and line
number are associated with a given address. number are associated with a given address.
The executable to use is specified with the @code{-e} option. The The executable to use is specified with the @code{-e} option. The
default is @file{a.out}. default is the file @file{a.out}.
@code{addr2line} has two modes of operation. @code{addr2line} has two modes of operation.
@ -2551,9 +2552,9 @@ Some sample values are: @samp{a.out-hp300bsd}, @samp{ecoff-littlemips},
@samp{a.out-sunos-big}. @samp{a.out-sunos-big}.
You can also specify a target using a configuration triplet. This is You can also specify a target using a configuration triplet. This is
the same sort of name that is passed to configure to specify a target. the same sort of name that is passed to @file{configure} to specify a
When you use a configuration triplet as an argument, it must be fully target. When you use a configuration triplet as an argument, it must be
canonicalized. You can see the canonical version of a triplet by fully canonicalized. You can see the canonical version of a triplet by
running the shell script @file{config.sub} which is included with the running the shell script @file{config.sub} which is included with the
sources. sources.
@ -2897,7 +2898,7 @@ not notice unless it is glaringly wrong. You might as well not give us
a chance to make a mistake. a chance to make a mistake.
Even if the problem you experience is a fatal signal, you should still Even if the problem you experience is a fatal signal, you should still
say so explicitly. Suppose something strange is going on, such as, your say so explicitly. Suppose something strange is going on, such as your
copy of the utility is out of synch, or you have encountered a bug in copy of the utility is out of synch, or you have encountered a bug in
the C library on your system. (This has happened!) Your copy might the C library on your system. (This has happened!) Your copy might
crash and ours would not. If you told us to expect a crash, then when crash and ours would not. If you told us to expect a crash, then when
@ -2909,8 +2910,8 @@ to draw any conclusion from our observations.
If you wish to suggest changes to the source, send us context diffs, as If you wish to suggest changes to the source, send us context diffs, as
generated by @code{diff} with the @samp{-u}, @samp{-c}, or @samp{-p} generated by @code{diff} with the @samp{-u}, @samp{-c}, or @samp{-p}
option. Always send diffs from the old file to the new file. If you option. Always send diffs from the old file to the new file. If you
even discuss something in the @code{ld} source, refer to it by context, wish to discuss something in the @code{ld} source, refer to it by
not by line number. context, not by line number.
The line numbers in our development sources will not match those in your The line numbers in our development sources will not match those in your
sources. Your line numbers would convey no useful information to us. sources. Your line numbers would convey no useful information to us.