Doc #54746 [Opn->Wfx]: suggestion for rand() prototype

From: Date: Sat, 02 Jul 2011 08:11:23 +0000
Subject: Doc #54746 [Opn->Wfx]: suggestion for rand() prototype
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-6806@lists.php.net to get a copy of this message
Edit report at https://bugs.php.net/bug.php?id=54746&edit=1 ID: 54746 Updated by: frozenfire@php.net Reported by: gwarnants at gmail dot com Summary: suggestion for rand() prototype -Status: Open +Status: Wont fix Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant Block user comment: N Private report: N Previous Comments: ------------------------------------------------------------------------ [2011-05-16 16:23:07] rquadling@php.net To be able to render that, the underlying XML needs to be able to describe it. This particular request was in DocBook V5.1 (http://www.docbook.org/tdg51/en/html/group.methodparam.html) I don't think that this is officially released yet. So, for the time being, 2 prototypes is the most accurate way that can be used to describe the arguments. ------------------------------------------------------------------------ [2011-05-16 16:05:33] gwarnants at gmail dot com Description: ------------ --- From manual page: http://www.php.net/function.rand#Description --- Current prototype of rand() function is : int rand ( void ) int rand ( int $min , int $max ) I think it should be better to write a single prototype indicating optional parameters like this : int rand ( [int $min, int $max] ) ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=54746&edit=1

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