From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 1851) id E5E18383236F; Mon, 14 Nov 2022 08:38:47 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org E5E18383236F DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1668415127; bh=vYR72buflfjIWz2u7CSLtd6Xf59Y5Zkhje4bn4wlbK4=; h=From:To:Subject:Date:From; b=IwS28WYeb84TRmx6id0KncWloWxdhMk7p0+NB6LY6vkIPNhjmYEwv7W7w5Kyq34qV CQ7e9NRzX3M2KM2w4I6AJO15x8DvulWSpn7DZFIKUC5H4HwaAaDqfNAvUtKXjT/2kx j2mFPTXhgBpgdNn82UDb+rQAv36a674m8PTnUOGA= MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="utf-8" From: Martin Liska To: gcc-cvs@gcc.gnu.org Subject: [gcc r13-3987] Revert "sphinx: do not use tm.rst.in with empty content" X-Act-Checkin: gcc X-Git-Author: Martin Liska X-Git-Refname: refs/heads/master X-Git-Oldrev: 56de1406bc90428b629a064e869b6fe9b24dcf43 X-Git-Newrev: fcdbe60266928bf25dd93463371da66d43240cb6 Message-Id: <20221114083847.E5E18383236F@sourceware.org> Date: Mon, 14 Nov 2022 08:38:47 +0000 (GMT) List-Id: https://gcc.gnu.org/g:fcdbe60266928bf25dd93463371da66d43240cb6 commit r13-3987-gfcdbe60266928bf25dd93463371da66d43240cb6 Author: Martin Liska 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