Makefile.in (binutils.dvi): use TEXIDIR to find texinfo.tex

binutils.texi (ar): improve synopsis lines
              (strings): fix overfull box in synopsis
              (passim) remove some contractions
This commit is contained in:
Roland Pesch
1993-10-01 00:11:58 +00:00
parent 4f9bddb4fc
commit 650a49f055
2 changed files with 40 additions and 25 deletions

@ -1,5 +1,22 @@
Thu Sep 30 16:46:26 1993 Roland H. Pesch (pesch@fowanton.cygnus.com)
* Makefile.in (binutils.dvi): use TEXIDIR to find texinfo.tex
Sat Sep 25 18:09:29 1993 David J. Mackenzie (djm@thepub.cygnus.com)
* objcopy.c (simple_copy, smart_rename): New functions.
(main): Use them.
Fri Sep 24 15:38:29 1993 Ian Lance Taylor (ian@tweedledumb.cygnus.com)
* Makefile.in (clean, distclean): Recurse into testsuite.
Thu Sep 23 01:05:06 1993 Ian Lance Taylor (ian@tweedledumb.cygnus.com) Thu Sep 23 01:05:06 1993 Ian Lance Taylor (ian@tweedledumb.cygnus.com)
* objcopy.c (setup_sections, copy_sections): If stripping, don't
copy SEC_DEBUGGING sections.
* objdump.c (dump_headers): Print SEC_DEBUGGING flag.
* objdump.c (usage): Mention --stabs. * objdump.c (usage): Mention --stabs.
* objcopy.c (copy_object): Copy all applicable file flags. * objcopy.c (copy_object): Copy all applicable file flags.

@ -60,9 +60,7 @@ into another language, under the above conditions for modified versions.
@page @page
@tex @tex
\def\$#1${{#1}} % Kluge: collect RCS revision info without $...$ {\parskip=0pt \hfill Cygnus Support\par \hfill
\xdef\manvers{\$Revision$} % For use in headers, footers too
{\parskip=0pt \hfill Cygnus Support\par \hfill \manvers\par \hfill
\TeX{}info \texinfoversion\par } \TeX{}info \texinfoversion\par }
@end tex @end tex
@ -138,7 +136,7 @@ Discard symbols
@cindex archives @cindex archives
@cindex collections of files @cindex collections of files
@smallexample @smallexample
ar [-]@var{p}@var{mod} [ @var{membername} ] @var{archive} @var{file}@dots{} ar [-]@var{p}[@var{mod} [@var{relpos}]] @var{archive} [@var{member}@dots{}]
ar -M [ <mri-script ] ar -M [ <mri-script ]
@end smallexample @end smallexample
@ -196,7 +194,7 @@ program.
@section Controlling @code{ar} on the command line @section Controlling @code{ar} on the command line
@smallexample @smallexample
ar [-]@var{p}@var{mod} [ @var{membername} ] @var{archive} @var{file}@dots{} ar [-]@var{p}[@var{mod} [@var{relpos}]] @var{archive} [@var{member}@dots{}]
@end smallexample @end smallexample
@cindex Unix compatibility, @code{ar} @cindex Unix compatibility, @code{ar}
@ -205,7 +203,7 @@ arguments to execute: one keyletter specifying the @emph{operation}
(optionally accompanied by other keyletters specifying (optionally accompanied by other keyletters specifying
@emph{modifiers}), and the archive name to act on. @emph{modifiers}), and the archive name to act on.
Most operations can also accept further @var{file} arguments, Most operations can also accept further @var{member} arguments,
specifying particular files to operate on. specifying particular files to operate on.
GNU @code{ar} allows you to mix the operation code @var{p} and modifier GNU @code{ar} allows you to mix the operation code @var{p} and modifier
@ -222,7 +220,7 @@ any of the following, but you must specify only one of them:
@item d @item d
@cindex deleting from archive @cindex deleting from archive
@emph{Delete} modules from the archive. Specify the names of modules to @emph{Delete} modules from the archive. Specify the names of modules to
be deleted as @var{file}@dots{}; the archive is untouched if you be deleted as @var{member}@dots{}; the archive is untouched if you
specify no files to delete. specify no files to delete.
If you specify the @samp{v} modifier, @code{ar} lists each module If you specify the @samp{v} modifier, @code{ar} lists each module
@ -237,7 +235,7 @@ programs are linked using the library, if a symbol is defined in more
than one member. than one member.
If no modifiers 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{file} arguments are moved to the @emph{end} of the archive; @var{member} arguments are moved to the @emph{end} of the archive;
you can use the @samp{a}, @samp{b}, or @samp{i} modifiers 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. specified place instead.
@ -247,12 +245,12 @@ specified place instead.
output file. If the @samp{v} modifier 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. name before copying its contents to standard output.
If you specify no @var{file} arguments, all the files in the archive are If you specify no @var{member} arguments, all the files in the archive are
printed. printed.
@item q @item q
@cindex quick append to archive @cindex quick append to archive
@emph{Quick append}; add the files @var{file}@dots{} to the end of @emph{Quick append}; add the files @var{member}@dots{} to the end of
@var{archive}, without checking for replacement. @var{archive}, without checking for replacement.
The modifiers @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
@ -266,12 +264,12 @@ index is not updated, even if it already existed; you can use @samp{ar s} or
@item r @item r
@cindex replacement in archive @cindex replacement in archive
Insert the files @var{file}@dots{} into @var{archive} (with Insert the files @var{member}@dots{} into @var{archive} (with
@emph{replacement}). This operation differs from @samp{q} in that any @emph{replacement}). This operation differs from @samp{q} in that any
previously existing members are deleted if their names match those being previously existing members are deleted if their names match those being
added. added.
If one of the files named in @var{file}@dots{} doesn't exist, @code{ar} If one of the files named in @var{member}@dots{} does not exist, @code{ar}
displays an error message, and leaves undisturbed any existing members displays an error message, and leaves undisturbed any existing members
of the archive matching that name. of the archive matching that name.
@ -287,12 +285,12 @@ deleted) or replaced.
@item t @item t
@cindex contents of archive @cindex contents of archive
Display a @emph{table} listing the contents of @var{archive}, or those Display a @emph{table} listing the contents of @var{archive}, or those
of the files listed in @var{file}@dots{} that are present in the of the files listed in @var{member}@dots{} that are present in the
archive. Normally only the member name is shown; if you also want to archive. Normally only the member name is shown; if you also want to
see the modes (permissions), timestamp, owner, group, and size, you can see the modes (permissions), timestamp, owner, group, and size, you can
request that by also specifying the @samp{v} modifier. request that by also specifying the @samp{v} modifier.
If you do not specify a @var{file}, all files in the archive If you do not specify a @var{member}, all files in the archive
are listed. are listed.
@cindex repeated names in archive @cindex repeated names in archive
@ -306,11 +304,11 @@ listing---in our example, @samp{ar t b.a}.
@item x @item x
@cindex extract from archive @cindex extract from archive
@emph{Extract} members (named @var{file}) from the archive. You can @emph{Extract} members (named @var{member}) from the archive. You can
use the @samp{v} modifier 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. @code{ar} list each name as it extracts it.
If you do not specify a @var{file}, all files in the archive If you do not specify a @var{member}, all files in the archive
are extracted. are extracted.
@end table @end table
@ -323,26 +321,26 @@ keyletter, to specify variations on an operation's behavior:
@cindex relative placement in archive @cindex relative placement in archive
Add new files @emph{after} an existing member of the Add new files @emph{after} an existing member of the
archive. If you use the modifier @samp{a}, the name of an existing archive archive. If you use the modifier @samp{a}, the name of an existing archive
member must be present as the @var{membername} argument, before the member must be present as the @var{relpos} argument, before the
@var{archive} specification. @var{archive} specification.
@item b @item b
Add new files @emph{before} an existing member of the Add new files @emph{before} an existing member of the
archive. If you use the modifier @samp{b}, the name of an existing archive archive. If you use the modifier @samp{b}, the name of an existing archive
member must be present as the @var{membername} argument, before the member must be present as the @var{relpos} argument, before the
@var{archive} specification. (same as @samp{i}). @var{archive} specification. (same as @samp{i}).
@item c @item c
@cindex creating archives @cindex creating archives
@emph{Create} the archive. The specified @var{archive} is always @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 created if it did not exist, when you request an update. But a warning is
issued unless you specify in advance that you expect to create it, by issued unless you specify in advance that you expect to create it, by
using this modifier. using this modifier.
@item i @item i
Insert new files @emph{before} an existing member of the Insert new files @emph{before} an existing member of the
archive. If you use the modifier @samp{i}, the name of an existing archive archive. If you use the modifier @samp{i}, the name of an existing archive
member must be present as the @var{membername} argument, before the member must be present as the @var{relpos} argument, before the
@var{archive} specification. (same as @samp{b}). @var{archive} specification. (same as @samp{b}).
@item l @item l
@ -453,10 +451,10 @@ Add all the contents of @var{archive} (or, if specified, each named
Requires prior use of @code{OPEN} or @code{CREATE}. Requires prior use of @code{OPEN} or @code{CREATE}.
@item ADDMOD @var{file}, @var{file}, @dots{} @var{file} @item ADDMOD @var{member}, @var{member}, @dots{} @var{member}
@c FIXME! w/Replacement?? If so, like "ar r @var{archive} @var{names}" @c FIXME! w/Replacement?? If so, like "ar r @var{archive} @var{names}"
@c else like "ar q..." @c else like "ar q..."
Add each named @var{file} as a module in the current archive. Add each named @var{member} as a module in the current archive.
Requires prior use of @code{OPEN} or @code{CREATE}. Requires prior use of @code{OPEN} or @code{CREATE}.
@ -750,7 +748,7 @@ by their names.
@item -p @item -p
@itemx --no-sort @itemx --no-sort
@cindex sorting symbols @cindex sorting symbols
Don't bother to sort the symbols in any order; print them in the order Do not bother to sort the symbols in any order; print them in the order
encountered. encountered.
@item -P @item -P
@ -1066,8 +1064,8 @@ Display the version number of @code{size}.
@smallexample @smallexample
strings [-afov] [-@var{min-len}] [-n @var{min-len}] [-t @var{radix}] [-] strings [-afov] [-@var{min-len}] [-n @var{min-len}] [-t @var{radix}] [-]
[--all] [--print-file-name] [--bytes=@var{min-len}] [--radix=@var{radix}] [--all] [--print-file-name] [--bytes=@var{min-len}]
[--help] [--version] @var{file}@dots{} [--radix=@var{radix}] [--help] [--version] @var{file}@dots{}
@end smallexample @end smallexample
For each @var{file} given, GNU @code{strings} prints the printable For each @var{file} given, GNU @code{strings} prints the printable