php-documentation-list | 2000092
Date: 09/17/00
- Next message: Luca Perugini: "[PHP-DOC] cvs: phpdoc /it/appendices phpdevel.xml /it/chapters intro.xml /it/features file-upload.xml"
- Previous message: Luca Perugini: "[PHP-DOC] cvs: phpdoc /it/functions com.xml cpdf.xml cybercash.xml errorfunc.xml funchand.xml http.xml ibase.xml image.xml imap.xml info.xml math.xml misc.xml pdf.xml posix.xml recode.xml swf.xml"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
perugini Sun Sep 17 12:49:14 2000 EDT
Modified files:
/phpdoc/it/language control-structures.xml functions.xml
operators.xml types.xml variables.xml
Log:
Synchronized with : PHP3 -> PHP 3, PHP4 -> PHP 4
Index: phpdoc/it/language/control-structures.xml
diff -u phpdoc/it/language/control-structures.xml:1.3 phpdoc/it/language/control-structures.xml:1.4
--- phpdoc/it/language/control-structures.xml:1.3 Thu Aug 31 15:30:09 2000
+++ phpdoc/it/language/control-structures.xml Sun Sep 17 12:49:14 2000
@@ -421,9 +421,9 @@
</para>
<para>
Other languages have a <literal>foreach</literal> statement to
- traverse an array or hash. PHP3 has no such construct; PHP4 does
+ traverse an array or hash. PHP 3 has no such construct; PHP 4 does
(see <link
- linkend="control-structures.foreach">foreach</link>). In PHP3, you
+ linkend="control-structures.foreach">foreach</link>). In PHP 3, you
can combine <link linkend="control-structures.while">while</link>
with the <function>list</function> and <function>each</function>
functions to achieve the same effect. See the documentation for
@@ -434,7 +434,7 @@
<sect1 id="control-structures.foreach">
<title><literal>foreach</literal></title>
<para>
- PHP4 (not PHP3) includes a <literal>foreach</literal> construct,
+ PHP 4 (not PHP 3) includes a <literal>foreach</literal> construct,
much like perl and some other languages. This simply gives an easy
way to iterate over arrays. There are two syntaxes; the second is
a minor but useful extension of the first:
@@ -886,11 +886,11 @@
</informalexample>
</para>
<simpara>
- In PHP3, it is possible to execute a <literal>return</literal>
+ In PHP 3, it is possible to execute a <literal>return</literal>
statement inside a <function>require</function>ed file, as long as
that statement occurs in the global scope of the
<function>require</function>ed file. It may not occur within any
- block (meaning inside braces ({}). In PHP4, however, this ability
+ block (meaning inside braces ({}). In PHP 4, however, this ability
has been discontinued. If you need this functionality, see
<function>include</function>.
</simpara>
@@ -973,22 +973,22 @@
</informalexample>
</para>
<simpara>
- In both PHP3 and PHP4, it is possible to execute a
+ In both PHP 3 and PHP 4, it is possible to execute a
<literal>return</literal> statement inside an
<function>include</function>ed file, in order to terminate
processing in that file and return to the script which called
it. Some differences in the way this works exist, however. The
- first is that in PHP3, the <literal>return</literal> may not
+ first is that in PHP 3, the <literal>return</literal> may not
appear inside a block unless it's a function block, in which case
the <literal>return</literal> applies to that function and not the
- whole file. In PHP4, however, this restriction does not
- exist. Also, PHP4 allows you to return values from
+ whole file. In PHP 4, however, this restriction does not
+ exist. Also, PHP 4 allows you to return values from
<function>include</function>ed files. You can take the value of
the <function>include</function> call as you would a normal
- function. This generates a parse error in PHP3.
+ function. This generates a parse error in PHP 3.
</simpara>
<example>
- <title><function>include</function> in PHP3 and PHP4</title>
+ <title><function>include</function> in PHP 3 and PHP 4</title>
<para>
Assume the existence of the following file (named
<filename>test.inc</filename>) in the same directory as the main
@@ -1014,9 +1014,9 @@
</programlisting>
</para>
<para>
- When <filename>main.html</filename> is called in PHP3, it will
+ When <filename>main.html</filename> is called in PHP 3, it will
generate a parse error on line 2; you can't take the value of an
- <function>include</function> in PHP3. In PHP4, however, the
+ <function>include</function> in PHP 3. In PHP 4, however, the
result will be:
<screen>
Before the return
@@ -1034,12 +1034,12 @@
</programlisting>
</para>
<para>
- In PHP4, the output will be:
+ In PHP 4, the output will be:
<screen>
Before the return
Back in main.html
</screen>
- However, PHP3 will give the following output:
+ However, PHP 3 will give the following output:
<screen>
Before the return
27Back in main.html
@@ -1058,7 +1058,7 @@
</screen>
</para>
<para>
- The spurious '27' is due to the fact that PHP3 does not support
+ The spurious '27' is due to the fact that PHP 3 does not support
<literal>return</literal>ing values from files like that.
</para>
</example>
Index: phpdoc/it/language/functions.xml
diff -u phpdoc/it/language/functions.xml:1.2 phpdoc/it/language/functions.xml:1.3
--- phpdoc/it/language/functions.xml:1.2 Thu Aug 31 15:29:12 2000
+++ phpdoc/it/language/functions.xml Sun Sep 17 12:49:14 2000
@@ -23,18 +23,18 @@
definitions.
</simpara>
<simpara>
- In PHP3, functions must be defined before they are referenced. No
- such requirement exists in PHP4.
+ In PHP 3, functions must be defined before they are referenced. No
+ such requirement exists in PHP 4.
</simpara>
<simpara>
PHP does not support function overloading, nor is it possible to
undefine or redefine previously-declared functions.
</simpara>
<simpara>
- PHP3 does not support variable numbers of arguments to functions,
+ PHP 3 does not support variable numbers of arguments to functions,
although default arguments are supported (see <link
linkend="functions.arguments.default">Default argument
- values</link> for more information). PHP4 supports both: see <link
+ values</link> for more information). PHP 4 supports both: see <link
linkend="functions.variable-arg-list">Variable-length argument
lists</link> and the function references for
<function>func_num_args</function>,
@@ -57,13 +57,13 @@
reference</link>, and <link
linkend="functions.arguments.default">default argument
values</link>. Variable-length argument lists are supported only
- in PHP4 and later; see <link
+ in PHP 4 and later; see <link
linkend="functions.variable-arg-list">Variable-length argument
lists</link> and the function references for
<function>func_num_args</function>,
<function>func_get_arg</function>, and
<function>func_get_args</function> for more information. A
- similar effect can be achieved in PHP3 by passing an array of
+ similar effect can be achieved in PHP 3 by passing an array of
arguments to a function:
<informalexample>
@@ -208,7 +208,7 @@
<title>Variable-length argument lists</title>
<simpara>
- PHP4 has support for variable-length argument lists in
+ PHP 4 has support for variable-length argument lists in
user-defined functions. This is really quite easy, using the
<function>func_num_args</function>,
<function>func_get_arg</function>, and
@@ -282,7 +282,7 @@
</simpara>
<simpara>
This is a deprecated feature, and should only be used by the
- PHP/FI2->PHP3 convertor.
+ PHP/FI2->PHP 3 convertor.
</simpara>
<warning>
<para>
@@ -292,7 +292,7 @@
<function>usort</function>, <function>array_walk</function>, and
<function>register_shutdown_function</function>. You can get
around this limitation by writing a wrapper function (in normal
- PHP3 form) to call the <literal>old_function</literal>.
+ PHP 3 form) to call the <literal>old_function</literal>.
</para>
</warning>
Index: phpdoc/it/language/operators.xml
diff -u phpdoc/it/language/operators.xml:1.2 phpdoc/it/language/operators.xml:1.3
--- phpdoc/it/language/operators.xml:1.2 Thu Aug 31 15:23:23 2000
+++ phpdoc/it/language/operators.xml Sun Sep 17 12:49:14 2000
@@ -95,10 +95,10 @@
Note that the assignment copies the original variable to the new
one (assignment by value), so changes to one will not affect the
other. This may also have relevance if you need to copy something
- like a large array inside a tight loop. PHP4 supports assignment
+ like a large array inside a tight loop. PHP 4 supports assignment
by reference, using the <computeroutput>$var =
&$othervar;</computeroutput> syntax, but this is not possible
- in PHP3. 'Assignment by reference' means that both variables end
+ in PHP 3. 'Assignment by reference' means that both variables end
up pointing at the same data, and nothing is copied anywhere.
To learn more about references, please read <link
linkend="language.references">References explained</link>.
@@ -194,7 +194,7 @@
<entry>Identical</entry>
<entry>
True if $a is equal to $b, and they are of the same
- type. (PHP4 only)
+ type. (PHP 4 only)
</entry>
</row>
<row>
@@ -207,7 +207,7 @@
<entry>Not identical</entry>
<entry>
True if $a is not equal to $b, or they are not of the same
- type. (PHP4 only)
+ type. (PHP 4 only)
</entry>
</row>
<row>
Index: phpdoc/it/language/types.xml
diff -u phpdoc/it/language/types.xml:1.2 phpdoc/it/language/types.xml:1.3
--- phpdoc/it/language/types.xml:1.2 Thu Aug 31 15:24:36 2000
+++ phpdoc/it/language/types.xml Sun Sep 17 12:49:14 2000
@@ -409,7 +409,7 @@
</informalexample>
</para>
<para>
- In PHP3 it is not possible to reference multidimensional arrays
+ In PHP 3 it is not possible to reference multidimensional arrays
directly within strings. For instance, the following will not
have the desired result:
<informalexample>
@@ -418,7 +418,7 @@
echo "This won't work: $a[3][bar]";
</programlisting>
</informalexample>
- In PHP3, the above will output <computeroutput>This won't work:
+ In PHP 3, the above will output <computeroutput>This won't work:
Array[bar]</computeroutput>. The string concatenation operator,
however, can be used to overcome this:
<informalexample>
@@ -429,7 +429,7 @@
</informalexample>
</para>
<para>
- In PHP4, however, the whole problem may be circumvented by
+ In PHP 4, however, the whole problem may be circumvented by
enclosing the array reference (inside the string) in curly
braces:
<informalexample>
Index: phpdoc/it/language/variables.xml
diff -u phpdoc/it/language/variables.xml:1.2 phpdoc/it/language/variables.xml:1.3
--- phpdoc/it/language/variables.xml:1.2 Thu Aug 31 15:26:37 2000
+++ phpdoc/it/language/variables.xml Sun Sep 17 12:49:14 2000
@@ -39,7 +39,7 @@
</para>
<para>
- In PHP3, variables are always assigned by value. That is to say,
+ In PHP 3, variables are always assigned by value. That is to say,
when you assign an expression to a variable, the entire value of
the original expression is copied into the destination
variable. This means, for instance, that after assigning one
@@ -49,7 +49,7 @@
linkend="language.expressions">Expressions</link>.
</para>
<para>
- PHP4 offers another way to assign values to variables:
+ PHP 4 offers another way to assign values to variables:
<emphasis>assign by reference</emphasis>. This means that the new
variable simply references (in other words, "becomes an alias for"
or "points to") the original variable. Changes to the new variable
- Next message: Luca Perugini: "[PHP-DOC] cvs: phpdoc /it/appendices phpdevel.xml /it/chapters intro.xml /it/features file-upload.xml"
- Previous message: Luca Perugini: "[PHP-DOC] cvs: phpdoc /it/functions com.xml cpdf.xml cybercash.xml errorfunc.xml funchand.xml http.xml ibase.xml image.xml imap.xml info.xml math.xml misc.xml pdf.xml posix.xml recode.xml swf.xml"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

