Doc #67823 [Opn->Asn]: posix_* $fd documented as int, should be resource.
| From: | aharvey@php.net | Date: | Mon, 11 Aug 2014 22:58:37 +0000 |
| Subject: | Doc #67823 [Opn->Asn]: posix_* $fd documented as int, should be resource. | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-11427@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=67823&edit=1
ID: 67823
Updated by: aharvey@php.net
Reported by: donatj at gmail dot com
Summary: posix_* $fd documented as int, should be resource.
-Status: Open
+Status: Assigned
Type: Documentation Problem
Package: POSIX related
Operating System: N/A
PHP Version: Irrelevant
-Assigned To:
+Assigned To: aharvey
Block user comment: N
Private report: N
New Comment:
Good catch. It's actually a little more complicated than that again â those two
functions will accept both integers (in which case they're assumed to be file descriptors) and
resources.
I'll fix that up.
Previous Comments:
------------------------------------------------------------------------
[2014-08-11 22:08:22] donatj at gmail dot com
Description:
------------
posix_isatty and posix_ttyname are documented as taking an int parameter, when more specifically
they take a *resource*; namely STDOUT, STDERR, STDIN, etc.
Methods such as fread and frwite which take similar resources document this as *resource* rather
than int and I think its more correct to change the posix methods to being documented as *resource*
http://docs.php.net/manual/en/function.posix-isatty.php
http://docs.php.net/manual/en/function.posix-ttyname.php
http://us3.php.net/manual/en/function.fread.php
Expected result:
----------------
resource
Actual result:
--------------
int
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=67823&edit=1