From 371e300b1d0d80f36e8e039046a8e855e13d942f Mon Sep 17 00:00:00 2001 From: Nick Clifton Date: Tue, 23 Jan 2001 21:35:15 +0000 Subject: [PATCH] Replace , with \, inside @gccoptlist macros. Document %B and %j and %. and %v3 and %M and %{S*&T} spec switches. From-SVN: r39210 --- gcc/ChangeLog | 6 ++++++ gcc/invoke.texi | 51 +++++++++++++++++++++++++++++++++++++++---------- 2 files changed, 47 insertions(+), 10 deletions(-) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 4812071c105..0a254aac525 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,9 @@ +2001-01-23 Nick Clifton + + * 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 * c4x.c (c4x_r11_set_p): Calculate rtx code correctly. diff --git a/gcc/invoke.texi b/gcc/invoke.texi index 6bee6fd667f..560041e741b 100644 --- a/gcc/invoke.texi +++ b/gcc/invoke.texi @@ -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 -- 2.30.2