merged branch javiereguiluz/update_http_cache_doc (PR #605)

This PR was squashed before being merged into the master branch (closes #605).

Commits
-------

b6606a7c Updated HttpCacheServiceProvider documentation

Discussion
----------

Updated HttpCacheServiceProvider documentation

---------------------------------------------------------------------------

by igorw at 2013-01-23T12:38:25Z

👍

doc/providers/http_cache.rst

@@ -18,6 +18,15 @@ Services
 * **http_cache**: An instance of `HttpCache
   <http://api.symfony.com/master/Symfony/Component/HttpKernel/HttpCache/HttpCache.html>`_.
 
+* **http_cache.esi**: An instance of `Esi
+  <http://api.symfony.com/master/Symfony/Component/HttpKernel/HttpCache/Esi.html>`_,
+  that implements the ESI capabilities to Request and Response instances.
+
+* **http_cache.store**: An instance of `Store
+  <http://api.symfony.com/master/Symfony/Component/HttpKernel/HttpCache/Store.html>`_,
+  that implements all the logic for storing cache metadata (Request and Response
+  headers).
+
 Registering
 -----------
 
@@ -86,6 +95,14 @@ The provider also provides ESI support::
 
     $app['http_cache']->run();
 
+If your application doesn't use ESI, you can disable it to slightly improve the
+overall performance::
+
+    $app->register(new Silex\Provider\HttpCacheServiceProvider(), array(
+       'http_cache.cache_dir' => __DIR__.'/cache/',
+       'http_cache.esi'       => null,
+    ));
+
 .. tip::
 
     To help you debug caching issues, set your application ``debug`` to true.