bug #3039 use DebugClassLoader class from Debug component instead of the one from ... (xabbuh)

This PR was submitted for the master branch but it was merged into the 2.4 branch instead (closes #3039).

Discussion
----------

use DebugClassLoader class from Debug component instead of the one from ...

...the Class Loader component

| Q             | A
| ------------- | ---
| Doc fix?      | yes
| New docs?     | no
| Applies to    | 2.4
| Fixed tickets | #2955

Commits
-------

e78c1ca use DebugClassLoader class from Debug component instead of the one from the Class Loader component

Author: weaverryan

components/class_loader/debug_class_loader.rst

@@ -4,14 +4,6 @@
 Debugging a Class Loader
 ========================
 
-The :class:`Symfony\\Component\\ClassLoader\\DebugClassLoader` attempts to
-throw more helpful exceptions when a class isn't found by the registered
-autoloaders. All autoloaders that implement a ``findFile()`` method are replaced
-with a ``DebugClassLoader`` wrapper.
-
-Using the ``DebugClassLoader`` is as easy as calling its static
-:method:`Symfony\\Component\\ClassLoader\\DebugClassLoader::enable` method::
-
-    use Symfony\Component\ClassLoader\DebugClassLoader;
-    
-    DebugClassLoader::enable();
+Since Symfony 2.4, the ``DebugClassLoader`` of the Class Loader component is
+deprecated. Use the
+:doc:`DebugClassLoader provided by the Debug component </components/debug/class_loader>`.

components/debug/class_loader.rst

@@ -0,0 +1,22 @@
+.. index::
+    single: Class Loader; DebugClassLoader
+    single: Debug; DebugClassLoader
+
+Debugging a Class Loader
+========================
+
+.. versionadded:: 2.4
+    The ``DebugClassLoader`` of the Debug component is new in Symfony 2.4.
+    Previously, it was located in the Class Loader component.
+
+The :class:`Symfony\\Component\\Debug\\DebugClassLoader` attempts to
+throw more helpful exceptions when a class isn't found by the registered
+autoloaders. All autoloaders that implement a ``findFile()`` method are replaced
+with a ``DebugClassLoader`` wrapper.
+
+Using the ``DebugClassLoader`` is as easy as calling its static
+:method:`Symfony\\Component\\Debug\\DebugClassLoader::enable` method::
+
+    use Symfony\Component\ClassLoader\DebugClassLoader;
+
+    DebugClassLoader::enable();

components/debug/index.rst

@@ -0,0 +1,8 @@
+Debug
+=====
+
+.. toctree::
+    :maxdepth: 2
+
+    introduction
+    class_loader

components/debug.rst renamed to components/debug/introduction.rst

@@ -30,9 +30,8 @@ Enabling them all is as easy as it can get::
     Debug::enable();
 
 The :method:`Symfony\\Component\\Debug\\Debug::enable` method registers an
-error handler and an exception handler. If the :doc:`ClassLoader component
-</components/class_loader/introduction>` is available, a special class loader
-is also registered.
+error handler, an exception handler and
+:doc:`a special class loader </components/debug/class_loader>`.
 
 Read the following sections for more information about the different available
 tools.

components/index.rst

@@ -9,7 +9,7 @@ The Components
     config/index
     console/index
     css_selector
-    debug
+    debug/index
     dependency_injection/index
     dom_crawler
     event_dispatcher/index

components/map.rst.inc

@@ -27,9 +27,10 @@
 
   * :doc:`/components/css_selector`
 
-* **Debug**
+* :doc:`/components/debug/index`
 
-  * :doc:`/components/debug`
+  * :doc:`/components/debug/introduction`
+  * :doc:`/components/debug/class_loader`
 
 * :doc:`/components/dependency_injection/index`
 

cookbook/configuration/front_controllers_and_kernel.rst

@@ -45,8 +45,8 @@ to `decorate`_ the kernel with additional features. Examples include:
 * Configuring the autoloader or adding additional autoloading mechanisms;
 * Adding HTTP level caching by wrapping the kernel with an instance of
   :ref:`AppCache <symfony-gateway-cache>`;
-* Enabling (or skipping) the :doc:`ClassCache </cookbook/debugging>`
-* Enabling the :doc:`Debug component </components/debug>`.
+* Enabling (or skipping) the :doc:`ClassCache </cookbook/debugging>`;
+* Enabling the :doc:`Debug Component </components/debug/introduction>`.
 
 The front controller can be chosen by requesting URLs like: