[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content

public inbox for gcc-cvs@sourceware.org
help / color / mirror / Atom feed

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-07 14:09 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-07 14:09 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:5d1c0a731e52fef64c50f2b455a0373689b36a96

commit 5d1c0a731e52fef64c50f2b455a0373689b36a96
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-08 14:53 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-08 14:53 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:d2d892d3c8eca981daa9b117812c794ba670c2b7

commit d2d892d3c8eca981daa9b117812c794ba670c2b7
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-08 14:43 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-08 14:43 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:e6e50f0e7e6128b9216d5cb09446d83ebb24bb80

commit e6e50f0e7e6128b9216d5cb09446d83ebb24bb80
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-08 14:36 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-08 14:36 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:82512f85f81dd9fc0b385b3bc10d5a669e6a1b40

commit 82512f85f81dd9fc0b385b3bc10d5a669e6a1b40
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-08 14:35 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-08 14:35 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:d842ad39295905104f94f2af64044749e7688a44

commit d842ad39295905104f94f2af64044749e7688a44
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-08 12:06 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-08 12:06 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:82f088368edd455041fcd75e0e2cf0def6a9b365

commit 82f088368edd455041fcd75e0e2cf0def6a9b365
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-08 11:39 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-08 11:39 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:9e20ee6159cc13d70bb1fa780e0c9dff8d21e9d2

commit 9e20ee6159cc13d70bb1fa780e0c9dff8d21e9d2
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-08 10:21 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-08 10:21 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:a1e8401c70acee5f6f11ae266a9f49444f80b3c4

commit a1e8401c70acee5f6f11ae266a9f49444f80b3c4
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-07 14:34 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-07 14:34 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:0951d9238ca159b257d6891a7dbd03a3a2c0c23e

commit 0951d9238ca159b257d6891a7dbd03a3a2c0c23e
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-07 14:19 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-07 14:19 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:d95af921088d15c89411bc9cca35f24498b2db51

commit d95af921088d15c89411bc9cca35f24498b2db51
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-07 14:10 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-07 14:10 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:c2bc47cbd6c2302de46f163ba67b91a3159b3502

commit c2bc47cbd6c2302de46f163ba67b91a3159b3502
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-07 14:07 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-07 14:07 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:2af81e5f04ae0e63681706dc3d6b9938500a0fe6

commit 2af81e5f04ae0e63681706dc3d6b9938500a0fe6
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-07 13:21 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-07 13:21 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:09fcb2d0dd78515c43bd605998b59072d38f1d04

commit 09fcb2d0dd78515c43bd605998b59072d38f1d04
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content
@ 2022-11-07 13:01 Martin Liska
  0 siblings, 0 replies; 14+ messages in thread
From: Martin Liska @ 2022-11-07 13:01 UTC (permalink / raw)
  To: gcc-cvs

https://gcc.gnu.org/g:eb89c9c42600728909543fdd737da08784b671da

commit eb89c9c42600728909543fdd737da08784b671da
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 13:59:01 2022 +0100

    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:
---
 .../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, 7 insertions(+), 27 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 b39ec393ff0..6efe42f3515 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 7a18f0439ae..7b0c7f700a9 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 e7068d876b2..46a423a840d 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

^ permalink raw reply	[flat|nested] 14+ messages in thread

end of thread, other threads:[~2022-11-08 14:53 UTC | newest]

Thread overview: 14+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-11-07 14:09 [gcc(refs/users/marxin/heads/sphinx-final)] sphinx: do not use tm.rst.in with empty content Martin Liska
  -- strict thread matches above, loose matches on Subject: below --
2022-11-08 14:53 Martin Liska
2022-11-08 14:43 Martin Liska
2022-11-08 14:36 Martin Liska
2022-11-08 14:35 Martin Liska
2022-11-08 12:06 Martin Liska
2022-11-08 11:39 Martin Liska
2022-11-08 10:21 Martin Liska
2022-11-07 14:34 Martin Liska
2022-11-07 14:19 Martin Liska
2022-11-07 14:10 Martin Liska
2022-11-07 14:07 Martin Liska
2022-11-07 13:21 Martin Liska
2022-11-07 13:01 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).