Doc #61473 [NEW]: The PHP Documentation is missing clear expectations on filesystem separators

From: Operating system: Windows 7 64 bit PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:The PHP Documentation is missing clear expectations on filesystem separators Description: ------------ From Bug #61441 [2012-03-20 10:06 UTC] pajoye@php.net Expected behavior. All files operations working with paths to clean or resolve them returns the OS specific directory separator. [2012-03-20 21:07 UTC] daveespionage at gmail dot com @pajoye: Is this in the PHP documentation anywhere? I cannot find it in http://php.net/manual/en/function.readlink.php or the parent http://www.php.net/manual/en/ref.filesystem.php Should I file a missing documentation bug? Thanks! Expected result: ---------------- Filesystem-related functions or parent Filesystem pages in documentation should clearly state what sort of directory separators will be returned (OS-specific, or OS-agnostic) Actual result: -------------- There is indication of support for Windows for many of the filesystem functions, but no clear documentation stating how these functions will return directory separators. -- Edit bug report at https://bugs.php.net/bug.php?id=61473&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=61473&r=trysnapshot54 Try a snapshot (PHP 5.3): https://bugs.php.net/fix.php?id=61473&r=trysnapshot53 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=61473&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=61473&r=fixed Fixed in SVN and need be documented: https://bugs.php.net/fix.php?id=61473&r=needdocs Fixed in release: https://bugs.php.net/fix.php?id=61473&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=61473&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=61473&r=needscript Try newer version: https://bugs.php.net/fix.php?id=61473&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=61473&r=support Expected behavior: https://bugs.php.net/fix.php?id=61473&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=61473&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=61473&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=61473&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=61473&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=61473&r=dst IIS Stability: https://bugs.php.net/fix.php?id=61473&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=61473&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=61473&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=61473&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=61473&r=mysqlcfg