[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

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

commit a767363d6b7218ff052f5a73ef527c955aa1f7a1
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..66f5ba119ea 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -9,5 +9,5 @@ References for Other Languages
 See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
-See :ref:`gfortran:standards`, for details
+See :ref:`fortran:standards`, for details
 of standards supported by GNU Fortran.
\ No newline at end of file
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..14bb3bb7fa9 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:install:option:`--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..f29d7248d64 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :gcc:option:`-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

https://gcc.gnu.org/g:1ebf5e4122b0d07f7737bfb0f613e89af37c9be0

commit 1ebf5e4122b0d07f7737bfb0f613e89af37c9be0
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..b74c27e0fff 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -10,4 +10,4 @@ See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
 See :ref:`gfortran:standards`, for details
-of standards supported by GNU Fortran.
\ No newline at end of file
+of standards supported by GNU Fortran.
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..7ca45310ffe 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:option:`install:--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..0a079976f53 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :option:`gcc:-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

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

commit e40bc0e5939dfa0d28131ee6c47082bcc08fbbef
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..b74c27e0fff 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -10,4 +10,4 @@ See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
 See :ref:`gfortran:standards`, for details
-of standards supported by GNU Fortran.
\ No newline at end of file
+of standards supported by GNU Fortran.
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..7ca45310ffe 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:option:`install:--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..0a079976f53 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :option:`gcc:-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

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

commit c4f43e485ee00fbb9319b9d7e83dbdd7af6c7282
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..b74c27e0fff 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -10,4 +10,4 @@ See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
 See :ref:`gfortran:standards`, for details
-of standards supported by GNU Fortran.
\ No newline at end of file
+of standards supported by GNU Fortran.
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..7ca45310ffe 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:option:`install:--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..0a079976f53 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :option:`gcc:-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

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

commit c71902426ef1c2885d69b234200a03d0e9814b0d
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..b74c27e0fff 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -10,4 +10,4 @@ See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
 See :ref:`gfortran:standards`, for details
-of standards supported by GNU Fortran.
\ No newline at end of file
+of standards supported by GNU Fortran.
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..7ca45310ffe 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:option:`install:--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..0a079976f53 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :option:`gcc:-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

https://gcc.gnu.org/g:60db9f5edfb2538bf16fee027205c0e31a8b7e8f

commit 60db9f5edfb2538bf16fee027205c0e31a8b7e8f
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..66f5ba119ea 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -9,5 +9,5 @@ References for Other Languages
 See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
-See :ref:`gfortran:standards`, for details
+See :ref:`fortran:standards`, for details
 of standards supported by GNU Fortran.
\ No newline at end of file
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..14bb3bb7fa9 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:install:option:`--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..f29d7248d64 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :gcc:option:`-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

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

commit f3d5592caf67c452c8506cf88a55ff17c003ae7c
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..66f5ba119ea 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -9,5 +9,5 @@ References for Other Languages
 See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
-See :ref:`gfortran:standards`, for details
+See :ref:`fortran:standards`, for details
 of standards supported by GNU Fortran.
\ No newline at end of file
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..14bb3bb7fa9 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:install:option:`--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..f29d7248d64 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :gcc:option:`-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

https://gcc.gnu.org/g:70bd1597131f26f213a5af76f4451a164a388de6

commit 70bd1597131f26f213a5af76f4451a164a388de6
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..66f5ba119ea 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -9,5 +9,5 @@ References for Other Languages
 See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
-See :ref:`gfortran:standards`, for details
+See :ref:`fortran:standards`, for details
 of standards supported by GNU Fortran.
\ No newline at end of file
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..14bb3bb7fa9 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:install:option:`--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..f29d7248d64 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :gcc:option:`-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

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

commit ae9bec18cd9119ea494a3581e3485708c282bc58
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..66f5ba119ea 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -9,5 +9,5 @@ References for Other Languages
 See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
-See :ref:`gfortran:standards`, for details
+See :ref:`fortran:standards`, for details
 of standards supported by GNU Fortran.
\ No newline at end of file
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..14bb3bb7fa9 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:install:option:`--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..f29d7248d64 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :gcc:option:`-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

https://gcc.gnu.org/g:0914c51a2315fc221afcc5e92a0118b4e7f1415f

commit 0914c51a2315fc221afcc5e92a0118b4e7f1415f
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..66f5ba119ea 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -9,5 +9,5 @@ References for Other Languages
 See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
-See :ref:`gfortran:standards`, for details
+See :ref:`fortran:standards`, for details
 of standards supported by GNU Fortran.
\ No newline at end of file
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..14bb3bb7fa9 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:install:option:`--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..f29d7248d64 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :gcc:option:`-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

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

commit f380ad65b1950e806aad94a64c8fceafa8dcc8e0
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..66f5ba119ea 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -9,5 +9,5 @@ References for Other Languages
 See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
-See :ref:`gfortran:standards`, for details
+See :ref:`fortran:standards`, for details
 of standards supported by GNU Fortran.
\ No newline at end of file
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..14bb3bb7fa9 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:install:option:`--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..f29d7248d64 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :gcc:option:`-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

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

commit ff0d210106f46541d7261434b171a62e8497c9b0
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..66f5ba119ea 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -9,5 +9,5 @@ References for Other Languages
 See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
-See :ref:`gfortran:standards`, for details
+See :ref:`fortran:standards`, for details
 of standards supported by GNU Fortran.
\ No newline at end of file
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..14bb3bb7fa9 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:install:option:`--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..f29d7248d64 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :gcc:option:`-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

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

commit f68ece481fc58fc7cc6f0437d24623766f44262f
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..66f5ba119ea 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -9,5 +9,5 @@ References for Other Languages
 See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
-See :ref:`gfortran:standards`, for details
+See :ref:`fortran:standards`, for details
 of standards supported by GNU Fortran.
\ No newline at end of file
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..14bb3bb7fa9 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:install:option:`--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..f29d7248d64 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :gcc:option:`-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

https://gcc.gnu.org/g:20e3dfc6a0a2f314ba1d46c3cc9ceb11de91e5c8

commit 20e3dfc6a0a2f314ba1d46c3cc9ceb11de91e5c8
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..66f5ba119ea 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -9,5 +9,5 @@ References for Other Languages
 See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
-See :ref:`gfortran:standards`, for details
+See :ref:`fortran:standards`, for details
 of standards supported by GNU Fortran.
\ No newline at end of file
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..14bb3bb7fa9 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:install:option:`--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..f29d7248d64 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :gcc:option:`-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c

[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: fix cross manual references

[Martin Liska]

https://gcc.gnu.org/g:6216028ab4b378772a842e0f2ed2a0d9c4f87e57

commit 6216028ab4b378772a842e0f2ed2a0d9c4f87e57
Author: Martin Liska <mliska@suse.cz>
Date:   Thu Jul 28 02:09:54 2022 +0200

    sphinx: fix cross manual references
    
    gcc/ada/ChangeLog:
    
            * doc/gnat_rm/index.rst: Fix cross manual refs.
    
    gcc/ChangeLog:
    
            * doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst:
            Fix cross manual refs.
            * doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst:
            Likewise.
    
    gcc/jit/ChangeLog:
    
            * doc/internals/index.rst: Fix cross manual refs.
            * doc/topics/contexts.rst: Likewise.

Diff:
---
 gcc/ada/doc/gnat_rm/index.rst                                         | 3 ++-
 .../gcc-command-options/options-controlling-the-kind-of-output.rst    | 2 +-
 .../references-for-other-languages.rst                                | 2 +-
 gcc/jit/doc/internals/index.rst                                       | 2 +-
 gcc/jit/doc/topics/contexts.rst                                       | 4 ++--
 5 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/gcc/ada/doc/gnat_rm/index.rst b/gcc/ada/doc/gnat_rm/index.rst
index 6c2616a0f1c..372c2100e51 100644
--- a/gcc/ada/doc/gnat_rm/index.rst
+++ b/gcc/ada/doc/gnat_rm/index.rst
@@ -1,6 +1,7 @@
+.. _top:
+
 GNAT Reference Manual
 =====================
-
 .. only:: not latex
 
     *GNAT, The GNU Ada Development Environment*
diff --git a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
index 61420c1c395..ea9e3cfc168 100644
--- a/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
+++ b/gcc/doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst
@@ -700,7 +700,7 @@ one of the options :option:`-c`, :option:`-S`, or :option:`-E` to say where
 .. option:: -fdump-ada-spec[-slim]
 
   For C and C++ source and include files, generate corresponding Ada specs.
-  See :ref:`gnat_ugn:generating-ada-bindings-for-c-and-c++-headers`, which provides detailed documentation on this feature.
+  See :ref:`gnat_ugn:Generating_Ada_Bindings_for_C_and_C++_headers`, which provides detailed documentation on this feature.
 
 .. option:: -fada-spec-parent={unit}
 
diff --git a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
index 001116ac260..66f5ba119ea 100644
--- a/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
+++ b/gcc/doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst
@@ -9,5 +9,5 @@ References for Other Languages
 See :ref:`gnat_rm:top`, for information on standard
 conformance and compatibility of the Ada compiler.
 
-See :ref:`gfortran:standards`, for details
+See :ref:`fortran:standards`, for details
 of standards supported by GNU Fortran.
\ No newline at end of file
diff --git a/gcc/jit/doc/internals/index.rst b/gcc/jit/doc/internals/index.rst
index 092380c8f20..14bb3bb7fa9 100644
--- a/gcc/jit/doc/internals/index.rst
+++ b/gcc/jit/doc/internals/index.rst
@@ -173,7 +173,7 @@ For example, the following invocation verbosely runs the testcase
   (...shows full valgrind report for this test case...)
 
 When running under valgrind, it's best to have configured gcc with
-:option:`--enable-valgrind-annotations`, which automatically suppresses
+:install:option:`--enable-valgrind-annotations`, which automatically suppresses
 various known false positives.
 
 Environment variables
diff --git a/gcc/jit/doc/topics/contexts.rst b/gcc/jit/doc/topics/contexts.rst
index b1a7a0af56f..f29d7248d64 100644
--- a/gcc/jit/doc/topics/contexts.rst
+++ b/gcc/jit/doc/topics/contexts.rst
@@ -237,7 +237,7 @@ future activies on a context to the given `FILE *`.
    a much simpler executable that performs the equivalent calls into
    libgccjit, without needing the client code and its data.
 
-   Typically you need to supply :option:`-Wno-unused-variable` when
+   Typically you need to supply :gcc:option:`-Wno-unused-variable` when
    compiling the generated file (since the result of each API call is
    assigned to a unique variable within the generated C source, and not
    all are necessarily then used).
@@ -252,7 +252,7 @@ future activies on a context to the given `FILE *`.
 
    Parameter "dumpname" corresponds to the equivalent gcc command-line
    option, without the "-fdump-" prefix.
-   For example, to get the equivalent of :option:`-fdump-tree-vrp1`,
+   For example, to get the equivalent of :option:`-fdump-tree-vrp <gcc:-fdump-tree-all>`,
    supply ``"tree-vrp1"``:
 
    .. code-block:: c