[llvm-commits] [llvm] r172162 - in /llvm/trunk/docs: ./ CommandGuide/
Sean Silva
silvas at purdue.edu
Thu Jan 10 18:28:09 PST 2013
Author: silvas
Date: Thu Jan 10 20:28:08 2013
New Revision: 172162
URL: http://llvm.org/viewvc/llvm-project?rev=172162&view=rev
Log:
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.
Modified:
llvm/trunk/docs/AliasAnalysis.rst
llvm/trunk/docs/Atomics.rst
llvm/trunk/docs/BitCodeFormat.rst
llvm/trunk/docs/BranchWeightMetadata.rst
llvm/trunk/docs/Bugpoint.rst
llvm/trunk/docs/CMake.rst
llvm/trunk/docs/CodeGenerator.rst
llvm/trunk/docs/CodingStandards.rst
llvm/trunk/docs/CommandGuide/index.rst
llvm/trunk/docs/CommandLine.rst
llvm/trunk/docs/CompilerWriterInfo.rst
llvm/trunk/docs/DebuggingJITedCode.rst
llvm/trunk/docs/DeveloperPolicy.rst
llvm/trunk/docs/ExceptionHandling.rst
llvm/trunk/docs/ExtendingLLVM.rst
llvm/trunk/docs/FAQ.rst
llvm/trunk/docs/GetElementPtr.rst
llvm/trunk/docs/GettingStarted.rst
llvm/trunk/docs/GettingStartedVS.rst
llvm/trunk/docs/GoldPlugin.rst
llvm/trunk/docs/HowToAddABuilder.rst
llvm/trunk/docs/HowToBuildOnARM.rst
llvm/trunk/docs/HowToReleaseLLVM.rst
llvm/trunk/docs/HowToSetUpLLVMStyleRTTI.rst
llvm/trunk/docs/HowToSubmitABug.rst
llvm/trunk/docs/HowToUseInstrMappings.rst
llvm/trunk/docs/Lexicon.rst
llvm/trunk/docs/LinkTimeOptimization.rst
llvm/trunk/docs/MakefileGuide.rst
llvm/trunk/docs/MarkedUpDisassembly.rst
llvm/trunk/docs/Packaging.rst
llvm/trunk/docs/ProgrammersManual.rst
llvm/trunk/docs/Projects.rst
llvm/trunk/docs/SegmentedStacks.rst
llvm/trunk/docs/TableGenFundamentals.rst
llvm/trunk/docs/YamlIO.rst
llvm/trunk/docs/design_and_overview.rst
llvm/trunk/docs/development_process.rst
llvm/trunk/docs/index.rst
llvm/trunk/docs/mailing_lists.rst
llvm/trunk/docs/programming.rst
llvm/trunk/docs/subsystems.rst
llvm/trunk/docs/userguides.rst
llvm/trunk/docs/yaml2obj.rst
Modified: llvm/trunk/docs/AliasAnalysis.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/AliasAnalysis.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/AliasAnalysis.rst (original)
+++ llvm/trunk/docs/AliasAnalysis.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _alias_analysis:
-
==================================
LLVM Alias Analysis Infrastructure
==================================
Modified: llvm/trunk/docs/Atomics.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/Atomics.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/Atomics.rst (original)
+++ llvm/trunk/docs/Atomics.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _atomics:
-
==============================================
LLVM Atomic Instructions and Concurrency Guide
==============================================
Modified: llvm/trunk/docs/BitCodeFormat.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/BitCodeFormat.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/BitCodeFormat.rst (original)
+++ llvm/trunk/docs/BitCodeFormat.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _bitcode_format:
-
.. role:: raw-html(raw)
:format: html
Modified: llvm/trunk/docs/BranchWeightMetadata.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/BranchWeightMetadata.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/BranchWeightMetadata.rst (original)
+++ llvm/trunk/docs/BranchWeightMetadata.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _branch_weight:
-
===========================
LLVM Branch Weight Metadata
===========================
Modified: llvm/trunk/docs/Bugpoint.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/Bugpoint.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/Bugpoint.rst (original)
+++ llvm/trunk/docs/Bugpoint.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _bugpoint:
-
====================================
LLVM bugpoint tool: design and usage
====================================
Modified: llvm/trunk/docs/CMake.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/CMake.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/CMake.rst (original)
+++ llvm/trunk/docs/CMake.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _building-with-cmake:
-
========================
Building LLVM with CMake
========================
Modified: llvm/trunk/docs/CodeGenerator.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/CodeGenerator.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/CodeGenerator.rst (original)
+++ llvm/trunk/docs/CodeGenerator.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _code_generator:
-
==========================================
The LLVM Target-Independent Code Generator
==========================================
Modified: llvm/trunk/docs/CodingStandards.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/CodingStandards.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/CodingStandards.rst (original)
+++ llvm/trunk/docs/CodingStandards.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _coding_standards:
-
=====================
LLVM Coding Standards
=====================
Modified: llvm/trunk/docs/CommandGuide/index.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/CommandGuide/index.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/CommandGuide/index.rst (original)
+++ llvm/trunk/docs/CommandGuide/index.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _commands:
-
LLVM Command Guide
------------------
Modified: llvm/trunk/docs/CommandLine.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/CommandLine.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/CommandLine.rst (original)
+++ llvm/trunk/docs/CommandLine.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _commandline:
-
==============================
CommandLine 2.0 Library Manual
==============================
Modified: llvm/trunk/docs/CompilerWriterInfo.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/CompilerWriterInfo.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/CompilerWriterInfo.rst (original)
+++ llvm/trunk/docs/CompilerWriterInfo.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _compiler_writer_info:
-
========================================================
Architecture & Platform Information for Compiler Writers
========================================================
Modified: llvm/trunk/docs/DebuggingJITedCode.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/DebuggingJITedCode.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/DebuggingJITedCode.rst (original)
+++ llvm/trunk/docs/DebuggingJITedCode.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _debugging-jited-code:
-
==============================
Debugging JIT-ed Code With GDB
==============================
Modified: llvm/trunk/docs/DeveloperPolicy.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/DeveloperPolicy.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/DeveloperPolicy.rst (original)
+++ llvm/trunk/docs/DeveloperPolicy.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _developer_policy:
-
=====================
LLVM Developer Policy
=====================
Modified: llvm/trunk/docs/ExceptionHandling.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/ExceptionHandling.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/ExceptionHandling.rst (original)
+++ llvm/trunk/docs/ExceptionHandling.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _exception_handling:
-
==========================
Exception Handling in LLVM
==========================
Modified: llvm/trunk/docs/ExtendingLLVM.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/ExtendingLLVM.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/ExtendingLLVM.rst (original)
+++ llvm/trunk/docs/ExtendingLLVM.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _extending_llvm:
-
============================================================
Extending LLVM: Adding instructions, intrinsics, types, etc.
============================================================
Modified: llvm/trunk/docs/FAQ.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/FAQ.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/FAQ.rst (original)
+++ llvm/trunk/docs/FAQ.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _faq:
-
================================
Frequently Asked Questions (FAQ)
================================
Modified: llvm/trunk/docs/GetElementPtr.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/GetElementPtr.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/GetElementPtr.rst (original)
+++ llvm/trunk/docs/GetElementPtr.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _gep:
-
=======================================
The Often Misunderstood GEP Instruction
=======================================
Modified: llvm/trunk/docs/GettingStarted.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/GettingStarted.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/GettingStarted.rst (original)
+++ llvm/trunk/docs/GettingStarted.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _getting_started:
-
====================================
Getting Started with the LLVM System
====================================
Modified: llvm/trunk/docs/GettingStartedVS.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/GettingStartedVS.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/GettingStartedVS.rst (original)
+++ llvm/trunk/docs/GettingStartedVS.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _winvs:
-
==================================================================
Getting Started with the LLVM System using Microsoft Visual Studio
==================================================================
Modified: llvm/trunk/docs/GoldPlugin.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/GoldPlugin.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/GoldPlugin.rst (original)
+++ llvm/trunk/docs/GoldPlugin.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _gold-plugin:
-
====================
The LLVM gold plugin
====================
Modified: llvm/trunk/docs/HowToAddABuilder.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/HowToAddABuilder.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/HowToAddABuilder.rst (original)
+++ llvm/trunk/docs/HowToAddABuilder.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _how_to_add_a_builder:
-
===================================================================
How To Add Your Build Configuration To LLVM Buildbot Infrastructure
===================================================================
Modified: llvm/trunk/docs/HowToBuildOnARM.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/HowToBuildOnARM.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/HowToBuildOnARM.rst (original)
+++ llvm/trunk/docs/HowToBuildOnARM.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _how_to_build_on_arm:
-
===================================================================
How To Build On ARM
===================================================================
Modified: llvm/trunk/docs/HowToReleaseLLVM.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/HowToReleaseLLVM.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/HowToReleaseLLVM.rst (original)
+++ llvm/trunk/docs/HowToReleaseLLVM.rst Thu Jan 10 20:28:08 2013
@@ -196,7 +196,7 @@
Build ``Debug``, ``Release+Asserts``, and ``Release`` versions
of ``llvm`` on all supported platforms. Directions to build ``llvm``
-are :ref:`here <getting_started>`.
+are :doc:`here <GettingStarted>`.
Build Clang Binary Distribution
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Modified: llvm/trunk/docs/HowToSetUpLLVMStyleRTTI.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/HowToSetUpLLVMStyleRTTI.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/HowToSetUpLLVMStyleRTTI.rst (original)
+++ llvm/trunk/docs/HowToSetUpLLVMStyleRTTI.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _how-to-set-up-llvm-style-rtti:
-
======================================================
How to set up LLVM-style RTTI for your class hierarchy
======================================================
Modified: llvm/trunk/docs/HowToSubmitABug.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/HowToSubmitABug.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/HowToSubmitABug.rst (original)
+++ llvm/trunk/docs/HowToSubmitABug.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _how-to-submit-a-bug-report:
-
================================
How to submit an LLVM bug report
================================
Modified: llvm/trunk/docs/HowToUseInstrMappings.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/HowToUseInstrMappings.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/HowToUseInstrMappings.rst (original)
+++ llvm/trunk/docs/HowToUseInstrMappings.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _how_to_use_instruction_mappings:
-
===============================
How To Use Instruction Mappings
===============================
Modified: llvm/trunk/docs/Lexicon.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/Lexicon.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/Lexicon.rst (original)
+++ llvm/trunk/docs/Lexicon.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _lexicon:
-
================
The LLVM Lexicon
================
Modified: llvm/trunk/docs/LinkTimeOptimization.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/LinkTimeOptimization.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/LinkTimeOptimization.rst (original)
+++ llvm/trunk/docs/LinkTimeOptimization.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _lto:
-
======================================================
LLVM Link Time Optimization: Design and Implementation
======================================================
Modified: llvm/trunk/docs/MakefileGuide.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/MakefileGuide.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/MakefileGuide.rst (original)
+++ llvm/trunk/docs/MakefileGuide.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _makefile_guide:
-
===================
LLVM Makefile Guide
===================
Modified: llvm/trunk/docs/MarkedUpDisassembly.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/MarkedUpDisassembly.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/MarkedUpDisassembly.rst (original)
+++ llvm/trunk/docs/MarkedUpDisassembly.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _marked_up_disassembly:
-
=======================================
LLVM's Optional Rich Disassembly Output
=======================================
Modified: llvm/trunk/docs/Packaging.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/Packaging.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/Packaging.rst (original)
+++ llvm/trunk/docs/Packaging.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _packaging:
-
========================
Advice on Packaging LLVM
========================
Modified: llvm/trunk/docs/ProgrammersManual.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/ProgrammersManual.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/ProgrammersManual.rst (original)
+++ llvm/trunk/docs/ProgrammersManual.rst Thu Jan 10 20:28:08 2013
@@ -77,8 +77,8 @@
(even better, get the book)
<http://www.mindview.net/Books/TICPP/ThinkingInCPP2e.html>`_.
-You are also encouraged to take a look at the :ref:`LLVM Coding Standards
-<coding_standards>` guide which focuses on how to write maintainable code more
+You are also encouraged to take a look at the :doc:`LLVM Coding Standards
+<CodingStandards>` guide which focuses on how to write maintainable code more
than where to put your curly braces.
.. _resources:
@@ -178,8 +178,8 @@
These five templates can be used with any classes, whether they have a v-table
or not. If you want to add support for these templates, see the document
-:ref:`How to set up LLVM-style RTTI for your class hierarchy
-<how-to-set-up-llvm-style-rtti>`
+:doc:`How to set up LLVM-style RTTI for your class hierarchy
+<HowToSetUpLLVMStyleRTTI>`
.. _string_apis:
Modified: llvm/trunk/docs/Projects.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/Projects.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/Projects.rst (original)
+++ llvm/trunk/docs/Projects.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _projects:
-
========================
Creating an LLVM Project
========================
Modified: llvm/trunk/docs/SegmentedStacks.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/SegmentedStacks.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/SegmentedStacks.rst (original)
+++ llvm/trunk/docs/SegmentedStacks.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _segmented_stacks:
-
========================
Segmented Stacks in LLVM
========================
Modified: llvm/trunk/docs/TableGenFundamentals.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/TableGenFundamentals.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/TableGenFundamentals.rst (original)
+++ llvm/trunk/docs/TableGenFundamentals.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _tablegen:
-
=====================
TableGen Fundamentals
=====================
Modified: llvm/trunk/docs/YamlIO.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/YamlIO.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/YamlIO.rst (original)
+++ llvm/trunk/docs/YamlIO.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _yamlio:
-
=====================
YAML I/O
=====================
Modified: llvm/trunk/docs/design_and_overview.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/design_and_overview.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/design_and_overview.rst (original)
+++ llvm/trunk/docs/design_and_overview.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _design_and_overview:
-
LLVM Design & Overview
======================
@@ -31,7 +29,7 @@
More details (quite old now).
-* :ref:`gep`
+* :doc:`GetElementPtr`
Answers to some very frequent questions about LLVM's most frequently
misunderstood instruction.
Modified: llvm/trunk/docs/development_process.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/development_process.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/development_process.rst (original)
+++ llvm/trunk/docs/development_process.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _development_process:
-
Development Process Documentation
=================================
@@ -11,7 +9,7 @@
LLVMBuild
HowToReleaseLLVM
-* :ref:`projects`
+* :doc:`Projects`
How-to guide and templates for new projects that *use* the LLVM
infrastructure. The templates (directory organization, Makefiles, and test
@@ -23,7 +21,7 @@
Describes the LLVMBuild organization and files used by LLVM to specify
component descriptions.
-* :ref:`makefile_guide`
+* :doc:`MakefileGuide`
Describes how the LLVM makefiles work and how to use them.
Modified: llvm/trunk/docs/index.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/index.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/index.rst (original)
+++ llvm/trunk/docs/index.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _contents:
-
Overview
========
@@ -18,7 +16,7 @@
* **Design & Overview**
Several introductory papers and presentations are available at
- :ref:`design_and_overview`.
+ :doc:`design_and_overview`.
* **Publications**
@@ -26,7 +24,7 @@
* **User Guides**
- Those new to the LLVM system should first visit the :ref:`userguides`.
+ Those new to the LLVM system should first visit the :doc:`userguides`.
NOTE: If you are a user who is only interested in using LLVM-based
compilers, you should look into `Clang <http://clang.llvm.org>`_ or
@@ -37,21 +35,21 @@
* **API Clients**
Developers of applications which use LLVM as a library should visit the
- :ref:`programming`.
+ :doc:`programming`.
* **Subsystems**
API clients and LLVM developers may be interested in the
- :ref:`subsystems` documentation.
+ :doc:`subsystems` documentation.
* **Development Process**
Additional documentation on the LLVM project can be found at
- :ref:`development_process`.
+ :doc:`development_process`.
* **Mailing Lists**
- For more information, consider consulting the LLVM :ref:`mailing_lists`.
+ For more information, consider consulting the LLVM :doc:`mailing_lists`.
.. toctree::
:maxdepth: 2
Modified: llvm/trunk/docs/mailing_lists.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/mailing_lists.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/mailing_lists.rst (original)
+++ llvm/trunk/docs/mailing_lists.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _mailing_lists:
-
Mailing Lists
=============
Modified: llvm/trunk/docs/programming.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/programming.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/programming.rst (original)
+++ llvm/trunk/docs/programming.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _programming:
-
Programming Documentation
=========================
@@ -14,12 +12,12 @@
HowToSetUpLLVMStyleRTTI
ProgrammersManual
-* `LLVM Language Reference Manual <LangRef.html>`_
+* :doc:`LLVM Language Reference Manual <LangRef>`
Defines the LLVM intermediate representation and the assembly form of the
different nodes.
-* :ref:`atomics`
+* :doc:`Atomics`
Information about LLVM's concurrency model.
@@ -28,11 +26,11 @@
Introduction to the general layout of the LLVM sourcebase, important classes
and APIs, and some tips & tricks.
-* :ref:`commandline`
+* :doc:`CommandLine`
Provides information on using the command line parsing library.
-* :ref:`coding_standards`
+* :doc:`CodingStandards`
Details the LLVM coding standards and provides useful information on writing
efficient C++ code.
@@ -42,7 +40,7 @@
How to make ``isa<>``, ``dyn_cast<>``, etc. available for clients of your
class hierarchy.
-* :ref:`extending_llvm`
+* :doc:`ExtendingLLVM`
Look here to see how to add instructions and intrinsics to LLVM.
@@ -53,6 +51,6 @@
* `ViewVC Repository Browser <http://llvm.org/viewvc/>`_
-* :ref:`compiler_writer_info`
+* :doc:`CompilerWriterInfo`
A list of helpful links for compiler writers.
Modified: llvm/trunk/docs/subsystems.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/subsystems.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/subsystems.rst (original)
+++ llvm/trunk/docs/subsystems.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _subsystems:
-
Subsystem Documentation
=======================
@@ -34,18 +32,18 @@
Information on how to write LLVM backends for machine targets.
-* :ref:`code_generator`
+* :doc:`CodeGenerator`
The design and implementation of the LLVM code generator. Useful if you are
working on retargetting LLVM to a new architecture, designing a new codegen
pass, or enhancing existing components.
-* :ref:`tablegen`
+* :doc:`TableGenFundamentals`
Describes the TableGen tool, which is used heavily by the LLVM code
generator.
-* :ref:`alias_analysis`
+* :doc:`AliasAnalysis`
Information on how to write a new alias analysis implementation or how to
use existing analyses.
@@ -64,17 +62,17 @@
This document describes the current status of vectorization in LLVM.
-* :ref:`exception_handling`
+* :doc:`ExceptionHandling`
This document describes the design and implementation of exception handling
in LLVM.
-* :ref:`bugpoint`
+* :doc:`Bugpoint`
Automatic bug finder and test-case reducer description and usage
information.
-* :ref:`bitcode_format`
+* :doc:`BitCodeFormat`
This describes the file format and encoding used for LLVM "bc" files.
@@ -83,28 +81,28 @@
This document describes the LLVM System Library (``lib/System``) and
how to keep LLVM source code portable
-* :ref:`lto`
+* :doc:`LinkTimeOptimization`
This document describes the interface between LLVM intermodular optimizer
and the linker and its design
-* :ref:`gold-plugin`
+* :doc:`GoldPlugin`
How to build your programs with link-time optimization on Linux.
-* :ref:`debugging-jited-code`
+* :doc:`DebuggingJITedCode`
How to debug JITed code with GDB.
-* :ref:`branch_weight`
+* :doc:`BranchWeightMetadata`
Provides information about Branch Prediction Information.
-* :ref:`segmented_stacks`
+* :doc:`SegmentedStacks`
This document describes segmented stacks and how they are used in LLVM.
-* :ref:`marked_up_disassembly`
+* :doc:`MarkedUpDisassembly`
This document describes the optional rich disassembly output syntax.
Modified: llvm/trunk/docs/userguides.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/userguides.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/userguides.rst (original)
+++ llvm/trunk/docs/userguides.rst Thu Jan 10 20:28:08 2013
@@ -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.
Modified: llvm/trunk/docs/yaml2obj.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/yaml2obj.rst?rev=172162&r1=172161&r2=172162&view=diff
==============================================================================
--- llvm/trunk/docs/yaml2obj.rst (original)
+++ llvm/trunk/docs/yaml2obj.rst Thu Jan 10 20:28:08 2013
@@ -1,5 +1,3 @@
-.. _yaml2obj:
-
yaml2obj
========
More information about the llvm-commits
mailing list