torben Sat Jul 14 04:14:04 2001 EDT Modified files: /phpdoc/en/language types.xml Log: More fixes.
Index: phpdoc/en/language/types.xml diff -u phpdoc/en/language/types.xml:1.37 phpdoc/en/language/types.xml:1.38 --- phpdoc/en/language/types.xml:1.37 Sat Jul 14 03:49:16 2001 +++ phpdoc/en/language/types.xml Sat Jul 14 04:14:04 2001 @@ -89,7 +89,7 @@ (at least it is for the operator-defs) <simpara> - In parameter definitions you can also encouter the 'number' pseudo-type, + In parameter definitions you can also encounter the 'number' pseudo-type, that indicates a parameter that is either <type>integer</type> or <type>double</type>. </simpara> @@ -177,14 +177,14 @@ <sect2 id="language.types.boolean.casting"> <title>Converting to boolean</title> <simpara> - To explicitely convert a value to <type>boolean</type>, use either + To explicitly convert a value to <type>boolean</type>, use either the <literal>(bool)</literal> or the <literal>(boolean)</literal> cast. However, in most cases you do not need to use the cast, since a value will be automatically converted if an operator, function or control structure requires a <type>boolean</type> argument. </simpara> <simpara> - See also <link linkend="language.types.type-juggling">type-juggling</link>. + See also <link linkend="language.types.type-juggling">Type Juggling</link>. </simpara> <para> @@ -295,7 +295,7 @@ </para> <note><!-- or warning? --> <simpara> - In PHP there is no such thing as integer-division. <literal>1/2</literal> + In PHP there is no such thing as integer division. <literal>1/2</literal> yields the <type>double</type> <literal>0.5</literal>. <!-- See ??? for more information. (with the operators, or with type-jug) --> </simpara> @@ -336,12 +336,13 @@ </informalexample> <warning> <simpara> - Unfortunately, there is a bug in the script engine (still present in - 4.0.6, probably resolved in 4.0.7) so that this does not always work - correctly when there are negative numbers involved. However when both - operands are positive, there is no problem. For example: when you do - <literal>-50000 * $million</literal>, the result will be - <literal>-429496728</literal>. + Unfortunately, there is a bug in the script engine (still + present in 4.0.6, probably resolved in 4.0.7) so that this + does not always work correctly when there are negative numbers + involved. For example: when you do <literal>-50000 * + $million</literal>, the result will be + <literal>-429496728</literal>. However, when both operands are + positive there is no problem. </simpara> </warning> </para> @@ -351,7 +352,7 @@ <sect2 id="language.types.integer.casting"> <title>Converting to integer</title> <simpara> - To explicitely convert a value to <type>integer</type>, use either + To explicitly convert a value to <type>integer</type>, use either the <literal>(int)</literal> or the <literal>(integer)</literal> cast. However, in most cases you do not need to use the cast, since a value will be autmatically converted if an operator, function or @@ -372,7 +373,7 @@ </sect3> <sect3 id="language.types.integer.casting.from-double"> - <title>From floating point numbers</title> + <title>From <link linkend="language.types.double">floating point +numbers</link></title> <simpara> When converting from float to integer, the number will be rounded <emphasis>towards zero</emphasis>. @@ -393,7 +394,7 @@ sometimes lead to unexpected results. <informalexample> <programlisting role="php"> -echo (int) ( (0.1+0.7) * 10 ); // echo's 7! +echo (int) ( (0.1+0.7) * 10 ); // echoes 7! </programlisting> </informalexample> @@ -414,14 +415,14 @@ <sect3 id="language.types.integer.casting.from-other"> <title>From other types</title> <para> - Behaviour of converting to integer is undefined for other - types. Currently, the behaviour is the same as if - the value was first <link linkend="language.types.boolean.casting" - >converted to boolean</link>. <caution> <simpara> - However, do <emphasis>not</emphasis> - relay on this behaviour, as it can change without notice. + Behaviour of converting to integer is undefined for other + types. Currently, the behaviour is the same as if the value + was first <link linkend="language.types.boolean.casting" + >converted to boolean</link>. However, do + <emphasis>not</emphasis> relay on this behaviour, as it can + change without notice. </simpara> </caution> </para> @@ -441,7 +442,7 @@ <sect1 id="language.types.double"> <title>Floating point numbers</title> <para> - Floating point numbers (aka "doubles", "floats" or "real numbers") can be + Floating point numbers (AKA "doubles", "floats" or "real numbers") can be specified using any of the following syntaxes: <synopsis> $a = 1.234; $a = 1.2e3; $a = 7E-10; @@ -664,21 +665,21 @@ <simpara> It is very important to note that the line with the closing identifier contains no other characters, except - <emphasis>possibly</emphasis> a <literal>;</literal>. + <emphasis>possibly</emphasis> a semicolon (<literal>;</literal>). That means especially that the identifier <emphasis>may not be indented</emphasis>, and there - may not be any spaces or tabs after or before the <literal>;</literal>. + may not be any spaces or tabs after or before the semicolon. </simpara> <simpara> Probably the nastiest gotcha is that there may also not be a carriage return (<literal>\r</literal>) at the end of the line, only - a form feed, a.k.a. newline (<literal>\n</literal>). + a form feed, AKA newline (<literal>\n</literal>). Since Microsoft Windows uses the sequence <literal>\r\n</literal> as a line terminator, your heredoc may not work if you write your - script in a windows editor. However, most programming - editors provide a way to save your files with UNIX + script in a Windows editor. However, most programming + editors provide a way to save your files with a UNIX line terminator. <!-- FTP will sometimes automatically convert \r\n to \n while @@ -750,7 +751,7 @@ <link linkend="language.types.string.parsing.complex">complex</link> one. The simple syntax is the most common and convenient, it provides a way - to parse a variable, an array-value, or a object-property. + to parse a variable, an array value, or an object property. </simpara> <simpara> The complex syntax was introduced in PHP 4, @@ -761,11 +762,10 @@ <sect4 id="language.types.string.parsing.simple"> <title>Simple syntax</title> <simpara> - If a <literal>$</literal> is encoutered, the parser will - greedily take as much tokens as possible to form a valid - variable name. Enclose the the variable name in curly - braces if you want to explicitely specify the end of the - name. + If a dollar sign (<literal>$</literal>) is encountered, the + parser will greedily take as much tokens as possible to form a + valid variable name. Enclose the variable name in curly + braces if you want to explicitly specify the end of the name. </simpara> <informalexample> <programlisting role="php"> @@ -776,12 +776,12 @@ </programlisting> </informalexample> <simpara> - Similary, you can also have an array-index and an - object-property parsed. With array-indices, the - ']' marks the end of the index, for object-properties - the same rules apply as to simple variables, though - with object properties there doesn't exist a trick - like the one with variables. + Similary, you can also have an array index or an object + property parsed. With array indices, the closing square bracket + (<literal>]</literal>) marks the end of the index. For + object properties the same rules apply as to simple variables, + though with object properties there doesn't exist a trick like + the one with variables. <!-- XXX isn't &true; :(, this would be the trick Also, @@ -1080,7 +1080,7 @@ <sect3 id="language.types.array.syntax.modifying"> <title>Creating/modifying with square-bracket syntax</title> <para> - You can also modify an existing array, by explicitely setting + You can also modify an existing array, by explicitly setting values. </para> <para>