Doc #54747 [Opn->Csd]: Default value for touch() function

From: Date: Tue, 17 May 2011 20:52:52 +0000
Subject: Doc #54747 [Opn->Csd]: Default value for touch() function
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-6466@lists.php.net to get a copy of this message
Edit report at http://bugs.php.net/bug.php?id=54747&edit=1 ID: 54747 Updated by: salathe@php.net Reported by: gwarnants at gmail dot com Summary: Default value for touch() function -Status: Open +Status: Closed Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant -Assigned To: +Assigned To: salathe Block user comment: N Private report: N New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. The $atime parameter defaults to the value passed to the $time parameter, or the latter's default if that too is not passed. If anything, that would make the prototype look like: bool touch ( string $filename [, int $time = time() [, int $atime = $time ]] ) Which I fear would cause more confusion than omitting the default value. I have however updated the description to be more clear about $atime using $time's value if present. Previous Comments: ------------------------------------------------------------------------ [2011-05-17 22:52:29] salathe@php.net Automatic comment from SVN on behalf of salathe Revision: http://svn.php.net/viewvc/?view=revision&revision=311148 Log: clarify default value for atime parameter for touch() (doc #54747) ------------------------------------------------------------------------ [2011-05-16 16:33:37] gwarnants at gmail dot com Description: ------------ --- From manual page: http://www.php.net/function.touch#Description --- Third parameter $atime is indicated as optional. Details says that if not present it will be set to "time". So, prototype should be written accordingly : bool touch ( string $filename [, int $time = time() [, int $atime = time() ]] ) ------------------------------------------------------------------------ -- Edit this bug report at http://bugs.php.net/bug.php?id=54747&edit=1

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