* binutils.texinfo: minor typos, phrasing, formatting fixes.
This commit is contained in:
Roland Pesch
parent
ee17cac9c6
commit
c9629e6eac
@ -1,3 +1,7 @@
|
||||
Tue Oct 8 16:55:03 1991 Roland H. Pesch (pesch at cygnus.com)
|
||||
|
||||
* binutils.texinfo: minor typos, phrasing, formatting fixes.
|
||||
|
||||
Tue Oct 8 15:13:20 1991 Per Bothner (bothner at cygnus.com)
|
||||
|
||||
* configure.in: Get host file from ../bfd/config, not config.
|
||||
|
||||
@ -119,7 +119,7 @@ are most often used as @dfn{libraries} holding commonly needed
|
||||
subroutines.
|
||||
|
||||
@code{ar} will create an index to the symbols defined in relocatable
|
||||
object modules in the archive when you specify the option @samp{s}.
|
||||
object modules in the archive when you specify the modifier @samp{s}.
|
||||
Once created, this index is updated in the archive whenever @code{ar}
|
||||
makes a change to its contents. An archive with such an index speeds up
|
||||
linking to the library, and allows routines in the library to call each
|
||||
@ -138,8 +138,8 @@ keyletters specifying @emph{modifiers}), and the archive name to act on.
|
||||
Most operations can also accept further @var{files} arguments,
|
||||
specifying particular files to operate on.
|
||||
|
||||
GNU @code{ar} allows you to mix the operation code and modifier flags in
|
||||
any order, within the first command-line argument.
|
||||
GNU @code{ar} allows you to mix the operation code @var{p} and modifier
|
||||
flags @var{mod} in any order, within the first command-line argument.
|
||||
|
||||
If you wish, you may prefix the first command-line argument with a
|
||||
dash.
|
||||
@ -153,7 +153,7 @@ any of the following, but you must specify only one of them:
|
||||
be deleted as @var{files}; the archive is untouched if you
|
||||
specify no files to delete.
|
||||
|
||||
If you specify the @samp{v} option flag, @code{ar} will list each module
|
||||
If you specify the @samp{v} modifier, @code{ar} will list each module
|
||||
as it is deleted.
|
||||
|
||||
@item m
|
||||
@ -163,14 +163,14 @@ The ordering of members in an archive can make a difference in how
|
||||
programs are linked using the library, if a symbol is defined in more
|
||||
than one member.
|
||||
|
||||
If no option flags are used with @code{m}, any members you name in the
|
||||
If no modifiers are used with @code{m}, any members you name in the
|
||||
@var{files} arguments are moved to the @emph{end} of the archive;
|
||||
you can use the @samp{a}, @samp{b}, or @samp{i} options to move them to a
|
||||
you can use the @samp{a}, @samp{b}, or @samp{i} modifiers to move them to a
|
||||
specified place instead.
|
||||
|
||||
@item p
|
||||
@emph{Print} the specified members of the archive, to the standard
|
||||
output file. If the @samp{v} option flag is specified, show the member
|
||||
output file. If the @samp{v} modifier is specified, show the member
|
||||
name before copying its contents to standard output.
|
||||
|
||||
If you specify no @var{files}, all the files in the archive are printed.
|
||||
@ -179,10 +179,10 @@ If you specify no @var{files}, all the files in the archive are printed.
|
||||
@emph{Quick append}; add @var{files} to the end of @var{archive},
|
||||
without checking for replacement.
|
||||
|
||||
The options @samp{a}, @samp{b}, and @samp{i} do @emph{not} affect this
|
||||
The modifiers @samp{a}, @samp{b}, and @samp{i} do @emph{not} affect this
|
||||
operation; new members are always placed at the end of the archive.
|
||||
|
||||
The option @samp{v} makes @code{ar} list each file as it is appended.
|
||||
The modifier @samp{v} makes @code{ar} list each file as it is appended.
|
||||
|
||||
@c FIXME: per Gumby, versions other than WRS of this will *not* auto-update
|
||||
@c SYMDEF index on 'q' updates.
|
||||
@ -197,10 +197,10 @@ displays an error message, and leaves undisturbed any existing members
|
||||
of the archive matching that name.
|
||||
|
||||
By default, new members are added at the end of the file; but you may
|
||||
use one of the options @samp{a}, @samp{b}, or @samp{i} to request
|
||||
use one of the modifiers @samp{a}, @samp{b}, or @samp{i} to request
|
||||
placement relative to some existing member.
|
||||
|
||||
The option flag @samp{v} used with this operation elicits a line of
|
||||
The modifier @samp{v} used with this operation elicits a line of
|
||||
output for each file inserted, along with one of the letters @samp{a} or
|
||||
@samp{r} to indicate whether the file was appended (no old member
|
||||
deleted) or replaced.
|
||||
@ -210,7 +210,7 @@ Display a @emph{table} listing the contents of @var{archive}, or those
|
||||
of the files listed in @var{files} that are present in the
|
||||
archive. Normally only the member name is shown; if you also want to
|
||||
see the modes (permissions), timestamp, owner, group, and size, you can
|
||||
request that by also specifying the @samp{v} option flag.
|
||||
request that by also specifying the @samp{v} modifier.
|
||||
|
||||
If you do not specify any @var{files}, all files in the archive
|
||||
are listed.
|
||||
@ -224,7 +224,7 @@ listing---in our example, @samp{ar t b.a}.
|
||||
|
||||
@item x
|
||||
@emph{Extract} members (named @var{files}) from the archive. You can
|
||||
use the @samp{v} option flag with this operation, to request that
|
||||
use the @samp{v} modifier with this operation, to request that
|
||||
@code{ar} list each name as it extracts it.
|
||||
|
||||
If you do not specify any @var{files}, all files in the archive
|
||||
@ -252,7 +252,7 @@ member must be present as the @var{membername} argument, before the
|
||||
@emph{Create} the archive. The specified @var{archive} is always
|
||||
created if it didn't exist, when you request an update. But a warning is
|
||||
issued unless you specify in advance that you expect to create it, by
|
||||
using this option flag.
|
||||
using this modifier.
|
||||
|
||||
@item i
|
||||
Insert new files @emph{before} an existing member of the
|
||||
@ -261,34 +261,34 @@ member must be present as the @var{membername} argument, before the
|
||||
@var{archive} specification. (same as @samp{b}).
|
||||
|
||||
@item l
|
||||
This option flag is accepted but not used.
|
||||
This modifier is accepted but not used.
|
||||
@c whaffor ar l modifier??? presumably compat; with
|
||||
@c what???---pesch@@cygnus.com, 25jan91
|
||||
|
||||
@item o
|
||||
Preserve the @emph{original} dates of members when extracting them. If
|
||||
you do not specify this option flag, files extracted from the archive
|
||||
you do not specify this modifier, files extracted from the archive
|
||||
will be stamped with the time of extraction.
|
||||
|
||||
@item s
|
||||
Write an object-file index into the archive, or update an existing one,
|
||||
even if no other change is made to the archive. You may use this option
|
||||
even if no other change is made to the archive. You may use this modifier
|
||||
flag either with any operation, or alone. Running @samp{ar s} on an
|
||||
archive is equivalent to running @samp{ranlib} on it.
|
||||
|
||||
@item u
|
||||
Normally, @code{ar r}@dots{} or @code{ar q}@dots{} insert all files
|
||||
Normally, @code{ar r}@dots{} inserts all files
|
||||
listed into the archive. If you would like to insert @emph{only} those
|
||||
of the files you list that are newer than existing members of the same
|
||||
names, use this option. The option-flag combination @samp{qu} is
|
||||
equivalent to @samp{ru}; checking the timestamps loses any speed
|
||||
advantage, so @code{ar} treats both commands as replace operations with
|
||||
the @samp{u} option appended.
|
||||
names, use this modifier. The @samp{u} modifier is allowed only for the
|
||||
operation @samp{r} (replace). In particular, the combination @samp{qu} is
|
||||
not allowed, since checking the timestamps would lose any speed
|
||||
advantage from the operation @samp{q}.
|
||||
|
||||
@item v
|
||||
This option requests the @emph{verbose} version of an operations. Many
|
||||
This modifier requests the @emph{verbose} version of an operation. Many
|
||||
operations display additional information, such as filenames processed,
|
||||
when the option @samp{v} is appended.
|
||||
when the modifier @samp{v} is appended.
|
||||
|
||||
@end table
|
||||
|
||||
@ -305,13 +305,11 @@ The GNU linker @code{ld} is now described in a separate manual.
|
||||
[ -s | +print-armap ] [ -o | +print-file-name ]
|
||||
[ -n | +numeric-sort ] [ -p | +no-sort ]
|
||||
[ -r | +reverse-sort ] [ -u | +undefined-only ]
|
||||
[ +target [@var{bfdname}] ]
|
||||
[ +target @var{bfdname} ]
|
||||
[ @var{objfiles}@dots{} ]
|
||||
@end smallexample
|
||||
|
||||
GNU @code{nm} will list the symbols from object files @var{objfiles}.
|
||||
Any command-line options must precede all object files; only the
|
||||
@samp{+target} option can be further specified with an argument.
|
||||
|
||||
The long and short forms of options, shown here as alternatives, are
|
||||
equivalent.
|
||||
@ -408,9 +406,9 @@ objdump -b oasys -m vax -h fu.o
|
||||
@end example
|
||||
@noindent
|
||||
Displays summary information from the section headers (@samp{-h}) of
|
||||
@file{fu.o}, which is explicitly identified as a Vax (@samp{-m}) object
|
||||
@file{fu.o}, which is explicitly identified (@samp{-m}) as a Vax object
|
||||
file in the format produced by Oasys compilers. You can list the
|
||||
formats available with the @var{-i} option.
|
||||
formats available with the @samp{-i} option.
|
||||
|
||||
@item -d
|
||||
Disassemble. Display the assembler mnemonics for the machine
|
||||
@ -458,7 +456,8 @@ This is similar to the information provided by the @samp{nm} program.
|
||||
|
||||
@item -x
|
||||
Display all available header information, including the symbol table and
|
||||
relocation entries. @samp{-x} is equivalent to @samp{-f -a -h -r -t}.
|
||||
relocation entries. Using @samp{-x} is equivalent to specifying all of
|
||||
@samp{-f -a -h -r -t}.
|
||||
|
||||
@end table
|
||||
|
||||
@ -469,17 +468,20 @@ relocation entries. @samp{-x} is equivalent to @samp{-f -a -h -r -t}.
|
||||
ranlib @var{archive}
|
||||
@end smallexample
|
||||
|
||||
@code{ranlib} generates the an index to the contents of an archive, and
|
||||
@code{ranlib} generates an index to the contents of an archive, and
|
||||
stores it in the archive. The index lists each symbol defined by a
|
||||
member of an archive that is a relocatable object file.
|
||||
|
||||
You may use @code{nm -s} or @code{nm +print-armap} to list this table.
|
||||
You may use @code{nm -s} or @code{nm +print-armap} to list this index.
|
||||
|
||||
An archive with such an index speeds up linking to the library, and
|
||||
allows routines in the library to call each other without regard to
|
||||
their placement in the archive.
|
||||
|
||||
The GNU @code{ranlib} program is another form of GNU @code{ar}.
|
||||
The GNU @code{ranlib} program is another form of GNU @code{ar}; running
|
||||
@code{ranlib} is completely equivalent to executing @samp{ar -s}.
|
||||
@xref{ar}.
|
||||
|
||||
|
||||
@ignore
|
||||
@c FIXME vintage ranlib had options [ -t | +touch ] [ -v | +verbose ]
|
||||
@ -511,9 +513,9 @@ Use this option if you'd like informational messages about what
|
||||
@chapter size
|
||||
|
||||
@smallexample
|
||||
size [ -d | -o | -x | +radix @var{number} ]
|
||||
[ -A | -B | +format @var{compatibility} ] [ +help ]
|
||||
[ +target [@var{bfdname}] [ -V | +version ]
|
||||
size [ -A | -B | +format @var{compatibility} ]
|
||||
[ +help ] [ -d | -o | -x | +radix @var{number} ]
|
||||
[ +target @var{bfdname} [ -V | +version ]
|
||||
@var{objfiles}@dots{}
|
||||
@end smallexample
|
||||
|
||||
@ -524,17 +526,8 @@ module in an archive.
|
||||
|
||||
The command line options have the following meanings:
|
||||
@table @code
|
||||
@item +radix @var{number}
|
||||
@itemx -d
|
||||
@itemx -o
|
||||
@itemx -x
|
||||
Using one of these options, you can control whether the size of each
|
||||
section is given in decimal (@samp{-d}, or @samp{+radix 10}); octal
|
||||
(@samp{-o}, or @samp{+radix 8}); or hexadecimal (@samp{-x}, or
|
||||
@samp{+radix 16}). In @samp{+radix @var{number}}, only the three
|
||||
values (8, 10, 16) are supported. The total size is always given in two
|
||||
radices; decimal and hexadecimal for @samp{-d} or @samp{-x} output, or
|
||||
octal and hexadecimal if you're using @samp{-o}.
|
||||
@item @var{objfiles}@dots{}
|
||||
The object files to be examined.
|
||||
|
||||
@item +format @var{compatibility}
|
||||
@itemx -A
|
||||
@ -578,6 +571,21 @@ section size addr
|
||||
Total 388688
|
||||
@end smallexample
|
||||
|
||||
@item +help
|
||||
Show a summary of acceptable arguments and options.
|
||||
|
||||
@item +radix @var{number}
|
||||
@itemx -d
|
||||
@itemx -o
|
||||
@itemx -x
|
||||
Using one of these options, you can control whether the size of each
|
||||
section is given in decimal (@samp{-d}, or @samp{+radix 10}); octal
|
||||
(@samp{-o}, or @samp{+radix 8}); or hexadecimal (@samp{-x}, or
|
||||
@samp{+radix 16}). In @samp{+radix @var{number}}, only the three
|
||||
values (8, 10, 16) are supported. The total size is always given in two
|
||||
radices; decimal and hexadecimal for @samp{-d} or @samp{-x} output, or
|
||||
octal and hexadecimal if you're using @samp{-o}.
|
||||
|
||||
@item +target @var{bfdname}
|
||||
You can specify a particular object-code format for @var{objfiles} as
|
||||
@var{bfdname}. This may not be necessary; @var{size} can
|
||||
@ -607,8 +615,10 @@ depending on its command-line options.
|
||||
|
||||
@code{strip} will not execute unless at least one object file is listed.
|
||||
|
||||
@quotation
|
||||
@emph{WARNING:} @code{strip} modifies the files named in its argument,
|
||||
rather than writing modified copies under different names.
|
||||
@end quotation
|
||||
|
||||
The long and short forms of options, shown here as alternatives, are
|
||||
equivalent.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user