RE: [PHP-DOC] Re: Strange declaration

From: Date: Fri, 24 Jan 2003 14:30:24 +0000
Subject: RE: [PHP-DOC] Re: Strange declaration
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969351257@lists.php.net to get a copy of this message
> -----Original Message----- > From: Gabor Hojtsy [mailto:gabor@hojtsy.hu] > Sent: 24 January 2003 12:48 > > > I found a rather strange declaration on this page: > > http://www.php.net/manual/en/function.range.php > > > > It says: > > > > "New parameter: The optional step parameter was added in 4.4.0." > > > > My point is, when was PHP v.4.4.0 released? Shouldn't it be > "will be" > > instead of "was"? > > Well, the documentation is easier to maintain, if we add > "was", as when > PHP 4.4.0 is released, there is no need to search for the > parts where it > is mentioned, and modify the text. :) Well, we could always try to find a more "time-neutral" form of words -- my best suggestion, off the top of my head, would be something like: "New parameter: the optional step parameter is available starting with PHP 5.0.0" (or "as from 5.0.0") Actually, shouldn't this be a Note, and without the "New parameter" bit? -- then it won't need revising in a couple of years when 5.1.x is out and it's no longer new! Cheers! Mike --------------------------------------------------------------------- Mike Ford, Electronic Information Services Adviser, Learning Support Services, Learning & Information Services, JG125, James Graham Building, Leeds Metropolitan University, Beckett Park, LEEDS, LS6 3QS, United Kingdom Email: m.ford@lmu.ac.uk Tel: +44 113 283 2600 extn 4730 Fax: +44 113 283 3211

« previous php.doc (#969351257) next »