use DebugClassLoader class from Debug component instead of the one fr…

…om the Class Loader component
symfony · Mar 5, 2014 · e78c1ca · e78c1ca
1 parent 1065855
commit e78c1ca
Show file tree

Hide file tree

Showing 7 changed files with 41 additions and 19 deletions.
diff --git a/components/class_loader/debug_class_loader.rst b/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>`.
diff --git a/components/debug/class_loader.rst b/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();
diff --git a/components/debug/index.rst b/components/debug/index.rst
@@ -0,0 +1,8 @@
+Debug
+=====
+
+.. toctree::
+    :maxdepth: 2
+
+    introduction
+    class_loader
diff --git a/components/debug.rst → components/debug/introduction.rst b/components/debug.rst → 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.

diff --git a/components/index.rst b/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

diff --git a/components/map.rst.inc b/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`
 

diff --git a/cookbook/configuration/front_controllers_and_kernel.rst b/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: