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
