[cfe-commits] r171382 - in /cfe/trunk/docs: InternalsManual.rst JSONCompilationDatabase.rst LanguageExtensions.rst LibASTMatchers.rst LibTooling.rst ObjectiveCLiterals.rst PCHInternals.rst Tooling.rst
Sean Silva
silvas at purdue.edu
Wed Jan 2 05:07:49 PST 2013
Author: silvas
Date: Wed Jan 2 07:07:47 2013
New Revision: 171382
URL: http://llvm.org/viewvc/llvm-project?rev=171382&view=rev
Log:
docs: Fix up HTML links to proper reST links.
Modified:
cfe/trunk/docs/InternalsManual.rst
cfe/trunk/docs/JSONCompilationDatabase.rst
cfe/trunk/docs/LanguageExtensions.rst
cfe/trunk/docs/LibASTMatchers.rst
cfe/trunk/docs/LibTooling.rst
cfe/trunk/docs/ObjectiveCLiterals.rst
cfe/trunk/docs/PCHInternals.rst
cfe/trunk/docs/Tooling.rst
Modified: cfe/trunk/docs/InternalsManual.rst
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/InternalsManual.rst?rev=171382&r1=171381&r2=171382&view=diff
==============================================================================
--- cfe/trunk/docs/InternalsManual.rst (original)
+++ cfe/trunk/docs/InternalsManual.rst Wed Jan 2 07:07:47 2013
@@ -525,7 +525,7 @@
The Driver Library
==================
-The clang Driver and library are documented `here <DriverInternals.html>`_.
+The clang Driver and library are documented :doc:`here <DriverInternals>`.
Precompiled Headers
===================
@@ -534,7 +534,7 @@
implementation, precompiled headers (:doc:`PCH <PCHInternals>`) uses a
serialized representation of Clang's internal data structures, encoded with the
`LLVM bitstream format <http://llvm.org/docs/BitCodeFormat.html>`_.
-Pretokenized headers (`PTH <PTHInternals.html>`_), on the other hand, contain a
+Pretokenized headers (:doc:`PTH <PTHInternals>`), on the other hand, contain a
serialized representation of the tokens encountered when preprocessing a header
(and anything that header includes).
Modified: cfe/trunk/docs/JSONCompilationDatabase.rst
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/JSONCompilationDatabase.rst?rev=171382&r1=171381&r2=171382&view=diff
==============================================================================
--- cfe/trunk/docs/JSONCompilationDatabase.rst (original)
+++ cfe/trunk/docs/JSONCompilationDatabase.rst Wed Jan 2 07:07:47 2013
@@ -34,7 +34,7 @@
works) with the option ``CMAKE_EXPORT_COMPILE_COMMANDS``.
Clang's tooling interface supports reading compilation databases; see
-the `LibTooling documentation <LibTooling.html>`_. libclang and its
+the :doc:`LibTooling documentation <LibTooling>`. libclang and its
python bindings also support this (since clang 3.2); see
`CXCompilationDatabase.h </doxygen/group__COMPILATIONDB.html>`_.
Modified: cfe/trunk/docs/LanguageExtensions.rst
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/LanguageExtensions.rst?rev=171382&r1=171381&r2=171382&view=diff
==============================================================================
--- cfe/trunk/docs/LanguageExtensions.rst (original)
+++ cfe/trunk/docs/LanguageExtensions.rst Wed Jan 2 07:07:47 2013
@@ -87,8 +87,8 @@
``cxx_`` or ``objc_``.
Another use of ``__has_feature`` is to check for compiler features not related
-to the language standard, such as e.g. `AddressSanitizer
-<AddressSanitizer.html>`_.
+to the language standard, such as e.g. :doc:`AddressSanitizer
+<AddressSanitizer>`.
If the ``-pedantic-errors`` option is given, ``__has_extension`` is equivalent
to ``__has_feature``.
@@ -925,8 +925,8 @@
Automatic reference counting
----------------------------
-Clang provides support for `automated reference counting
-<AutomaticReferenceCounting.html>`_ in Objective-C, which eliminates the need
+Clang provides support for :doc:`automated reference counting
+<AutomaticReferenceCounting>` in Objective-C, which eliminates the need
for manual ``retain``/``release``/``autorelease`` message sends. There are two
feature macros associated with automatic reference counting:
``__has_feature(objc_arc)`` indicates the availability of automated reference
@@ -934,6 +934,8 @@
automated reference counting also includes support for ``__weak`` pointers to
Objective-C objects.
+.. _objc-fixed-enum:
+
Enumerations with a fixed underlying type
-----------------------------------------
@@ -1010,8 +1012,8 @@
Object Literals and Subscripting
--------------------------------
-Clang provides support for `Object Literals and Subscripting
-<ObjectiveCLiterals.html>`_ in Objective-C, which simplifies common Objective-C
+Clang provides support for :doc:`Object Literals and Subscripting
+<ObjectiveCLiterals>` in Objective-C, which simplifies common Objective-C
programming patterns, makes programs more concise, and improves the safety of
container creation. There are several feature macros associated with object
literals and subscripting: ``__has_feature(objc_array_literals)`` tests the
Modified: cfe/trunk/docs/LibASTMatchers.rst
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/LibASTMatchers.rst?rev=171382&r1=171381&r2=171382&view=diff
==============================================================================
--- cfe/trunk/docs/LibASTMatchers.rst (original)
+++ cfe/trunk/docs/LibASTMatchers.rst Wed Jan 2 07:07:47 2013
@@ -7,9 +7,9 @@
:doc:`LibTooling`, LibASTMatchers helps to write code-to-code transformation
tools or query tools.
-We assume basic knowledge about the Clang AST. See the `Introduction to the
-Clang AST <IntroductionToTheClangAST.html>`_ if you want to learn more about
-how the AST is structured.
+We assume basic knowledge about the Clang AST. See the :doc:`Introduction
+to the Clang AST <IntroductionToTheClangAST>` if you want to learn more
+about how the AST is structured.
.. FIXME: create tutorial and link to the tutorial
@@ -52,7 +52,7 @@
The precondition to using the matchers is to understand how the AST for what you
want to match looks like. The
-`Introduction to the Clang AST <IntroductionToTheClangAST.html>`_ teaches you
+:doc:`Introduction to the Clang AST <IntroductionToTheClangAST>` teaches you
how to dump a translation unit's AST into a human readable format.
.. FIXME: Introduce link to ASTMatchersTutorial.html
Modified: cfe/trunk/docs/LibTooling.rst
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/LibTooling.rst?rev=171382&r1=171381&r2=171382&view=diff
==============================================================================
--- cfe/trunk/docs/LibTooling.rst (original)
+++ cfe/trunk/docs/LibTooling.rst Wed Jan 2 07:07:47 2013
@@ -7,7 +7,7 @@
LibTooling.
For the information on how to setup Clang Tooling for LLVM see
-`HowToSetupToolingForLLVM.html <HowToSetupToolingForLLVM.html>`_
+:doc:`HowToSetupToolingForLLVM`
Introduction
------------
Modified: cfe/trunk/docs/ObjectiveCLiterals.rst
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/ObjectiveCLiterals.rst?rev=171382&r1=171381&r2=171382&view=diff
==============================================================================
--- cfe/trunk/docs/ObjectiveCLiterals.rst (original)
+++ cfe/trunk/docs/ObjectiveCLiterals.rst Wed Jan 2 07:07:47 2013
@@ -164,9 +164,7 @@
The expression ``@(AVAudioQualityMax)`` converts ``AVAudioQualityMax``
to an integer type, and boxes the value accordingly. If the enum has a
-`fixed underlying
-type <http://clang.llvm.org/docs/LanguageExtensions.html#objc_fixed_enum>`_
-as in:
+:ref:`fixed underlying type <objc-fixed-enum>` as in:
.. code-block:: objc
@@ -178,8 +176,7 @@
Boxing a value of enum type will result in a ``NSNumber`` pointer with a
creation method according to the underlying type of the enum, which can
-be a `fixed underlying
-type <http://clang.llvm.org/docs/LanguageExtensions.html#objc_fixed_enum>`_
+be a :ref:`fixed underlying type <objc-fixed-enum>`
or a compiler-defined integer type capable of representing the values of
all the members of the enumeration:
Modified: cfe/trunk/docs/PCHInternals.rst
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/PCHInternals.rst?rev=171382&r1=171381&r2=171382&view=diff
==============================================================================
--- cfe/trunk/docs/PCHInternals.rst (original)
+++ cfe/trunk/docs/PCHInternals.rst Wed Jan 2 07:07:47 2013
@@ -7,7 +7,7 @@
This document describes the design and implementation of Clang's precompiled
headers (PCH) and modules. If you are interested in the end-user view, please
-see the `User's Manual <UsersManual.html#precompiledheaders>`_.
+see the :ref:`User's Manual <usersmanual-precompiled-headers>`.
Using Precompiled Headers with ``clang``
----------------------------------------
Modified: cfe/trunk/docs/Tooling.rst
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/Tooling.rst?rev=171382&r1=171381&r2=171382&view=diff
==============================================================================
--- cfe/trunk/docs/Tooling.rst (original)
+++ cfe/trunk/docs/Tooling.rst Wed Jan 2 07:07:47 2013
@@ -33,7 +33,7 @@
Clang Plugins
-------------
-`Clang Plugins <ClangPlugins.html>`_ allow you to run additional actions on the
+:doc:`Clang Plugins <ClangPlugins>` allow you to run additional actions on the
AST as part of a compilation. Plugins are dynamic libraries that are loaded at
runtime by the compiler, and they're easy to integrate into your build
environment.
@@ -60,7 +60,7 @@
LibTooling
----------
-`LibTooling <LibTooling.html>`_ is a C++ interface aimed at writing standalone
+:doc:`LibTooling <LibTooling>` is a C++ interface aimed at writing standalone
tools, as well as integrating into services that run clang tools. Canonical
examples of when to use LibTooling:
@@ -85,7 +85,7 @@
Clang Tools
-----------
-`Clang tools <ClangTools.html>`_ are a collection of specific developer tools
+:doc:`Clang tools <ClangTools>` are a collection of specific developer tools
built on top of the LibTooling infrastructure as part of the Clang project.
They are targeted at automating and improving core development activities of
C/C++ developers.
More information about the cfe-commits
mailing list