cvs: phpdoc /en/appendices aliases.xml

goba Mon May 24 16:27:50 2004 EDT Modified files: /phpdoc/en/appendices aliases.xml Log: reworded the intro, so it human friendlier http://cvs.php.net/diff.php/phpdoc/en/appendices/aliases.xml?r1=1.28&r2=1.29&ty=u Index: phpdoc/en/appendices/aliases.xml diff -u phpdoc/en/appendices/aliases.xml:1.28 phpdoc/en/appendices/aliases.xml:1.29 --- phpdoc/en/appendices/aliases.xml:1.28 Sun Apr 11 11:41:59 2004 +++ phpdoc/en/appendices/aliases.xml Mon May 24 16:27:50 2004 @@ -1,17 +1,18 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.28 $ --> +<!-- $Revision: 1.29 $ --> <appendix id="aliases"> <title>List of Function Aliases</title> <para> - Here is the aliases list. All aliases are listed here. It is usually - a bad idea to use aliases, as they may be bound to obsolescence or + There are quite a few functions in PHP which you can call with more + than one name. In some cases there is no preferred name among the + multiple ones, <function>is_int</function> and + <function>is_integer</function> are equally good for example. + However there are functions which changed names because of an API + cleanup or some other reason and the old names are only kept as + aliases for backward compatibility. It is usually a bad idea to use + these kind of aliases, as they may be bound to obsolescence or renaming, which will lead to unportable script. This list is provided to help those who want to upgrade their old scripts to newer syntax. - </para> - <para> - However, some functions simply have two names, and there is no real - preference. (For example, <function>is_int</function> and - <function>is_integer</function> are equally good) </para> <para> This list is consistent with PHP 4.0.6. For an alias list that updates