RE: [PHP-DOC] Re: Strange declaration
| From: | Ford, Mike [LSS] | 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