espressif/binutils-gdb
1
0
Fork 0
mirror of https://github.com/espressif/binutils-gdb.git synced 2025-06-18 08:38:10 +08:00
Code Issues Packages Projects Releases Wiki Activity

binutils.texi: modified from 95q4

Browse Source
This commit is contained in:
Victoria Mixon
1995-11-10 19:09:41 +00:00
parent b51e5b4f6e
commit b94ff92428
1 changed files with 23 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
binutils/binutils.texi
View File

@ -13,7 +13,7 @@ END-INFO-DIR-ENTRY
@end ifinfo @end ifinfo
@ifinfo @ifinfo
Copyright @copyright{} 1991, 1992, 1993, 1994 Free Software Foundation, Inc. Copyright @copyright{} 1991, 1992, 1993, 1994, 1995 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice this manual provided the copyright notice and this permission notice
@ -48,10 +48,10 @@ into another language, under the above conditions for modified versions.
@c @c
@setchapternewpage odd @setchapternewpage odd
@settitle GNU Binary Utilities @settitle @sc{gnu} Binary Utilities
@titlepage @titlepage
@finalout @finalout
@title The GNU Binary Utilities @title The @sc{gnu} Binary Utilities
@subtitle Version @value{VERSION} @subtitle Version @value{VERSION}
@sp 1 @sp 1
@subtitle May 1993 @subtitle May 1993
@ -66,7 +66,7 @@ into another language, under the above conditions for modified versions.
@end tex @end tex
@vskip 0pt plus 1filll @vskip 0pt plus 1filll
Copyright @copyright{} 1991, 1992, 1993, 1994 Free Software Foundation, Inc. Copyright @copyright{} 1991, 1992, 1993, 1994, 1995 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice this manual provided the copyright notice and this permission notice
@ -85,7 +85,7 @@ into another language, under the above conditions for modified versions.
@top Introduction @top Introduction
@cindex version @cindex version
This brief manual contains preliminary documentation for the GNU binary This brief manual contains preliminary documentation for the @sc{gnu} binary
utilities (collectively version @value{VERSION}): utilities (collectively version @value{VERSION}):
@iftex @iftex
@ -148,7 +148,7 @@ ar [-]@var{p}[@var{mod} [@var{relpos}]] @var{archive} [@var{member}@dots{}]
ar -M [ <mri-script ] ar -M [ <mri-script ]
@end smallexample @end smallexample
The GNU @code{ar} program creates, modifies, and extracts from The @sc{gnu} @code{ar} program creates, modifies, and extracts from
archives. An @dfn{archive} is a single file holding a collection of archives. An @dfn{archive} is a single file holding a collection of
other files in a structure that makes it possible to retrieve other files in a structure that makes it possible to retrieve
the original individual files (called @dfn{members} of the archive). the original individual files (called @dfn{members} of the archive).
@ -158,7 +158,7 @@ group are preserved in the archive, and can be restored on
extraction. extraction.
@cindex name length @cindex name length
GNU @code{ar} can maintain archives whose members have names of any @sc{gnu} @code{ar} can maintain archives whose members have names of any
length; however, depending on how @code{ar} is configured on your length; however, depending on how @code{ar} is configured on your
system, a limit on member-name length may be imposed for compatibility system, a limit on member-name length may be imposed for compatibility
with archive formats maintained with other tools. If it exists, the with archive formats maintained with other tools. If it exists, the
@ -185,7 +185,7 @@ table. If an archive lacks the table, another form of @code{ar} called
@cindex compatibility, @code{ar} @cindex compatibility, @code{ar}
@cindex @code{ar} compatibility @cindex @code{ar} compatibility
GNU @code{ar} is designed to be compatible with two different @sc{gnu} @code{ar} is designed to be compatible with two different
facilities. You can control its activity using command-line options, facilities. You can control its activity using command-line options,
like the different varieties of @code{ar} on Unix systems; or, if you like the different varieties of @code{ar} on Unix systems; or, if you
specify the single command-line option @samp{-M}, you can control it specify the single command-line option @samp{-M}, you can control it
@ -214,7 +214,7 @@ arguments to execute: one keyletter specifying the @emph{operation}
Most operations can also accept further @var{member} 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 @sc{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. flags @var{mod} in any order, within the first command-line argument.
If you wish, you may begin the first command-line argument with a If you wish, you may begin the first command-line argument with a
@ -346,7 +346,7 @@ issued unless you specify in advance that you expect to create it, by
using this modifier. using this modifier.
@item f @item f
Truncate names in the archive. GNU @code{ar} will normally permit file Truncate names in the archive. @sc{gnu} @code{ar} will normally permit file
names of any length. This will cause it to create archives which are names of any length. This will cause it to create archives which are
not compatible with the native @code{ar} program on some systems. If not compatible with the native @code{ar} program on some systems. If
this is a concern, the @samp{f} modifier may be used to truncate file this is a concern, the @samp{f} modifier may be used to truncate file
@ -361,7 +361,7 @@ member must be present as the @var{relpos} argument, before the
@item l @item l
This modifier is accepted but not used. This modifier is accepted but not used.
@c whaffor ar l modifier??? presumably compat; with @c whaffor ar l modifier??? presumably compat; with
@c what???---pesch@@cygnus.com, 25jan91 @c what???---doc@@cygnus.com, 25jan91
@item o @item o
@cindex dates in archive @cindex dates in archive
@ -416,7 +416,7 @@ on any error.
The @code{ar} command language is @emph{not} designed to be equivalent The @code{ar} command language is @emph{not} designed to be equivalent
to the command-line options; in fact, it provides somewhat less control to the command-line options; in fact, it provides somewhat less control
over archives. The only purpose of the command language is to ease the over archives. The only purpose of the command language is to ease the
transition to GNU @code{ar} for developers who already have scripts transition to @sc{gnu} @code{ar} for developers who already have scripts
written for the MRI ``librarian'' program. written for the MRI ``librarian'' program.
The syntax for the @code{ar} command language is straightforward: The syntax for the @code{ar} command language is straightforward:
@ -526,7 +526,7 @@ Requires prior use of @code{OPEN} or @code{CREATE}.
@item LIST @item LIST
Display full contents of the current archive, in ``verbose'' style Display full contents of the current archive, in ``verbose'' style
regardless of the state of @code{VERBOSE}. The effect is like @samp{ar regardless of the state of @code{VERBOSE}. The effect is like @samp{ar
tv @var{archive}}). (This single command is a GNU @code{ld} tv @var{archive}}). (This single command is a @sc{gnu} @code{ld}
enhancement, rather than present for MRI compatibility.) enhancement, rather than present for MRI compatibility.)
Requires prior use of @code{OPEN} or @code{CREATE}. Requires prior use of @code{OPEN} or @code{CREATE}.
@ -563,8 +563,8 @@ Requires prior use of @code{OPEN} or @code{CREATE}.
@chapter ld @chapter ld
@cindex linker @cindex linker
@kindex ld @kindex ld
The GNU linker @code{ld} is now described in a separate manual. The @sc{gnu} linker @code{ld} is now described in a separate manual.
@xref{Top,, Overview,, Using LD: the GNU linker}. @xref{Top,, Overview,, Using LD: the @sc{gnu} linker}.
@end iftex @end iftex
@node nm @node nm
@ -583,7 +583,7 @@ nm [ -a | --debug-syms ] [ -g | --extern-only ]
[ --no-demangle ] [ -V | --version ] [ --help ] [ @var{objfile}@dots{} ] [ --no-demangle ] [ -V | --version ] [ --help ] [ @var{objfile}@dots{} ]
@end smallexample @end smallexample
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
@file{a.out}. @file{a.out}.
@ -1170,7 +1170,7 @@ 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 allows routines in the library to call each other without regard to
their placement in the archive. their placement in the archive.
The GNU @code{ranlib} program is another form of GNU @code{ar}; running The @sc{gnu} @code{ranlib} program is another form of @sc{gnu} @code{ar}; running
@code{ranlib} is completely equivalent to executing @samp{ar -s}. @code{ranlib} is completely equivalent to executing @samp{ar -s}.
@xref{ar}. @xref{ar}.
@ -1193,7 +1193,7 @@ size [ -A | -B | --format=@var{compatibility} ]
@var{objfile}@dots{} @var{objfile}@dots{}
@end smallexample @end smallexample
The GNU @code{size} utility lists the section sizes---and the total The @sc{gnu} @code{size} utility lists the section sizes---and the total
size---for each of the object or archive files @var{objfile} in its size---for each of the object or archive files @var{objfile} in its
argument list. By default, one line of output is generated for each argument list. By default, one line of output is generated for each
object file or each module in an archive. object file or each module in an archive.
@ -1207,7 +1207,7 @@ The command line options have the following meanings:
@itemx -B @itemx -B
@itemx --format=@var{compatibility} @itemx --format=@var{compatibility}
@cindex @code{size} display format @cindex @code{size} display format
Using one of these options, you can choose whether the output from GNU Using one of these options, you can choose whether the output from @sc{gnu}
@code{size} resembles output from System V @code{size} (using @samp{-A}, @code{size} resembles output from System V @code{size} (using @samp{-A},
or @samp{--format=sysv}), or Berkeley @code{size} (using @samp{-B}, or or @samp{--format=sysv}), or Berkeley @code{size} (using @samp{-B}, or
@samp{--format=berkeley}). The default is the one-line format similar to @samp{--format=berkeley}). The default is the one-line format similar to
@ -1289,7 +1289,7 @@ strings [-afov] [-@var{min-len}] [-n @var{min-len}] [-t @var{radix}] [-]
[--help] [--version] @var{file}@dots{} [--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, @sc{gnu} @code{strings} prints the printable
character sequences that are at least 4 characters long (or the number character sequences that are at least 4 characters long (or the number
given with the options below) and are followed by an unprintable given with the options below) and are followed by an unprintable
character. By default, it only prints the strings from the initialized character. By default, it only prints the strings from the initialized
@ -1361,7 +1361,7 @@ strip [ -F @var{bfdname} | --target=@var{bfdname} | --target=@var{bfdname} ]
@var{objfile}@dots{} @var{objfile}@dots{}
@end smallexample @end smallexample
GNU @code{strip} discards all symbols from object files @sc{gnu} @code{strip} discards all symbols from object files
@var{objfile}. The list of object files may include archives. @var{objfile}. The list of object files may include archives.
At least one object file must be given. At least one object file must be given.
@ -1487,13 +1487,13 @@ Do not remove the initial underscore.
@item -s @var{format} @item -s @var{format}
@itemx --format=@var{format} @itemx --format=@var{format}
GNU @code{nm} can decode three different methods of mangling, used by @sc{gnu} @code{nm} can decode three different methods of mangling, used by
different C++ compilers. The argument to this option selects which different C++ compilers. The argument to this option selects which
method it uses: method it uses:
@table @code @table @code
@item gnu @item gnu
the one used by the GNU compiler (the default method) the one used by the @sc{gnu} compiler (the default method)
@item lucid @item lucid
the one used by the Lucid compiler the one used by the Lucid compiler
@item arm @item arm