Re: Function aliases in the manual
| From: | Jon Parise | Date: | Mon, 30 Jul 2001 15:17:24 +0000 |
| Subject: | Re: Function aliases in the manual | ||
| References: | 1 2 | Groups: | php.dev php.doc |
| Request: | Send a blank email to php-dev+get-61553@lists.php.net to get a copy of this message | ||
On Mon, Jul 30, 2001 at 10:29:50AM +0200, Damien Seguy wrote:
> > Would is possible to allow function aliases to be added to the
> > PHP manual?
> >
> > This would allow us to maintain backwards compatibility in the
> > manual for functions that have been renamed. Ideally, this would
> > work for searching, too.
>
> That seemed a good idea to me too, but we have to keep in mind that
> showing old syntax will make users use it, and that's not what we
> want too.
I didn't really plan on showing the old syntax. I meant we
should have a little "Formerly know as:" line, perhaps under the
PHP version information.
> May be, we could set up an appendix for this? Or, set up a special
> paragraph at beginning of chapters (such as mysql) that holds old
> syntax.
That sounds like a good solution.
--
Jon Parise (jon@csh.rit.edu) . Rochester Inst. of Technology
http://www.csh.rit.edu/~jon/ : Computer Science House
Member