Update to Drupal 8.0-dev-2015-11-17. Commits through da81cd220, Tue Nov 17 15:53:49 2015 +0000, Issue #2617224 by Wim Leers: Move around/fix some documentation.

vendor/symfony/http-foundation/Session/Session.php

@@ -23,8 +23,6 @@ use Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage;
  *
  * @author Fabien Potencier <fabien@symfony.com>
  * @author Drak <drak@zikula.org>
- *
- * @api
  */
 class Session implements SessionInterface, \IteratorAggregate, \Countable
 {

vendor/symfony/http-foundation/Session/SessionInterface.php

@@ -26,8 +26,6 @@ interface SessionInterface
      * @return bool True if session started.
      *
      * @throws \RuntimeException If session fails to start.
-     *
-     * @api
      */
     public function start();
 
@@ -35,8 +33,6 @@ interface SessionInterface
      * Returns the session ID.
      *
      * @return string The session ID.
-     *
-     * @api
      */
     public function getId();
 
@@ -44,8 +40,6 @@ interface SessionInterface
      * Sets the session ID.
      *
      * @param string $id
-     *
-     * @api
      */
     public function setId($id);
 
@@ -53,8 +47,6 @@ interface SessionInterface
      * Returns the session name.
      *
      * @return mixed The session name.
-     *
-     * @api
      */
     public function getName();
 
@@ -62,8 +54,6 @@ interface SessionInterface
      * Sets the session name.
      *
      * @param string $name
-     *
-     * @api
      */
     public function setName($name);
 
@@ -79,8 +69,6 @@ interface SessionInterface
      *                      not a Unix timestamp.
      *
      * @return bool True if session invalidated, false if error.
-     *
-     * @api
      */
     public function invalidate($lifetime = null);
 
@@ -95,8 +83,6 @@ interface SessionInterface
      *                       not a Unix timestamp.
      *
      * @return bool True if session migrated, false if error.
-     *
-     * @api
      */
     public function migrate($destroy = false, $lifetime = null);
 
@@ -115,8 +101,6 @@ interface SessionInterface
      * @param string $name The attribute name
      *
      * @return bool true if the attribute is defined, false otherwise
-     *
-     * @api
      */
     public function has($name);
 
@@ -127,8 +111,6 @@ interface SessionInterface
      * @param mixed  $default The default value if not found.
      *
      * @return mixed
-     *
-     * @api
      */
     public function get($name, $default = null);
 
@@ -137,8 +119,6 @@ interface SessionInterface
      *
      * @param string $name
      * @param mixed  $value
-     *
-     * @api
      */
     public function set($name, $value);
 
@@ -146,8 +126,6 @@ interface SessionInterface
      * Returns attributes.
      *
      * @return array Attributes
-     *
-     * @api
      */
     public function all();
 
@@ -164,15 +142,11 @@ interface SessionInterface
      * @param string $name
      *
      * @return mixed The removed value or null when it does not exist
-     *
-     * @api
      */
     public function remove($name);
 
     /**
      * Clears all attributes.
-     *
-     * @api
      */
     public function clear();
 

vendor/symfony/http-foundation/Session/Storage/Handler/NullSessionHandler.php

@@ -17,8 +17,6 @@ namespace Symfony\Component\HttpFoundation\Session\Storage\Handler;
  * Can be used in unit testing or in a situations where persisted sessions are not desired.
  *
  * @author Drak <drak@zikula.org>
- *
- * @api
  */
 class NullSessionHandler implements \SessionHandlerInterface
 {

vendor/symfony/http-foundation/Session/Storage/NativeSessionStorage.php

@@ -65,7 +65,7 @@ class NativeSessionStorage implements SessionStorageInterface
      * ("auto_start", is not supported as it tells PHP to start a session before
      * PHP starts to execute user-land code. Setting during runtime has no effect).
      *
-     * cache_limiter, "nocache" (use "0" to prevent headers from being sent entirely).
+     * cache_limiter, "" (use "0" to prevent headers from being sent entirely).
      * cookie_domain, ""
      * cookie_httponly, ""
      * cookie_lifetime, "0"
@@ -195,6 +195,16 @@ class NativeSessionStorage implements SessionStorageInterface
      */
     public function regenerate($destroy = false, $lifetime = null)
     {
+        // Cannot regenerate the session ID for non-active sessions.
+        if (PHP_VERSION_ID >= 50400 && \PHP_SESSION_ACTIVE !== session_status()) {
+            return false;
+        }
+
+        // Check if session ID exists in PHP 5.3
+        if (PHP_VERSION_ID < 50400 && '' === session_id()) {
+            return false;
+        }
+
         if (null !== $lifetime) {
             ini_set('session.cookie_lifetime', $lifetime);
         }

vendor/symfony/http-foundation/Session/Storage/SessionStorageInterface.php

@@ -18,8 +18,6 @@ use Symfony\Component\HttpFoundation\Session\SessionBagInterface;
  *
  * @author Fabien Potencier <fabien@symfony.com>
  * @author Drak <drak@zikula.org>
- *
- * @api
  */
 interface SessionStorageInterface
 {
@@ -29,8 +27,6 @@ interface SessionStorageInterface
      * @throws \RuntimeException If something goes wrong starting the session.
      *
      * @return bool True if started.
-     *
-     * @api
      */
     public function start();
 
@@ -45,8 +41,6 @@ interface SessionStorageInterface
      * Returns the session ID.
      *
      * @return string The session ID or empty.
-     *
-     * @api
      */
     public function getId();
 
@@ -54,8 +48,6 @@ interface SessionStorageInterface
      * Sets the session ID.
      *
      * @param string $id
-     *
-     * @api
      */
     public function setId($id);
 
@@ -63,8 +55,6 @@ interface SessionStorageInterface
      * Returns the session name.
      *
      * @return mixed The session name.
-     *
-     * @api
      */
     public function getName();
 
@@ -72,8 +62,6 @@ interface SessionStorageInterface
      * Sets the session name.
      *
      * @param string $name
-     *
-     * @api
      */
     public function setName($name);
 
@@ -105,8 +93,6 @@ interface SessionStorageInterface
      * @return bool True if session regenerated, false if error
      *
      * @throws \RuntimeException If an error occurs while regenerating this storage
-     *
-     * @api
      */
     public function regenerate($destroy = false, $lifetime = null);