aboutsummaryrefslogtreecommitdiff
path: root/ld
diff options
context:
space:
mode:
authorRoland Pesch <pesch@cygnus>1993-10-01 21:08:13 +0000
committerRoland Pesch <pesch@cygnus>1993-10-01 21:08:13 +0000
commit7f9ae73e76a980b1086c58f6fbe03d2c35e21c19 (patch)
treeeb825e8f24daf7eedd3f7ab7838e71d0da709dcf /ld
parentf73b07c9d26a2baf9463349b2526f646d6d5238b (diff)
downloadgdb-7f9ae73e76a980b1086c58f6fbe03d2c35e21c19.zip
gdb-7f9ae73e76a980b1086c58f6fbe03d2c35e21c19.tar.gz
gdb-7f9ae73e76a980b1086c58f6fbe03d2c35e21c19.tar.bz2
Makefile.in: correct out-of-date TEXIDIR default
ld.texinfo: (a) fix INPUT cmd description (b) fix bad formatting in FSF style (warning examples) (c) add some index entries on warnings
Diffstat (limited to 'ld')
-rw-r--r--ld/ld.texinfo43
1 files changed, 28 insertions, 15 deletions
diff --git a/ld/ld.texinfo b/ld/ld.texinfo
index f44ac62..a18c92d 100644
--- a/ld/ld.texinfo
+++ b/ld/ld.texinfo
@@ -1,7 +1,7 @@
\input texinfo
@setfilename ld.info
@syncodeindex ky cp
-@c @include configdoc.texi
+@include configdoc.texi
@c @smallbook
@c @cropmarks
@@ -216,11 +216,11 @@ may follow, precede, or be mixed in with command-line options, except that
an @var{objfile} argument may not be placed between an option and
its argument.
-Usually the linker is invoked with at least one object file, but other
-forms of binary input files can also be specified with @samp{-l},
-@samp{-R}, and the script command language. If @emph{no} binary input
-files at all are specified, the linker does not produce any output, and
-issues the message @samp{No input files}.
+Usually the linker is invoked with at least one object file, but you can
+specify other forms of binary input files using @samp{-l}, @samp{-R},
+and the script command language. If @emph{no} binary input files at all
+are specified, the linker does not produce any output, and issues the
+message @samp{No input files}.
Option arguments must either follow the option letter without intervening
whitespace, or be given as separate arguments immediately following the
@@ -446,6 +446,7 @@ Use @var{output} as the name for the program produced by @code{ld}; if this
option is not specified, the name @file{a.out} is used by default. The
script command @code{OUTPUT} can also specify the output file name.
+@ifclear SingleFormat
@kindex -oformat
@item -oformat @var{output-format}
Specify the binary format for the output object file. You don't usually
@@ -456,6 +457,7 @@ supported by the BFD libraries. (You can list the available binary
formats with @samp{objdump -i}.) The script command
@code{OUTPUT_FORMAT} can also specify the output format, but this option
overrides it. @xref{BFD}.
+@end ifclear
@item -R @var{filename}
@kindex -R @var{file}
@@ -584,6 +586,9 @@ Display the version number for @code{ld}.
Display the version number for @code{ld} and exit.
@item -warn-common
+@kindex -warn-comon
+@cindex warnings, on combining symbols
+@cindex combining symbols, warnings on
Warn when a common symbol is combined with another common symbol or with
a symbol definition. Unix linkers allow this somewhat sloppy practice,
but linkers on some other operating systems do not. This option allows
@@ -646,7 +651,8 @@ Merging a common symbol with a previous same-sized common symbol.
@item
Merging a common symbol with a previous larger common symbol.
@smallexample
-@var{file}(@var{section}): warning: common of `@var{symbol}' overridden by larger common
+@var{file}(@var{section}): warning: common of `@var{symbol}' overridden
+ by larger common
@var{file}(@var{section}): warning: larger common is here
@end smallexample
@@ -655,7 +661,8 @@ Merging a common symbol with a previous smaller common symbol. This is
the same as the previous case, except that the symbols are
encountered in a different order.
@smallexample
-@var{file}(@var{section}): warning: common of `@var{symbol}' overriding smaller common
+@var{file}(@var{section}): warning: common of `@var{symbol}' overriding
+ smaller common
@var{file}(@var{section}): warning: smaller common is here
@end smallexample
@end enumerate
@@ -1791,8 +1798,14 @@ output file is specified (@samp{-r}).
@itemx INPUT ( @var{file} @var{file} @dots{} )
@cindex binary input files
Use this command to include binary input files in the link, without
-including them in a particular section definition. Files specified this
-way are treated identically to object files listed on the command line.
+including them in a particular section definition.
+Specify the full name for each @var{file}, including @samp{.a} if
+required.
+
+@code{ld} searches for each @var{file} through the archive-library
+search path, just as for files you specify on the command line.
+See the description of @samp{-L} in @ref{Options,,Command Line
+Options}.
@ignore
@item MAP ( @var{name} )
@@ -1881,11 +1894,11 @@ functionality are not listed.
@end menu
@end ifset
-@c FIXME! This could use @up/@down, but there seems to be a conflict
+@c FIXME! This could use @raisesections/@lowersections, but there seems to be a conflict
@c between those and node-defaulting.
@ifset H8300
@ifclear GENERIC
-@up
+@raisesections
@end ifclear
@node H8/300
@section @code{ld} and the H8/300
@@ -1913,13 +1926,13 @@ page of memory, and changes them to use the eight-bit address form.
top page of memory).
@end table
@ifclear GENERIC
-@down
+@lowersections
@end ifclear
@end ifset
@ifset I960
@ifclear GENERIC
-@up
+@raisesections
@end ifclear
@node i960
@section @code{ld} and the Intel 960 family
@@ -1955,7 +1968,7 @@ the 960 architecture family allows combination of target architectures; each
use will add another pair of name variants to search for when @w{@samp{-l}}
specifies a library.
@ifclear GENERIC
-@down
+@lowersections
@end ifclear
@end ifset