[PHP-DOC] cvs: phpdoc /ja/functions gettext.xml gmp.xml http.xml hw.xml ibase.xml icap.xml iconv.xml ifx.xml image.xml

2002-01-19 Thread Rui Hirokawa

hirokawaSun Jan 20 00:07:01 2002 EDT

  Modified files:  
/phpdoc/ja/functionsgettext.xml gmp.xml http.xml hw.xml ibase.xml 
icap.xml iconv.xml ifx.xml image.xml 
  Log:
  translation updated.
  

Index: phpdoc/ja/functions/gettext.xml
diff -u phpdoc/ja/functions/gettext.xml:1.8 phpdoc/ja/functions/gettext.xml:1.9
--- phpdoc/ja/functions/gettext.xml:1.8 Wed Dec 12 15:52:58 2001
+++ phpdoc/ja/functions/gettext.xml Sun Jan 20 00:07:01 2002
@@ -1,4 +1,5 @@
 
+
  
   GNU Gettext
   gettext
@@ -32,6 +33,29 @@

   
 
+  
+   
+bind_textdomain_codeset
+
+ 
+DOMAINメッセージカタログからのメッセージが変更される文字エンコー
+ ディングを指定する
+
+   
+   
+説明
+
+ 
+  string bind_textdomain_codeset
+  string domain
+  string codeset
+ 
+
+
+ &warn.undocumented.func;
+
+   
+  
+
   

 dcgettext
@@ -54,6 +78,30 @@

   
 
+  
+   
+dcngettext
+
+ dcgettext()の複数版
+   
+   
+説明
+
+ 
+  string dcngettext
+  string domain
+  string msgid1
+  string msgid2
+  int n
+  int category
+ 
+
+
+ &warn.undocumented.func;
+
+   
+  
+
   

 dgettext
@@ -69,8 +117,30 @@
  
 
 
- 関数dgettextにより
- 
単一のメッセージ参照についてカレントのドメインを上書きすることができます。
+ 
+関数dgettextにより単一のメッセージ参照につい
+ てカレントのドメインを上書きすることができます。
+
+   
+  
+
+  
+   
+dcngettext
+dcgettext()の複数型です
+   
+   
+説明
+
+ 
+  string dcngettext
+  string domain
+  string msgid1
+  string msgid2
+  int n
+ 
+
+
+ &warn.undocumented.func;
 

   
@@ -96,7 +166,8 @@
 
  gettext-check
  
-

[PHP-DOC] Norwegian translation

2002-01-19 Thread Geir Eivind Mork

I started on a norwegian translation a while back but I want to get it up 
to date and keep it in the CVS. I wonder a bit on that part, so I ask those 
who are a bit more experienced on the field to give me some guildlines so 
it's as little pain as possible :)

Just found out I could speed up the project today when I got another to 
help on the translation. 

-- 
. Geir Eivind Mork - Bodø -  http://www.moijk.net
. Mårli & Pettersen Reklame - http://www.mpr.no



[PHP-DOC] Bug #14984 Updated: php parser problem, with // comment, can reveal script

2002-01-19 Thread irc-html

ID: 14984
Updated by: irc-html
Reported By: [EMAIL PROTECTED]
Old Status: Open
Status: Assigned
Bug Type: Documentation problem
Operating System: windows and other
PHP Version: 4.0.6
Old Assigned To: 
Assigned To: irc-html
New Comment:

I'll add a note in the documentation about this.

Status -> Assigned


Previous Comments:


[2002-01-11 05:56:38] [EMAIL PROTECTED]

'?>' in a comment switching out of php mode
is intended behaviour, consider

..

embedded in a document

changing this would break backwards compatibility
and would lead to problems of its own kind

changed to "documentation problem"



[2002-01-10 19:03:01] [EMAIL PROTECTED]

Hi all,

I found this bug randomly as all other, it cause me
a php html parser to crash.

try a script like this : 


'.$tmp);
// eval('>'.$tmp);
$coucou='';

$password = 'le parser php déconne';
$password = 'php parser bug';

/*

*/
// // coucou ?>
// ?>
// ?
// >
?>

see the result, abnormal I think:

'.$tmp); // eval('>'.$tmp); $coucou=''; $password = 'le parser php
déconne'; $password = 'php parser bug'; /* */ // // coucou ?> // ?> //
? // > ?>


I think it can be a very very serious, easy to fiw fot you,
but in the case a php user encounter it.
It so surpising !!!



thanks.

An echo please.

Yours faithlly php is always great!.





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




[PHP-DOC] Linking Class Methods

2002-01-19 Thread Kenneth Schwartz

I was attempting to update some of the Ming documentation, I noticed
that SWFMovie->method does not link the method. How
does one link the actual method?  IIRC, it was SWFMovie.method, but it
does not present well on the documentation page.

Does anyone else have any suggestions?

Best regards,

Kenneth Schwartz - http://www.irc-html.com
E-mail: [EMAIL PROTECTED]
Emergency Contact: 910-382-6280




[PHP-DOC] cvs: phpdoc /en/language control-structures.xml

2002-01-19 Thread Philip Olson

philip  Sat Jan 19 20:09:31 2002 EDT

  Modified files:  
/phpdoc/en/language control-structures.xml 
  Log:
  include: minor textual changes.
  
  
Index: phpdoc/en/language/control-structures.xml
diff -u phpdoc/en/language/control-structures.xml:1.52 
phpdoc/en/language/control-structures.xml:1.53
--- phpdoc/en/language/control-structures.xml:1.52  Sat Jan 19 07:01:10 2002
+++ phpdoc/en/language/control-structures.xml   Sat Jan 19 20:09:30 2002
@@ -1,5 +1,5 @@
 
-
+
  
   Control Structures
 
@@ -1098,7 +1098,7 @@
  failure.  include produces a 
  Warning while 
require
  results in a Fatal Error.
- In other words, don't hesitate to use require if you want 
+ In other words, use require if you want 
  a missing file to halt processing of the page.  include 
does 
  not behave this way, the script will continue regardless.  Be sure to have an 
  appropriate include_path setting as well.
@@ -1292,7 +1292,7 @@
 
 ?>
 
-getfoo.php
+testreturns.php
 


-$bar is the value (1) because the include was successful.  
-Notice the difference between the above examples.  The first uses 
+$bar is the value 1 because the include 
+was successful.  Notice the difference between the above examples.  The first 
+uses 
 return within the included file while the other does not.  
 A few other ways to "include" files into variables are with 
 fopen, file or by using 





[PHP-DOC] cvs: phpdoc /en/functions ming.xml

2002-01-19 Thread Kenneth Schwartz

irc-htmlSat Jan 19 19:42:36 2002 EDT

  Modified files:  
/phpdoc/en/functionsming.xml 
  Log:
  whitespace correction
  

Index: phpdoc/en/functions/ming.xml
diff -u phpdoc/en/functions/ming.xml:1.31 phpdoc/en/functions/ming.xml:1.32
--- phpdoc/en/functions/ming.xml:1.31   Wed Jan  2 06:51:18 2002
+++ phpdoc/en/functions/ming.xmlSat Jan 19 19:42:36 2002
@@ -1,19 +1,19 @@
 
-
+
  
   Ming functions for Flash
   Ming (flash)
 
   
-  &warn.experimental;
+   &warn.experimental;

 Introduction
 
-Ming is an open-source (LGPL) library which allows you to create SWF
-("Flash") format movies.  Ming supports almost all of Flash 4's features,
-including: shapes, gradients, bitmaps (pngs and jpegs), morphs ("shape
-tweens"), text, buttons, actions, sprites ("movie clips"), streaming mp3,
-and color transforms--the only thing that's missing is sound events.
+ Ming is an open-source (LGPL) library which allows you to create SWF
+ ("Flash") format movies.  Ming supports almost all of Flash 4's features,
+ including: shapes, gradients, bitmaps (pngs and jpegs), morphs ("shape
+ tweens"), text, buttons, actions, sprites ("movie clips"), streaming mp3,
+ and color transforms--the only thing that's missing is sound events.
 
 
  Ming is not an acronym. 
@@ -25,13 +25,13 @@
  or the entire frame if not embedded. 
 
 
-Ming offers a number of advantages over the existing PHP/libswf module.
-You can use Ming anywhere you can compile the code, whereas libswf is
-closed-source and only available for a few platforms, Windows not one of
-them.  Ming provides some insulation from the mundane details of the SWF
-file format, wrapping the movie elements in PHP objects.  Also, Ming is
-still being maintained; if there's a feature that you want to see, just
-let us know mailto:&email.ming;";>&email.ming;.
+ Ming offers a number of advantages over the existing PHP/libswf module.
+ You can use Ming anywhere you can compile the code, whereas libswf is
+ closed-source and only available for a few platforms, Windows not one of
+ them.  Ming provides some insulation from the mundane details of the SWF
+ file format, wrapping the movie elements in PHP objects.  Also, Ming is
+ still being maintained; if there's a feature that you want to see, just
+ let us know mailto:&email.ming;";>&email.ming;.
 
 
  Ming was added in PHP 4.0.5.
@@ -41,10 +41,10 @@

 Installation
 
-To use Ming with PHP, you first need to build and install the Ming
-library.  Source code and installation instructions are available at the
-Ming home page : &url.ming;
-along with examples, a small tutorial, and the latest news.
+ To use Ming with PHP, you first need to build and install the Ming
+ library.  Source code and installation instructions are available at the
+ Ming home page : &url.ming;
+ along with examples, a small tutorial, and the latest news.
 
 
  Download the ming archive. Unpack the archive. Go in the
@@ -98,71 +98,71 @@
 
 
  
- 
-  swfmovie.
+  
+   swfmovie.
   
-
+ 
  
- 
-  swfshape.
+  
+   swfshape.
   
-
+ 
  
- 
-  swfdisplayitem.
+  
+   swfdisplayitem.
   
-
+ 
  
- 
-  swfgradient.
+  
+   swfgradient.
   
-
+ 
 
  
- 
-  swfbitmap.
+  
+   swfbitmap.
   
-
+ 
  
- 
-  swffill.
+  
+   swffill.
   
-
+ 
  
- 
-  swfmorph.
+  
+   swfmorph.
   
-
+ 
  
- 
-  swftext.
+  
+   swftext.
   
-
+ 
  
- 
-  swffont.
+  
+   swffont.
   
-
+ 
  
- 
-  swftextfield.
+  
+   swftextfield.
   
-
+ 
  
- 
-  swfsprite.
+  
+   swfsprite.
   
-
+ 
 
- 
-  swfbutton.
+  
+   swfbutton.
   
-
+ 
  
- 
-  swfaction.
+  
+   swfaction.
   
-
+ 
 

   
@@ -266,7 +266,7 @@
   
 

-   &warn.experimental.func;
+&warn.experimental.func;

 swfmovie creates a new movie object, 
 representing an SWF version 4 movie.
@@ -300,7 +300,7 @@
   
  
 
-   &warn.experimental.func;
+&warn.experimental.func;
 
  swfmovie->output dumps your lovingly prepared movie out. 
  In PHP, preceding this with the command 
@@ -310,7 +310,7 @@
 header('Content-type: application/x-shockwave-flash'); 
 ?>
 ]]>
-
+ 
  conv

[PHP-DOC] cvs: phpdoc /en/functions fbsql.xml

2002-01-19 Thread Kenneth Schwartz

irc-htmlSat Jan 19 18:42:22 2002 EDT

  Modified files:  
/phpdoc/en/functionsfbsql.xml 
  Log:
  function description updates
  
Index: phpdoc/en/functions/fbsql.xml
diff -u phpdoc/en/functions/fbsql.xml:1.35 phpdoc/en/functions/fbsql.xml:1.36
--- phpdoc/en/functions/fbsql.xml:1.35  Sat Jan 12 11:28:50 2002
+++ phpdoc/en/functions/fbsql.xml   Sat Jan 19 18:42:21 2002
@@ -1,5 +1,5 @@
 
-
+
  
   FrontBase Functions
   FrontBase
@@ -2393,9 +2393,7 @@
   

 fbsql_database
-
- No description given yet
-
+Get or set the database name used with a connection


 Description
@@ -2412,14 +2410,10 @@

   
 
-
-
   

 fbsql_get_autostart_info
-
- No description given yet
-
+No description given yet


 Description
@@ -2440,9 +2434,7 @@
   

 fbsql_hostname
-
- No description given yet
-
+Get or set the host name used with a connection


 Description
@@ -2464,9 +2456,7 @@
   

 fbsql_password
-
- No description given yet
-
+Get or set the user password used with a connection


 Description
@@ -2513,9 +2503,7 @@
   

 fbsql_username
-
- No description given yet
-
+Get or set the host user used with a connection


 Description





[PHP-DOC] cvs: phpdoc /en/functions dbplus.xml

2002-01-19 Thread Kenneth Schwartz

irc-htmlSat Jan 19 18:33:12 2002 EDT

  Modified files:  
/phpdoc/en/functionsdbplus.xml 
  Log:
  function proto updates
  
Index: phpdoc/en/functions/dbplus.xml
diff -u phpdoc/en/functions/dbplus.xml:1.19 phpdoc/en/functions/dbplus.xml:1.20
--- phpdoc/en/functions/dbplus.xml:1.19 Sat Jan 12 11:13:51 2002
+++ phpdoc/en/functions/dbplus.xml  Sat Jan 19 18:33:12 2002
@@ -1,5 +1,5 @@
 
-
+
  
   DB++ Functions
   DB++
@@ -945,7 +945,7 @@
   

 dbplus_rcreate
-
+Creates a new DB++ relation


 Description
@@ -982,7 +982,7 @@
   

 dbplus_rcrtexact
-
+Creates an exact but empty copy of a relation including 
+indices


 Description
@@ -1009,7 +1009,7 @@
   

 dbplus_rcrtlike
-
+Creates an empty copy of a relation with default indices


 Description
@@ -1089,7 +1089,8 @@
   
   

-dbplus_restorepos ???
+dbplus_restorepos
+???


 Description





[PHP-DOC] cvs: phpdoc /de Translators

2002-01-19 Thread Friedhelm Betz

betzSat Jan 19 18:18:39 2002 EDT

  Modified files:  
/phpdoc/de  Translators 
  Log:
  variables.xml sync with en 1.32
  
Index: phpdoc/de/Translators
diff -u phpdoc/de/Translators:1.248 phpdoc/de/Translators:1.249
--- phpdoc/de/Translators:1.248 Sat Jan 19 15:44:11 2002
+++ phpdoc/de/Translators   Sat Jan 19 18:18:39 2002
@@ -205,7 +205,7 @@
 operators.xml   Sven Lauer  fertig
 references.xml  Sebastian Bergmann  fertig
 types.xml   Friedhelm Betz  fertig (bis 1.70)
-variables.xml   Friedhelm Betz  Änderungen
+variables.xml   Friedhelm Betz  fertig (bis 1.32)
 -
 preface.xml Egon Schmid fertig  
 





[PHP-DOC] cvs: phpdoc /en/functions crack.xml dbase.xml

2002-01-19 Thread Kenneth Schwartz

irc-htmlSat Jan 19 18:11:33 2002 EDT

  Modified files:  
/phpdoc/en/functionscrack.xml dbase.xml 
  Log:
  incorporate user notes, configure options
  
Index: phpdoc/en/functions/crack.xml
diff -u phpdoc/en/functions/crack.xml:1.5 phpdoc/en/functions/crack.xml:1.6
--- phpdoc/en/functions/crack.xml:1.5   Wed Jan  2 14:14:25 2002
+++ phpdoc/en/functions/crack.xml   Sat Jan 19 18:11:32 2002
@@ -1,5 +1,5 @@
 
-
+
  
   Crack functions
   Crack functions
@@ -8,7 +8,7 @@

 These functions allow you to use the CrackLib library to test the 'strength'
 of a password.  In order to use these functions, you must compile PHP with
-Crack support by using the --with-crack
+Crack support by using the --with-crack[=DIR]
 option.


Index: phpdoc/en/functions/dbase.xml
diff -u phpdoc/en/functions/dbase.xml:1.15 phpdoc/en/functions/dbase.xml:1.16
--- phpdoc/en/functions/dbase.xml:1.15  Sun Dec 30 06:51:05 2001
+++ phpdoc/en/functions/dbase.xml   Sat Jan 19 18:11:32 2002
@@ -1,5 +1,5 @@
 
-
+
  
   dBase functions
   dBase
@@ -7,7 +7,8 @@
   

 These functions allow you to access records stored in dBase-format
-(dbf) databases.
+(dbf) databases.  In order to use these functions, you must compile
+PHP with the --enable-dbase option.


 There is no support for indexes or memo fields. There is no





[PHP-DOC] cvs: phpdoc /de/language variables.xml

2002-01-19 Thread Friedhelm Betz

betzSat Jan 19 18:11:31 2002 EDT

  Modified files:  
/phpdoc/de/language variables.xml 
  Log:
  finished update of variables.xml
  

Index: phpdoc/de/language/variables.xml
diff -u phpdoc/de/language/variables.xml:1.15 phpdoc/de/language/variables.xml:1.16
--- phpdoc/de/language/variables.xml:1.15   Wed Dec 12 15:46:23 2001
+++ phpdoc/de/language/variables.xmlSat Jan 19 18:11:26 2002
@@ -1,8 +1,6 @@
 
  
   Variablen
-
 
   
Grundlegendes
@@ -13,7 +11,7 @@

 

-Variablen-Namen werden in PHP nach den gleichen Regeln wie die
+Variablen-Namen werden in PHP nach den gleichen Regeln wie
 andere Bezeichner erstellt. Ein gültiger Variablen-Name beginnt
 mit einem Buchstaben oder einem Unterstrich ("_"), gefolgt von
 einer beliebigen Anzahl von Buchstaben, Zahlen oder Unterstrichen.
@@ -45,18 +43,18 @@

 

-Variablen werden in PHP3 durch ihren Wert bestimmt. Das heisst,
+Variablen werden in PHP 3 durch ihren Wert bestimmt. Das heisst,
 wenn sie einer Variablen einen Ausdruck zuweisen, wird der gesamte
 Inhalt des Originalausdrucks in die Zielvariable kopiert. Die
 Folge ist, dass eine Variable, die ihren Inhalt von einer anderen
 Variablen erhalten hat, ihren Inhalt behält, auch wenn sie danach
-den  Inhalt der anderen (Quell- / Ursprungs-)Variablen ändern. Die
+den Inhalt der anderen (Quell- / Ursprungs-)Variablen ändern. Die
 Inhalte der Ziel- und Quellvariablen sind also insoweit unabhängig
 voneinander. Für weitere Informationen lesen sie bitte Expressions / Ausdrücke.


-PHP4 bietet eine andere Möglichkeit der Wertzuweisung bei
+PHP 4 bietet eine andere Möglichkeit der Wertzuweisung bei
 Variablen: Zuweisung durch Referenzierung.
 Das bedeutet, dass der Wert der neuen Variablen eine Referenz zur
 Ursprungs-Variablen darstellt (mit anderen Worten: Der Wert ist
@@ -64,24 +62,26 @@
 Variablen zeigen also auf die selbe(n) Speicherstelle(n).
 Änderungen der neuen Variablen ändern auch deren Ursprungs-
 Variable und umgekehrt. Der Wert / Inhalt wird also nicht kopiert. Die
-Übertragung geschieht dadurch auch schneller als in PHP3. Dies wird
+Übertragung geschieht dadurch auch schneller als in PHP 3. Dies wird
 sich aber nur bei umfangreichen Schleifen oder bei der Übertragung
 von grossen Arrays oder Objekten bemerkbar machen.


-Für die Zuweisung per Referenz müssen sie lediglich ein "&" plus
-"amp;" (&) der (Ausgangs-, Quell-) Variablen voranstellen, die
+Für die Zuweisung per Referenz müssen sie lediglich ein &
+der (Ausgangs-, Quell-) Variablen voranstellen, die
 sie einer anderen Variablen zuweisen wollen. Der folgende Skript-
 Ausschnitt wird zweimal 'Mein Name ist Bob' ausgeben:
 
  
-

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

2002-01-19 Thread Friedhelm Betz

betzSat Jan 19 18:04:13 2002 EDT

  Modified files:  
/phpdoc/en/language variables.xml 
  Log:
  added $_FILES and $_SESSION to list of Superglobals. scope additon for $_files
  
Index: phpdoc/en/language/variables.xml
diff -u phpdoc/en/language/variables.xml:1.31 phpdoc/en/language/variables.xml:1.32
--- phpdoc/en/language/variables.xml:1.31   Fri Jan 18 16:50:44 2002
+++ phpdoc/en/language/variables.xmlSat Jan 19 18:04:13 2002
@@ -1,5 +1,5 @@
 
-
+
  
   Variables
   
@@ -461,7 +461,8 @@
   Announcement for more details. These are the
   $_GET, $_POST,
   $_ENV, $_SERVER,
-  $_COOKIE, and $_REQUEST
+  $_COOKIE, $_REQUEST
+  $_FILES, and $_SESSION
   arrays, and they are informally known as
   Superglobals since they are always
   available without regard to scope. These deprecate the older
@@ -598,7 +599,8 @@
  about files uploaded via the HTTP POST method. See POST method
  uploads for information on the contents of
- $_FILES.  Introduced in PHP 4.1.0.
+ $_FILES. Automatically global in any scope.
+ Introduced in PHP 4.1.0.
 

   





[PHP-DOC] cvs: phpdoc /en/functions cybermut.xml

2002-01-19 Thread Kenneth Schwartz

irc-htmlSat Jan 19 17:56:44 2002 EDT

  Modified files:  
/phpdoc/en/functionscybermut.xml 
  Log:
  incorrect function naming in examples (incorporate user notes)
  
Index: phpdoc/en/functions/cybermut.xml
diff -u phpdoc/en/functions/cybermut.xml:1.14 phpdoc/en/functions/cybermut.xml:1.15
--- phpdoc/en/functions/cybermut.xml:1.14   Wed Jan  9 19:51:21 2002
+++ phpdoc/en/functions/cybermut.xmlSat Jan 19 17:56:44 2002
@@ -1,5 +1,5 @@
 
-
+
  
   Crédit Mutuel CyberMUT functions
   CyberMUT
@@ -81,7 +81,7 @@
 // Version number
 $VERSION="1.2";
 
-  $retour =  creditmut_creerformulairecm(
+  $retour =  cybermut_creerformulairecm(
   "https://www.creditmutuel.fr/test/telepaiement/paiement.cgi";,
   $VERSION,
   "1234567890",
@@ -161,7 +161,7 @@
 $texte_libre = $HTTP_GET_VARS["texte-libre"];
 $code_retour = $HTTP_GET_VARS["code-retour"]; 
 
-$mac_ok = 
creditmut_testmac($MAC,$VERSION,$TPE,$date,$montant,$reference,$texte_libre,$code_retour);
+$mac_ok = 
+cybermut_testmac($MAC,$VERSION,$TPE,$date,$montant,$reference,$texte_libre,$code_retour);
 
 if ($mac_ok) {
 
@@ -170,9 +170,9 @@
   //
   //
 
-  $result=creditmut_creerreponsecm("OK");
+  $result=cybermut_creerreponsecm("OK");
 } else {
-  $result=creditmut_creerreponsecm("Document Falsifie");
+  $result=cybermut_creerreponsecm("Document Falsifie");
 }
  
 ?>





[PHP-DOC] cvs: phpdoc /en/functions cybercash.xml

2002-01-19 Thread Kenneth Schwartz

irc-htmlSat Jan 19 17:52:03 2002 EDT

  Modified files:  
/phpdoc/en/functionscybercash.xml 
  Log:
  cap error
  
Index: phpdoc/en/functions/cybercash.xml
diff -u phpdoc/en/functions/cybercash.xml:1.11 phpdoc/en/functions/cybercash.xml:1.12
--- phpdoc/en/functions/cybercash.xml:1.11  Sat Jan 19 17:48:50 2002
+++ phpdoc/en/functions/cybercash.xml   Sat Jan 19 17:52:03 2002
@@ -1,5 +1,5 @@
 
-
+
  
   Cybercash payment functions
   Cybercash
@@ -82,7 +82,7 @@
   

 cybercash_base64_decode
-base64 decode data for cybercash
+base64 decode data for Cybercash


 Description





[PHP-DOC] cvs: phpdoc /en/functions cybercash.xml

2002-01-19 Thread Kenneth Schwartz

irc-htmlSat Jan 19 17:48:50 2002 EDT

  Modified files:  
/phpdoc/en/functionscybercash.xml 
  Log:
  refpurpose updates
  
Index: phpdoc/en/functions/cybercash.xml
diff -u phpdoc/en/functions/cybercash.xml:1.10 phpdoc/en/functions/cybercash.xml:1.11
--- phpdoc/en/functions/cybercash.xml:1.10  Wed Dec 12 15:46:40 2001
+++ phpdoc/en/functions/cybercash.xml   Sat Jan 19 17:48:50 2002
@@ -1,5 +1,5 @@
 
-
+
  
   Cybercash payment functions
   Cybercash
@@ -16,7 +16,7 @@
   

 cybercash_encr
-???
+Cybercash encrypt


 Description
@@ -39,7 +39,7 @@
   

 cybercash_decr
-???
+Cybercash decrypt


 Description
@@ -62,7 +62,7 @@
   

 cybercash_base64_encode
-???
+base64 encode data for Cybercash


 Description
@@ -82,7 +82,7 @@
   

 cybercash_base64_decode
-
+base64 decode data for cybercash


 Description





[PHP-DOC] cvs: phpdoc /he/language basic-syntax.xml

2002-01-19 Thread shlomi loubaton

shlomi  Sat Jan 19 17:33:47 2002 EDT

  Modified files:  
/phpdoc/he/language basic-syntax.xml 
  Log:
  fixed encoding
  
Index: phpdoc/he/language/basic-syntax.xml
diff -u phpdoc/he/language/basic-syntax.xml:1.1 phpdoc/he/language/basic-syntax.xml:1.2
--- phpdoc/he/language/basic-syntax.xml:1.1 Sat Jan 19 01:14:10 2002
+++ phpdoc/he/language/basic-syntax.xml Sat Jan 19 17:33:47 2002
@@ -1,5 +1,5 @@
-
-
+
+
  
   úçáéø áñéñé
 





[PHP-DOC] cvs: phpdoc /he/chapters intro.xml

2002-01-19 Thread shlomi loubaton

shlomi  Sat Jan 19 17:33:14 2002 EDT

  Modified files:  
/phpdoc/he/chapters intro.xml 
  Log:
  fixed encoding
  
Index: phpdoc/he/chapters/intro.xml
diff -u phpdoc/he/chapters/intro.xml:1.1 phpdoc/he/chapters/intro.xml:1.2
--- phpdoc/he/chapters/intro.xml:1.1Wed Jan 16 19:28:28 2002
+++ phpdoc/he/chapters/intro.xmlSat Jan 19 17:33:13 2002
@@ -1,5 +1,5 @@
-
-
+
+
  
   ä÷ãîä
 





[PHP-DOC] cvs: phpdoc /he bookinfo.xml preface.xml

2002-01-19 Thread shlomi loubaton

shlomi  Sat Jan 19 17:31:22 2002 EDT

  Modified files:  
/phpdoc/he  bookinfo.xml preface.xml 
  Log:
  fixed encoding
  
Index: phpdoc/he/bookinfo.xml
diff -u phpdoc/he/bookinfo.xml:1.1 phpdoc/he/bookinfo.xml:1.2
--- phpdoc/he/bookinfo.xml:1.1  Thu Jan 17 18:11:22 2002
+++ phpdoc/he/bookinfo.xml  Sat Jan 19 17:31:22 2002
@@ -1,5 +1,5 @@
-
-
+
+
 
  
   
Index: phpdoc/he/preface.xml
diff -u phpdoc/he/preface.xml:1.1 phpdoc/he/preface.xml:1.2
--- phpdoc/he/preface.xml:1.1   Tue Jan 15 19:28:48 2002
+++ phpdoc/he/preface.xml   Sat Jan 19 17:31:22 2002
@@ -1,5 +1,5 @@
-
-
+
+
 
  
   ä÷ãîä





[PHP-DOC] cvs: phpdoc /en/functions cpdf.xml

2002-01-19 Thread Kenneth Schwartz

irc-htmlSat Jan 19 17:30:46 2002 EDT

  Modified files:  
/phpdoc/en/functionscpdf.xml 
  Log:
  fixed error in example: added unit parameter to cpdf_page_init call
  
Index: phpdoc/en/functions/cpdf.xml
diff -u phpdoc/en/functions/cpdf.xml:1.37 phpdoc/en/functions/cpdf.xml:1.38
--- phpdoc/en/functions/cpdf.xml:1.37   Mon Jan 14 10:47:59 2002
+++ phpdoc/en/functions/cpdf.xmlSat Jan 19 17:30:45 2002
@@ -1,5 +1,5 @@
 
-
+
  
   ClibPDF functions
   ClibPDF
@@ -66,7 +66,7 @@
 

[PHP-DOC] cvs: phpdoc /he Translators

2002-01-19 Thread shlomi loubaton

shlomi  Sat Jan 19 17:27:15 2002 EDT

  Modified files:  
/phpdoc/he  Translators 
  Log:
  updated files status
  
Index: phpdoc/he/Translators
diff -u phpdoc/he/Translators:1.4 phpdoc/he/Translators:1.5
--- phpdoc/he/Translators:1.4   Sat Jan 19 01:18:22 2002
+++ phpdoc/he/Translators   Sat Jan 19 17:27:15 2002
@@ -27,11 +27,11 @@
 variables.xml
 - features: ---
 connection-handling.xml
-cookies.xml
+cookies.xmlraful   started
 error-handling.xml
-file-upload.xml
+file-upload.xmlraful   started
 http-auth.xml
-images.xml
+images.xml raful   started
 persistent-connections.xml
 remote-files.xml
 safe-mode.xml





[PHP-DOC] Re: Misleading session_register() documentation

2002-01-19 Thread Jesse McCarthy


Yasuo Ohgaki <[EMAIL PROTECTED]> wrote on 1/19/02 1:02:14 AM:

>> I've updated doc days ago. Howver, build system is not working(?)
>> Therefore, doc is wrong still :)
>> 
>> I'll update Variable section later.
>> 
>
>Someone already fixed variable section :)
>

Yes, that's good, hopefully the session_register() documentation will be 
fixed soon.  I'd just like to say, for the benefit of any interested parties, 
that all-in-all I have found the online PHP documentation to be excellent, an 
invaluable resource that is greatly appreciated, as is PHP itself. 

-- Jesse McCarthy




[PHP-DOC] cvs: phpdoc /en/functions array.xml

2002-01-19 Thread Kenneth Schwartz

irc-htmlSat Jan 19 17:02:17 2002 EDT

  Modified files:  
/phpdoc/en/functionsarray.xml 
  Log:
  ksort: incorporate user notes.. see also krsort, uksort
  
Index: phpdoc/en/functions/array.xml
diff -u phpdoc/en/functions/array.xml:1.152 phpdoc/en/functions/array.xml:1.153
--- phpdoc/en/functions/array.xml:1.152 Fri Jan 11 08:18:50 2002
+++ phpdoc/en/functions/array.xml   Sat Jan 19 17:02:15 2002
@@ -1,5 +1,5 @@
 
-
+
  
   Array Functions
   Arrays
@@ -3143,6 +3143,7 @@
 
 
  See also asort, arsort,
+ krsort, uksort,
  sort, natsort, and
  rsort.
 





Re: [PHP-DOC] Re: quick notes stat

2002-01-19 Thread Gabor Hojtsy

> > I have a local copy of user notes for some time now to test
> > the new CHM manual with user notes inclusion. It is not up
> > to date, but the small stats I made may help people examine,
> > what is the big picture about user notes:
> > 
> > Files with notes  : 941
> > Files without notes   : 1803
> > Total number of notes : 5944
> 
> just for reference, there were 4836 total notes just a month ago, the
> last time i went through a serious sweep to clean things up.
> 
> (when goba said the majority of the notes are useful, i'd have to
> strenuously disagree. the amount of incorrect and irrelevant information
> in the notes frightens me, but cleaning things up and finding the gems
> in the rough is grueling work.)

I have an old download of the notes, from the last year :)
It would be nice to think about some cool solution for
user note downloads for the CHM compiles. I used hu.php.net
(I have FTP access there), to get the user notes dump.
But as they are not in CVS, one needs to have FTP access to
a mirror, or rsync on his computer to get the notes. This
is not that ideal, considering, that the CHM compiler works
only on Windows, so the process is the most convinient there.

I rarely use user notes, so what I said about their usefullness
was based on CHM users input. You can read the user survey
we made here: http://www.weblabor.hu/php/newchm.php
There are many more comments, and advices for improvements
in the manual.

Goba





[PHP-DOC] cvs: phpdoc /de Translators

2002-01-19 Thread Friedhelm Betz

betzSat Jan 19 15:44:11 2002 EDT

  Modified files:  
/phpdoc/de  Translators 
  Log:
  will update variables.xml
  
Index: phpdoc/de/Translators
diff -u phpdoc/de/Translators:1.247 phpdoc/de/Translators:1.248
--- phpdoc/de/Translators:1.247 Fri Jan 18 18:28:04 2002
+++ phpdoc/de/Translators   Sat Jan 19 15:44:11 2002
@@ -205,7 +205,7 @@
 operators.xml   Sven Lauer  fertig
 references.xml  Sebastian Bergmann  fertig
 types.xml   Friedhelm Betz  fertig (bis 1.70)
-variables.xml   Thomas Schuermann   fertig
+variables.xml   Friedhelm Betz  Änderungen
 -
 preface.xml Egon Schmid fertig  
 





[PHP-DOC] cvs: phpdoc /pl/functions filesystem.xml

2002-01-19 Thread Slawomir Pucia

slawek  Sat Jan 19 14:38:00 2002 EDT

  Modified files:  
/phpdoc/pl/functionsfilesystem.xml 
  Log:
  Added &return.success; where needed.
  
  
Index: phpdoc/pl/functions/filesystem.xml
diff -u phpdoc/pl/functions/filesystem.xml:1.7 phpdoc/pl/functions/filesystem.xml:1.8
--- phpdoc/pl/functions/filesystem.xml:1.7  Thu Dec 20 09:35:48 2001
+++ phpdoc/pl/functions/filesystem.xml  Sat Jan 19 14:38:00 2002
@@ -1,6 +1,6 @@
 
 
-
+
  
   Funkcje systemu plików
   System plików
@@ -424,8 +424,8 @@
  Wska¼nik pliku fp jest zamykany.
 
 
- Zwraca &true; gdy sukces i &false; gdy niepowodzenie.
-   
+ &return.success;
+
 
  Wska¼nik pliku musi byæ poprawny i musi wskazywaæ na plik
  poprawnie otwarty przez fopen lub
@@ -1671,7 +1671,9 @@
 
 
  Pobiera wska¼nik pliku, fp, i przycina plik do d³ugo¶ci, rozmiar.
- Funkcja zwraca &true; gdy sukces i &false; gdy niepowodzenie.
+
+
+ &return.success;
 

   





[PHP-DOC] cvs: phpdoc /pl/language functions.xml

2002-01-19 Thread Slawomir Pucia

slawek  Sat Jan 19 14:36:26 2002 EDT

  Modified files:  
/phpdoc/pl/language functions.xml 
  Log:
  Removed garbage.
  
  
Index: phpdoc/pl/language/functions.xml
diff -u phpdoc/pl/language/functions.xml:1.6 phpdoc/pl/language/functions.xml:1.7
--- phpdoc/pl/language/functions.xml:1.6Thu Dec 20 07:52:15 2001
+++ phpdoc/pl/language/functions.xmlSat Jan 19 14:36:25 2002
@@ -1,6 +1,6 @@
 
 
-
+
  
   Funkcje
 
@@ -8,8 +8,7 @@
Funkcje zdefiniowane przez u¿ytkownika
  

-Funkcja mo¿e byæ zdefiniowana u¿ywaj±c sk³adni takiej jak poni¿sza
-A function may be defined using syntax such as the following:
+Funkcja mo¿e byæ zdefiniowana u¿ywaj±c sk³adni takiej jak poni¿sza:
  
 
  





[PHP-DOC] cvs: phpdoc /pl/functions mysql.xml

2002-01-19 Thread Slawomir Pucia

slawek  Sat Jan 19 14:24:28 2002 EDT

  Modified files:  
/phpdoc/pl/functionsmysql.xml 
  Log:
  Fixed unfinished sentence, removed tabs.
  
  
Index: phpdoc/pl/functions/mysql.xml
diff -u phpdoc/pl/functions/mysql.xml:1.16 phpdoc/pl/functions/mysql.xml:1.17
--- phpdoc/pl/functions/mysql.xml:1.16  Sat Jan 12 14:34:32 2002
+++ phpdoc/pl/functions/mysql.xml   Sat Jan 19 14:24:28 2002
@@ -1,6 +1,6 @@
 
-
-
+
+
  
   Funkcje MySQL
   MySQL
@@ -398,8 +398,8 @@
  identyfikatorem po³±czenia.
 
 
-&return.success; 
-   
+ &return.success; 
+
 
  tworzenie bazy MySQL
  
@@ -618,10 +618,10 @@
  mysql_drop_db usuwa ca³± bazê z serwera
  skojarzonego z podanym identyfikatorem po³±czenia.
 
-   
+
  Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿
  mysql_dropdb. Jest to jednak niezalecane.
-   
+
  
  Patrz tak¿e: mysql_create_db.
 
@@ -796,8 +796,8 @@
  kolumna bêdzie brana pod uwagê. Dostêp do innych kolumn o tej
  samej nazwie jest mo¿liwy jedynie przez indeksowanie numeryczne
  lub przez stworzenie aliasa. Po stworzeniu aliasa nie mo¿na
-ju¿ odwo³ywaæ siê do danej kolumny u¿ywaj±c jej prawdziwej nazwy
-(w tym przyk³adzie u¿ywaj±c 'pole').
+ ju¿ odwo³ywaæ siê do danej kolumny u¿ywaj±c jej prawdziwej nazwy
+ (w tym przyk³adzie u¿ywaj±c 'pole').
  
   
 

[PHP-DOC] Re: quick notes stat

2002-01-19 Thread Jim Winstead

Gabor Hojtsy <[EMAIL PROTECTED]> wrote:
> I have a local copy of user notes for some time now to test
> the new CHM manual with user notes inclusion. It is not up
> to date, but the small stats I made may help people examine,
> what is the big picture about user notes:
> 
> Files with notes  : 941
> Files without notes   : 1803
> Total number of notes : 5944

just for reference, there were 4836 total notes just a month ago, the
last time i went through a serious sweep to clean things up.

(when goba said the majority of the notes are useful, i'd have to
strenuously disagree. the amount of incorrect and irrelevant information
in the notes frightens me, but cleaning things up and finding the gems
in the rough is grueling work.)

and last time i checked, the top ten pages (by number of notes)
accounted for more than 10% of the notes.

jim



[PHP-DOC] Bug #15116: Rendering/naming Problem

2002-01-19 Thread holliwell

From: [EMAIL PROTECTED]
Operating system: n/a
PHP version:  4.1.1
PHP Bug Type: Documentation problem
Bug description:  Rendering/naming Problem


Some links are not correctly rendered/displayed in the funktion
reference:
Image functions and Oracle8 functions.
The reason: funtion names inside  are uppercase.

See below:
Image functions
For example: xml source of function imagearc
See also ImageEllipse,
ImageFilledEllipse, and
ImageFilledArc.

Oracle8 functions
For example: xml source of function OCIDefineByName

If you need to define an abstract Datatype(LOB/ROWID/BFILE) you
need to allocate it first using
OCINewDescriptor function. See also the
OCIBindByName function.


Online to see at:
http://www.php.net/manual/en/function.ocidefinebyname.php

In reply to my mail to PHO-DOC list the answer from Jim Winstead:

>as near as i can tell, the stylesheets should be trying >to do a
case-insensitive comparison to avoid this issue. >if that isn't working,
it's a bug in the html-common.dsl >stylesheet.
>
> jim

Is this a bug in the stylesheets or should all function names inside
 be lowercase?

Friedhelm Betz
-- 
Edit bug report at: http://bugs.php.net/?id=15116&edit=1




Re: [PHP-DOC] Directory proposal

2002-01-19 Thread Gabor Hojtsy

> > Friedhelm Betz <[EMAIL PROTECTED]> wrote:
> >> so everyone can contribute and has the chance to take a look at.
> >> Discussions could be summarized in drafts (if someone has the time)
> >> and it would be easier to get the (current) state of discussions.
> 
> > +2, great idea.
> 
> Was not my idea; "stolen" from Goba ;-)
> I asked him by pm to move coding standars draft from
> http://www.holliwell.de/draft/draft1 to cvs and the and the answer
> from Goba:
> > Can you have a look at the php4 source tree. AFAIK there
> > should be an RFC dir somewhere :) It would be better to
> > add an RFC dir to phpdoc, and then we can add discussion
> > docs there (like the facts about licenses, and things we
> > already digged up about them).

There is no RFC dir in PHP4 though. Don't know from where
I remembered this solution. Somewhere from the PHP projects...

Goba





Re: [PHP-DOC] Directory proposal

2002-01-19 Thread Friedhelm Betz


Hi

> Friedhelm Betz <[EMAIL PROTECTED]> wrote:
>> so everyone can contribute and has the chance to take a look at.
>> Discussions could be summarized in drafts (if someone has the time)
>> and it would be easier to get the (current) state of discussions.

> +2, great idea.

Was not my idea; "stolen" from Goba ;-)
I asked him by pm to move coding standars draft from
http://www.holliwell.de/draft/draft1 to cvs and the and the answer
from Goba:
> Can you have a look at the php4 source tree. AFAIK there
> should be an RFC dir somewhere :) It would be better to
> add an RFC dir to phpdoc, and then we can add discussion
> docs there (like the facts about licenses, and things we
> already digged up about them).

Its not me to win luarels :-)

 Friedhelm   




[PHP-DOC] cvs: phpdoc /it/functions calendar.xml

2002-01-19 Thread Marco Cucinato

cucinatoSat Jan 19 10:46:48 2002 EDT

  Modified files:  
/phpdoc/it/functionscalendar.xml 
  Log:
  Type fixes
  
  
Index: phpdoc/it/functions/calendar.xml
diff -u phpdoc/it/functions/calendar.xml:1.9 phpdoc/it/functions/calendar.xml:1.10
--- phpdoc/it/functions/calendar.xml:1.9Thu Dec 20 17:54:07 2001
+++ phpdoc/it/functions/calendar.xmlSat Jan 19 10:46:44 2002
@@ -7,20 +7,20 @@
   

 Le funzioni di calendario sono disponibili solo se è stata compilata
-l'estensione calendar, che si trova  nelle cartelle "dl" o "ext"
+l'estensione calendar, che si trova nelle cartelle "dl" o "ext"
 dei sorgenti PHP.
 Leggere il file README prima di usarla.


 L'estensione calendar presenta una serie di funzioni che semplificano 
 la conversione tra differenti formati di calendario.  Il formato intermedio
-o standard è basato sul Conteggio Quotidiano Giuliano.  Il Conteggio
+o standard è basato sul Conteggio del Giorno Giuliano.  Il Conteggio
 Giuliano è un conteggio di giorni che parte molto prima di qualsiasi data
 la maggior parte della gente potrebbe usare (circa il 4000 a.C.).  Per
 convertire tra i sistemi di calendario, si deve prima convertire nel sistema
-Giuliano, poi nel sistema di calendario scelto.  Il Conteggio Quotidiano
+del Giorno Giuliano, poi nel sistema di calendario scelto.  Il Conteggio del 
+Giorno
 Giuliano è molto diverso dal Calendario Giulano! Per maggiori
-informazioni sui sistemi di calendario guardare &url.calendar;.  Parti di questa
 pagina sono inclusi in queste istruzioni, citate tra virgolette.

@@ -29,7 +29,7 @@
   

 JDToGregorian
-Converte il Conteggio Giuliano in data Gregoriana
+Converte il Giorno Giuliano in data Gregoriana


 Descrizione
@@ -50,7 +50,7 @@

 GregorianToJD 
 
- Converte ua data Gregoriana in un Giorno Giuliano
+ Converte una data Gregoriana in un Giorno Giuliano
 


@@ -246,7 +246,7 @@
   

 JDMonthName
-Resituisce il nome di un mese
+Restituisce il nome di un mese


 Descrizione
@@ -490,7 +490,7 @@
   

 unixtojd
-Converte un timestamp UNIX in una Giorno Giuliano
+Converte un timestamp UNIX in un Giorno Giuliano


 Descrizione





[PHP-DOC] cvs: phpdoc /ja/functions dl.xml

2002-01-19 Thread Rui Hirokawa

hirokawaSat Jan 19 09:59:25 2002 EDT

  Removed files:   
/phpdoc/ja/functionsdl.xml 
  Log:
  delete dl.xml.
  





Re: [PHP-DOC] Directory proposal

2002-01-19 Thread Jan Lehnardt

Hi,
On Sat, 19 Jan 2002 14:41:41 +0100
Friedhelm Betz <[EMAIL PROTECTED]> wrote:
> so everyone can contribute and has the chance to take a look at.
> Discussions could be summarized in drafts (if someone has the time)
> and it would be easier to get the (current) state of discussions.

+2, great idea.

Jan
-- 
Q: Thank Jan? A: http://geschenke.an.dasmoped.net/



Re: [PHP-DOC] cvs: phpdoc /he/language basic-syntax.xml

2002-01-19 Thread Shlomi Loubaton

> > 
>
> Please change the XML encoding in all files to your encoding,
> as XML tools do not like to be fooled :)
>
> Goba

oh, ok.. forgot about that... I'll fix it soon.
BTW: my XML tools didn't care much about it.. I guess... so I was able to
create the hebrew HTML pages.

Shlomi.






Re: [PHP-DOC] Directory proposal

2002-01-19 Thread Gabor Hojtsy

> imho it could be helpful to have an RFC-like directory on phpdoc.
> Why? We can add discussion docs there mentioned in TODO:
> DISCUSSIONS:
>   - coding standars for scripts in phpdoc (see the howto
> and http://www.holliwell.de/draft/draft1 for now)
>   - licensing issues, possible licenses
>   - users manual / developers manual division?
> effects on folders, files, make system, style sheets
> 
> so everyone can contribute and has the chance to take a look at.
> Discussions could be summarized in drafts (if someone has the time)
> and it would be easier to get the (current) state of discussions.

Nice, we can start out with the coding standards draft ;)

Goba





[PHP-DOC] Directory proposal

2002-01-19 Thread Friedhelm Betz


Hi,
imho it could be helpful to have an RFC-like directory on phpdoc.
Why? We can add discussion docs there mentioned in TODO:
DISCUSSIONS:
  - coding standars for scripts in phpdoc (see the howto
and http://www.holliwell.de/draft/draft1 for now)
  - licensing issues, possible licenses
  - users manual / developers manual division?
effects on folders, files, make system, style sheets

so everyone can contribute and has the chance to take a look at.
Discussions could be summarized in drafts (if someone has the time)
and it would be easier to get the (current) state of discussions.

 Friedhelm




[PHP-DOC] cvs: phpdoc /en/language control-structures.xml

2002-01-19 Thread Kenneth Schwartz

irc-htmlSat Jan 19 07:01:12 2002 EDT

  Modified files:  
/phpdoc/en/language control-structures.xml 
  Log:
  added CDATA tag for example
  
Index: phpdoc/en/language/control-structures.xml
diff -u phpdoc/en/language/control-structures.xml:1.51 
phpdoc/en/language/control-structures.xml:1.52
--- phpdoc/en/language/control-structures.xml:1.51  Sat Jan 19 05:37:31 2002
+++ phpdoc/en/language/control-structures.xml   Sat Jan 19 07:01:10 2002
@@ -1,5 +1,5 @@
 
-
+
  
   Control Structures
 
@@ -297,7 +297,7 @@
 checked at the end of each iteration instead of in the beginning.
 The main difference from regular while loops is
 that the first iteration of a do..while loop is
-guarenteed to run (the truth expression is only checked at the end
+guaranteed to run (the truth expression is only checked at the end
 of the iteration), whereas it's may not necessarily run with a
 regular while loop (the truth expression is
 checked at the beginning of each iteration, if it evaluates to
@@ -876,7 +876,7 @@

 The declare construct is used to
 set execution directives for a block of code.
-The syntax of declare is similiar to
+The syntax of declare is similar to
 the syntax of other flow control constructs:
 
  
@@ -1049,6 +1049,7 @@
 
  Basic require examples
  
+
  







[PHP-DOC] quick notes stat

2002-01-19 Thread Gabor Hojtsy

Hi!

I have a local copy of user notes for some time now to test
the new CHM manual with user notes inclusion. It is not up
to date, but the small stats I made may help people examine,
what is the big picture about user notes:

Files with notes  : 941
Files without notes   : 1803
Total number of notes : 5944

Goba





[PHP-DOC] cvs: phpdoc /en/language control-structures.xml

2002-01-19 Thread Philip Olson

philip  Sat Jan 19 05:37:31 2002 EDT

  Modified files:  
/phpdoc/en/language control-structures.xml 
  Log:
  include/require: Update reflects change in behavoir as of 4.0.2.
   PHP3 info condensed into a 
 Duplicate info removed, most docs are within include()
  *_once : Updated.
  
  

Index: phpdoc/en/language/control-structures.xml
diff -u phpdoc/en/language/control-structures.xml:1.50 
phpdoc/en/language/control-structures.xml:1.51
--- phpdoc/en/language/control-structures.xml:1.50  Sat Jan 19 02:09:31 2002
+++ phpdoc/en/language/control-structures.xml   Sat Jan 19 05:37:31 2002
@@ -1,5 +1,5 @@
 
-
+
  
   Control Structures
 
@@ -34,7 +34,7 @@
 As described in the section about
 expressions, expr is evaluated to its
 Boolean value.  If expr evaluates to &true;,
-PHP will execute statement, and if it evaluates
+   PHP will execute statement, and if it evaluates
 to &false; - it'll ignore it. More information about what values evaluate
 to &false; can be found in the 'Converting to boolean'
@@ -1020,499 +1020,340 @@

   
 
-  
+
+ 
require
+

-The require statement replaces itself with
-the specified file, much like the C preprocessor's
-#include works.
+The require statement includes and evaluates
+the specific file.


-If "URL fopen wrappers" are enabled in PHP (which they are in the
-default configuration), you can specify the file to be
-requireed using an URL instead of a local
-pathname. See Remote
-files and fopen for more information.
+ require includes and evaluates a specific file.  
+ Detailed information on how this inclusion works is described in the 
+ documentation for include.
+   
+   
+ require and include 
+ are identical in every way except how they handle failure.  
+ include produces a 
+ Warning while 
+ require results in a 
+ Fatal Error.  In other words, don't hesitate to use 
+ require if you want a missing file to halt processing 
+ of the page.  include does not behave this way, the
+ script will continue regardless.  Be sure to have an appropriate
+ include_path setting as well.

+   
+
+ Basic require examples
+ 
+
+ 
+   
+   

-An important note about how this works is that when a file is
-includeed or requireed,
-parsing drops out of PHP mode and into HTML mode at the beginning
-of the target file, and resumes PHP mode again at the end. For
-this reason, any code inside the target file which should be
-executed as PHP code must be enclosed within valid PHP start and end
-tags.
+See the include documentation for more examples.

+   
+
+ Prior to PHP 4.0.2, the following applies: require will 
+ always attempt to read the target file, even if the line it's on never executes.
+ The conditional statement won't affect require. However, 
+ if the line on which the require occurs is not executed, 
+ neither will any of the code in the target file be executed.  Similarly, looping 
+ structures do not affect the behaviour of require. Although 
+ the code contained in the target file is still subject to the loop, the 
+ require itself happens only once.
+
+   

-require is not actually a function in PHP;
-rather, it is a language construct. It is subject to some
-different rules than functions are. For instance,
-require is not subject to any containing
-control structures. For another, it does not return any value;
-attempting to read a return value from a
-require call results in a parse error.
+See also include, require_once,
+include_once, eval, 
+file, readfile, 
+virtual and include_path.

+  
+
+ 
+   include

-Unlike include, require
-will always read in the target file,
-even if the line it's on never executes. If
-you want to conditionally include a file, use
-include. The conditional statement won't
-affect the require. However, if the line on
-which the require occurs is not executed,
-neither will any of the code in the target file be executed.
+The include statement includes and evaluates
+the specified file.


-Similarly, looping structures do not affect the behaviour of
-require. Although the code contained in the
-target file is still subject to the loop, the
-require itself happens only once.
+ The documentation below also applies to require.
+ The two constructs are identical in every way except how they handle
+ failure.  include produces a 
+ Warning while 
+require
+ results in a Fatal Error.
+ In other words, don't hesitate to use require if you want 
+ a missing file to halt processing of the page.  include 
+does 
+ not behave this way, the script will continue regardless.  Be sure to have an 
+ appro

[PHP-DOC] new include/require docs

2002-01-19 Thread Philip Olson

Am about to submit docs for include/require and _once counterparts.  The
main changes are within include().  

As of 4.0.2, include() and require() are identical except for the type of
error they provide with include giving us an E_WARNING and require
providing an E_ERROR (Fatal).  This of course is upon failure.

The docs have been updated to reflect this.  include() now contains the
bulk of the documentation, require() has less and points to it.  The PHP3
specific stuff has been condensed into a .  And most of the examples
are new.

Am about to submit, please don't hesitate to review these docs.  I've gone
over it quite a few times, my eye balls are ready to stop.  Am off to bed.
hope I didn't forget anything! :)

Regards,
Philip Olson

p.s. Some examples do not take into account E_NOTICE (undefined variables)
but this was sorta the point (you'll see), does this seem like a problem?
Hmm, maybe so :)







Re: [PHP-DOC] cvs: phpdoc /he/language basic-syntax.xml

2002-01-19 Thread Gabor Hojtsy

> 

Please change the XML encoding in all files to your encoding,
as XML tools do not like to be fooled :)

Goba