Doc #60026 [NEW]: Remove references to obsolete RFC 2109 in manual page for setcookie()

From: Operating system: PHP version: Irrelevant Package: HTTP related Bug Type: Documentation Problem Bug description:Remove references to obsolete RFC 2109 in manual page for setcookie() Description: ------------ The page http://php.net/manual/en/function.setcookie.php contains several references to RFC 2109. This has been obsoleted by RFC 6265 (published April 2011). http://tools.ietf.org/html/rfc2109 http://tools.ietf.org/html/rfc6265 In particular, the manual page currently says: > domain: > The domain that the cookie is available to. To make the cookie available > on all subdomains of example.com (including example.com itself) then you'd > set it to '.example.com'. Although some browsers will accept cookies > without the initial ., RFC 2109 requires it to be included. Setting the > domain to 'www.example.com' or '.www.example.com' will make the cookie only > available in the www subdomain. The requirement about the leading period has been reverted, so now it is no longer permitted, though browsers are required to ignore any leading periods (section 4.1.2.3). I don't know if any current browsers require the use of a leading period. RFC 6265 claims to be describe current practice, and says that "[w]here some existing software differs from the recommended protocol in significant ways, the document contains a note explaining the difference". There is no mention of browsers malfunctioning when the leading period is omitted. - The manual page should be updated to refer to RFC 6265. - The examples should not use a leading period for the domain argument. - The description of the domain argument should be rephrased to reflect the updated RFC. -- Edit bug report at https://bugs.php.net/bug.php?id=60026&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=60026&r=trysnapshot54 Try a snapshot (PHP 5.3): https://bugs.php.net/fix.php?id=60026&r=trysnapshot53 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=60026&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=60026&r=fixed Fixed in SVN and need be documented: https://bugs.php.net/fix.php?id=60026&r=needdocs Fixed in release: https://bugs.php.net/fix.php?id=60026&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=60026&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=60026&r=needscript Try newer version: https://bugs.php.net/fix.php?id=60026&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=60026&r=support Expected behavior: https://bugs.php.net/fix.php?id=60026&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=60026&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=60026&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=60026&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=60026&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=60026&r=dst IIS Stability: https://bugs.php.net/fix.php?id=60026&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=60026&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=60026&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=60026&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=60026&r=mysqlcfg