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

Martin Liska marxin@gcc.gnu.org
Thu Jul 28 12:24:29 GMT 2022


https://gcc.gnu.org/g:67a1a5fdd31f9cd369dd173d69a43fbf80164f0a

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

    sphinx: fix cross manual references

Diff:
---
 doc/baseconf.py                                                       | 1 -
 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 ++--
 6 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/doc/baseconf.py b/doc/baseconf.py
index 1e212170c42..87cda64329b 100644
--- a/doc/baseconf.py
+++ b/doc/baseconf.py
@@ -131,7 +131,6 @@ man_pages = []
 # FIXME: handle WARNINGs: unknown option issues and cross refs
 suppress_warnings = [
     'ref.option',
-    'ref.ref'
 ]
 
 # Use xelatex by default
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 dab61402b45..798aadb32f0 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
@@ -704,7 +704,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 c0434cb4357..fdb6c96358b 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 9200181bba4..3f759da49ce 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


More information about the Gcc-cvs mailing list