Doc #61473 [Opn->Nab]: The PHP Documentation is missing clear expectations on filesystem separators

From: Date: Sat, 26 Jan 2013 11:45:12 +0000
Subject: Doc #61473 [Opn->Nab]: The PHP Documentation is missing clear expectations on filesystem separators
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-9487@lists.php.net to get a copy of this message
Edit report at https://bugs.php.net/bug.php?id=61473&edit=1

 ID:                 61473
 Updated by:         krakjoe@php.net
 Reported by:        daveespionage at gmail dot com
 Summary:            The PHP Documentation is missing clear expectations
                     on filesystem separators
-Status:             Open
+Status:             Not a bug
 Type:               Documentation Problem
 Package:            Documentation problem
 Operating System:   Windows 7 64 bit
 PHP Version:        Irrelevant
 Block user comment: N
 Private report:     N

 New Comment:

As stated, this is expected behaviour.


Previous Comments:
------------------------------------------------------------------------
[2012-03-22 12:38:47] daveespionage at gmail dot com

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 this bug report at https://bugs.php.net/bug.php?id=61473&edit=1


Thread (2 messages)

« previous php.doc.bugs (#9487) next »