Re: [PHP-DOC] cvs: phpdoc /en/language oop5.xml /en/language/oop5 ...

2004-07-11 Thread Philip Olson

In the future we should have the person who created the files "rename"
them as to keep the proper information in the CVS blame logs.  Sure we'll
eventually insert credit tags but it just doesn't feel right to have
someone else moving the files this way, imho at least :)

Regards,
Philip



On Sun, 11 Jul 2004, Nuno Lopes wrote:

> nlopess   Sun Jul 11 08:33:25 2004 EDT
> 
>   Added files: 
> /phpdoc/en/language/oop5  abstract.xml cloning.xml constants.xml 
>   decon.xml final.xml interfaces.xml 
>   iterations.xml magic.xml 
>   object-comparison.xml overloading.xml 
>   paamayim-nekudotayim.xml reflection.xml 
>   static.xml visibility.xml 
> 
>   Removed files:   
> /phpdoc/en/language/oop5  oop5-abstract.xml oop5-cloning.xml 
>   oop5-constants.xml oop5-decon.xml 
>   oop5-final.xml oop5-interfaces.xml 
>   oop5-iterations.xml oop5-magic.xml 
>   oop5-object-comparison.xml 
>   oop5-overloading.xml 
>   oop5-paamayim-nekudotayim.xml 
>   oop5-reflection.xml oop5-static.xml 
>   oop5-visibility.xml 
> 
>   Modified files:  
> /phpdoc/en/language   oop5.xml 
>   Log:
>   renaming files and adding initial reflection documentation
>   


Re: [PHP-DOC] cvs: phpdoc /en/reference/zlib ini.xml reference.xml /en/reference/zlib/functions gzclose.xml gzcompress.xml gzdeflate.xml gzencode.xml

2004-07-11 Thread Marco Cucinato
Il 00:47, lunedì 12 luglio 2004, Marco Cucinato ha scritto:
> cucinato  Sun Jul 11 18:47:21 2004 EDT
>
>   Modified files:
> /phpdoc/en/reference/zlib ini.xml reference.xml
> /phpdoc/en/reference/zlib/functions   gzclose.xml gzcompress.xml
>   gzdeflate.xml gzencode.xml
>   Log:
>   Sync to EN tree

Whooops... dunno what happened
perhaps the CVS directory got copied from the EN section...
I'm reverting them now.


[PHP-DOC] cvs: phpdoc /en/reference/zlib ini.xml reference.xml /en/reference/zlib/functions gzclose.xml gzcompress.xml gzdeflate.xml gzencode.xml

2004-07-11 Thread Marco Cucinato
cucinatoSun Jul 11 18:47:21 2004 EDT

  Modified files:  
/phpdoc/en/reference/zlib   ini.xml reference.xml 
/phpdoc/en/reference/zlib/functions gzclose.xml gzcompress.xml 
gzdeflate.xml gzencode.xml 
  Log:
  Sync to EN tree
  
  http://cvs.php.net/diff.php/phpdoc/en/reference/zlib/ini.xml?r1=1.7&r2=1.8&ty=u
Index: phpdoc/en/reference/zlib/ini.xml
diff -u phpdoc/en/reference/zlib/ini.xml:1.7 phpdoc/en/reference/zlib/ini.xml:1.8
--- phpdoc/en/reference/zlib/ini.xml:1.7Mon May 31 13:13:24 2004
+++ phpdoc/en/reference/zlib/ini.xmlSun Jul 11 18:47:20 2004
@@ -1,21 +1,21 @@
 
-
+
 
  &reftitle.runtime;
  &extension.runtime;
  
-  The zlib extension offers the option to transparently compress
-  your pages on-the-fly, if the requesting browser supports
-  this. Therefore there are three options in the configuration file &php.ini;.
+  L'estensione zlib permette di comprimere in modo trasparente
+  le pagine on-the-fly, se il browser supporta questa
+  funzionalità. Quindi ci sono due opzioni nel file di configurazione &php.ini;.

-   Zlib Configuration Options
+   Opzioni di configurazione di Zlib

 
  
-  Name
+  Nome
   Default
-  Changeable
+  Configurabile in
  
 
 
@@ -37,7 +37,7 @@
 

   
-   For further details and definition of the PHP_INI_* constants see
+   Per ulteriori dettagli e definizioni delle costanti PHP_INI_* vedere
   ini_set.
 
  
@@ -52,22 +52,22 @@


 
- Whether to transparently compress pages. If this option is set
- to "On" in &php.ini; or the Apache configuration, pages are
- compressed if the browser sends an "Accept-Encoding: gzip" or
- "deflate" header. "Content-Encoding: gzip" (respectively
- "deflate") and "Vary: Accept-Encoding" headers are added to
- the output.
+ Decide se comprimere le agine in maniera trasparente. Se questa opzione è 
impostata
+ a "On" in &php.ini; o nella configurazione di Apache, le pagine vengono
+ compresse se il browser invia un header "Accept-Encoding: gzip" o
+ "deflate". Gli header "Content-Encoding: gzip" (oppure
+ "deflate") e "Vary: Accept-Encoding" sono aggiunti
+ all'output.
 
 
- This option also accepts integer values instead of boolean
- "On"/"Off", using this you can set the output buffer size
- (default is 4KB).
+ Questa opzione accetta anche valori interi oltre ai booleani
+ "On"/"Off", in questo modo è possibile impostare la dimensione del buffer
+ (il default è 4KB).
 
 
  
-  output_handler must be 
-  empty if this is set 'On' ! Instead you must use zlib.output_handler.
+  output_handler deve essere
+  vuoto se quest opzione è 'On' ! Altrimenti occorre utilizzare 
zlib.output_handler.
  
 

@@ -80,7 +80,7 @@


 
- Compression level used for transparent output compression.
+ Livello di compressione utilizzato per la compressione trasparente dell'output.
 

   
@@ -92,9 +92,9 @@


 
- You cannot specify additional output handlers if zlib.output_compression
- is activated here. This setting does the same as 
- output_handler but in a different order.
+ Non si possino specificare ulteriori handler dell'output se 
zlib.output_compression
+ è attivo. Questa impostazione è come 
+ output_handler ma con un ordine differente.
 

   
http://cvs.php.net/diff.php/phpdoc/en/reference/zlib/reference.xml?r1=1.14&r2=1.15&ty=u
Index: phpdoc/en/reference/zlib/reference.xml
diff -u phpdoc/en/reference/zlib/reference.xml:1.14 
phpdoc/en/reference/zlib/reference.xml:1.15
--- phpdoc/en/reference/zlib/reference.xml:1.14 Fri Feb 27 06:01:35 2004
+++ phpdoc/en/reference/zlib/reference.xml  Sun Jul 11 18:47:20 2004
@@ -1,36 +1,36 @@
 
-
+
  
-  Zlib Compression Functions
+  Funzioni di compressione Zlib
   Zlib
 
   

 &reftitle.intro;
 
- This module enables you to transparently read and write
- gzip (.gz) compressed files, through versions of most of
- the filesystem functions
- which work with gzip-compressed files (and uncompressed files,
- too, but not with sockets).
+ questo modulo permette di leggere e scrivere in modo trasparente
+ i file compressi con gzip (.gz), attraverso versioni di molte delle
+ funzioni del filesystem
+ in grado di operare su file compressi con gzip (ed anche su file non compressi,
+ ma non con i socket).
 
 
  
-  Version 4.0.4 introduced a fopen-wrapper for .gz-files, so that
-  you can use a special 'zlib:' URL to access compressed files
-  transparently using the normal f*() file access functions if you
-  prepend the filename or path with a 'zlib:' prefix when calling
+  La versione 4.0.4 ha introdotto un wrapper di fopen per i file .gz, che
+  permette di usare una speciale URL 'zlib:' per acce

[PHP-DOC] #29094 [Opn->Csd]: setrawcookie spelling error in doc

2004-07-11 Thread dave
 ID:   29094
 Updated by:   [EMAIL PROTECTED]
 Reported By:  chris at hackmosphere dot com
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: n/a
 PHP Version:  5.0.0RC3
 New Comment:

This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation
better.


Previous Comments:


[2004-07-11 17:37:02] chris at hackmosphere dot com

Description:

Automatically is spelled automaticall under the description for
setrawcookie() in the english php manual.

http://ca3.php.net/manual/en/function.setrawcookie.php






-- 
Edit this bug report at http://bugs.php.net/?id=29094&edit=1


[PHP-DOC] cvs: phpdoc /en/reference/http/functions setrawcookie.xml

2004-07-11 Thread Dave
daveSun Jul 11 11:41:38 2004 EDT

  Modified files:  
/phpdoc/en/reference/http/functions setrawcookie.xml 
  Log:
  - Fix #29094
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/http/functions/setrawcookie.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/reference/http/functions/setrawcookie.xml
diff -u phpdoc/en/reference/http/functions/setrawcookie.xml:1.1 
phpdoc/en/reference/http/functions/setrawcookie.xml:1.2
--- phpdoc/en/reference/http/functions/setrawcookie.xml:1.1 Sat Feb  7 13:56:34 
2004
+++ phpdoc/en/reference/http/functions/setrawcookie.xml Sun Jul 11 11:41:38 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -20,7 +20,7 @@
 
  setrawcookie is exactly the same as
  setcookie except that the cookie value will not
- automaticall be urlencoded when send to the browser.
+ be automatically urlencoded when sent to the browser.
 
 
  See also header, setcookie and the 


[PHP-DOC] #29094 [NEW]: setrawcookie spelling error in doc

2004-07-11 Thread chris at hackmosphere dot com
From: chris at hackmosphere dot com
Operating system: n/a
PHP version:  5.0.0RC3
PHP Bug Type: Documentation problem
Bug description:  setrawcookie spelling error in doc

Description:

Automatically is spelled automaticall under the description for
setrawcookie() in the english php manual.

http://ca3.php.net/manual/en/function.setrawcookie.php


-- 
Edit bug report at http://bugs.php.net/?id=29094&edit=1
-- 
Try a CVS snapshot (php4):  http://bugs.php.net/fix.php?id=29094&r=trysnapshot4
Try a CVS snapshot (php5):  http://bugs.php.net/fix.php?id=29094&r=trysnapshot5
Fixed in CVS:   http://bugs.php.net/fix.php?id=29094&r=fixedcvs
Fixed in release:   http://bugs.php.net/fix.php?id=29094&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=29094&r=needtrace
Need Reproduce Script:  http://bugs.php.net/fix.php?id=29094&r=needscript
Try newer version:  http://bugs.php.net/fix.php?id=29094&r=oldversion
Not developer issue:http://bugs.php.net/fix.php?id=29094&r=support
Expected behavior:  http://bugs.php.net/fix.php?id=29094&r=notwrong
Not enough info:http://bugs.php.net/fix.php?id=29094&r=notenoughinfo
Submitted twice:http://bugs.php.net/fix.php?id=29094&r=submittedtwice
register_globals:   http://bugs.php.net/fix.php?id=29094&r=globals
PHP 3 support discontinued: http://bugs.php.net/fix.php?id=29094&r=php3
Daylight Savings:   http://bugs.php.net/fix.php?id=29094&r=dst
IIS Stability:  http://bugs.php.net/fix.php?id=29094&r=isapi
Install GNU Sed:http://bugs.php.net/fix.php?id=29094&r=gnused
Floating point limitations: http://bugs.php.net/fix.php?id=29094&r=float


[PHP-DOC] cvs: phpdoc /en/language oop5.xml /en/language/oop5 abstract.xml cloning.xml constants.xml decon.xml final.xml interfaces.xml iterations.xml magic.xml object-comparison.xml oop5-abstract.xml oop5-cloning.xml oop5-constants.xml oop5-decon.xml oop5-final.xml oop5-interfaces.xml oop5-iterations.xml oop5-magic.xml oop5-object-comparison.xml oop5-overloading.xml oop5-paamayim-nekudotayim.xml oop5-reflection.xml oop5-static.xml oop5-visibility.xml overloading.xml paamayim-nekudotayim.xml reflection.xml static.xml visibility.xml

2004-07-11 Thread Nuno Lopes
nlopess Sun Jul 11 08:33:25 2004 EDT

  Added files: 
/phpdoc/en/language/oop5abstract.xml cloning.xml constants.xml 
decon.xml final.xml interfaces.xml 
iterations.xml magic.xml 
object-comparison.xml overloading.xml 
paamayim-nekudotayim.xml reflection.xml 
static.xml visibility.xml 

  Removed files:   
/phpdoc/en/language/oop5oop5-abstract.xml oop5-cloning.xml 
oop5-constants.xml oop5-decon.xml 
oop5-final.xml oop5-interfaces.xml 
oop5-iterations.xml oop5-magic.xml 
oop5-object-comparison.xml 
oop5-overloading.xml 
oop5-paamayim-nekudotayim.xml 
oop5-reflection.xml oop5-static.xml 
oop5-visibility.xml 

  Modified files:  
/phpdoc/en/language oop5.xml 
  Log:
  renaming files and adding initial reflection documentation
  http://cvs.php.net/diff.php/phpdoc/en/language/oop5.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc/en/language/oop5.xml
diff -u phpdoc/en/language/oop5.xml:1.4 phpdoc/en/language/oop5.xml:1.5
--- phpdoc/en/language/oop5.xml:1.4 Sun Jul 11 06:06:18 2004
+++ phpdoc/en/language/oop5.xml Sun Jul 11 08:33:25 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Classes and Objects (PHP 5)
 
@@ -10,20 +10,20 @@
 
   
 
-  &language.oop5.oop5-decon;
-  &language.oop5.oop5-visibility;
-  &language.oop5.oop5-paamayim-nekudotayim;
-  &language.oop5.oop5-static;
-  &language.oop5.oop5-constants;
-  &language.oop5.oop5-abstract;
-  &language.oop5.oop5-interfaces;
-  &language.oop5.oop5-overloading;
-  &language.oop5.oop5-iterations;
-  &language.oop5.oop5-magic;
-  &language.oop5.oop5-final;
-  &language.oop5.oop5-cloning;
-  &language.oop5.oop5-object-comparison;
-  &language.oop5.oop5-reflection;
+  &language.oop5.decon;
+  &language.oop5.visibility;
+  &language.oop5.paamayim-nekudotayim;
+  &language.oop5.static;
+  &language.oop5.constants;
+  &language.oop5.abstract;
+  &language.oop5.interfaces;
+  &language.oop5.overloading;
+  &language.oop5.iterations;
+  &language.oop5.magic;
+  &language.oop5.final;
+  &language.oop5.cloning;
+  &language.oop5.object-comparison;
+  &language.oop5.reflection;
 
  
 
 
  Object Abstraction

  
   PHP 5 introduces abstract classes and methods. An abstract
   method only declares the method's signature and does not provide an
   implementation. A class that contains abstract methods needs to be declared
   abstract.
  

  
   


   
  

   
Abstract classes cannot be instantiated. Old code that has no user-defined
classes or functions named 'abstract' should run without modifications.
   

 
 


http://cvs.php.net/co.php/phpdoc/en/language/oop5/cloning.xml?r=1.1&p=1
Index: phpdoc/en/language/oop5/cloning.xml
+++ phpdoc/en/language/oop5/cloning.xml


 
  Object cloning
  
  
  Creating a copy of an object with fully replicated properties is not
  always the wanted behavior. A good example of the need for copy
  constructors, is if you have an object which represents a GTK window and the
  object holds the resource of this GTK window, when you create a duplicate
  you might want to create a new window with the same properties and have the
  new object hold the resource of the new window. Another example is if your
  object holds a reference to another object which it uses and when you
  replicate the parent object you want to create a new instance of this other
  object so that the replica has its own separate copy.
  

  
   An object copy is created by using the clone keyword (which calls the
   object's __clone() method if possible). An object's __clone()  method
   cannot be called directly.
  

  
   

   
  

  
   When the developer asks to create a new copy of an object, PHP 5 will check
   if a __clone() method has been defined or not. If not, it will call a
   default __clone() which will copy all of the object's properties. If a
   __clone() method is defined, then it will be responsible to set the
   necessary properties in the created object. For convenience, the engine
   will supply a function that imports all of the properties from the source
   object, so that they can start with a by-value replica of the source
   object, and only override properties that need to be changed.
  


 Cloning an object
 

 




 
 


http://cvs.php.net/co.php/phpdoc/en/language/oop5/constants.xml?r=1.1&p=1
Index: phpdoc/en/language/oop5/constants.xml
+++ phpdoc/en/language/oop5/constants.xml


 
  Object Constants
  
   .
  


 
 


http://cvs.php.net/co.php/phpdoc/en/language/oop5/decon.xml?r=1.1&p=1
Index: phpdoc/en/language/oop5/decon.xml
+++ phpdoc/en/language/oop5/decon.xm

[PHP-DOC] cvs: phpdoc /en/reference/sybase ini.xml

2004-07-11 Thread Nuno Lopes
nlopess Sun Jul 11 08:31:06 2004 EDT

  Modified files:  
/phpdoc/en/reference/sybase ini.xml 
  Log:
  un-comment ini entries
  
http://cvs.php.net/diff.php/phpdoc/en/reference/sybase/ini.xml?r1=1.9&r2=1.10&ty=u
Index: phpdoc/en/reference/sybase/ini.xml
diff -u phpdoc/en/reference/sybase/ini.xml:1.9 phpdoc/en/reference/sybase/ini.xml:1.10
--- phpdoc/en/reference/sybase/ini.xml:1.9  Thu Jul  8 10:27:54 2004
+++ phpdoc/en/reference/sybase/ini.xml  Sun Jul 11 08:31:05 2004
@@ -1,5 +1,5 @@
 
-
+
 
  &reftitle.runtime;
  &extension.runtime;
@@ -301,7 +301,6 @@
 


-
+

 
  sybct.hostname


Re: [PHP-DOC] cvs: phpdoc /en/language oop5.xml /en/language/oop5 oop5-abstract.xml oop5-cloning.xml oop5-constants.xml oop5-decon.xml oop5-final.xml oop5-interfaces.xml oop5-iterations.xml oop5-magic.xml oop5-overloading.xml oop5-paamayim-nekudotayim.php

2004-07-11 Thread Nuno Lopes
> OK, could you please also do the renaming? Wold be fine.
> 
> Goba
> 

OK!


Re: [PHP-DOC] cvs: phpdoc /en/language oop5.xml /en/language/oop5 oop5-abstract.xml oop5-cloning.xml oop5-constants.xml oop5-decon.xml oop5-final.xml oop5-interfaces.xml oop5-iterations.xml oop5-magic.xml oop5-overloading.xml oop5-paamayim-nekudotayim.php

2004-07-11 Thread Gabor Hojtsy
 Added files:
   /phpdoc/en/language oop5.xml
   /phpdoc/en/language/oop5 oop5-abstract.xml oop5-cloning.xml
   oop5-constants.xml oop5-decon.xml
   oop5-final.xml oop5-interfaces.xml
   oop5-iterations.xml oop5-magic.xml
   oop5-overloading.xml
   oop5-paamayim-nekudotayim.php
   oop5-reflection.xml oop5-static.xml
   oop5-visibility.xml
 Log:
 The new oop5 documentation.
I agree, since that files are in the oop5 folder. But whait a second,
because I'm finishing importing the Reflection docs.
OK, could you please also do the renaming? Wold be fine.
Goba


Re: [PHP-DOC] cvs: phpdoc /en/language oop5.xml /en/language/oop5 oop5-abstract.xml oop5-cloning.xml oop5-constants.xml oop5-decon.xml oop5-final.xml oop5-interfaces.xml oop5-iterations.xml oop5-magic.xml oop5-overloading.xml oop5-paamayim-nekudotayim.php

2004-07-11 Thread Nuno Lopes

> >   Added files:
> > /phpdoc/en/language oop5.xml
> > /phpdoc/en/language/oop5 oop5-abstract.xml oop5-cloning.xml
> > oop5-constants.xml oop5-decon.xml
> > oop5-final.xml oop5-interfaces.xml
> > oop5-iterations.xml oop5-magic.xml
> > oop5-overloading.xml
> > oop5-paamayim-nekudotayim.php
> > oop5-reflection.xml oop5-static.xml
> > oop5-visibility.xml
> >   Log:
> >   The new oop5 documentation.
>
> Why do we need the "oop5-" prefix on all files. We *should not* have it.
> Please recommit with filenames without this prefix, so we can go on with
> that structure. The folder name itself contains oop5, so there is no
> need for the files to contain it. Or provide a reason if you think it
> should stay this way!
>
> Goba


I agree, since that files are in the oop5 folder. But whait a second,
because I'm finishing importing the Reflection docs.
Nuno


Re: [PHP-DOC] cvs: phpdoc /en/language oop5.xml /en/language/oop5 oop5-abstract.xml oop5-cloning.xml oop5-constants.xml oop5-decon.xml oop5-final.xml oop5-interfaces.xml oop5-iterations.xml oop5-magic.xml oop5-overloading.xml oop5-paamayim-nekudotayim.php oop5-reflection.xml oop5-static.xml oop5-visibility.xml

2004-07-11 Thread Gabor Hojtsy
  Added files: 
/phpdoc/en/language	oop5.xml 
/phpdoc/en/language/oop5	oop5-abstract.xml oop5-cloning.xml 
	oop5-constants.xml oop5-decon.xml 
	oop5-final.xml oop5-interfaces.xml 
	oop5-iterations.xml oop5-magic.xml 
	oop5-overloading.xml 
	oop5-paamayim-nekudotayim.php 
	oop5-reflection.xml oop5-static.xml 
	oop5-visibility.xml 
  Log:
  The new oop5 documentation.
Why do we need the "oop5-" prefix on all files. We *should not* have it. 
Please recommit with filenames without this prefix, so we can go on with 
that structure. The folder name itself contains oop5, so there is no 
need for the files to contain it. Or provide a reason if you think it 
should stay this way!

Goba


[PHP-DOC] cvs: phpdoc /en/language oop5.xml /en/language/oop5 oop5-object-comparison.xml

2004-07-11 Thread Nuno Lopes
nlopess Sun Jul 11 06:06:18 2004 EDT

  Modified files:  
/phpdoc/en/language oop5.xml 
/phpdoc/en/language/oop5oop5-object-comparison.xml 
  Log:
  fix ids, sorry
  
http://cvs.php.net/diff.php/phpdoc/en/language/oop5.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc/en/language/oop5.xml
diff -u phpdoc/en/language/oop5.xml:1.3 phpdoc/en/language/oop5.xml:1.4
--- phpdoc/en/language/oop5.xml:1.3 Sun Jul 11 05:32:52 2004
+++ phpdoc/en/language/oop5.xml Sun Jul 11 06:06:18 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Classes and Objects (PHP 5)
 
@@ -22,7 +22,7 @@
   &language.oop5.oop5-magic;
   &language.oop5.oop5-final;
   &language.oop5.oop5-cloning;
-  &language.oop5.object-comparison;
+  &language.oop5.oop5-object-comparison;
   &language.oop5.oop5-reflection;
 
  
http://cvs.php.net/diff.php/phpdoc/en/language/oop5/oop5-object-comparison.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/language/oop5/oop5-object-comparison.xml
diff -u phpdoc/en/language/oop5/oop5-object-comparison.xml:1.1 
phpdoc/en/language/oop5/oop5-object-comparison.xml:1.2
--- phpdoc/en/language/oop5/oop5-object-comparison.xml:1.1  Sun Jul 11 05:32:52 
2004
+++ phpdoc/en/language/oop5/oop5-object-comparison.xml  Sun Jul 11 06:06:18 2004
@@ -1,6 +1,6 @@
 
-
-  
+
+  
Comparing objects

 In PHP 5, object comparison is a more complicated than in PHP 4 and more


Re: [PHP-DOC] cvs: phpdoc / manual.xml.in

2004-07-11 Thread Nuno Lopes
> For some reason I couldn't get the docs referencing the :: to get
> included, 'make test' complains about it not existing.

I've fixed it! You have commited a .php file instead of xml :)

> The chapter happened to be the same name as the php4 docs, i was
> looking for the method to include that php4 and php5 image to
> distinguish them apart in the listing. I remember seeing that image
> somewhere but can't seem to find it anymore.

That image is part of livedocs. Currently it is just added automatically to
new PHP 5 functions.

I've take a look to this chapter, and I haven't found the __toString()
method... Where should it go? Or you were thinking in documenting it in
'magic methods'?

Nuno


[PHP-DOC] cvs: phpdoc /en/language oop.xml oop5.xml /en/language/oop5 oop5-decon.xml oop5-object-comparison.xml oop5-paamayim-nekudotayim.php oop5-paamayim-nekudotayim.xml

2004-07-11 Thread Nuno Lopes
nlopess Sun Jul 11 05:32:52 2004 EDT

  Added files: 
/phpdoc/en/language/oop5oop5-object-comparison.xml 
oop5-paamayim-nekudotayim.xml 

  Removed files:   
/phpdoc/en/language/oop5oop5-paamayim-nekudotayim.php 

  Modified files:  
/phpdoc/en/language oop.xml oop5.xml 
/phpdoc/en/language/oop5oop5-decon.xml 
  Log:
  fix ::
  move comparing objects in PHP 5 to oop5
  http://cvs.php.net/diff.php/phpdoc/en/language/oop.xml?r1=1.52&r2=1.53&ty=u
Index: phpdoc/en/language/oop.xml
diff -u phpdoc/en/language/oop.xml:1.52 phpdoc/en/language/oop.xml:1.53
--- phpdoc/en/language/oop.xml:1.52 Sun May 23 12:02:56 2004
+++ phpdoc/en/language/oop.xml  Sun Jul 11 05:32:52 2004
@@ -1,7 +1,7 @@
 
-
+
  
-  Classes and Objects
+  Classes and Objects (PHP 4)
 
   
class
@@ -964,8 +964,8 @@

   
 
-  
-   Comparing objects in PHP 4
+  
+   Comparing objects
   
In PHP 4, objects are compared in a very simple manner, namely: Two object
instances are equal if they have the same attributes and values, and are
@@ -1114,103 +1114,6 @@

   
  
-
-  
-   Comparing objects in PHP 5
-   &warn.experimental;
-   
-In PHP 5, object comparison is a more complicated than in PHP 4 and more
-in accordance to what one will expect from an Object Oriented Language
-(not that PHP 5 is such a language).
-   
-   
-When using the comparison operator (==), 
-object variables are compared in a simple manner, namely: Two object
-instances are equal if they have the same attributes and values, and are
-instances of the same class.
-   
-   
-On the other hand, when using the identity operator (===),
-object variables are identical if and only if they refer to the same
-instance of the same class.
-   
-   
-An example will clarify these rules.
-
- Example of object comparison in PHP 5
- 
-
- 
-
-This example will output:
-
-Two instances of the same class
-o1 == o2 : TRUE
-o1 != o2 : FALSE
-o1 === o2 : FALSE
-o1 !== o2 : TRUE
-
-Two references to the same instance
-o1 == o2 : TRUE
-o1 != o2 : FALSE
-o1 === o2 : TRUE
-o1 !== o2 : FALSE
-
-Instances of two different classes
-o1 == o2 : FALSE
-o1 != o2 : TRUE
-o1 === o2 : FALSE
-o1 !== o2 : TRUE
-
-   
-  
  
  
 
+
  
-  Classes and Objects
+  Classes and Objects (PHP 5)
 
   
Introduction
@@ -12,10 +12,7 @@
 
   &language.oop5.oop5-decon;
   &language.oop5.oop5-visibility;
-  
+  &language.oop5.oop5-paamayim-nekudotayim;
   &language.oop5.oop5-static;
   &language.oop5.oop5-constants;
   &language.oop5.oop5-abstract;
@@ -25,6 +22,7 @@
   &language.oop5.oop5-magic;
   &language.oop5.oop5-final;
   &language.oop5.oop5-cloning;
+  &language.oop5.object-comparison;
   &language.oop5.oop5-reflection;
 
  
http://cvs.php.net/diff.php/phpdoc/en/language/oop5/oop5-decon.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/language/oop5/oop5-decon.xml
diff -u phpdoc/en/language/oop5/oop5-decon.xml:1.1 
phpdoc/en/language/oop5/oop5-decon.xml:1.2
--- phpdoc/en/language/oop5/oop5-decon.xml:1.1  Sat Jul 10 15:30:37 2004
+++ phpdoc/en/language/oop5/oop5-decon.xml  Sun Jul 11 05:32:52 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Constructors and Destructors
   
@@ -14,7 +14,7 @@
  
   Parent constructors are not called implicitly.  In order to run
   a parent constructor, a call to
-  parent::__construct() is required.
+  parent::__construct is required.
  
 
 

http://cvs.php.net/co.php/phpdoc/en/language/oop5/oop5-object-comparison.xml?r=1.1&p=1
Index: phpdoc/en/language/oop5/oop5-object-comparison.xml
+++ phpdoc/en/language/oop5/oop5-object-comparison.xml


  
   Comparing objects
   
In PHP 5, object comparison is a more complicated than in PHP 4 and more
in accordance to what one will expect from an Object Oriented Language
(not that PHP 5 is such a language).
   
   
When using the comparison operator (==), 
object variables are compared in a simple manner, namely: Two object
instances are equal if they have the same attributes and values, and are
instances of the same class.
   
   
On the other hand, when using the identity operator (===),
object variables are identical if and only if they refer to the same
instance of the same class.
   
   
An example will clarify these rules.

 Example of object comparison in PHP 5
 

 

This example will output:

Two instances of the same class
o1 == o2 : TRUE
o1 != o2 : FALSE
o1 === o2 : FALSE
o1 !== o2 : TRUE

Two references to the same instance
o1 == o2 : TRUE
o1 != o2 : FALSE
o1 === o2 : TRUE
o1 !== o2 : FALSE

Instances of two different classes
o1 == o2 : FALSE
o1 != o2 : TRUE
o1 === o2 : FALSE
o1 !== o2 : TRUE

   
  
 


http://cvs.php.net/co.php/phpdoc/en/language/oop5/oop5-paamayim-nekudotayim.xml?r=1.1&p=1
Index: phpdoc/en/language/oop5/oop5-paamayim-nekudotayim.xml
+