fixes thanks to @wouterj

xabbuh · xabbuh · commit d3cd48cd3be8 · 2013-08-19T17:54:20.000+02:00
diff --git a/components/class_loader/class_loader.rst b/components/class_loader/class_loader.rst
@@ -1,5 +1,5 @@
 .. index::
-   single: Class Loader; MapClassLoader
+   single: Class Loader; PSR-0 Class Loader
 
 The PSR-0 Class Loader
 ======================
@@ -10,11 +10,11 @@ Introduction
 .. versionadded:: 2.1
     The ``ClassLoader`` class was added in Symfony 2.1.
 
-If your classes and third-party libraries follow the `PSR-0`_ standards or the
-`PEAR`_ naming conventions, you can use the :class:`Symfony\\Component\\ClassLoader\\ClassLoader`
-class to load all of your project's classes.
+If your classes and third-party libraries follow the `PSR-0`_ standards, you
+can use the :class:`Symfony\\Component\\ClassLoader\\ClassLoader` class to
+load all of your project's classes.
 
-.. note::
+.. tip::
 
     You can use both the ``ApcClassLoader`` and the ``XcacheClassLoader`` to
     :doc:`cache</components/class_loader/cache_class_loader>` a ``ClassLoader``
@@ -66,7 +66,7 @@ register your classes::
         'Twig_'  => __DIR__.'/vendor/twig/twig/lib',
     ));
 
-Classes from a sub-namespace or a sub-hierarchy of PEAR classes can be looked
+Classes from a sub-namespace or a sub-hierarchy of `PEAR`_ classes can be looked
 for in a location list to ease the vendoring of a sub-set of classes for large
 projects::
 
diff --git a/components/class_loader/introduction.rst b/components/class_loader/introduction.rst
@@ -1,23 +1,28 @@
+.. index::
+    single: Components; Class Loader
+
 The Class Loader Component
 ==========================
 
-    The Class Loader Component loads your project classes automatically.
+    The Class Loader Component provides tools to load and cache your project
+    classes automatically.
+
+Usage
+-----
 
 Whenever you use an undefined class, PHP uses the autoloading mechanism to
 delegate the loading of a file defining the class. Symfony2 provides two
 autoloaders, which are able to load your classes:
 
-* :doc:`A PSR-0 class loader<class_loader>`
-
-* :doc:`Load classes based on class-to-file mapping<map_class_loader>`
+* :doc:`A PSR-0 class loader</components/class_loader/class_loader>`
+* :doc:`Load classes based on class-to-file mapping</components/class_loader/map_class_loader>`
 
 Additionally, the Symfony Class Loader Component ships with a set of wrapper
 classes which can be used to add additional functionality on top of existing
 autoloaders:
 
-* :doc:`cache_class_loader`
-
-* :doc:`debug_class_loader`
+* :doc:`/components/class_loader/cache_class_loader`
+* :doc:`/components/class_loader/debug_class_loader`
 
 Installation
 ------------
diff --git a/components/class_loader/map_class_loader.rst b/components/class_loader/map_class_loader.rst
@@ -4,10 +4,20 @@
 MapClassLoader
 ==============
 
-Additionally to any dynamic class loader (like the :doc:`PSR-0 class loader <class_loader>`)
-you can use the :class:`Symfony\\Component\\ClassLoader\\MapClassLoader` to statically
-map classes to files. Using it is as easy as passing your mapping to its constructor
-when creating an instance of the ``MapClassLoader`` class::
+Introduction
+------------
+
+Additionally to any dynamic class loader (like the
+:doc:`PSR-0 class loader</components/class_loader/class_loader>`) you can use
+the :class:`Symfony\\Component\\ClassLoader\\MapClassLoader` to statically map
+classes to files. This is useful if you use third-party libraries which don't
+follow the `PSR-0`_ standards.
+
+Usage
+-----
+
+Using it is as easy as passing your mapping to its constructor when creating
+an instance of the ``MapClassLoader`` class::
 
     require_once '/path/to/src/Symfony/Component/ClassLoader/MapClassLoader';
     
@@ -26,3 +36,5 @@ when creating an instance of the ``MapClassLoader`` class::
     stack. If you want to use it as the default autoloader, pass ``true``
     when calling the ``register()`` method. Your class loader will then be
     prepended on the autoload stack.
+
+.. _PSR-0: http://symfony.com/PSR0
