public inbox for gcc-cvs@sourceware.org
help / color / mirror / Atom feed
* [gcc r13-3987] Revert "sphinx: do not use tm.rst.in with empty content"
@ 2022-11-14 8:38 Martin Liska
0 siblings, 0 replies; only message in thread
From: Martin Liska @ 2022-11-14 8:38 UTC (permalink / raw)
To: gcc-cvs
https://gcc.gnu.org/g:fcdbe60266928bf25dd93463371da66d43240cb6
commit r13-3987-gfcdbe60266928bf25dd93463371da66d43240cb6
Author: Martin Liska <mliska@suse.cz>
Date: Sun Nov 13 21:58:54 2022 +0100
Revert "sphinx: do not use tm.rst.in with empty content"
This reverts commit 66f55038a4238ce5fb1f198feb552653eb472d61.
Diff:
---
.../assembler-commands-for-exception-regions.rst | 10 ++++++++--
.../the-overall-framework-of-an-assembler-file.rst | 5 ++++-
.../target-macros/run-time-target-specification.rst | 19 +++++++++++++++----
3 files changed, 27 insertions(+), 7 deletions(-)
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 6efe42f3515..b39ec393ff0 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,7 +54,10 @@ region.
``INCOMING_RETURN_ADDR_RTX`` and ``OBJECT_FORMAT_ELF``),
GCC will provide a default definition of 1.
-.. function:: enum unwind_info_type TARGET_EXCEPT_UNWIND_INFO (struct gcc_options *opts)
+.. include:: ../tm.rst.in
+ :start-after: [TARGET_EXCEPT_UNWIND_INFO]
+ :end-before: [TARGET_EXCEPT_UNWIND_INFO]
+
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
@@ -80,7 +83,10 @@ region.
``DWARF2_UNWIND_INFO`` depends on command-line options, the target
must define this hook so that :samp:`{opts}` is used correctly.
-.. c:var:: bool TARGET_UNWIND_TABLES_DEFAULT
+.. include:: ../tm.rst.in
+ :start-after: [TARGET_UNWIND_TABLES_DEFAULT]
+ :end-before: [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 7b0c7f700a9..7a18f0439ae 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,7 +128,10 @@ This describes the overall framework of an assembly file.
:end-before: [TARGET_ASM_FUNCTION_SWITCHED_TEXT_SECTIONS]
-.. c:var:: bool TARGET_HAVE_NAMED_SECTIONS
+.. include:: ../tm.rst.in
+ :start-after: [TARGET_HAVE_NAMED_SECTIONS]
+ :end-before: [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 46a423a840d..e7068d876b2 100644
--- a/gcc/doc/gccint/target-macros/run-time-target-specification.rst
+++ b/gcc/doc/gccint/target-macros/run-time-target-specification.rst
@@ -67,15 +67,20 @@ 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.
-.. c:var:: int TARGET_DEFAULT_TARGET_FLAGS
+.. include:: tm.rst.in
+ :start-after: [TARGET_DEFAULT_TARGET_FLAGS]
+ :end-before: [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
@@ -89,7 +94,10 @@ any target-specific headers.
option was passed (``UNKNOWN_LOCATION`` except for options passed
via attributes).
-.. function:: bool TARGET_HANDLE_C_OPTION (size_t code, const char *arg, int value)
+.. include:: tm.rst.in
+ :start-after: [TARGET_HANDLE_C_OPTION]
+ :end-before: [TARGET_HANDLE_C_OPTION]
+
This target hook is called whenever the user specifies one of the
target-specific C language family options described by the :samp:`.opt`
@@ -141,7 +149,10 @@ any target-specific headers.
used to alter option flag variables which only exist in those
frontends.
-.. c:var:: const struct default_options * TARGET_OPTION_OPTIMIZATION_TABLE
+.. include:: tm.rst.in
+ :start-after: [TARGET_OPTION_OPTIMIZATION_TABLE]
+ :end-before: [TARGET_OPTION_OPTIMIZATION_TABLE]
+
Some machines may desire to change what optimizations are performed for
various optimization levels. This variable, if defined, describes
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2022-11-14 8:38 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-11-14 8:38 [gcc r13-3987] Revert "sphinx: do not use tm.rst.in with empty content" Martin Liska
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).