From 511ab9e95b69fddced78b9096afe745a5547f3c8 Mon Sep 17 00:00:00 2001 From: Ian Lance Taylor Date: Sat, 29 May 1999 19:43:33 +0000 Subject: [PATCH] * ld.texinfo (Options): Clarify that options which refer to files must be properly ordered. --- ld/ChangeLog | 5 +++++ ld/ld.texinfo | 17 ++++++++++------- 2 files changed, 15 insertions(+), 7 deletions(-) diff --git a/ld/ChangeLog b/ld/ChangeLog index 546d82fdf08..2b0528df651 100644 --- a/ld/ChangeLog +++ b/ld/ChangeLog @@ -1,3 +1,8 @@ +1999-05-29 Ian Lance Taylor + + * ld.texinfo (Options): Clarify that options which refer to files + must be properly ordered. + 1999-05-29 Nick Clifton * emultempl/armelf.em (..._parse_args): New function: Parse diff --git a/ld/ld.texinfo b/ld/ld.texinfo index 027f196d599..43665761779 100644 --- a/ld/ld.texinfo +++ b/ld/ld.texinfo @@ -179,18 +179,21 @@ result of linking the file @code{/lib/crt0.o} with @code{hello.o} and the library @code{libc.a}, which will come from the standard search directories. (See the discussion of the @samp{-l} option below.) -The command-line options to @code{ld} may be specified in any order, and -may be repeated at will. Repeating most options with a different -argument will either have no further effect, or override prior +Some of the command-line options to @code{ld} may be specified at any +point in the command line. However, options which refer to files, such +as @samp{-l} or @samp{-T}, cause the file to be read at the point at +which the option appears in the command line, relative to the object +files and other file options. Repeating non-file options with a +different argument will either have no further effect, or override prior occurrences (those further to the left on the command line) of that option. Options which may be meaningfully specified more than once are noted in the descriptions below. @cindex object files -Non-option arguments are objects files which are to be linked together. -They may follow, precede, or be mixed in with command-line options, -except that an object file argument may not be placed between an option -and its argument. +Non-option arguments are object files or archives which are to be linked +together. They may follow, precede, or be mixed in with command-line +options, except that an object file argument may not be placed between +an option and its argument. 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}, -- 2.30.2