CVS update: php3/doc/functions

Date: Sunday May 9, 1999 @ 1:15 Author: paul Update of /repository/php3/doc/functions In directory php:/tmp/cvs-serv19239/functions Modified Files: array.sgml datetime.sgml filesystem.sgml misc.sgml strings.sgml Log Message: More manual changes based on errata... Question to all those out there? How does one update the docs that are on php.net? I am removing notes since they are being included in the docs but there is this lag period between the deletion from the notes db and the inclusion on the doc site. Index: php3/doc/functions/array.sgml diff -u php3/doc/functions/array.sgml:1.32 php3/doc/functions/array.sgml:1.33 --- php3/doc/functions/array.sgml:1.32 Thu Feb 18 12:42:20 1999 +++ php3/doc/functions/array.sgml Sun May 9 01:15:15 1999 @@ -749,6 +749,11 @@ user-supplied comparison function. If the array you wish to sort needs to be sorted by some non-trivial criteria, you should use this function. + <para> + The comparison function must return an integer less than, equal to, or + greater than zero if the first argument is considered to be respectively + less than, equal to, or greater than the second. If two members compare + as equal, their order in the sorted array is undefined. <example> <title><function>usort</function> example</title> <programlisting> Index: php3/doc/functions/datetime.sgml diff -u php3/doc/functions/datetime.sgml:1.26 php3/doc/functions/datetime.sgml:1.27 --- php3/doc/functions/datetime.sgml:1.26 Mon Mar 29 15:26:09 1999 +++ php3/doc/functions/datetime.sgml Sun May 9 01:15:15 1999 @@ -142,7 +142,7 @@ <listitem><simpara>%b - abbreviated month name according to the current locale</simpara></listitem> <listitem><simpara>%B - full month name according to the current locale</simpara></listitem> <listitem><simpara>%c - preferred date and time representation for the current locale</simpara></listitem> - <listitem><simpara>%d - day of the month as a decimal number (range 0 to 31)</simpara></listitem> + <listitem><simpara>%d - day of the month as a decimal number (range 00 to 31)</simpara></listitem> <listitem><simpara>%H - hour as a decimal number using a 24-hour clock (range 00 to 23)</simpara></listitem> <listitem><simpara>%I - hour as a decimal number using a 12-hour clock (range 01 to 12)</simpara></listitem> <listitem><simpara>%j - day of the year as a decimal number (range 001 to 366)</simpara></listitem> Index: php3/doc/functions/filesystem.sgml diff -u php3/doc/functions/filesystem.sgml:1.46 php3/doc/functions/filesystem.sgml:1.47 --- php3/doc/functions/filesystem.sgml:1.46 Sat May 8 23:09:52 1999 +++ php3/doc/functions/filesystem.sgml Sun May 9 01:15:15 1999 @@ -1457,6 +1457,7 @@ <orderedlist> <listitem><simpara>device</simpara></listitem> <listitem><simpara>inode</simpara></listitem> + <listitem><simpara>inode protection mode</simpara></listitem> <listitem><simpara>number of links</simpara></listitem> <listitem><simpara>user id of owner</simpara></listitem> <listitem><simpara>group id owner</simpara></listitem> Index: php3/doc/functions/misc.sgml diff -u php3/doc/functions/misc.sgml:1.21 php3/doc/functions/misc.sgml:1.22 --- php3/doc/functions/misc.sgml:1.21 Fri Apr 16 21:56:25 1999 +++ php3/doc/functions/misc.sgml Sun May 9 01:15:15 1999 @@ -445,6 +445,11 @@ <simpara> Registers the function named by <parameter>func</parameter> to be executed when script processing is complete. + <para> + Common Pitfalls: + <simpara> + Since no output is allowed to the browser in this function, you will be + unable to debug it using statements such as print or echo. </refsect1> </refentry> @@ -630,7 +635,7 @@ it is recommended that you use something along the lines of <informalexample><programlisting> $token = md5(uniqid("")); // no random portion -$better_token = md5(uniqid(random())); // better, difficult to guess +$better_token = md5(uniqid(rand())); // better, difficult to guess </programlisting></informalexample> <simpara> This will create a 32 character identifier (a 128 bit hex number) Index: php3/doc/functions/strings.sgml diff -u php3/doc/functions/strings.sgml:1.61 php3/doc/functions/strings.sgml:1.62 --- php3/doc/functions/strings.sgml:1.61 Tue Mar 30 23:26:10 1999 +++ php3/doc/functions/strings.sgml Sun May 9 01:15:15 1999 @@ -1573,7 +1573,7 @@ will contain the single character at <parameter>start</parameter>. Examples: <informalexample><programlisting role=php> -$rest = substr("abcdef", -1, -1); // returns "bcde" +$rest = substr("abcdef", 1, -1); // returns "bcde" </programlisting> </informalexample> -- PHP Development Mailing List http://www.php.net/ To unsubscribe send an empty message to php-dev-unsubscribe@lists.php.net For help: php-dev-help@lists.php.net