From: Martin Liska Date: Mon, 7 Nov 2022 12:59:01 +0000 (+0100) Subject: sphinx: do not use tm.rst.in with empty content X-Git-Tag: basepoints/gcc-14~3369 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=66f55038a4238ce5fb1f198feb552653eb472d61;p=thirdparty%2Fgcc.git sphinx: do not use tm.rst.in with empty content gcc/ChangeLog: * doc/gccint/target-macros/defining-the-output-assembler-language/assembler-commands-for-exception-regions.rst: Do not include tm.rst.in. * doc/gccint/target-macros/defining-the-output-assembler-language/the-overall-framework-of-an-assembler-file.rst: Likewise. * doc/gccint/target-macros/run-time-target-specification.rst: Likewise. --- diff --git a/gcc/doc/gccint/target-macros/defining-the-output-assembler-language/assembler-commands-for-exception-regions.rst b/gcc/doc/gccint/target-macros/defining-the-output-assembler-language/assembler-commands-for-exception-regions.rst index b39ec393ff07..6efe42f3515e 100644 --- a/gcc/doc/gccint/target-macros/defining-the-output-assembler-language/assembler-commands-for-exception-regions.rst +++ b/gcc/doc/gccint/target-macros/defining-the-output-assembler-language/assembler-commands-for-exception-regions.rst @@ -54,10 +54,7 @@ region. ``INCOMING_RETURN_ADDR_RTX`` and ``OBJECT_FORMAT_ELF``), GCC will provide a default definition of 1. -.. include:: ../tm.rst.in - :start-after: [TARGET_EXCEPT_UNWIND_INFO] - :end-before: [TARGET_EXCEPT_UNWIND_INFO] - +.. function:: enum unwind_info_type TARGET_EXCEPT_UNWIND_INFO (struct gcc_options *opts) This hook defines the mechanism that will be used for exception handling by the target. If the target has ABI specified unwind tables, the hook @@ -83,10 +80,7 @@ region. ``DWARF2_UNWIND_INFO`` depends on command-line options, the target must define this hook so that :samp:`{opts}` is used correctly. -.. include:: ../tm.rst.in - :start-after: [TARGET_UNWIND_TABLES_DEFAULT] - :end-before: [TARGET_UNWIND_TABLES_DEFAULT] - +.. c:var:: bool TARGET_UNWIND_TABLES_DEFAULT This variable should be set to ``true`` if the target ABI requires unwinding tables even when exceptions are not used. It must not be modified by diff --git a/gcc/doc/gccint/target-macros/defining-the-output-assembler-language/the-overall-framework-of-an-assembler-file.rst b/gcc/doc/gccint/target-macros/defining-the-output-assembler-language/the-overall-framework-of-an-assembler-file.rst index 7a18f0439ae9..7b0c7f700a94 100644 --- a/gcc/doc/gccint/target-macros/defining-the-output-assembler-language/the-overall-framework-of-an-assembler-file.rst +++ b/gcc/doc/gccint/target-macros/defining-the-output-assembler-language/the-overall-framework-of-an-assembler-file.rst @@ -128,10 +128,7 @@ This describes the overall framework of an assembly file. :end-before: [TARGET_ASM_FUNCTION_SWITCHED_TEXT_SECTIONS] -.. include:: ../tm.rst.in - :start-after: [TARGET_HAVE_NAMED_SECTIONS] - :end-before: [TARGET_HAVE_NAMED_SECTIONS] - +.. c:var:: bool TARGET_HAVE_NAMED_SECTIONS This flag is true if the target supports ``TARGET_ASM_NAMED_SECTION``. It must not be modified by command-line option processing. diff --git a/gcc/doc/gccint/target-macros/run-time-target-specification.rst b/gcc/doc/gccint/target-macros/run-time-target-specification.rst index e7068d876b24..46a423a840d2 100644 --- a/gcc/doc/gccint/target-macros/run-time-target-specification.rst +++ b/gcc/doc/gccint/target-macros/run-time-target-specification.rst @@ -67,20 +67,15 @@ Here are run-time target specifications. Variable extern int target_flagsThis variable is declared in :samp:`options.h`, which is included before any target-specific headers. -.. include:: tm.rst.in - :start-after: [TARGET_DEFAULT_TARGET_FLAGS] - :end-before: [TARGET_DEFAULT_TARGET_FLAGS] - +.. c:var:: int TARGET_DEFAULT_TARGET_FLAGS This variable specifies the initial value of ``target_flags``. Its default setting is 0. .. index:: optional hardware or system features, features, optional, in system conventions -.. include:: tm.rst.in - :start-after: [TARGET_HANDLE_OPTION] - :end-before: [TARGET_HANDLE_OPTION] +.. function:: bool TARGET_HANDLE_OPTION (struct gcc_options *opts, struct gcc_options *opts_set, const struct cl_decoded_option *decoded, location_t loc) This hook is called whenever the user specifies one of the target-specific options described by the :samp:`.opt` definition files @@ -94,10 +89,7 @@ any target-specific headers. option was passed (``UNKNOWN_LOCATION`` except for options passed via attributes). -.. include:: tm.rst.in - :start-after: [TARGET_HANDLE_C_OPTION] - :end-before: [TARGET_HANDLE_C_OPTION] - +.. function:: bool TARGET_HANDLE_C_OPTION (size_t code, const char *arg, int value) This target hook is called whenever the user specifies one of the target-specific C language family options described by the :samp:`.opt` @@ -149,10 +141,7 @@ any target-specific headers. used to alter option flag variables which only exist in those frontends. -.. include:: tm.rst.in - :start-after: [TARGET_OPTION_OPTIMIZATION_TABLE] - :end-before: [TARGET_OPTION_OPTIMIZATION_TABLE] - +.. c:var:: const struct default_options * TARGET_OPTION_OPTIMIZATION_TABLE Some machines may desire to change what optimizations are performed for various optimization levels. This variable, if defined, describes