Merge pull request #1565 from drak/sessionsync

Update session docs

Author: weaverryan

components/http_foundation/session_configuration.rst

@@ -35,21 +35,17 @@ While native save handlers can be activated by directly using
 ``ini_set('session.save_handler', $name);``, Symfony2 provides a convenient way to
 activate these in the same way as custom handlers.
 
-Symfony2 provides drivers for the following native save handlers:
+Symfony2 provides drivers for the following native save handler as an example:
 
   * :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NativeFileSessionHandler`
-  * :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NativeSqliteSessionHandler`
-  * :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NativeMemcacheSessionHandler`
-  * :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NativeMemcachedSessionHandler`
-  * :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NativeRedisSessionHandler`
 
 Example usage::
 
     use Symfony\Component\HttpFoundation\Session\Session;
     use Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage;
-    use Symfony\Component\HttpFoundation\Session\Storage\Handler\NativeMemcachedSessionHandler;
+    use Symfony\Component\HttpFoundation\Session\Storage\Handler\NativeFileSessionHandler;
 
-    $storage = new NativeSessionStorage(array(), new NativeMemcachedSessionHandler());
+    $storage = new NativeSessionStorage(array(), new NativeFileSessionHandler());
     $session = new Session($storage);
 
 .. note::

components/http_foundation/sessions.rst

@@ -42,6 +42,12 @@ Quick example::
     ``session_id()``, ``session_name()``, and ``session_destroy()`` and instead
     use the APIs in the following section.
 
+.. note::
+
+    While it is recommended to explicitly start a session, a sessions will actually
+    start on demand, that is, if any session request is made to read/write session
+    data.
+
 .. warning::
 
     Symfony sessions are incompatible with PHP ini directive ``session.auto_start = 1``