docs: Fix long standing linking antipattern.
Before we learned about :doc:, we used :ref: and put a dummy link at the
top of each page. Don't do that anymore.
This fixes PR14891 as a special case.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@172162 91177308-0d34-0410-b5e6-96231b3b80d8
diff --git a/docs/userguides.rst b/docs/userguides.rst
index c0a4356..e7e4518 100644
--- a/docs/userguides.rst
+++ b/docs/userguides.rst
@@ -1,5 +1,3 @@
-.. _userguides:
-
User Guides
===========
@@ -26,18 +24,18 @@
Passes
YamlIO
-* :ref:`getting_started`
+* :doc:`GettingStarted`
Discusses how to get up and running quickly with the LLVM infrastructure.
Everything from unpacking and compilation of the distribution to execution
of some tools.
-* :ref:`building-with-cmake`
+* :doc:`CMake`
An addendum to the main Getting Started guide for those using the `CMake
build system <http://www.cmake.org>`_.
-* :ref:`how_to_build_on_arm`
+* :doc:`HowToBuildOnARM`
Notes on building and testing LLVM/Clang on ARM.
@@ -51,11 +49,11 @@
Tutorials about using LLVM. Includes a tutorial about making a custom
language with LLVM.
-* :ref:`developer_policy`
+* :doc:`DeveloperPolicy`
The LLVM project's policy towards developers and their contributions.
-* :ref:`LLVM Command Guide <commands>`
+* :doc:`LLVM Command Guide <CommandGuide/index>`
A reference manual for the LLVM command line utilities ("man" pages for LLVM
tools).
@@ -64,7 +62,7 @@
A list of optimizations and analyses implemented in LLVM.
-* :ref:`faq`
+* :doc:`FAQ`
A list of common questions and problems and their solutions.
@@ -72,7 +70,7 @@
This describes new features, known bugs, and other limitations.
-* :ref:`how-to-submit-a-bug-report`
+* :doc:`HowToSubmitABug`
Instructions for properly submitting information about any bugs you run into
in the LLVM system.
@@ -89,19 +87,19 @@
Instructions for building the clang front-end from source.
-* :ref:`packaging`
+* :doc:`Packaging`
Advice on packaging LLVM into a distribution.
-* :ref:`lexicon`
+* :doc:`Lexicon`
Definition of acronyms, terms and concepts used in LLVM.
-* :ref:`how_to_add_a_builder`
+* :doc:`HowToAddABuilder`
Instructions for adding new builder to LLVM buildbot master.
-* :ref:`yamlio`
+* :doc:`YamlIO`
A reference guide for using LLVM's YAML I/O library.