diff options
Diffstat (limited to 'gcc/doc/tm.texi')
| -rw-r--r-- | gcc/doc/tm.texi | 55 |
1 files changed, 12 insertions, 43 deletions
diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi index a4f33a75db5..66a092fbc1a 100644 --- a/gcc/doc/tm.texi +++ b/gcc/doc/tm.texi @@ -126,21 +126,6 @@ should call @code{DEFAULT_WORD_SWITCH_TAKES_ARG} and then check for additional options. @end defmac -@defmac SWITCH_CURTAILS_COMPILATION (@var{char}) -A C expression which determines whether the option @option{-@var{char}} -stops compilation before the generation of an executable. The value is -boolean, nonzero if the option does stop an executable from being -generated, zero otherwise. - -By default, this macro is defined as -@code{DEFAULT_SWITCH_CURTAILS_COMPILATION}, which handles the standard -options properly. You need not define -@code{SWITCH_CURTAILS_COMPILATION} unless you wish to add additional -options which affect the generation of an executable. Any redefinition -should call @code{DEFAULT_SWITCH_CURTAILS_COMPILATION} and then check -for additional options. -@end defmac - @defmac TARGET_OPTION_TRANSLATE_TABLE If defined, a list of pairs of strings, the first of which is a potential command line target to the @file{gcc} driver program, and the @@ -757,6 +742,10 @@ only available in the C (and related language) front ends, then you should use @code{TARGET_HANDLE_C_OPTION} instead. @end deftypefn +@deftypefn {Target Hook} tree TARGET_OBJC_CONSTRUCT_STRING (tree @var{string}) +Construct a constant string representation for @var{string} +@end deftypefn + @defmac TARGET_VERSION This macro is a C statement to print on @code{stderr} a string describing the particular machine description choice. Every machine @@ -791,26 +780,19 @@ used to alter option flag variables which only exist in those frontends. @end defmac -@deftypefn {Target Hook} void TARGET_OPTION_OPTIMIZATION (int @var{level}, int @var{size}) +@deftypevr {Target Hook} {const struct default_options *} TARGET_OPTION_OPTIMIZATION_TABLE Some machines may desire to change what optimizations are performed for -various optimization levels. This hook, if defined, is executed once +various optimization levels. This variable, if defined, describes +options to enable at particular sets of optimization levels. These +options are processed once just after the optimization level is determined and before the remainder -of the command options have been parsed. Values set in this macro are -used as the default values for the other command line options. - -@var{level} is the optimization level specified; 2 if @option{-O2} is -specified, 1 if @option{-O} is specified, and 0 if neither is specified. +of the command options have been parsed, so may be overridden by other +options passed explicily. -@var{size} is nonzero if @option{-Os} is specified and zero otherwise. - -This macro is run once at program startup and when the optimization +This processing is run once at program startup and when the optimization options are changed via @code{#pragma GCC optimize} or by using the @code{optimize} attribute. - -@strong{Do not examine @code{write_symbols} in -this hook!} The debugging options are not supposed to alter the -generated code. -@end deftypefn +@end deftypevr @deftypefn {Target Hook} void TARGET_OPTION_INIT_STRUCT (struct gcc_options *@var{opts}) Set target-dependent initial values of fields in @var{opts}. @@ -827,12 +809,6 @@ chance to display extra information on the target specific command line options found in its @file{.opt} file. @end deftypefn -@defmac CAN_DEBUG_WITHOUT_FP -Define this macro if debugging can be performed even without a frame -pointer. If this macro is defined, GCC will turn on the -@option{-fomit-frame-pointer} option whenever @option{-O} is specified. -@end defmac - @defmac SWITCHABLE_TARGET Some targets need to switch between substantially different subtargets during compilation. For example, the MIPS target has one subtarget for @@ -942,13 +918,6 @@ order of words in memory is the same as the order in registers. This macro need not be a constant. @end defmac -@defmac LIBGCC2_WORDS_BIG_ENDIAN -Define this macro if @code{WORDS_BIG_ENDIAN} is not constant. This must be a -constant value with the same meaning as @code{WORDS_BIG_ENDIAN}, which will be -used only when compiling @file{libgcc2.c}. Typically the value will be set -based on preprocessor defines. -@end defmac - @defmac FLOAT_WORDS_BIG_ENDIAN Define this macro to have the value 1 if @code{DFmode}, @code{XFmode} or @code{TFmode} floating point numbers are stored in memory with the word |