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.
This commit is contained in:
Martin Liska 2022-11-07 13:59:01 +01:00
parent 7231864243
commit 66f55038a4
3 changed files with 7 additions and 27 deletions

View file

@ -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

View file

@ -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.

View file

@ -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