[PHP-DOC] #21970 [Asn]: Creating a new Tutorial section

2005-09-08 Thread aidan
 ID:   21970
 Updated by:   [EMAIL PROTECTED]
 Reported By:  philip at cornado dot com
 Status:   Assigned
 Bug Type: Documentation problem
 Operating System: all
 PHP Version:  Irrelevant
 Assigned To:  aidan
 New Comment:

Summarising the feedback,

* I think we've agreed "techniques" is the way to go in terms of naming
the new section.

* I think getting-started will stay where it is.

* The new techniques section will be placed after the  security
section.

* All the material in the features section will be incorporated into
the techniques section.

And the following new sections will be created,

- techniques.include-path
See philip's original post.
Also, I notice a lot of questions regarding include_paths in included
files, where the include path is relative to, getcwd, etc. This would
make a nice addition to the include-path section.

- techniques.patterns
PHP 4 / 5 singleton + factory patterns

- techniques.magic-quotes
Info moved and aggregated from the security / faq

- techniques.register-globals
Info moved and aggregated from the security / faq

- techniques.command-line
All the information about running PHP from the CLI

?- techniques.databasing
general good database practices (also moved from security section)


So far I think everyone has agreed on these. The ones we're not too
sure about being the tutorial-type sections. Perhaps these could be
placed in a subsection of techniques called "design".


- techniques.design.black-box
Detailing the foo.php?page=contact design


Previous Comments:


[2005-01-25 07:44:08] [EMAIL PROTECTED]

Somewhere down the line this bug report got renamed so be sure it's not
closed until include_path is properly (extensively) documented.

Not everything belongs in a tutorial...I agree with Goba on all points.



[2005-01-24 16:44:24] [EMAIL PROTECTED]

I agree with both Anatoly & Goba, here.
- Getting started needs to be easily found by new developers.
- And ~"Techniques" is a good name for the section we envisioned as
"Tutorials" they're programming (usually php-specific or web-specific)
techniques.
- Perhaps a note should be dropped into the intro to
"features/techniques" section that links to Getting Started.

S





[2005-01-23 15:09:06] [EMAIL PROTECTED]

I think 'getting started' should be left alone, it is quite good for a
beginner to start. If you look a bit closely at 'features' though, it
is the exact place where tutorials are located already. We agreed on it
before AFAIR that extension specific tutorials should go into their
reference part, while broader scope tutorials or core tutorials should
go into 'features'. Now we can rename it to 'PHP Programming
Techniques' or something more flashy, but I think it is the right place
to push tutorials into (except the getting started tutorial).

Derek: 'reference' should be very far from being confused with
'tutorial' IMHO!



[2005-01-23 14:50:02] [EMAIL PROTECTED]

No, getting started is for beginners and they should be able to get to
this page as fast as possible by just clicking "next" link or by
looking at Table of Contents. Being good attractor for newbies "Getting
Started" should be located at the top of ToC and visible by default.
"Language Reference" is too dull to reflect how clear and easy PHP is.




[2005-01-23 08:23:39] [EMAIL PROTECTED]

I believe we should rename Getting Started to Tutorials (or something
similar and relevant), and move it below Language Reference. The
introduction section of Getting Started should be moved to the
beginning of the Language Reference section. This seems to fit best.
Right now 'Getting Started' is an oddball.



The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
http://bugs.php.net/21970

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


[PHP-DOC] build failure fr (2005-09-09) (fwd)

2005-09-08 Thread Derick Rethans
Hei,

Somebody broke something, please fix (this happens for all languages).

regards,
-- 
Derick Rethans
http://derickrethans.nl | http://ez.no | http://xdebug.org

-- Forwarded message --
Date: Fri, 9 Sep 2005 00:18:07 +0200
From: [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Cc: [EMAIL PROTECTED]
X-Bogosity: No, tests=bogofilter, spamicity=0.00, version=0.96.0
Subject: build failure fr (2005-09-09)

/usr/bin/openjade:E: error reading "dsssl/catalog" (Is a directory)


[PHP-DOC] cvs: phpdoc /en/reference/pdf/functions pdf-add-note.xml

2005-09-08 Thread Derek Ford
derek   Fri Sep  9 01:15:14 2005 EDT

  Modified files:  
/phpdoc/en/reference/pdf/functions  pdf-add-note.xml 
  Log:
  Added an example
  
http://cvs.php.net/diff.php/phpdoc/en/reference/pdf/functions/pdf-add-note.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc/en/reference/pdf/functions/pdf-add-note.xml
diff -u phpdoc/en/reference/pdf/functions/pdf-add-note.xml:1.4 
phpdoc/en/reference/pdf/functions/pdf-add-note.xml:1.5
--- phpdoc/en/reference/pdf/functions/pdf-add-note.xml:1.4  Sat Aug  9 
00:31:33 2003
+++ phpdoc/en/reference/pdf/functions/pdf-add-note.xml  Fri Sep  9 01:15:13 2005
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -26,6 +26,36 @@
  paragraph, newparagraph, 
  key, or help. &return.success;
 
+
+ 
+  Adding a note to a PDF document with PDFlib
+  
+
+  
+ 
+

   
 


[PHP-DOC] cvs: phpdoc /en/reference/pdo_sqlite reference.xml /en/reference/pdo_sqlite/functions PDO-sqliteCreateAggregate.xml PDO-sqliteCreateFunction.xml

2005-09-08 Thread Wez Furlong
wez Fri Sep  9 00:10:15 2005 EDT

  Modified files:  
/phpdoc/en/reference/pdo_sqlite reference.xml 
/phpdoc/en/reference/pdo_sqlite/functions   
PDO-sqliteCreateAggregate.xml 
PDO-sqliteCreateFunction.xml 
  Log:
  tweak.
  livedocs won't let me view the those two function pages, so I hope they are 
ok.
  
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/pdo_sqlite/reference.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc/en/reference/pdo_sqlite/reference.xml
diff -u phpdoc/en/reference/pdo_sqlite/reference.xml:1.4 
phpdoc/en/reference/pdo_sqlite/reference.xml:1.5
--- phpdoc/en/reference/pdo_sqlite/reference.xml:1.4Sun Sep  4 15:39:25 2005
+++ phpdoc/en/reference/pdo_sqlite/reference.xmlFri Sep  9 00:10:10 2005
@@ -1,5 +1,5 @@
 
-
+
 
 
 
@@ -13,7 +13,13 @@
 
  &warn.experimental;
  PDO_SQLITE is a driver that implements the PHP Data Objects (PDO) 
interface
- to enable access to SQLite 2 and SQLite 3 databases.
+ to enable access to SQLite 3 databases.
+
+
+ In PHP 5.1, the SQLite extension also
+ provides a driver for SQLite 2 databases; while it is not technically a
+ part of the PDO_SQLITE driver, it behaves very similarly, so it is
+ documented alongside it.
 

   
@@ -55,12 +61,18 @@
DSN prefix (SQLite 2)

 
- While the default and recommended SQLite version in PDO_SQLITE is
- version 3, the driver also supports accessing and creating SQLite 2
- databases. This enables you to access databases you may have created
+ The SQLite extension in
+ PHP 5.1 provides a PDO driver that supports accessing and creating 
SQLite 2
+ databases.  This enables you to access databases you may have created
  with the SQLite extension in
  previous versions of PHP.
 
+
+ 
+  The sqlite2 driver is only available in PHP 5.1 if you have enabled
+  both PDO and ext/sqlite.  It is not currently available via PECL.
+ 
+
 
  The DSN prefix for connecting to SQLite 2 databases is
  sqlite2:.
@@ -95,9 +107,9 @@
SQLite databases:


   
http://cvs.php.net/diff.php/phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateAggregate.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateAggregate.xml
diff -u 
phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateAggregate.xml:1.1 
phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateAggregate.xml:1.2
--- phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateAggregate.xml:1.1  
Thu Sep  8 23:25:36 2005
+++ phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateAggregate.xml  
Fri Sep  9 00:10:14 2005
@@ -1,5 +1,5 @@
 
-
+
   

 PDO::sqliteCreateAggregate
@@ -174,6 +174,7 @@
   PDO::sqliteCreateFunction

   
+ 
 
   
 
http://cvs.php.net/diff.php/phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateFunction.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateFunction.xml
diff -u 
phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateFunction.xml:1.1 
phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateFunction.xml:1.2
--- phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateFunction.xml:1.1   
Thu Sep  8 23:25:37 2005
+++ phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateFunction.xml   
Fri Sep  9 00:10:15 2005
@@ -1,5 +1,5 @@
 
-
+
   

 PDO::sqliteCreateFunction
@@ -142,6 +142,7 @@
   PDO::sqliteCreateAggregate

   
+ 
 
   
 


[PHP-DOC] cvs: phpdoc /en/reference/pdo_sqlite/functions PDO-sqliteCreateAggregate.xml PDO-sqliteCreateFunction.xml

2005-09-08 Thread Wez Furlong
wez Thu Sep  8 23:25:38 2005 EDT

  Added files: 
/phpdoc/en/reference/pdo_sqlite/functions   
PDO-sqliteCreateAggregate.xml 
PDO-sqliteCreateFunction.xml 
  Log:
  Document sqlite specific functions for PDO.
  
  
http://cvs.php.net/co.php/phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateAggregate.xml?r=1.1&p=1
Index: phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateAggregate.xml
+++ phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateAggregate.xml


  
   
PDO::sqliteCreateAggregate

 Registers an aggregating User Defined Function for use in SQL statements

   

   
&reftitle.description;

 boolPDO::sqliteCreateAggregate
   
stringfunction_name
   
callbackstep_func
   
callbackfinalize_func
   intnum_args


&warn.experimental.func;
  
   PDO::sqliteCreateAggregate is similar to
   PDO::sqliteCreateFunction except that it registers
   functions that can be used to calculate a result aggregated across all the
   rows of a query.
  
  
   The key difference between this function and
   PDO::sqliteCreateFunction is that two functions are
   required to manage the aggregate; step_func is
   called for each row of the result set.  Your PHP function should
   accumulate the result and store it into the aggregation context.
   Once all the rows have been processed,
   finalize_func will be called and it should then
   take the data from the aggregation context and return the result.
   Callback functions should return a type understood by SQLite (i.e.
   scalar type).
  
 

 
  &reftitle.parameters;
  
   

 function_name
 
  
   The name of the function used in SQL statements.
  
 


 step_func
 
  
   Callback function called for each row of the result set.
  
 


 finalize_func
 
  
   Callback function to aggregate the "stepped" data from each row.
  
 


 num_args
 
  
   Hint to the SQLite parser if the callback function accepts a
   predetermined number of arguments.
  
 

   
  
 

 
  &reftitle.examples;
  
   
max_length aggregation function example



   
  
  
   In this example, we are creating an aggregating function that will
   calculate the length of the longest string in one of the columns of the
   table.  For each row, the max_len_step function is
   called and passed a context parameter.  The context
   parameter is just like any other PHP variable and be set to hold an array
   or even an object value.  In this example, we are simply using it to hold
   the maximum length we have seen so far; if the
   string has a length longer than the current
   maximum, we update the context to hold this new maximum length.
  
  
   After all of the rows have been processed, SQLite calls the
   max_len_finalize function to determine the aggregate
   result.  Here, we could perform some kind of calculation based on the
   data found in the context.  In our simple example
   though, we have been calculating the result as the query progressed, so we
   simply need to return the context value.
  
  
   
It is NOT recommended for you to store a copy of the values in the context
and then process them at the end, as you would cause SQLite to use a lot of
memory to process the query - just think of how much memory you would need
if a million rows were stored in memory, each containing a string 32 bytes
in length.
   
  
  
   
You can use PDO::sqliteCreateFunction and
PDO::sqliteCreateAggregate to override SQLite native
SQL functions.
   
  
 


 
  &reftitle.seealso;
  
   
  PDO::sqliteCreateFunction
   
  

  



http://cvs.php.net/co.php/phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateFunction.xml?r=1.1&p=1
Index: phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateFunction.xml
+++ phpdoc/en/reference/pdo_sqlite/functions/PDO-sqliteCreateFunction.xml


  
   
PDO::sqliteCreateFunction

 Registers a User Defined Function for use in SQL statements

   

   
&reftitle.description;

 boolPDO::sqliteCreateFunction
 
stringfunction_name
 
callbackcallback
 intnum_args


&warn.experimental.func;

  
   PDO::sqliteCreateFunction allows you to register a PHP
   function with SQLite as an UDF (User Defined
   Function), so that it can be called from within your SQL statements.
  
  
   The UDF can be used in any SQL statement that can call functions, such as
   SELECT and UPDATE statements and also in triggers.
  
 

 
  &reftitle.parameters;
  
   

 function_name
 
  
   The name of the function used in SQL statements.
  
 


 callback
 
  
   Callback function to handle the defined SQL function.
  
  
   
Callback functions

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

2005-09-08 Thread Wez Furlong
wez Thu Sep  8 23:00:48 2005 EDT

  Modified files:  
/phpdoc/en/reference/pdoreference.xml 
  Log:
  revise install instructions
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/pdo/reference.xml?r1=1.30&r2=1.31&ty=u
Index: phpdoc/en/reference/pdo/reference.xml
diff -u phpdoc/en/reference/pdo/reference.xml:1.30 
phpdoc/en/reference/pdo/reference.xml:1.31
--- phpdoc/en/reference/pdo/reference.xml:1.30  Sun Sep  4 15:39:23 2005
+++ phpdoc/en/reference/pdo/reference.xml   Thu Sep  8 23:00:46 2005
@@ -1,5 +1,5 @@
 
-
+
 
 
 
@@ -21,59 +21,101 @@
  itself; you must use a database-specific
  PDO driver to access a database server.
 
+
+ PDO ships with PHP 5.1, and is available as a PECL extension for PHP 5.0;
+ PDO requires the new OO features in the core of PHP 5, and so will not
+ run with earlier versions of PHP.
+


&reftitle.install;
-   
-   
-
- Windows
+  
+ 
  
-  Follow the same steps to install and enable the PDO drivers of your
-  choice.
+  Having PDO as a shared module will allow you to run pear
+  upgrade pdo as new versions of PDO are published, without
+  forcing you to rebuild the whole of PHP.  Note that if you do this, you
+  also need to upgrade your database specific PDO drivers at the same
+  time.
  
+
+
+ PHP 5.0 and up on Unix systems
+ 
+  PDO is available as a PECL extension from
+  &url.pecl.package;pdo.
+  Installation can be performed via the pear tool; this
+  is enabled by default when you configure PHP.  You should ensure that
+  PHP was configured --with-zlib in order for
+  pear to be able to handle the compressed package
+  files.
+ 
+ 
+  Run the following command to download, build, and install the
+  latest stable version of PDO:
+  
+
+  
+ 
+ 
+  If PDO is still in beta (and at the time of writing, it is), you will
+  need to tell the pear tool that it's ok to fetch the beta package.
+  Instead of running the command above, run the following:
+  
+
+  
+ 
+ 
+  The pear command automatically installs the
+  PDO module into your PHP extensions directory. To enable the
+  PDO extension on Linux or Unix operating systems, you must add
+  the following line to &php.ini;:
+  
+
+  
+ 
+
+
+ Windows users running PHP 5.1 and up
  
   
-   Windows users can download the extension DLL 
php_pdo.dll
-   as part of the PECL collection binaries from
-   &url.php.downloads; or a more 
-   recent version from a PHP 5 PECL 
-   Snapshot.
-  
- 
- 
-  
-   To enable the PDO extension on Windows operating systems, you must
-   add the following line to &php.ini;:
+   PDO and all the major drivers ship with PHP as shared extensions, and
+   simply need to be activated by editing the &php.ini; file:

 
-   
-  
- 
- 
-  
-   Determine your PHP bin directory. If your
-   PHP 5 CLI binary lives at /usr/local/php5/bin/php
-   then the bin dir is /usr/local/php5/bin.
-  
- 
- 
-  
-   Set your path so that your PHP bin directory
-   is at the front:
-   
-
-   
-  
- 
- 
-  
-   Manually build and install the PDO extension:
-   
-
-   
-  
- 
-

 
&reference.pdo.ini;


[PHP-DOC] cvs: livedocs / README

2005-09-08 Thread Wez Furlong
wez Thu Sep  8 22:17:16 2005 EDT

  Modified files:  
/livedocs   README 
  Log:
  solaris /bin/sh doesn't grok "exec >file"; run with ksh instead
  
  
  
http://cvs.php.net/diff.php/livedocs/README?r1=1.15&r2=1.16&ty=u
Index: livedocs/README
diff -u livedocs/README:1.15 livedocs/README:1.16
--- livedocs/README:1.15Wed Feb  9 13:15:53 2005
+++ livedocs/README Thu Sep  8 22:17:14 2005
@@ -1,6 +1,6 @@
 README
 ==
-$Id: README,v 1.15 2005/02/09 18:15:53 edink Exp $
+$Id: README,v 1.16 2005/09/09 02:17:14 wez Exp $
 vim:et:tw=78
 
 INTRODUCTION
@@ -83,6 +83,8 @@
 
 ./build.sh
 
+On Solaris, you need to run "ksh ./build.sh" instead.
+
 This creates phpdoc-idx.$LANG.sqlite and livedoc-cache-idx.$LANG.sqlite.
 It will also configure phpdoc (autoconf & ./configure).
 



Re: [PHP-DOC] Small corrections on install/debian.xml

2005-09-08 Thread Friedhelm Betz

Raphael Melo de Oliveira Bastos Sales wrote:

Hi there,

I'm a translator from the Brazilian Portuguese team and as I was
translating the file install/debian.xml, I noticed something strange:
On line 90:
In the last section, PHP was installed without with only core modules.

I think the "without" should be taken off.


Yes.


Also, on lines 101, 169, 172, it should be "additional" not "additionnal".


of course


If these mistakes are misinterpretations of my part, please
forgive me. If not, I though you guys might want to know and correct
it, as they are small mistakes, which makes them hard to notice. :)

Thanks for the attention,



You have Karma for the en-tree, so you can fix this errors ;-)

Regards
Friedhelm


[PHP-DOC] Small corrections on install/debian.xml

2005-09-08 Thread Raphael Melo de Oliveira Bastos Sales
Hi there,

I'm a translator from the Brazilian Portuguese team and as I was
translating the file install/debian.xml, I noticed something strange:
On line 90:
In the last section, PHP was installed without with only core modules.

I think the "without" should be taken off.

Also, on lines 101, 169, 172, it should be "additional" not "additionnal".

If these mistakes are misinterpretations of my part, please
forgive me. If not, I though you guys might want to know and correct
it, as they are small mistakes, which makes them hard to notice. :)

Thanks for the attention,

Raphael


[PHP-DOC] cvs: phpdoc /scripts xml_proto.php

2005-09-08 Thread Friedhelm Betz
betzThu Sep  8 15:53:16 2005 EDT

  Modified files:  
/phpdoc/scripts xml_proto.php 
  Log:
  adjust 
  
http://cvs.php.net/diff.php/phpdoc/scripts/xml_proto.php?r1=1.37&r2=1.38&ty=u
Index: phpdoc/scripts/xml_proto.php
diff -u phpdoc/scripts/xml_proto.php:1.37 phpdoc/scripts/xml_proto.php:1.38
--- phpdoc/scripts/xml_proto.php:1.37   Thu Sep  8 15:39:39 2005
+++ phpdoc/scripts/xml_proto.phpThu Sep  8 15:53:16 2005
@@ -16,7 +16,7 @@
   | Authors:   Brad House <[EMAIL PROTECTED]> |
   +--+
  
-  $Id: xml_proto.php,v 1.37 2005/09/08 19:39:39 vrana Exp $
+  $Id: xml_proto.php,v 1.38 2005/09/08 19:53:16 betz Exp $
 */
 
 /*
@@ -56,7 +56,7 @@
08/08/05 v2.3 - Refpurpose is on one line
 */
 
-$version="2.2";
+$version="2.3";
 
 $funclist=array();
 $num_funcs=0;


Re: [PHP-DOC] cvs: phpdoc /scripts xml_proto.php

2005-09-08 Thread vrana
Friedhelm Betz wrote:
> I guess those revision comments should be the revision number of the
> generated file not the revision number from xml_proto.php itself.
> So this should be
> ''."\n" .
> instead
> ''."\n" .

It's not a big deal as it gets updated with the first commit but we
can obviously replace $Revision with $'.'Revision to simplify diffs of
changes in this file.

Jakub Vrána


[PHP-DOC] cvs: phpdoc /scripts xml_proto.php

2005-09-08 Thread Jakub Vrana
vrana   Thu Sep  8 15:39:43 2005 EDT

  Modified files:  
/phpdoc/scripts xml_proto.php 
  Log:
  Disable automatic updating of generated $Revision
  
http://cvs.php.net/diff.php/phpdoc/scripts/xml_proto.php?r1=1.36&r2=1.37&ty=u
Index: phpdoc/scripts/xml_proto.php
diff -u phpdoc/scripts/xml_proto.php:1.36 phpdoc/scripts/xml_proto.php:1.37
--- phpdoc/scripts/xml_proto.php:1.36   Thu Sep  8 15:29:19 2005
+++ phpdoc/scripts/xml_proto.phpThu Sep  8 15:39:39 2005
@@ -16,7 +16,7 @@
   | Authors:   Brad House <[EMAIL PROTECTED]> |
   +--+
  
-  $Id: xml_proto.php,v 1.36 2005/09/08 19:29:19 betz Exp $
+  $Id: xml_proto.php,v 1.37 2005/09/08 19:39:39 vrana Exp $
 */
 
 /*
@@ -159,7 +159,7 @@
   }
 
   fwrite($fp, ''."\n" .
-   ''."\n" .
+   ''."\n" .
"\n" .
"\n" .
"\n" .
@@ -246,7 +246,7 @@
 $functype = trim($funclist[$i]["function_type"]);
 
 fwrite($fp, ''."\n" .
-   ''."\n" .
+   ''."\n" .
"\n" .
"\n" .
" \n" .


Re: [PHP-DOC] cvs: phpdoc /scripts xml_proto.php

2005-09-08 Thread Nuno Lopes

Jakub Vrana wrote:

 fwrite($fp, ''."\n" .
-   ''."\n" .
+   ''."\n" .
+   "\n" .
+   "\n" .
"\n" .

"\n" .
" $extension_name Functions\n" .
@@ -244,7 +246,7 @@
 $functype = trim($funclist[$i]["function_type"]);
 fwrite($fp, ''."\n" .
-   ''."\n" .
+   ''."\n" .
"\n" .

"\n" .
" \n" .



I guess those revision comments should be the revision number of the 
generated file not the revision number from xml_proto.php itself.

So this should be
''."\n" .
instead
''."\n" .



Thats not a problem, as cvs will replace them.

Nuno 


[PHP-DOC] cvs: phpdoc /scripts xml_proto.php

2005-09-08 Thread Friedhelm Betz
betzThu Sep  8 15:29:20 2005 EDT

  Modified files:  
/phpdoc/scripts xml_proto.php 
  Log:
  no tabs
  http://cvs.php.net/diff.php/phpdoc/scripts/xml_proto.php?r1=1.35&r2=1.36&ty=u
Index: phpdoc/scripts/xml_proto.php
diff -u phpdoc/scripts/xml_proto.php:1.35 phpdoc/scripts/xml_proto.php:1.36
--- phpdoc/scripts/xml_proto.php:1.35   Wed Sep  7 04:20:42 2005
+++ phpdoc/scripts/xml_proto.phpThu Sep  8 15:29:19 2005
@@ -16,7 +16,7 @@
   | Authors:   Brad House <[EMAIL PROTECTED]> |
   +--+
  
-  $Id: xml_proto.php,v 1.35 2005/09/07 08:20:42 vrana Exp $
+  $Id: xml_proto.php,v 1.36 2005/09/08 19:29:19 betz Exp $
 */
 
 /*
@@ -49,8 +49,8 @@
  - Generation of references.xml template
  - functions with optional arguments would not parse properly, 
now it does
  - Wildcard scanning is now allowed
-- Requires PHP 4.3.0-pre1 or higher now
-- Usage is totally different
+ - Requires PHP 4.3.0-pre1 or higher now
+ - Usage is totally different
05/06/04 v2.1 - Corrected filenames for OO functions
01/03/05 v2.2 - Implemented the new doc style
08/08/05 v2.3 - Refpurpose is on one line
@@ -159,7 +159,7 @@
   }
 
   fwrite($fp, ''."\n" .
-   ''."\n" .
+   ''."\n" .
"\n" .
"\n" .
"\n" .
@@ -246,7 +246,7 @@
 $functype = trim($funclist[$i]["function_type"]);
 
 fwrite($fp, ''."\n" .
-   ''."\n" .
+   ''."\n" .
"\n" .
"\n" .
" \n" .
@@ -443,19 +443,19 @@
   case '\n':
   case ' ':
 if (!$spaces) {
- $spaces=1;
+  $spaces=1;
   $temp .= ' ';
- $temp_len++;
+  $temp_len++;
 }
-  break;
+break;
 
   default:
 if ($c != '\r' && $c != '\n') {
   $spaces=0;
- $temp .= $c;
- $temp_len++;
+  $temp .= $c;
+  $temp_len++;
 }
-  break;
+break;
 }
   }
   function_add_purpose($func_num, $temp);
@@ -464,129 +464,129 @@
 
 function parse_proto($proto)
 {
-  $len=0;
-  $i=0;
-  $c=0;
-  $done=0;
-  $start=0;
-  $func_number=-1;
-  $got_proto_def=0;
-  $got_proto_type=0;
-  $got_proto_name=0;
-  $got_arg_type=0;
-  $start_args=0;
-  $temp="";
-  $temp2="";
-  $temp_len=0;
-  $isopt=0;
-
-  $len=strlen($proto);
-
-  for ($i=0; $i<$len; $i++) {
-$c=substr($proto, $i, 1);
-switch ($c) {
-  case '\r':
-  case '\n':
-  case ' ':
-if ($temp_len) {
- if (!$got_proto_def) {
-   if (strcasecmp($temp, "proto") != 0) {
- // Possibly just a comment, don't output error info
- // echo "Not a proper proto definition: $proto\n";
- return(0);
-   } else {
- $got_proto_def=1;
-   }
- } else if (!$got_proto_type) {
-   $func_number=new_function();
-function_add_type($func_number, $temp);
-   $got_proto_type=1;
- } else if (!$got_proto_name) {
-function_add_name($func_number, $temp);
-   $got_proto_name=1;
- } else if ($start_args && !$got_arg_type) {
-$got_arg_type=1;
-   $temp2=$temp;
- } else if ($start_args && $got_arg_type) {
-   $got_arg_type=0;
-function_add_arg($func_number, $temp2, $temp, $isopt);
-   $temp2="";
- }
- $temp_len=0;
- $temp="";
-}
-  break;
+$len=0;
+$i=0;
+$c=0;
+$done=0;
+$start=0;
+$func_number=-1;
+$got_proto_def=0;
+$got_proto_type=0;
+$got_proto_name=0;
+$got_arg_type=0;
+$start_args=0;
+$temp="";
+$temp2="";
+$temp_len=0;
+$isopt=0;
+
+$len=strlen($proto);
+
+for ($i=0; $i<$len; $i++) {
+$c=substr($proto, $i, 1);
+switch ($c) {
+case '\r':
+case '\n':
+case ' ':
+if ($temp_len) {
+  if (!$got_proto_def) {
+if (strcasecmp($temp, "proto") != 0) {
+  // Possibly just a comment, don't output error info
+  // echo "Not a proper proto definition: $proto\n";
+  return(0);
+} else {
+$got_proto_def=1;
+}
+  } else if (!$got_proto_type) {
+  $func_number=new_function();
+  function_add_type($func_number, $temp);
+  $got_proto_type=1;
+  } else if (!$got_proto_name) {
+  function_add_name($func_number, $temp);
+  $got_proto_name=1;
+  } else if ($start_args && !$got_arg_type) {
+  $got_arg_type=1;
+  $temp2=$temp;
+  } else if ($start_args && $got_arg_type) {
+   

[PHP-DOC] cvs: phpdoc /en/reference/session_pgsql/functions session-pgsql-add-error.xml session-pgsql-get-error.xml session-pgsql-get-field.xml session-pgsql-reset.xml session-pgsql-set-field.xml

2005-09-08 Thread Friedhelm Betz
betzThu Sep  8 14:25:44 2005 EDT

  Added files: 
/phpdoc/en/reference/session_pgsql/functions

session-pgsql-add-error.xml 

session-pgsql-get-error.xml 

session-pgsql-get-field.xml 
session-pgsql-reset.xml 

session-pgsql-set-field.xml 
  Log:
  more function skeletons for session_pgsql
  
http://cvs.php.net/co.php/phpdoc/en/reference/session_pgsql/functions/session-pgsql-add-error.xml?r=1.1&p=1
Index: phpdoc/en/reference/session_pgsql/functions/session-pgsql-add-error.xml
+++ phpdoc/en/reference/session_pgsql/functions/session-pgsql-add-error.xml




 
  session_pgsql_add_error
  Increments error counts and sets last error message
 
 
  &reftitle.description;
  
   boolsession_pgsql_add_error
   interror_level
   stringerror_message
  

  &warn.undocumented.func;

 
 
  &reftitle.parameters;
  
   

 error_level
 
  
   
  
 


 error_message
 
  
   
  
 

   
  
 
 
  &reftitle.returnvalues;
  
  &return.success;
  
 

 
  &reftitle.seealso;
  
   
session_pgsql_get_error
   
  
 





http://cvs.php.net/co.php/phpdoc/en/reference/session_pgsql/functions/session-pgsql-get-error.xml?r=1.1&p=1
Index: phpdoc/en/reference/session_pgsql/functions/session-pgsql-get-error.xml
+++ phpdoc/en/reference/session_pgsql/functions/session-pgsql-get-error.xml




 
  session_pgsql_get_error
  Returns number of errors and last error message
 
 
  &reftitle.description;
  
   arraysession_pgsql_get_error
   boolwith_error_message
  
  
   Get the number of errors and optional the errror messages.
  
 
 
  &reftitle.parameters;
  
   

 with_error_message
 
  
   Set to &true; the literal error message for each error is also returned.
  
 

   
  
 
 
  &reftitle.returnvalues;
  
   The number of errors are returned as array.
  
 

 


 
  &reftitle.seealso;
  
   
session_pgsql_add_error
   
  
 





http://cvs.php.net/co.php/phpdoc/en/reference/session_pgsql/functions/session-pgsql-get-field.xml?r=1.1&p=1
Index: phpdoc/en/reference/session_pgsql/functions/session-pgsql-get-field.xml
+++ phpdoc/en/reference/session_pgsql/functions/session-pgsql-get-field.xml




 
  session_pgsql_get_field
  Get custom field value
 
 
  &reftitle.description;
  
   stringsession_pgsql_get_field
   
  

  &warn.undocumented.func;

 

 

 
  &reftitle.seealso;
  
   
session_pgsql_set_field
   
  
 





http://cvs.php.net/co.php/phpdoc/en/reference/session_pgsql/functions/session-pgsql-reset.xml?r=1.1&p=1
Index: phpdoc/en/reference/session_pgsql/functions/session-pgsql-reset.xml
+++ phpdoc/en/reference/session_pgsql/functions/session-pgsql-reset.xml




 
  session_pgsql_reset
  Reset connection to session database servsers
 
 
  &reftitle.description;
  
   boolsession_pgsql_reset
   
  
  
   Reset the connection to the seession database server.
  
 

 
  &reftitle.returnvalues;
  
   &return.success;
  
 


 


 






http://cvs.php.net/co.php/phpdoc/en/reference/session_pgsql/functions/session-pgsql-set-field.xml?r=1.1&p=1
Index: phpdoc/en/reference/session_pgsql/functions/session-pgsql-set-field.xml
+++ phpdoc/en/reference/session_pgsql/functions/session-pgsql-set-field.xml




 
  session_pgsql_set_field
  Set custom field value
 
 
  &reftitle.description;
  
   boolsession_pgsql_set_field
   stringvalue
  

  &warn.undocumented.func;

 
 
  &reftitle.parameters;
  
   

 value
 
  
   
  
 

   
  
 
 
  &reftitle.returnvalues;
  
   &return.success;
  
 

 

 
  &reftitle.seealso;
  
   
session_pgsql_get_field
   
  
 








[PHP-DOC] cvs: phpdoc /en/reference/session_pgsql/functions session-pgsql-status.xml

2005-09-08 Thread Friedhelm Betz
betzThu Sep  8 14:24:45 2005 EDT

  Modified files:  
/phpdoc/en/reference/session_pgsql/functions

session-pgsql-status.xml 
  Log:
  correct return type
  
http://cvs.php.net/diff.php/phpdoc/en/reference/session_pgsql/functions/session-pgsql-status.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/reference/session_pgsql/functions/session-pgsql-status.xml
diff -u 
phpdoc/en/reference/session_pgsql/functions/session-pgsql-status.xml:1.1 
phpdoc/en/reference/session_pgsql/functions/session-pgsql-status.xml:1.2
--- phpdoc/en/reference/session_pgsql/functions/session-pgsql-status.xml:1.1
Thu Sep  8 12:03:16 2005
+++ phpdoc/en/reference/session_pgsql/functions/session-pgsql-status.xml
Thu Sep  8 14:24:45 2005
@@ -1,5 +1,5 @@
 
-
+
 
 
  
@@ -11,7 +11,7 @@
   &reftitle.description;
   
arraysession_pgsql_status
-   void
+   
   
   &warn.experimental.func;
   &warn.undocumented.func;


Re: [PHP-DOC] cvs: phpdoc /scripts xml_proto.php

2005-09-08 Thread Friedhelm Betz

Jakub Vrana wrote:
 
   fwrite($fp, ''."\n" .

-   ''."\n" .
+   ''."\n" .
+   "\n" .
+   "\n" .
"\n" .
"\n" .
" $extension_name Functions\n" .
@@ -244,7 +246,7 @@
 $functype = trim($funclist[$i]["function_type"]);
 
 fwrite($fp, ''."\n" .

-   ''."\n" .
+   ''."\n" .
"\n" .
"\n" .
" \n" .



I guess those revision comments should be the revision number of the 
generated file not the revision number from xml_proto.php itself.

So this should be
''."\n" .
instead
''."\n" .

Friedhelm


Re: [PHP-DOC] get the word out about livedocs

2005-09-08 Thread Derick Rethans
On Thu, 8 Sep 2005, Gabor Hojtsy wrote:

> >>Actually these "let me first" stuff made livedocs progress quite slowly.
> >> Since doc.php.net does not work (is not accessible) for me for at least
> >>some days now, I would not be too excited about it being moved to
> >>doc.php.net :)
> > 
> > Ok.
> > My concern at this point, is a flock of hundreds (thousands?) of people
> > downloading a 5 meg file from my server.
> > 
> > Perhaps we could get mirrors... ? I dunno.. seems like overkill..
> 
> Nuno has a good way to push up CHMs to the rsync server. Maybe he can
> help in this case.

Actually it's a pull that I run with a cronjob. I guess we can host it 
somewhere. Do you want it to go to the mirrors?

regards,
Derick

-- 
Derick Rethans
http://derickrethans.nl | http://ez.no | http://xdebug.org


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

2005-09-08 Thread Antony Dovgal
tony2001Thu Sep  8 13:05:12 2005 EDT

  Modified files:  
/phpdoc/en/reference/maxdb  reference.xml 
  Log:
  missing whitespace
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/maxdb/reference.xml?r1=1.9&r2=1.10&ty=u
Index: phpdoc/en/reference/maxdb/reference.xml
diff -u phpdoc/en/reference/maxdb/reference.xml:1.9 
phpdoc/en/reference/maxdb/reference.xml:1.10
--- phpdoc/en/reference/maxdb/reference.xml:1.9 Sun Sep  4 15:39:18 2005
+++ phpdoc/en/reference/maxdb/reference.xml Thu Sep  8 13:05:12 2005
@@ -1,5 +1,5 @@
 
-
+
 
 
 
@@ -49,7 +49,7 @@
 &reftitle.required;
 
  In order to have these functions available, you must compile PHP with
- MaxDB support.Additionally, you must have the MaxDB SQLDBC runtime library
+ MaxDB support. Additionally, you must have the MaxDB SQLDBC runtime 
library
  available to access the MaxDB server. 
 
 


Re: [PHP-DOC] get the word out about livedocs

2005-09-08 Thread Gabor Hojtsy
>>Actually these "let me first" stuff made livedocs progress quite slowly.
>> Since doc.php.net does not work (is not accessible) for me for at least
>>some days now, I would not be too excited about it being moved to
>>doc.php.net :)
> 
> Ok.
> My concern at this point, is a flock of hundreds (thousands?) of people
> downloading a 5 meg file from my server.
> 
> Perhaps we could get mirrors... ? I dunno.. seems like overkill..

Nuno has a good way to push up CHMs to the rsync server. Maybe he can
help in this case.

Goba


Re: [PHP-DOC] get the word out about livedocs

2005-09-08 Thread Sean Coates

> Actually these "let me first" stuff made livedocs progress quite slowly.
>  Since doc.php.net does not work (is not accessible) for me for at least
> some days now, I would not be too excited about it being moved to
> doc.php.net :)

Ok.
My concern at this point, is a flock of hundreds (thousands?) of people
downloading a 5 meg file from my server.

Perhaps we could get mirrors... ? I dunno.. seems like overkill..

S


Re: [PHP-DOC] get the word out about livedocs

2005-09-08 Thread Gabor Hojtsy
>>Isn't it time to post a news announcement about Sean's instant livedocs
>>on php.net, so that we get actual testers finally? It seems that Sean
>>have not received too many comments on his work, but it would allow us
>>to get the word out finally. I know the original intention was to only
>>test it internally in the doc team, then the blog post revealed it, now
>>it might be the time to step further.
> 
> Thanks.
> However, please let me port it to docweb, first, at the very least.
> 
> I'd also like to fix/update the theme...
> 
> I'll hopefully find some time next week, at php|works -- perhaps not. (-:
> 
> Oh, and while we're talking about Livedocs, and since it's a good cause,
> I've added a charitable button to my livedocs..
> http://livedocs.phpdoc.info/ 

Actually these "let me first" stuff made livedocs progress quite slowly.
 Since doc.php.net does not work (is not accessible) for me for at least
some days now, I would not be too excited about it being moved to
doc.php.net :)

Goba


Re: [PHP-DOC] get the word out about livedocs

2005-09-08 Thread Sean Coates
> Isn't it time to post a news announcement about Sean's instant livedocs
> on php.net, so that we get actual testers finally? It seems that Sean
> have not received too many comments on his work, but it would allow us
> to get the word out finally. I know the original intention was to only
> test it internally in the doc team, then the blog post revealed it, now
> it might be the time to step further.

Thanks.
However, please let me port it to docweb, first, at the very least.

I'd also like to fix/update the theme...

I'll hopefully find some time next week, at php|works -- perhaps not. (-:

Oh, and while we're talking about Livedocs, and since it's a good cause,
I've added a charitable button to my livedocs..
http://livedocs.phpdoc.info/ 

S


[PHP-DOC] get the word out about livedocs

2005-09-08 Thread Gabor Hojtsy
Hi,

Isn't it time to post a news announcement about Sean's instant livedocs
on php.net, so that we get actual testers finally? It seems that Sean
have not received too many comments on his work, but it would allow us
to get the word out finally. I know the original intention was to only
test it internally in the doc team, then the blog post revealed it, now
it might be the time to step further.

Opinions?

Goba


Re: [PHP-DOC] Manual Credits/Contributors

2005-09-08 Thread Gabor Hojtsy
I have an important exam tomorrow, so I will only be able to add my
opinion later this week (probably weekend). This is high priority on my
TODO however, not forgotten!

Goba

Jakub Vrana wrote:
> Sean Coates wrote:
> 
>>I don't want to start a huge campaign of people who are in/out, but I
>>_do_ think we should update this list, at least yearly.
> 
> 
> I propose this list to the cover:
> 
> Mehdi Achour
> Friedhelm Betz
> (+) Sean Coates
> Antony Dovgal
> Nuno Lopes
> (+) Aidan Lister
> Philip Olson
> Jakub Vrana
> 
> (+) denotes added names.
> 
> Jakub Vrana
> 


[PHP-DOC] cvs: phpdoc /en/reference/session_pgsql .cvsignore configure.xml ini.xml reference.xml /en/reference/session_pgsql/functions session-pgsql-status.xml

2005-09-08 Thread Friedhelm Betz
betzThu Sep  8 12:03:16 2005 EDT

  Added files: 
/phpdoc/en/reference/session_pgsql  .cvsignore configure.xml ini.xml 
reference.xml 
/phpdoc/en/reference/session_pgsql/functions

session-pgsql-status.xml 
  Log:
  move session_pgsql from peardoc to phpdoc
  

http://cvs.php.net/co.php/phpdoc/en/reference/session_pgsql/.cvsignore?r=1.1&p=1
Index: phpdoc/en/reference/session_pgsql/.cvsignore
+++ phpdoc/en/reference/session_pgsql/.cvsignore
functions.xml

http://cvs.php.net/co.php/phpdoc/en/reference/session_pgsql/configure.xml?r=1.1&p=1
Index: phpdoc/en/reference/session_pgsql/configure.xml
+++ phpdoc/en/reference/session_pgsql/configure.xml



 &reftitle.install;
 
  Short installation note:
  
   

 Untar the tar.gz archive into
 php4/ext (Latest official releases
 can be found at SourceForge
 PHP Form Extension Project)

   
   

 If the new directory is now called something like
 session_pgsql. You should name it to
 session_pgsql (except you only want to build it as
 self-contained php-module).

   
   
Run ./buildconf in php4
   
   

 Run configure
 --with-session-pgsql (and your other
 options)

   
   
make; make install
   
  
 




http://cvs.php.net/co.php/phpdoc/en/reference/session_pgsql/ini.xml?r=1.1&p=1
Index: phpdoc/en/reference/session_pgsql/ini.xml
+++ phpdoc/en/reference/session_pgsql/ini.xml



 &reftitle.runtime;
 &extension.runtime;
 
  PostgreSQL session save handler is still under development. Refer to the
  README file in the source distribution for
  configuration details.
 




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







 PostgreSQL Session Save Handler
 Session PgSQL

  
   
&reftitle.intro;
&warn.experimental;
¬e.no-windows.extension;

 This module provide additional session save handler for session module
 using PostgreSQL as a storage. user session save
 handler may be used, but this module is written in C. Therefore, this
 module is roughly 2 times faster than save handler written in PHP script.


 Fail-over and load balance is planned to be implemented, but they are not
 available now.


 
  There will be functions for this module, but it is not available now.
 

   

   
&reftitle.required;

 You need at least PHP 4.1, PostgreSQL 7.1 and MM 1.1.3

   

   &reference.session-pgsql.configure;

   &reference.session-pgsql.ini;


   
Contact Information

 I have at the moment not very much time to further develop this
 extension. I will implement more and more features in the near future.


 If you have comments, bug fixes, enhancements or want to help developing
 this, you can drop me a mail at
 mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]. Any help 
is
 very welcome.

   
  

&reference.session-pgsql.functions;

 


http://cvs.php.net/co.php/phpdoc/en/reference/session_pgsql/functions/session-pgsql-status.xml?r=1.1&p=1
Index: phpdoc/en/reference/session_pgsql/functions/session-pgsql-status.xml
+++ phpdoc/en/reference/session_pgsql/functions/session-pgsql-status.xml




 
  session_pgsql_status
  Get current save handler status
 

 
  &reftitle.description;
  
   arraysession_pgsql_status
   void
  
  &warn.experimental.func;
  &warn.undocumented.func;
 





[PHP-DOC] cvs: phpdoc /howto scripts.xml

2005-09-08 Thread Friedhelm Betz
betzThu Sep  8 10:09:04 2005 EDT

  Modified files:  
/phpdoc/howto   scripts.xml 
  Log:
  typos
  
http://cvs.php.net/diff.php/phpdoc/howto/scripts.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc/howto/scripts.xml
diff -u phpdoc/howto/scripts.xml:1.2 phpdoc/howto/scripts.xml:1.3
--- phpdoc/howto/scripts.xml:1.2Wed Sep  7 17:25:36 2005
+++ phpdoc/howto/scripts.xmlThu Sep  8 10:09:02 2005
@@ -90,13 +90,13 @@
 
  The purpose of the extension, specified by an ID. There are several
  IDs available, which can be consulted in the
- en/entensions.ent file. They look like
+ en/extensions.ent file. They look like
  database.vendors or xml.
 
 
  If none of the available categories fits your extension, you can
  create a new one. To do so, you must add a new entity in the
- en/entensions.ent file, like:
+ en/extensions.ent file, like:
  XML
   Manipulation'>. After this, you still
  need to edit en/appendices/extensions.xml and


[PHP-DOC] cvs: phpdoc /en/reference/dom/functions dom-domdocument-save.xml dom-domdocument-savexml.xml /en/reference/libxml constants.xml

2005-09-08 Thread Nuno Lopes
nlopess Thu Sep  8 08:02:24 2005 EDT

  Modified files:  
/phpdoc/en/reference/libxml constants.xml 
/phpdoc/en/reference/dom/functions  dom-domdocument-save.xml 
dom-domdocument-savexml.xml 
  Log:
  document LIBXML_NOEMPTYTAG
  
http://cvs.php.net/diff.php/phpdoc/en/reference/libxml/constants.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc/en/reference/libxml/constants.xml
diff -u phpdoc/en/reference/libxml/constants.xml:1.5 
phpdoc/en/reference/libxml/constants.xml:1.6
--- phpdoc/en/reference/libxml/constants.xml:1.5Thu Sep  8 07:45:22 2005
+++ phpdoc/en/reference/libxml/constants.xmlThu Sep  8 08:02:23 2005
@@ -1,5 +1,5 @@
 
-
+
 
  &reftitle.constants;
  &extension.constants;
@@ -89,8 +89,8 @@
 
  
   This option is currently just available in the
-  dom_document_save and
-  dom_document_savexml functions.
+   and
+   functions.
  
 

http://cvs.php.net/diff.php/phpdoc/en/reference/dom/functions/dom-domdocument-save.xml?r1=1.7&r2=1.8&ty=u
Index: phpdoc/en/reference/dom/functions/dom-domdocument-save.xml
diff -u phpdoc/en/reference/dom/functions/dom-domdocument-save.xml:1.7 
phpdoc/en/reference/dom/functions/dom-domdocument-save.xml:1.8
--- phpdoc/en/reference/dom/functions/dom-domdocument-save.xml:1.7  Sun Feb 
13 23:13:15 2005
+++ phpdoc/en/reference/dom/functions/dom-domdocument-save.xml  Thu Sep  8 
08:02:24 2005
@@ -1,5 +1,5 @@
 
-
+
 
  
   DOMDocument->save()
@@ -14,6 +14,7 @@

 mixedsave
 
stringfilename
+integeroptions

   
   
@@ -21,6 +22,7 @@
called after building a new dom document from scratch as in the example 
below. 
   
  
+
  
   &reftitle.parameters;
   
@@ -33,15 +35,50 @@
   
  
 
+
+ options
+ 
+  
+   Additional Options. Currently only LIBXML_NOEMPTYTAG is supported.
+  
+ 
+

   
  
+
  
   &reftitle.returnvalues;
   
Returns the number of bytes written or &false; if an error occurred.
   
  
+
+ 
+  &reftitle.changelog;
+  
+   
+
+ 
+  
+   &Version;
+   &Description;
+  
+ 
+ 
+  
+   5.1.0
+   
+Added the options parameter
+   
+  
+ 
+
+   
+  
+ 
+
  
   &reftitle.examples;
   
http://cvs.php.net/diff.php/phpdoc/en/reference/dom/functions/dom-domdocument-savexml.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc/en/reference/dom/functions/dom-domdocument-savexml.xml
diff -u phpdoc/en/reference/dom/functions/dom-domdocument-savexml.xml:1.5 
phpdoc/en/reference/dom/functions/dom-domdocument-savexml.xml:1.6
--- phpdoc/en/reference/dom/functions/dom-domdocument-savexml.xml:1.5   Sun Feb 
13 23:13:15 2005
+++ phpdoc/en/reference/dom/functions/dom-domdocument-savexml.xml   Thu Sep 
 8 08:02:24 2005
@@ -1,5 +1,5 @@
 
-
+
 
  
   DOMDocument->saveXML()
@@ -14,6 +14,7 @@

 stringsaveXML
 DOMNodenode
+integeroptions

   
   
@@ -21,6 +22,7 @@
called after building a new dom document from scratch as in the example 
below. 
   
  
+
  
   &reftitle.parameters;
   
@@ -34,9 +36,19 @@
   
  
 
+
+ options
+ 
+  
+   Additional Options. Currently only LIBXML_NOEMPTYTAG is supported.
+  
+ 
+

   
  
+
  
   &reftitle.returnvalues;
   
@@ -58,6 +70,31 @@

   
  
+
+ 
+  &reftitle.changelog;
+  
+   
+
+ 
+  
+   &Version;
+   &Description;
+  
+ 
+ 
+  
+   5.1.0
+   
+Added the options parameter
+   
+  
+ 
+
+   
+  
+ 
+
  
   &reftitle.examples;
   


[PHP-DOC] cvs: phpdoc /en/reference/libxml constants.xml

2005-09-08 Thread Nuno Lopes
nlopess Thu Sep  8 07:45:22 2005 EDT

  Modified files:  
/phpdoc/en/reference/libxml constants.xml 
  Log:
  also add NOEMTYTAG constant, which I've forgotten
  
http://cvs.php.net/diff.php/phpdoc/en/reference/libxml/constants.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc/en/reference/libxml/constants.xml
diff -u phpdoc/en/reference/libxml/constants.xml:1.4 
phpdoc/en/reference/libxml/constants.xml:1.5
--- phpdoc/en/reference/libxml/constants.xml:1.4Thu Sep  8 07:02:23 2005
+++ phpdoc/en/reference/libxml/constants.xmlThu Sep  8 07:45:22 2005
@@ -1,5 +1,5 @@
 
-
+
 
  &reftitle.constants;
  &extension.constants;
@@ -78,6 +78,25 @@
   
   

+LIBXML_NOEMPTYTAG
+ (integer)
+   
+   
+
+ Expand empty tags (e.g. 
to +

) + + + + This option is currently just available in the + dom_document_save and + dom_document_savexml functions. + + + + + + LIBXML_NOENT (integer)

[PHP-DOC] #32943 [Bgs->Opn]: is_numeric validates "3e0"

2005-09-08 Thread betz
 ID:   32943
 Updated by:   [EMAIL PROTECTED]
 Reported By:  pmorgan at ukds dot net
-Status:   Bogus
+Status:   Open
 Bug Type: Documentation problem
 Operating System: Linux
 PHP Version:  4.3.10
 New Comment:

changed status


Previous Comments:


[2005-09-08 13:21:15] [EMAIL PROTECTED]

reopen this as documentation bug.
"number" could also be given in e-notation, hex-notation,
octal-notation  



[2005-05-04 14:40:54] pmorgan at ukds dot net

That needs to go into the manual "number in e-notation", which I
understand, or even better as an additional flag "allow_e-notation". 

It's the last error I would have expected and is very misleading AFAIK.



[2005-05-04 14:40:45] pmorgan at ukds dot net

That needs to go into the manual "number in e-notation", which I
understand, or even better as an additional flag "allow_e-notation". 

It's the last error I would have expected and is very misleading AFAIK.



[2005-05-04 14:30:10] [EMAIL PROTECTED]

Thank you for taking the time to write to us, but this is not
a bug. Please double-check the documentation available at
http://www.php.net/manual/ and the instructions on how to report
a bug at http://bugs.php.net/how-to-report.php

3e0 is a number in e-notation, which is of course a numerical string




[2005-05-04 12:29:00] pmorgan at ukds dot net

typo



The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
http://bugs.php.net/32943

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


[PHP-DOC] #32943 [Bgs]: is_numeric validates "3e0"

2005-09-08 Thread betz
 ID:   32943
 Updated by:   [EMAIL PROTECTED]
 Reported By:  pmorgan at ukds dot net
 Status:   Bogus
-Bug Type: Scripting Engine problem
+Bug Type: Documentation problem
 Operating System: Linux
 PHP Version:  4.3.10
 New Comment:

reopen this as documentation bug.
"number" could also be given in e-notation, hex-notation,
octal-notation  


Previous Comments:


[2005-05-04 14:40:54] pmorgan at ukds dot net

That needs to go into the manual "number in e-notation", which I
understand, or even better as an additional flag "allow_e-notation". 

It's the last error I would have expected and is very misleading AFAIK.



[2005-05-04 14:40:45] pmorgan at ukds dot net

That needs to go into the manual "number in e-notation", which I
understand, or even better as an additional flag "allow_e-notation". 

It's the last error I would have expected and is very misleading AFAIK.



[2005-05-04 14:30:10] [EMAIL PROTECTED]

Thank you for taking the time to write to us, but this is not
a bug. Please double-check the documentation available at
http://www.php.net/manual/ and the instructions on how to report
a bug at http://bugs.php.net/how-to-report.php

3e0 is a number in e-notation, which is of course a numerical string




[2005-05-04 12:29:00] pmorgan at ukds dot net

typo



[2005-05-04 12:28:04] pmorgan at ukds dot net

Description:

With some server side validation I inadvertenly entered "3e0" into the
textbox, it validated to my suprise. Would have expected this to throw
a false

Reproduce code:
---
echo is_numeric('3e00')? 'true': 'false';

Expected result:

false;
In fact anything without 0-9 and a . I would expect a false !






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


[PHP-DOC] cvs: phpdoc /en/reference/libxml constants.xml

2005-09-08 Thread Nuno Lopes
nlopess Thu Sep  8 07:02:26 2005 EDT

  Modified files:  
/phpdoc/en/reference/libxml constants.xml 
  Log:
  add new constants. move err_* constants to the bottom, to avoid confusion
  
http://cvs.php.net/diff.php/phpdoc/en/reference/libxml/constants.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc/en/reference/libxml/constants.xml
diff -u phpdoc/en/reference/libxml/constants.xml:1.3 
phpdoc/en/reference/libxml/constants.xml:1.4
--- phpdoc/en/reference/libxml/constants.xml:1.3Tue Mar  1 10:21:54 2005
+++ phpdoc/en/reference/libxml/constants.xmlThu Sep  8 07:02:23 2005
@@ -1,11 +1,28 @@
 
-
+
 
  &reftitle.constants;
  &extension.constants;
  
   

+LIBXML_COMPACT
+ (integer)
+   
+   
+
+ Activate small nodes allocation optimization. This may speed up your
+ application without needing to change the code.
+
+
+ 
+  Only available in Libxml >= 2.6.21
+ 
+
+   
+  
+  
+   
 LIBXML_DTDATTR
  (integer)

@@ -39,133 +56,149 @@
   
   

-LIBXML_ERR_ERROR
+LIBXML_NOBLANKS
  (integer)


 
- A recoverable error
+ Remove blank nodes
 

   
   

-LIBXML_ERR_FATAL
+LIBXML_NOCDATA
  (integer)


 
- A fatal error
+ Merge CDATA as text nodes
 

   
   

-LIBXML_ERR_NONE
+LIBXML_NOENT
  (integer)


 
- No errors
+ Substitute entities
 

   
   

-LIBXML_ERR_WARNING
+LIBXML_NOERROR
  (integer)


 
- A simple warning
+ Suppress error reports
 

   
   

-LIBXML_NOBLANKS
+LIBXML_NONET
  (integer)


 
- Remove blank nodes
+ Disable network access when loading documents
 

   
   

-LIBXML_NOCDATA
+LIBXML_NOWARNING
  (integer)


 
- Merge CDATA as text nodes
+ Suppress warning reports
 

   
   

-LIBXML_NOENT
+LIBXML_NOXMLDECL
  (integer)


 
- Substitute entities
+ Drop the XML declaration when saving a document
 
+
+ 
+  Only available in Libxml >= 2.6.21
+ 
+

   
   

-LIBXML_NOERROR
+LIBXML_NSCLEAN
  (integer)


 
- Suppress error reports
+ Remove redundant namespaces declarations
 

   
   

-LIBXML_NONET
+LIBXML_XINCLUDE
  (integer)


 
- Disable network access when loading documents
+ Implement XInclude substitution
 

   
   

-LIBXML_NOWARNING
+LIBXML_ERR_ERROR
  (integer)


 
- Suppress warning reports
+ A recoverable error
 

   
   

-LIBXML_NSCLEAN
+LIBXML_ERR_FATAL
  (integer)


 
- Remove redundant namespaces declarations
+ A fatal error
 

   
   

-LIBXML_XINCLUDE
+LIBXML_ERR_NONE
  (integer)


 
- Implement XInclude substitution
+ No errors
+
+   
+  
+  
+   
+LIBXML_ERR_WARNING
+ (integer)
+   
+   
+
+ A simple warning
 

   


Re: [PHP-DOC] Manual Credits/Contributors

2005-09-08 Thread Jakub Vrana
Sean Coates wrote:
> I don't want to start a huge campaign of people who are in/out, but I
> _do_ think we should update this list, at least yearly.

I propose this list to the cover:

Mehdi Achour
Friedhelm Betz
(+) Sean Coates
Antony Dovgal
Nuno Lopes
(+) Aidan Lister
Philip Olson
Jakub Vrana

(+) denotes added names.

Jakub Vrana


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

2005-09-08 Thread Jakub Vrana
vrana   Thu Sep  8 04:39:48 2005 EDT

  Modified files:  
/phpdoc/en/reference/array/functionsarray-walk.xml 
  Log:
  Remove superfluous information about reseting the array position
  
http://cvs.php.net/diff.php/phpdoc/en/reference/array/functions/array-walk.xml?r1=1.24&r2=1.25&ty=u
Index: phpdoc/en/reference/array/functions/array-walk.xml
diff -u phpdoc/en/reference/array/functions/array-walk.xml:1.24 
phpdoc/en/reference/array/functions/array-walk.xml:1.25
--- phpdoc/en/reference/array/functions/array-walk.xml:1.24 Sat Feb 19 
07:33:33 2005
+++ phpdoc/en/reference/array/functions/array-walk.xml  Thu Sep  8 04:39:45 2005
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -58,9 +58,7 @@
  array_walk is not affected by the internal
  array pointer of array.  
  array_walk will walk through the entire array 
- regardless of pointer position.  To reset the pointer, use 
- reset.  In PHP 3, 
- array_walk resets the pointer.
+ regardless of pointer position.
 
 
  Users may not change the array itself from the callback


Re: Re[2]: [PHP-DOC] Manual Credits/Contributors

2005-09-08 Thread David Mytton
I'd like to appear on the "Authors and Editors" list. I've not done
too much recently but I'm hoping to make some time to continue adding
examples to functions without then like I started doing a while back
:)

-- 
Regards,

David Mytton
http://www.olate.co.uk