RE: [PHP-DOC] Re: Strange declaration
| From: | Philip Olson | Date: | Fri, 24 Jan 2003 15:11:14 +0000 |
| Subject: | RE: [PHP-DOC] Re: Strange declaration | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969351260@lists.php.net to get a copy of this message | ||
> 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")
This sounds good. After everyone ponders this let's make
a decision and do it that way for all new parameters and
parameter changes. Maybe we can make a role for these,
much like we plan to do with seealso. This would be easier
to parse a list of all new/changed parameters and make
them consistent.
>
> 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!
It is a <note>, but is a note with a <title>. But yes,
we want to come up with a better name for new parameter
and changed parameter titles. Any suggestions? :) This
can affect the new role proposed above.
Regards,
Philip