[PHP-DOC] Karma for the phpdoc (en) module

2007-08-29 Thread Simion Onea
Hello Philip,

Thank you for granting me karma to the English module!
I will try to do my best.
In case that I will be unsure of something, I will post my question in the
mailing list first so that I don't mess something up.

Best regards,
Simion.


-Original Message-
From: Philip Olson [mailto:[EMAIL PROTECTED] 
Sent: Thursday, August 30, 2007 5:15 AM
To: Simion Onea
Cc: [EMAIL PROTECTED]; 'PHPdoc List'
Subject: Re: [PHP-DOC] Another typo in appendices/migration5.xml

Hello Simion,

Your karma has been updated, in the future feel free to fix the phpdoc (en)
module as you see fit. Keep up the good work! :)

Regards,
Philip


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

2007-08-29 Thread Greg Beaver
cellog  Thu Aug 30 03:28:24 2007 UTC

  Modified files:  
/phpdoc/en/reference/phar   ini.xml 
  Log:
  fix incorrect documentation on phar.extract_list
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/ini.xml?r1=1.4&r2=1.5&diff_format=u
Index: phpdoc/en/reference/phar/ini.xml
diff -u phpdoc/en/reference/phar/ini.xml:1.4 
phpdoc/en/reference/phar/ini.xml:1.5
--- phpdoc/en/reference/phar/ini.xml:1.4Thu Aug  2 15:07:22 2007
+++ phpdoc/en/reference/phar/ini.xmlThu Aug 30 03:28:24 2007
@@ -1,5 +1,5 @@
 
-
+
 http://docbook.org/ns/docbook";>
  &reftitle.runtime;
  &extension.runtime;
@@ -101,14 +101,18 @@
 
 
  
-  Allows mappings from fixed name to 
path/to/archive.phar.
-  The format of the parameter is 
name=archive:name2=archive2.
+  Allows mappings from a full path to a phar archive or its alias to
+  the location of its extracted files.
+  The format of the parameter is 
name=archive,name2=archive2.
+  This allows extraction of phar files to disk, and allows phar to act as a
+  kind of mapper to extracted disk files.  This is often done for 
performance
+  reasons, or to assist with debugging a phar.
   
phar.extract_list usage example

 

Re: [PHP-DOC] Another typo in appendices/migration5.xml

2007-08-29 Thread Philip Olson


The line 441 in appendices/migration5.xml -- "database" should be  
changed to "database server".
Otherwise the description of "ibase_server_info" is the same as of  
"ibase_db_info" (line 377).


Hello Simion,

Your karma has been updated, in the future feel free to fix the  
phpdoc (en) module as you see fit. Keep up the good work! :)


Regards,
Philip


Re: [PHP-DOC] #42387 [Opn]: Error notification callback not called. ASSISTANCE SOUGHT PLEASE!!!

2007-08-29 Thread Philip Olson


On Aug 29, 2007, at 9:36 AM, Franciuos K S X wrote:


Hello there,
Well i signed up to the mailing list having in mind i would pick
anything as far as php is concerned because am just trying to try to
learn php. It is on this not therefore that i request any one out
there to help me introduce to php, any links that are helpful to
beginners etc and any other kind of help.
Hear from u soon,
Franciuos.


Hello Franciuos,

I'm unsure what to say except this is the wrong mailing list (we work  
on the PHP manual itself) but check out the following resources:


  http://php.net/links
  http://php.net/support
  http://php.net/tutorial

As for a mailing list, it sounds like you may be looking for php- 
general@ instead of [EMAIL PROTECTED]


Regards,
Philip


Re: [PHP-DOC] EN-Revision comments Vs Docbook revision attributes

2007-08-29 Thread Philip Olson


On Aug 18, 2007, at 8:42 AM, Fernando Correa da Conceição wrote:


Hannes Magnusson escreveu:

Hello all

Was there any specific reason why this "EN-Revision" comment magic  
was

chosen over the Docbook revision attribute?


If there's a better way then let's do it... please propose exactly  
how it'd work and what it would look like. We'd also need to adjust  
all the translation scripts within docweb (and scripts/) before/while  
implementing.


Regards,
Philip


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

2007-08-29 Thread Philip Olson


On Aug 28, 2007, at 1:58 AM, Jakub Vrana wrote:


M. Sokolewicz wrote:

A lot of people might not know the info is there, but instead of
removing it entirely I would suggest using an option to enable/ 
disable

it. The skeleton created should still be obvious to people who do not
know much (if anything) about the way php-doc is made. So IMO it's  
not

obvious to everyone that the description of that paremeter should go
into that  section. Adding a switch (defaulting to  
off if

you wish) would make it easier to create one with extra "debug" info
which is useful to write the actual documentation. If people just  
want a
raw skeleton, with _no_ additional manual editing involved, they  
should

run it with a different flag/option/switch.


What about just put it inside a comment?

 " \n" .
 "  \n" .
+"   \n" .
 "  \n" .
 " \n" .


I feel people know what goes there, and don't find it nice to delete  
the phrase so many times. And when writing documentation people  
typically (should) go by the skeletons in the HOWTO or Wiki (which do  
contain the additional information) or use currently written  
documentation. Either way, I don't see cause for confusion and  
instead find people committing it as is, or being annoyed by having  
to delete it. After documenting one parameter, a person should know  
what goes there.


I don't mind creating an xml_proto switch to allow it but would like  
to see it default to off. Feel free to create this and if done please  
apply it to the other sections too (like examples). The comment idea  
is okay, but I prefer not.


Regards,
Philip


Re: [PHP-DOC] #42387 [Opn]: Error notification callback not called. ASSISTANCE SOUGHT PLEASE!!!

2007-08-29 Thread Franciuos K S X
Hello there,
Well i signed up to the mailing list having in mind i would pick
anything as far as php is concerned because am just trying to try to
learn php. It is on this not therefore that i request any one out
there to help me introduce to php, any links that are helpful to
beginners etc and any other kind of help.
Hear from u soon,
Franciuos.

On 8/23/07, [EMAIL PROTECTED] <[EMAIL PROTECTED]> wrote:
>  ID:   42387
>  Updated by:   [EMAIL PROTECTED]
>  Reported By:  chad at herballure dot com
>  Status:   Open
> -Bug Type: Streams related
> +Bug Type: Documentation problem
>  Operating System: Linux
>  PHP Version:  5.2.4RC2
>  New Comment:
>
> It's not an error callback, it's notification callback.
> Try this and you'll see what it actually does:
>
> 
> function stream_err()
> {
>   $args = func_get_args();
>   var_dump($args);
> }
>
> $ctx =
> stream_context_create(array('http'=>array('method'=>"GET",'header'=>"Accept-language:
> en\r\nCookie: foo=bar\r\n")));
> $ret = stream_context_set_params($ctx,
> array('notification'=>'stream_err'));
> $fp = fopen('http://www.example.com', 'r', false, $ctx);
>
> ?>
>
> The streams documentation really needs some loving care.. :)
>
>
> Previous Comments:
> 
>
> [2007-08-22 18:34:48] chad at herballure dot com
>
> Description:
> 
> The streams API doesn't appear to actually call the error callback.
> This is definitely true if the connection fails, or if the expected
> hostname doesn't match the SSL certificate. In the latter case, there is
> no reliable way of detecting the error.
>
> The reproduce code is a cut-down version of a test script being run
> through the CLI, while I figure out the streams API. I get the same
> behavior from 5.2.3 and 5.2.4RC2.
>
> Reproduce code:
> ---
> 
> $HOST_NAME = 'secureservicesonline.com';
> $CA_DIR = '/etc/ssl/certs'; // change this if needed
>
> function stream_err() {
>   $args = func_get_args();
>   echo("[stream_err, args=");
>   print_r($args); // which are undocumented, btw
>   echo("]\n");
> }
>
> $ctx = stream_context_create(array('ssl'=>array('verify_peer' => true,
> 'CN_match' => "$HOST_NAME.invalid", 'capath'=>$CA_DIR)));
> $ret = stream_context_set_params($ctx,
> array('notification'=>'stream_err'));
>
> var_dump($ret);
>
> $errno = $errstr = null;
> $fp = stream_socket_client("ssl://$HOST_NAME:443", $errno, $errstr, 30,
> STREAM_CLIENT_CONNECT, $ctx);
>
> var_dump($errno);
> var_dump($errstr);
>
> if( $fp !== false ) {
>   fclose($fp);
> }
>
> ?>
>
> Expected result:
> 
> [stream_err, args=Array ( .. )]
>
> Actual result:
> --
> PHP Warning:  stream_socket_client(): Peer certificate
> CN=`secureservicesonline.com' did not match expected
> CN=`secureservicesonline.com.invalid' in /.../https_client.php on line
> 52
>
> Warning: stream_socket_client(): Peer certificate
> CN=`secureservicesonline.com' did not match expected
> CN=`secureservicesonline.com.invalid' in /.../https_client.php on line
> 52
>
>
>
> 
>
>
> --
> Edit this bug report at http://bugs.php.net/?id=42387&edit=1
>


-- 
sfx


[PHP-DOC] cvs: phpdoc / funcindex.xml

2007-08-29 Thread Richard Quadling
rquadling   Wed Aug 29 13:17:57 2007 UTC

  Modified files:  
/phpdoc funcindex.xml 
  Log:
  New funcs
  
  
http://cvs.php.net/viewvc.cgi/phpdoc/funcindex.xml?r1=1.30&r2=1.31&diff_format=u
Index: phpdoc/funcindex.xml
diff -u phpdoc/funcindex.xml:1.30 phpdoc/funcindex.xml:1.31
--- phpdoc/funcindex.xml:1.30   Thu Aug 23 12:19:22 2007
+++ phpdoc/funcindex.xmlWed Aug 29 13:17:57 2007
@@ -1063,6 +1063,9 @@

geoip_country_code_by_name

geoip_country_name_by_name

geoip_database_info
+   
geoip_db_avail
+   
geoip_db_filename
+   
geoip_db_get_all_info

geoip_id_by_name

geoip_org_by_name

geoip_record_by_name


[PHP-DOC] cvs: phpdoc / quickref.txt

2007-08-29 Thread Richard Quadling
rquadling   Wed Aug 29 13:16:58 2007 UTC

  Modified files:  
/phpdoc quickref.txt 
  Log:
  Typo + new funcs
  
  
http://cvs.php.net/viewvc.cgi/phpdoc/quickref.txt?r1=1.22&r2=1.23&diff_format=u
Index: phpdoc/quickref.txt
diff -u phpdoc/quickref.txt:1.22 phpdoc/quickref.txt:1.23
--- phpdoc/quickref.txt:1.22Thu Aug 23 12:15:28 2007
+++ phpdoc/quickref.txt Wed Aug 29 13:16:57 2007
@@ -1033,6 +1033,9 @@
 geoip_country_code_by_name - Get the two letter country code
 geoip_country_name_by_name - Get the full country name
 geoip_database_info - Get GeoIP Database information
+geoip_db_avail - Determine if GeoIP Database is available
+geoip_db_filename - Returns the filename of the corresponding GeoIP Database
+geoip_db_get_all_info - Returns detailed informations about all GeoIP database 
types
 geoip_id_by_name - Get the Internet connection speed
 geoip_org_by_name - Get the organization name
 geoip_record_by_name - Returns the detailed City information found in the 
GeoIP Database
@@ -2246,7 +2249,7 @@
 ImagickDraw::setFillOpacity - Sets the opacity to use when drawing using the 
fill color or fill texture
 ImagickDraw::setFillPatternURL - Sets the URL to use as a fill pattern for 
filling objects
 ImagickDraw::setFillRule - Sets the fill rule to use while drawing polygons
-ImagickDraw::setFont - Sets the fully-sepecified font to use when annotating 
with text
+ImagickDraw::setFont - Sets the fully-specified font to use when annotating 
with text
 ImagickDraw::setFontFamily - Sets the font family to use when annotating with 
text
 ImagickDraw::setFontSize - Sets the font pointsize to use when annotating with 
text
 ImagickDraw::setFontStretch - Sets the font stretch to use when annotating 
with text


[PHP-DOC] Re: Another typo in appendices/migration5.xml

2007-08-29 Thread Richard Quadling
Done

On 29/08/2007, Simion Onea <[EMAIL PROTECTED]> wrote:
> Hi!
>
> The line 441 in appendices/migration5.xml -- "database" should be changed to 
> "database server".
> Otherwise the description of "ibase_server_info" is the same as of 
> "ibase_db_info" (line 377).
>
> Regards,
> Simion.
>
>


-- 
-
Richard Quadling
Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731
"Standing on the shoulders of some very clever giants!"


[PHP-DOC] cvs: phpdoc /en/appendices migration5.xml

2007-08-29 Thread Richard Quadling
rquadling   Wed Aug 29 07:36:52 2007 UTC

  Modified files:  
/phpdoc/en/appendices   migration5.xml 
  Log:
  Update ibase_server_info : Thanks Simion Onea
  
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/appendices/migration5.xml?r1=1.55&r2=1.56&diff_format=u
Index: phpdoc/en/appendices/migration5.xml
diff -u phpdoc/en/appendices/migration5.xml:1.55 
phpdoc/en/appendices/migration5.xml:1.56
--- phpdoc/en/appendices/migration5.xml:1.55Tue Aug 28 08:11:21 2007
+++ phpdoc/en/appendices/migration5.xml Wed Aug 29 07:36:52 2007
@@ -1,5 +1,5 @@
 
-
+
  http://docbook.org/ns/docbook"; 
xmlns:xlink="http://www.w3.org/1999/xlink";>
   Migrating from PHP 4 to PHP 5
 
@@ -438,7 +438,7 @@
 
  
   ibase_server_info - Request statistics about a
-  database
+  database server
  
 
 


[PHP-DOC] Another typo in appendices/migration5.xml

2007-08-29 Thread Simion Onea
Hi!

The line 441 in appendices/migration5.xml -- "database" should be changed to 
"database server".
Otherwise the description of "ibase_server_info" is the same as of 
"ibase_db_info" (line 377).

Regards,
Simion.