I don't think it's necessary to quote the developers when writing
documentation. Many people probably have no idea who Andi is and it's even
(very remotely) possible that he may not be involved in PHP development in
the future. The PHP docs are the definitive source for PHP documentation
and they already indirectly reflect the ideas and thoughts of the
development team, without having to quote them. Besides, the documentation
should be written in a confident style without having to support itself with
quotes or references.
What do you guys think?
Daniel
----- Original Message -----
From: "Zak Greant" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Sent: Sunday, June 24, 2001 12:11 AM
Subject: [PHP-DOC] cvs: phpdoc /en/functions var.xml
> zak Sun Jun 24 07:11:35 2001 EDT
>
> Modified files:
> /phpdoc/en/functions var.xml
> Log:
> Added note on behavior of is_scalar() with regards to resource type
values
>
> Index: phpdoc/en/functions/var.xml
> diff -u phpdoc/en/functions/var.xml:1.54 phpdoc/en/functions/var.xml:1.55
> --- phpdoc/en/functions/var.xml:1.54 Sat Jun 23 22:10:51 2001
> +++ phpdoc/en/functions/var.xml Sun Jun 24 07:11:35 2001
> @@ -747,6 +747,14 @@
> </para>
> <note>
> <para>
> + Note that the PHP resource type is not considered a scalar value.
> + Andi Gutmans states: "[Resources] are abstract datatypes which
> + happen to be in ID (integer) form ... people should [not] count
> + on it being an integer as this could change one day."
> + </para>
> + </note>
> + <note>
> + <para>
> This function was added to the CVS code after the release of PHP
> 4.0.4pl1
> </para>
> @@ -1291,7 +1299,7 @@
> <?php
> $a = array (1, 2, array ("a", "b", "c"));
> var_dump ($a);
> -
> +
> /* output:
> array(3) {
> [0]=>
>
>
>
