Replace , with \, inside @gccoptlist macros.

Document %B and %j and %. and %v3 and %M and %{S*&T} spec switches.

From-SVN: r39210
This commit is contained in:
Nick Clifton 2001-01-23 21:35:15 +00:00 committed by Nick Clifton
parent 3637cfac02
commit 371e300b1d
2 changed files with 47 additions and 10 deletions

View File

@ -1,3 +1,9 @@
2001-01-23 Nick Clifton <nickc@redhat.com>
* invoke.texi: Replace , with \, inside @gccoptlist macros.
(Spec Files): Document %B and %j and %. and %v3 and %M and
%{S*&T} spec switches.
2001-01-24 Herman A.J. ten Brugge <Haj.Ten.Brugge@net.HCC.nl>
* c4x.c (c4x_r11_set_p): Calculate rtx code correctly.

View File

@ -267,12 +267,12 @@ in the following sections.
-iprefix @var{file} -iwithprefix @var{dir} @gol
-iwithprefixbefore @var{dir} -isystem @var{dir} -isystem-c++ @var{dir} @gol
-M -MM -MF -MG -MP -MQ -MT -nostdinc -P -remap @gol
-trigraphs -undef -U@var{macro} -Wp,@var{option}}
-trigraphs -undef -U@var{macro} -Wp\,@var{option}}
@item Assembler Option
@xref{Assembler Options,,Passing Options to the Assembler}.
@gccoptlist{
-Wa,@var{option}}
-Wa\,@var{option}}
@item Linker Options
@xref{Link Options,,Options for Linking}.
@ -280,7 +280,7 @@ in the following sections.
@var{object-file-name} -l@var{library} @gol
-nostartfiles -nodefaultlibs -nostdlib @gol
-s -static -static-libgcc -shared -shared-libgcc -symbolic @gol
-Wl,@var{option} -Xlinker @var{option} @gol
-Wl\,@var{option} -Xlinker @var{option} @gol
-u @var{symbol}}
@item Directory Options
@ -519,7 +519,7 @@ in the following sections.
@emph{System V Options}
@gccoptlist{
-Qy -Qn -YP,@var{paths} -Ym,@var{dir}}
-Qy -Qn -YP\,@var{paths} -Ym\,@var{dir}}
@emph{ARC Options}
@gccoptlist{
@ -554,7 +554,7 @@ in the following sections.
@emph{MCore Options}
@gccoptlist{
-mhardlit, -mno-hardlit -mdiv -mno-div -mrelax-immediates @gol
-mhardlit -mno-hardlit -mdiv -mno-div -mrelax-immediates @gol
-mno-relax-immediates -mwide-bitfields -mno-wide-bitfields @gol
-m4byte-functions -mno-4byte-functions -mcallgraph-data @gol
-mno-callgraph-data -mslow-bytes -mno-slow-bytes -mno-lsim @gol
@ -3535,7 +3535,7 @@ Trigraph support is not popular, so many compilers do not implement it
properly. Portable code should not rely on trigraphs being either
converted or ignored.
@item -Wp,@var{option}
@item -Wp\,@var{option}
Pass @var{option} as an option to the preprocessor. If @var{option}
contains commas, it is split into multiple options at the commas.
@end table
@ -3547,7 +3547,7 @@ contains commas, it is split into multiple options at the commas.
You can pass options to the assembler.
@table @gcctabopt
@item -Wa,@var{option}
@item -Wa\,@var{option}
Pass @var{option} as an option to the assembler. If @var{option}
contains commas, it is split into multiple options at the commas.
@end table
@ -3712,7 +3712,7 @@ For example, to pass @samp{-assert definitions}, you must write
@samp{-Xlinker "-assert definitions"}, because this passes the entire
string as a single argument, which is not what the linker expects.
@item -Wl,@var{option}
@item -Wl\,@var{option}
Pass @var{option} as an option to the linker. If @var{option} contains
commas, it is split into multiple options at the commas.
@ -3967,6 +3967,10 @@ Substitute the basename of the input file being processed.
This is the substring up to (and not including) the last period
and not including the directory.
@item %B
This is the same as @samp{%b}, but include the file suffix (text after
the last period).
@item %d
Marks the argument containing or following the @samp{%d} as a
temporary file name, so that that file will be deleted if GCC exits
@ -4000,6 +4004,18 @@ for each @samp{%g.s} and another for each @samp{%U.s}. Previously, @samp{%U} wa
simply substituted with a file name chosen for the previous @samp{%u},
without regard to any appended suffix.
@item %j@var{SUFFIX}
Substitutes the name of the HOST_BIT_BUCKET, if any, and if it is
writable, and if save-temps is off; otherwise, substitute the name
of a temporary file, just like @samp{%u}. This temporary file is not
meant for communication between processes, but rather as a junk
disposal mechanism.
@item %.@var{SUFFIX}
Substitutes @var{.SUFFIX} for the suffixes of a matched switch's args
when it is subsequently output with @samp{%*}. @var{SUFFIX} is
terminated by the next space or %.
@item %w
Marks the argument containing or following the @samp{%w} as the
designated output file of this compilation. This puts the argument
@ -4075,6 +4091,10 @@ Substitute the major version number of GCC.
Substitute the minor version number of GCC.
(For version 2.9.5, this is 9.)
@item %v3
Substitute the patch level number of GCC.
(For version 2.9.5, this is 5.)
@item %a
Process the @code{asm} spec. This is used to compute the
switches to be passed to the assembler.
@ -4094,6 +4114,11 @@ Dump out a @samp{-L} option for each directory that GCC believes might
contain startup files. If the target supports multilibs then the
current multilib directory will be prepended to each of these paths.
@item %M
Output the multilib directory with directory seperators replaced with
"_". If multilib directories are not set, or the multilib directory is
"." then this option emits nothing.
@item %L
Process the @code{lib} spec. This is a spec string for deciding which
libraries should be included on the command line to the linker.
@ -4158,6 +4183,12 @@ text, including the space. Thus two arguments would be generated.
Like %@{@code{S}*@}, but don't put a blank between a switch and its
argument. Thus %@{^o*@} would only generate one argument, not two.
@item %@{@code{S}*&@code{T}*@}
Like %@{@code{S}*@}, but preserve order of @code{S} and @code{T} options
(the order of @code{S} and @code{T} in the spec is not significant).
There can be any number of ampersand-separated variables; for each the
wild card is optional. Useful for CPP as @samp{%@{D*&U*&A*@}}.
@item %@{<@code{S}@}
Remove all occurrences of @code{-S} from the command line. Note - this
command is position dependent. @samp{%} commands in the spec string
@ -7269,11 +7300,11 @@ Identify the versions of each tool used by the compiler, in a
Refrain from adding @code{.ident} directives to the output file (this is
the default).
@item -YP,@var{dirs}
@item -YP\,@var{dirs}
Search the directories @var{dirs}, and no others, for libraries
specified with @samp{-l}.
@item -Ym,@var{dir}
@item -Ym\,@var{dir}
Look in the directory @var{dir} to find the M4 preprocessor.
The assembler uses this option.
@c This is supposed to go with a -Yd for predefined M4 macro files, but