[PHP-DOC] cvs: phpdoc /en/reference/info/functions php-logo-guid.xml
vrana Sun Jul 3 02:25:03 2005 EDT Modified files: /phpdoc/en/reference/info/functions php-logo-guid.xml Log: Works only with expose_php http://cvs.php.net/diff.php/phpdoc/en/reference/info/functions/php-logo-guid.xml?r1=1.7r2=1.8ty=u Index: phpdoc/en/reference/info/functions/php-logo-guid.xml diff -u phpdoc/en/reference/info/functions/php-logo-guid.xml:1.7 phpdoc/en/reference/info/functions/php-logo-guid.xml:1.8 --- phpdoc/en/reference/info/functions/php-logo-guid.xml:1.7Fri Oct 10 07:26:15 2003 +++ phpdoc/en/reference/info/functions/php-logo-guid.xmlSun Jul 3 02:25:02 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.7 $ -- +!-- $Revision: 1.8 $ -- !-- splitted from ./en/functions/info.xml, last change in rev 1.3 -- refentry id=function.php-logo-guid refnamediv @@ -15,6 +15,8 @@ para This function returns the ID which can be used to display the PHP logo using the built-in image. + Logo is displayed only if link linkend=ini.expose-phpexpose_php/link + is On. /para para example
[PHP-DOC] cvs: phpdoc /en/reference/pgsql/functions pg-delete.xml pg-escape-bytea.xml pg-escape-string.xml pg-free-result.xml pg-get-notify.xml pg-get-pid.xml pg-insert.xml pg-update.xml
chriskl Sun Jul 3 06:03:51 2005 EDT Modified files: /phpdoc/en/reference/pgsql/functionspg-delete.xml pg-escape-bytea.xml pg-escape-string.xml pg-free-result.xml pg-get-notify.xml pg-get-pid.xml pg-insert.xml pg-update.xml Log: Convert several more pgsql extension doc pages to the new format. http://cvs.php.net/diff.php/phpdoc/en/reference/pgsql/functions/pg-delete.xml?r1=1.14r2=1.15ty=u Index: phpdoc/en/reference/pgsql/functions/pg-delete.xml diff -u phpdoc/en/reference/pgsql/functions/pg-delete.xml:1.14 phpdoc/en/reference/pgsql/functions/pg-delete.xml:1.15 --- phpdoc/en/reference/pgsql/functions/pg-delete.xml:1.14 Fri Jun 24 05:11:45 2005 +++ phpdoc/en/reference/pgsql/functions/pg-delete.xml Sun Jul 3 06:03:51 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.14 $ -- +!-- $Revision: 1.15 $ -- !-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 -- refentry id='function.pg-delete' refnamediv @@ -19,17 +19,66 @@ methodparam choice=opttypeint/typeparameteroptions/parameter/methodparam /methodsynopsis para - functionpg_delete/function deletes record condition specified by - parameterassoc_array/parameter which has - literalfield=value/literal. If parameteroptions/parameter is + functionpg_delete/function deletes records from a table specified by + the keys and values in parameterassoc_array/parameter. If parameteroptions/parameter is specified, functionpg_convert/function is applied - to parameterassoc_array/parameter with specified option. - return.success; - If constantPGSQL_DML_STRING/constant is part of the - parameteroptions/parameter then query string is returned. + to parameterassoc_array/parameter with the specified options. /para /refsect1 +refsect1 role=parameters + reftitle.parameters; + para + variablelist +varlistentry + termparameterconnection/parameter/term + listitem + para + PostgreSQL database connection resource. + /para + /listitem +/varlistentry +varlistentry + termparametertable_name/parameter/term + listitem + para + Name of the table from which to delete rows. + /para + /listitem +/varlistentry +varlistentry + termparameterassoc_array/parameter/term + listitem + para + An typearray/type whose keys are field names in the table parametertable_name/parameter, + and whose values are the values of those fields that are to be deleted. + /para + /listitem +/varlistentry +varlistentry + termparameteroptions/parameter/term + listitem + para + Any number of constantPGSQL_CONV_FORCE_NULL/constant, + constantPGSQL_DML_NO_CONV/constant, + constantPGSQL_DML_EXEC/constant or + constantPGSQL_DML_STRING/constant combined. If constantPGSQL_DML_STRING/constant is part of the + parameteroptions/parameter then query string is returned. + /para + /listitem +/varlistentry + /variablelist + /para + /refsect1 + + refsect1 role=returnvalues + reftitle.returnvalues; + para + return.success; Returns typestring/type if constantPGSQL_DML_STRING/constant is passed + via parameteroptions/parameter. + /para + /refsect1 + refsect1 role=examples reftitle.examples; para http://cvs.php.net/diff.php/phpdoc/en/reference/pgsql/functions/pg-escape-bytea.xml?r1=1.7r2=1.8ty=u Index: phpdoc/en/reference/pgsql/functions/pg-escape-bytea.xml diff -u phpdoc/en/reference/pgsql/functions/pg-escape-bytea.xml:1.7 phpdoc/en/reference/pgsql/functions/pg-escape-bytea.xml:1.8 --- phpdoc/en/reference/pgsql/functions/pg-escape-bytea.xml:1.7 Fri Mar 11 11:03:25 2005 +++ phpdoc/en/reference/pgsql/functions/pg-escape-bytea.xml Sun Jul 3 06:03:51 2005 @@ -1,11 +1,11 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.7 $ -- +!-- $Revision: 1.8 $ -- !-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 -- refentry id='function.pg-escape-bytea' refnamediv refnamepg_escape_bytea/refname refpurpose - Escape binary for bytea type + Escape a string for insertion into a bytea field /refpurpose /refnamediv @@ -21,22 +21,72 @@ /para note para -When you SELECT bytea type, PostgreSQL returns octal byte value -prefixed by \ (e.g. \032). Users are supposed to convert back to -binary format by yourself. +When you literalSELECT/select a bytea type, PostgreSQL returns octal byte values +prefixed with '\' (e.g. \032). Users are supposed to convert back to +binary format manually. /para para This function requires PostgreSQL 7.2 or
[PHP-DOC] Notes Status, 11921 total
Following are the top 20 pages of the manual, sorted by the number of user notes contributed. These sections could use a polish, those notes represent 8.9% of the 11921 total user notes. Notes | Page ---+- 73 | http://php.net/manual/en/function.header.php 66 | http://php.net/manual/en/function.date.php 62 | http://php.net/manual/en/function.preg-replace.php 59 | http://php.net/manual/en/function.mssql-connect.php 59 | http://php.net/manual/en/ref.session.php 57 | http://php.net/manual/en/ref.com.php 54 | http://php.net/manual/en/function.time.php 53 | http://php.net/manual/en/function.mktime.php 52 | http://php.net/manual/en/function.strtotime.php 51 | http://php.net/manual/en/function.fsockopen.php 50 | http://php.net/manual/en/ref.xml.php 49 | http://php.net/manual/en/function.sort.php 49 | http://php.net/manual/en/function.readdir.php 48 | http://php.net/manual/en/ref.image.php 48 | http://php.net/manual/en/ref.datetime.php 48 | http://php.net/manual/en/function.fopen.php 48 | http://php.net/manual/en/features.file-upload.php 47 | http://php.net/manual/en/function.str-replace.php 45 | http://php.net/manual/en/function.strftime.php 45 | http://php.net/manual/en/function.eregi.php
[PHP-DOC] cvs: phpdoc /en/reference/pgsql/functions pg-get-notify.xml
yannick Sun Jul 3 08:27:10 2005 EDT Modified files: /phpdoc/en/reference/pgsql/functionspg-get-notify.xml Log: fix build http://cvs.php.net/diff.php/phpdoc/en/reference/pgsql/functions/pg-get-notify.xml?r1=1.12r2=1.13ty=u Index: phpdoc/en/reference/pgsql/functions/pg-get-notify.xml diff -u phpdoc/en/reference/pgsql/functions/pg-get-notify.xml:1.12 phpdoc/en/reference/pgsql/functions/pg-get-notify.xml:1.13 --- phpdoc/en/reference/pgsql/functions/pg-get-notify.xml:1.12 Sun Jul 3 06:03:51 2005 +++ phpdoc/en/reference/pgsql/functions/pg-get-notify.xml Sun Jul 3 08:27:09 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.12 $ -- +!-- $Revision: 1.13 $ -- refentry id=function.pg-get-notify refnamediv refnamepg_get_notify/refname @@ -58,7 +58,7 @@ reftitle.returnvalues; para An typearray/type containing the literalNOTIFY/literal message name and backend PID. - Otherwise if no /literalNOTIFY/literal is waiting, then false; is returned. + Otherwise if no literalNOTIFY/literal is waiting, then false; is returned. /para /refsect1
[PHP-DOC] cvs: phpdoc /en/reference/pgsql/functions pg-get-pid.xml
chriskl Sun Jul 3 10:58:29 2005 EDT Modified files: /phpdoc/en/reference/pgsql/functionspg-get-pid.xml Log: Tiny mistake in whitespace. http://cvs.php.net/diff.php/phpdoc/en/reference/pgsql/functions/pg-get-pid.xml?r1=1.6r2=1.7ty=u Index: phpdoc/en/reference/pgsql/functions/pg-get-pid.xml diff -u phpdoc/en/reference/pgsql/functions/pg-get-pid.xml:1.6 phpdoc/en/reference/pgsql/functions/pg-get-pid.xml:1.7 --- phpdoc/en/reference/pgsql/functions/pg-get-pid.xml:1.6 Sun Jul 3 06:03:51 2005 +++ phpdoc/en/reference/pgsql/functions/pg-get-pid.xml Sun Jul 3 10:58:28 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.6 $ -- +!-- $Revision: 1.7 $ -- refentry id=function.pg-get-pid refnamediv refnamepg_get_pid/refname @@ -20,7 +20,7 @@ /para /refsect1 -refsect1 role=parameters + refsect1 role=parameters reftitle.parameters; para variablelist
[PHP-DOC] cvs: phpdoc /en/reference/pgsql/functions pg-get-result.xml
chriskl Sun Jul 3 10:59:22 2005 EDT
Modified files:
/phpdoc/en/reference/pgsql/functionspg-get-result.xml
Log:
New doc style for pg_get_result()
http://cvs.php.net/diff.php/phpdoc/en/reference/pgsql/functions/pg-get-result.xml?r1=1.4r2=1.5ty=u
Index: phpdoc/en/reference/pgsql/functions/pg-get-result.xml
diff -u phpdoc/en/reference/pgsql/functions/pg-get-result.xml:1.4
phpdoc/en/reference/pgsql/functions/pg-get-result.xml:1.5
--- phpdoc/en/reference/pgsql/functions/pg-get-result.xml:1.4 Fri Mar 11
11:03:25 2005
+++ phpdoc/en/reference/pgsql/functions/pg-get-result.xml Sun Jul 3
10:59:21 2005
@@ -1,5 +1,5 @@
?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.4 $ --
+!-- $Revision: 1.5 $ --
!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.58 --
refentry id='function.pg-get-result'
refnamediv
@@ -16,13 +16,88 @@
methodparam
choice=opttyperesource/typeparameterconnection/parameter/methodparam
/methodsynopsis
para
- functionpg_get_result/function get result resource from async
- query executed by
- functionpg_send_query/function. functionpg_send_query/function
- can send multiple queries to PostgreSQL server and
- functionpg_get_result/function is used to get query result
- one by one. It returns result resource. If there is no more
- results, it returns false;.
+ functionpg_get_result/function gets the result resource from
+ an asynchronous query executed by
+ functionpg_send_query/function,
functionpg_send_query_params/function or
+ functionpg_send_execute/function.
+ /para
+ parafunctionpg_send_query/function and the
+ other asynchronous query functions
+ can send multiple queries to a PostgreSQL server and
+ functionpg_get_result/function is used to get each query's results,
+ one by one.
+ /para
+ /refsect1
+
+ refsect1 role=parameters
+ reftitle.parameters;
+ para
+ variablelist
+varlistentry
+ termparameterconnection/parameter/term
+ listitem
+ para
+ PostgreSQL database connection resource.
+ /para
+ /listitem
+/varlistentry
+ /variablelist
+ /para
+ /refsect1
+
+ refsect1 role=returnvalues
+ reftitle.returnvalues;
+ para
+ The result typeresource/type, or false; if no more results are
available.
+ /para
+ /refsect1
+
+ refsect1 role=examples
+ reftitle.examples;
+ para
+ example
+titlefunctionpg_get_result/function example/title
+programlisting role=php
+![CDATA[
+?php
+ $dbconn = pg_connect(dbname=publisher) or die(Could not connect);
+
+ if (!pg_connection_busy($dbconn)) {
+ pg_send_query($dbconn, select * from authors; select count(*) from
authors;);
+ }
+
+ $res1 = pg_get_result($dbconn);
+ echo First call to pg_get_result(): $res1\n;
+ $rows1 = pg_num_rows($res1);
+ echo $res1 has $rows1 records\n\n;
+
+ $res2 = pg_get_result($dbconn);
+ echo second call to pg_get_result(): $res2\n;
+ $rows2 = pg_num_rows($res2);
+ echo $res2 has $rows2 records\n;
+?
+]]
+/programlisting
+example.outputs;
+screen
+![CDATA[
+first call to pg_get_result(): Resource id #3
+Resource id #3 has 3 records
+
+second call to pg_get_result(): Resource id #4
+Resource id #4 has 1 records
+]]
+/screen
+ /example
+ /para
+ /refsect1
+
+ refsect1 role=seealso
+ reftitle.seealso;
+ para
+ simplelist
+memberfunctionpg_send_query/function/member
+ /simplelist
/para
/refsect1
/refentry
[PHP-DOC] #33553 [Opn]: get_html_translation_table() ambiguous
ID: 33553
Updated by: [EMAIL PROTECTED]
Reported By: [EMAIL PROTECTED]
Status: Open
-Bug Type: Unknown/Other Function
+Bug Type: Documentation problem
Operating System: Linux
PHP Version: 4.3.10
New Comment:
You surely mean slash here, and not ampersand? Anyway, this is not a
PHP bug but a documentation issue.
Previous Comments:
[2005-07-03 17:09:54] [EMAIL PROTECTED]
Description:
get_html_translation_table() returns an array with two keys having
value ' (the ampersand). When array_flip()-ed, as suggested by the
manual, the second one overwrites the first, thus giving a reverse
table with only one ampersand key. Using this reverse table to convert
back a string is not possible, since the original table had the other
representation of the ampersand first, and used that for translation.
See http://lxr.php.net/source/php-src/ext/standard/html.c#466
Note that if this is not deemed to be a PHP bug, then this
irreversibility issue should be documented.
Reproduce code:
---
var_dump(htmlspecialchars(', ENT_QUOTES));
var_dump(get_html_translation_table(HTML_SPECIALCHARS, ENT_QUOTES));
var_dump(array_flip(get_html_translation_table(HTML_SPECIALCHARS,
ENT_QUOTES)));
Expected result:
No ambigous array elements in the translation table.
Actual result:
--
Two entries for the ampersand.
--
Edit this bug report at http://bugs.php.net/?id=33553edit=1
[PHP-DOC] #33553 [Opn]: get_html_translation_table() ambiguous
ID: 33553
Updated by: [EMAIL PROTECTED]
Reported By: [EMAIL PROTECTED]
Status: Open
Bug Type: Documentation problem
Operating System: Linux
PHP Version: 4.3.10
New Comment:
Sorry, I mean single quote, as it is evidenced by the lxr link I
provided.
Previous Comments:
[2005-07-03 17:15:31] [EMAIL PROTECTED]
You surely mean slash here, and not ampersand? Anyway, this is not a
PHP bug but a documentation issue.
[2005-07-03 17:09:54] [EMAIL PROTECTED]
Description:
get_html_translation_table() returns an array with two keys having
value ' (the ampersand). When array_flip()-ed, as suggested by the
manual, the second one overwrites the first, thus giving a reverse
table with only one ampersand key. Using this reverse table to convert
back a string is not possible, since the original table had the other
representation of the ampersand first, and used that for translation.
See http://lxr.php.net/source/php-src/ext/standard/html.c#466
Note that if this is not deemed to be a PHP bug, then this
irreversibility issue should be documented.
Reproduce code:
---
var_dump(htmlspecialchars(', ENT_QUOTES));
var_dump(get_html_translation_table(HTML_SPECIALCHARS, ENT_QUOTES));
var_dump(array_flip(get_html_translation_table(HTML_SPECIALCHARS,
ENT_QUOTES)));
Expected result:
No ambigous array elements in the translation table.
Actual result:
--
Two entries for the ampersand.
--
Edit this bug report at http://bugs.php.net/?id=33553edit=1
Re: [PHP-DOC] Livedocs -- Pre-Built!
http://www.phpdoc.info/livedocs/built/ It's built nightly. I know today's (20050621) works well. Recent builds have 46 bytes - brilliant shrink but I'm afraid something is missing inside ;-). Not sure what that's all about, but I'll look into it once I'm out from under my pile of email. (I just moved, and my stupid stupid telco can't even switch lines properly..) S
[PHP-DOC] #33549 [Opn-Ver]: Wrong result with bcmul()
ID: 33549 Updated by: [EMAIL PROTECTED] Reported By: a dot schilder at gmx dot de -Status: Open +Status: Verified -Bug Type: BC math related +Bug Type: Documentation problem Operating System: Win XP SP2 PHP Version: 5.0.4 New Comment: If you pass the numbers as strings (as expected, although the manual has it wrong in the example), this works fine: bcmul(1, 0.1, 5); Reclassified as documentation issue. (the bad examples in bcmath section) Previous Comments: [2005-07-02 18:03:12] a dot schilder at gmx dot de Description: The result returned by bcmul() with the factor X (greater than 0) and 0.1 is 0 - it's not the expected result. Reproduce code: --- // Does not work - result is 0: bcmul(1, 0.1, 5); // This workaround does it - result 0.1: bcdiv(bcmul(1, 0.00010, 5), 10, 5); Expected result: The correct result 0.1 Actual result: -- 0 -- Edit this bug report at http://bugs.php.net/?id=33549edit=1
[PHP-DOC] cvs: phpdoc /en/reference/pgsql/functions pg-escape-bytea.xml
chriskl Sun Jul 3 23:29:33 2005 EDT Modified files: /phpdoc/en/reference/pgsql/functionspg-escape-bytea.xml Log: Sorry, fix build. http://cvs.php.net/diff.php/phpdoc/en/reference/pgsql/functions/pg-escape-bytea.xml?r1=1.8r2=1.9ty=u Index: phpdoc/en/reference/pgsql/functions/pg-escape-bytea.xml diff -u phpdoc/en/reference/pgsql/functions/pg-escape-bytea.xml:1.8 phpdoc/en/reference/pgsql/functions/pg-escape-bytea.xml:1.9 --- phpdoc/en/reference/pgsql/functions/pg-escape-bytea.xml:1.8 Sun Jul 3 06:03:51 2005 +++ phpdoc/en/reference/pgsql/functions/pg-escape-bytea.xml Sun Jul 3 23:29:33 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.8 $ -- +!-- $Revision: 1.9 $ -- !-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 -- refentry id='function.pg-escape-bytea' refnamediv @@ -21,7 +21,7 @@ /para note para -When you literalSELECT/select a bytea type, PostgreSQL returns octal byte values +When you literalSELECT/literal a bytea type, PostgreSQL returns octal byte values prefixed with '\' (e.g. \032). Users are supposed to convert back to binary format manually. /para
[PHP-DOC] cvs: phpdoc /en/reference/ps/functions ps-add-pdflink.xml
jsgoupilMon Jul 4 00:14:35 2005 EDT Modified files: /phpdoc/en/reference/ps/functions ps-add-pdflink.xml Log: typo: adding space after dot http://cvs.php.net/diff.php/phpdoc/en/reference/ps/functions/ps-add-pdflink.xml?r1=1.1r2=1.2ty=u Index: phpdoc/en/reference/ps/functions/ps-add-pdflink.xml diff -u phpdoc/en/reference/ps/functions/ps-add-pdflink.xml:1.1 phpdoc/en/reference/ps/functions/ps-add-pdflink.xml:1.2 --- phpdoc/en/reference/ps/functions/ps-add-pdflink.xml:1.1 Wed Jun 22 09:21:21 2005 +++ phpdoc/en/reference/ps/functions/ps-add-pdflink.xml Mon Jul 4 00:14:33 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.1 $ -- +!-- $Revision: 1.2 $ -- !-- splitted from ./en/functions/ps.xml, last change in rev 1.12 -- refentry id=function.ps-add-pdflink refnamediv @@ -22,7 +22,7 @@ /methodsynopsis para Places a hyperlink at the given position pointing to a second pdf document. - Clicking on the link will branch to the document at the given page.The + Clicking on the link will branch to the document at the given page. The first page in a document has number 1. /para para
[PHP-DOC] cvs: phpdoc /en/reference/ps/functions ps-arc.xml ps-arcn.xml
jsgoupilMon Jul 4 00:24:26 2005 EDT Modified files: /phpdoc/en/reference/ps/functions ps-arcn.xml ps-arc.xml Log: verb tense http://cvs.php.net/diff.php/phpdoc/en/reference/ps/functions/ps-arcn.xml?r1=1.1r2=1.2ty=u Index: phpdoc/en/reference/ps/functions/ps-arcn.xml diff -u phpdoc/en/reference/ps/functions/ps-arcn.xml:1.1 phpdoc/en/reference/ps/functions/ps-arcn.xml:1.2 --- phpdoc/en/reference/ps/functions/ps-arcn.xml:1.1Wed Jun 22 09:21:21 2005 +++ phpdoc/en/reference/ps/functions/ps-arcn.xmlMon Jul 4 00:24:25 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.1 $ -- +!-- $Revision: 1.2 $ -- !-- splitted from ./en/functions/ps.xml, last change in rev 1.12 -- refentry id=function.ps-arcn refnamediv @@ -22,7 +22,7 @@ Draws a portion of a circle with at middle point at (parameterx/parameter, parametery/parameter). The arc starts at an angle of parameteralpha/parameter and ends at an angle of - parameterbeta/parameter. It is draws clockwise. The subpath added to + parameterbeta/parameter. It is drawn clockwise. The subpath added to the current path starts on the arc at angle parameterbeta/parameter and ends on the arc at angle parameteralpha/parameter. /para http://cvs.php.net/diff.php/phpdoc/en/reference/ps/functions/ps-arc.xml?r1=1.1r2=1.2ty=u Index: phpdoc/en/reference/ps/functions/ps-arc.xml diff -u phpdoc/en/reference/ps/functions/ps-arc.xml:1.1 phpdoc/en/reference/ps/functions/ps-arc.xml:1.2 --- phpdoc/en/reference/ps/functions/ps-arc.xml:1.1 Wed Jun 22 09:21:21 2005 +++ phpdoc/en/reference/ps/functions/ps-arc.xml Mon Jul 4 00:24:25 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.1 $ -- +!-- $Revision: 1.2 $ -- !-- splitted from ./en/functions/ps.xml, last change in rev 1.12 -- refentry id=function.ps-arc refnamediv @@ -22,7 +22,7 @@ Draws a portion of a circle with at middle point at (parameterx/parameter, parametery/parameter). The arc starts at an angle of parameteralpha/parameter and ends at an angle of - parameterbeta/parameter. It is draw counterclockwise. The subpath added + parameterbeta/parameter. It is drawn counterclockwise. The subpath added to the current path starts on the arc at angle parameteralpha/parameter and ends on the arc at angle parameterbeta/parameter. /para
[PHP-DOC] cvs: phpdoc /en/reference/pgsql/functions pg-get-notify.xml pg-last-error.xml pg-last-notice.xml pg-last-oid.xml
chriskl Mon Jul 4 00:44:22 2005 EDT
Modified files:
/phpdoc/en/reference/pgsql/functionspg-get-notify.xml
pg-last-error.xml
pg-last-notice.xml
pg-last-oid.xml
Log:
Convert several more pgsql doc pages to the new format.
http://cvs.php.net/diff.php/phpdoc/en/reference/pgsql/functions/pg-get-notify.xml?r1=1.13r2=1.14ty=u
Index: phpdoc/en/reference/pgsql/functions/pg-get-notify.xml
diff -u phpdoc/en/reference/pgsql/functions/pg-get-notify.xml:1.13
phpdoc/en/reference/pgsql/functions/pg-get-notify.xml:1.14
--- phpdoc/en/reference/pgsql/functions/pg-get-notify.xml:1.13 Sun Jul 3
08:27:09 2005
+++ phpdoc/en/reference/pgsql/functions/pg-get-notify.xml Mon Jul 4
00:44:21 2005
@@ -1,5 +1,5 @@
?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.13 $ --
+!-- $Revision: 1.14 $ --
refentry id=function.pg-get-notify
refnamediv
refnamepg_get_notify/refname
@@ -21,7 +21,7 @@
/para
/refsect1
-refsect1 role=parameters
+ refsect1 role=parameters
reftitle.parameters;
para
variablelist
http://cvs.php.net/diff.php/phpdoc/en/reference/pgsql/functions/pg-last-error.xml?r1=1.7r2=1.8ty=u
Index: phpdoc/en/reference/pgsql/functions/pg-last-error.xml
diff -u phpdoc/en/reference/pgsql/functions/pg-last-error.xml:1.7
phpdoc/en/reference/pgsql/functions/pg-last-error.xml:1.8
--- phpdoc/en/reference/pgsql/functions/pg-last-error.xml:1.7 Thu Apr 21
05:29:05 2005
+++ phpdoc/en/reference/pgsql/functions/pg-last-error.xml Mon Jul 4
00:44:21 2005
@@ -1,5 +1,5 @@
?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.7 $ --
+!-- $Revision: 1.8 $ --
!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 --
refentry id=function.pg-last-error
refnamediv
@@ -15,15 +15,15 @@
/methodsynopsis
para
functionpg_last_error/function returns the last error message
- for given parameterconnection/parameter.
+ for a given parameterconnection/parameter.
/para
para
- Error messages may be overwritten by internal PostgreSQL(libpq)
- function calls. It may not return appropriate error message, if
- multiple errors are occurred inside a PostgreSQL module function.
+ Error messages may be overwritten by internal PostgreSQL (libpq)
+ function calls. It may not return an appropriate error message if
+ multiple errors occur inside a PostgreSQL module function.
/para
para
- Use functionpg_result_error/function,
+ Use functionpg_result_error/function,
functionpg_result_error_field/function,
functionpg_result_status/function and
functionpg_connection_status/function for better error handling.
/para
@@ -34,11 +34,62 @@
/note
/refsect1
+ refsect1 role=parameters
+ reftitle.parameters;
+ para
+ variablelist
+varlistentry
+ termparameterconnection/parameter/term
+ listitem
+ para
+ PostgreSQL database connection resource. When
+ parameterconnection/parameter is not present, the default
connection
+ is used. The default connection is the last connection made by
+ functionpg_connect/function or functionpg_pconnect/function.
+ /para
+ /listitem
+/varlistentry
+ /variablelist
+ /para
+ /refsect1
+
+ refsect1 role=returnvalues
+ reftitle.returnvalues;
+ para
+ A typestring/type containing the last error message on the
+ given parameterconnection/parameter, or false; on error.
+ /para
+ /refsect1
+
+ refsect1 role=examples
+ reftitle.examples;
+ para
+ example
+titlefunctionpg_last_error/function example/title
+programlisting role=php
+![CDATA[
+?php
+$pgsql_conn = pg_connect(dbname=mark host=localhost);
+
+if ($pgsql_conn) {
+ print Successfully connected to: . pg_host($pgsql_conn) . br/\n;
+} else {
+ print pg_last_error($pgsql_conn);
+ exit;
+}
+?
+]]
+/programlisting
+ /example
+ /para
+ /refsect1
+
refsect1 role=seealso
reftitle.seealso;
para
simplelist
memberfunctionpg_result_error/function/member
+memberfunctionpg_result_error_field/function/member
/simplelist
/para
/refsect1
http://cvs.php.net/diff.php/phpdoc/en/reference/pgsql/functions/pg-last-notice.xml?r1=1.5r2=1.6ty=u
Index: phpdoc/en/reference/pgsql/functions/pg-last-notice.xml
diff -u phpdoc/en/reference/pgsql/functions/pg-last-notice.xml:1.5
phpdoc/en/reference/pgsql/functions/pg-last-notice.xml:1.6
--- phpdoc/en/reference/pgsql/functions/pg-last-notice.xml:1.5 Fri Mar 11
11:03:25 2005
+++ phpdoc/en/reference/pgsql/functions/pg-last-notice.xml Mon Jul 4
00:44:21 2005
@@ -1,5 +1,5 @@
?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.5 $ --
+!-- $Revision: 1.6 $ --
!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 --
refentry id=function.pg-last-notice
refnamediv
@@ -17,12 +17,14 @@
/methodsynopsis
para
[PHP-DOC] cvs: phpdoc /en/reference/pgsql/functions pg-get-result.xml
jsgoupilMon Jul 4 00:50:59 2005 EDT Modified files: /phpdoc/en/reference/pgsql/functionspg-get-result.xml Log: program and screen didn't fit http://cvs.php.net/diff.php/phpdoc/en/reference/pgsql/functions/pg-get-result.xml?r1=1.5r2=1.6ty=u Index: phpdoc/en/reference/pgsql/functions/pg-get-result.xml diff -u phpdoc/en/reference/pgsql/functions/pg-get-result.xml:1.5 phpdoc/en/reference/pgsql/functions/pg-get-result.xml:1.6 --- phpdoc/en/reference/pgsql/functions/pg-get-result.xml:1.5 Sun Jul 3 10:59:21 2005 +++ phpdoc/en/reference/pgsql/functions/pg-get-result.xml Mon Jul 4 00:50:58 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.5 $ -- +!-- $Revision: 1.6 $ -- !-- splitted from ./en/functions/pgsql.xml, last change in rev 1.58 -- refentry id='function.pg-get-result' refnamediv @@ -72,7 +72,7 @@ echo $res1 has $rows1 records\n\n; $res2 = pg_get_result($dbconn); - echo second call to pg_get_result(): $res2\n; + echo Second call to pg_get_result(): $res2\n; $rows2 = pg_num_rows($res2); echo $res2 has $rows2 records\n; ? @@ -81,10 +81,10 @@ example.outputs; screen ![CDATA[ -first call to pg_get_result(): Resource id #3 +First call to pg_get_result(): Resource id #3 Resource id #3 has 3 records -second call to pg_get_result(): Resource id #4 +Second call to pg_get_result(): Resource id #4 Resource id #4 has 1 records ]] /screen
[PHP-DOC] cvs: phpdoc /en/reference/pgsql/functions pg-pconnect.xml pg-send-query.xml
chriskl Mon Jul 4 01:01:29 2005 EDT Modified files: /phpdoc/en/reference/pgsql/functionspg-pconnect.xml pg-send-query.xml Log: Document pg_pconnect. Make fix similar to jsgoupil's but in pg_send_query. http://cvs.php.net/diff.php/phpdoc/en/reference/pgsql/functions/pg-pconnect.xml?r1=1.7r2=1.8ty=u Index: phpdoc/en/reference/pgsql/functions/pg-pconnect.xml diff -u phpdoc/en/reference/pgsql/functions/pg-pconnect.xml:1.7 phpdoc/en/reference/pgsql/functions/pg-pconnect.xml:1.8 --- phpdoc/en/reference/pgsql/functions/pg-pconnect.xml:1.7 Fri Mar 11 11:03:26 2005 +++ phpdoc/en/reference/pgsql/functions/pg-pconnect.xml Mon Jul 4 01:01:28 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.7 $ -- +!-- $Revision: 1.8 $ -- !-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 -- refentry id=function.pg-pconnect refnamediv @@ -20,8 +20,11 @@ needed by other PostgreSQL functions. /para para - For a description of the parameterconnection_string/parameter - parameter, see functionpg_connect/function. + If a second call is made to functionpg_pconnect/function with + the same parameterconnection_string/parameter as an existing connection, the + existing connection will be returned unless you pass + constantPGSQL_CONNECT_FORCE_NEW/constant as + parameterconnect_type/parameter. /para para To enable persistent connection, the link @@ -40,6 +43,82 @@ /para /refsect1 + refsect1 role=parameters + reftitle.parameters; + para + variablelist +varlistentry + termparameterconnection_string/parameter/term + listitem + para + The parameterconnection_string/parameter can be empty to use all default parameters, or it + can contain one or more parameter settings separated by whitespace. + Each parameter setting is in the form literalkeyword = value/literal. Spaces around + the equal sign are optional. To write an empty value or a value + containing spaces, surround it with single quotes, e.g., literalkeyword = + 'a value'/literal. Single quotes and backslashes within the value must be + escaped with a backslash, i.e., \' and \\. + /para + para + The currently recognized parameter keywords are: + parameterhost/parameter, parameterhostaddr/parameter, parameterport/parameter, + parameterdbname/parameter, parameteruser/parameter, + parameterpassword/parameter, parameterconnect_timeout/parameter, + parameteroptions/parameter, parametertty/parameter (ignored), parametersslmode/parameter, + parameterrequiressl/parameter (deprecated in favor of parametersslmode/parameter), and + parameterservice/parameter. Which of these arguments exist depends + on your PostgreSQL version. + /para + /listitem +/varlistentry +varlistentry + termparameterconnect_type/parameter/term + listitem + para + If constantPGSQL_CONNECT_FORCE_NEW/constant is passed, then a new connection + is created, even if the parameterconnection_string/parameter is identical to + an existing connection. + /para + /listitem +/varlistentry + /variablelist + /para + /refsect1 + + refsect1 role=returnvalues + reftitle.returnvalues; + para + PostgreSQL connection resource on success, false; on failure. + /para + /refsect1 + + refsect1 role=examples + reftitle.examples; + para + example +titleUsing functionpg_pconnect/function/title +programlisting role=php +![CDATA[ +?php +$dbconn = pg_pconnect(dbname=mary); +//connect to a database named mary + +$dbconn2 = pg_pconnect(host=localhost port=5432 dbname=mary); +// connect to a database named mary on localhost at port 5432 + +$dbconn3 = pg_pconnect(host=sheep port=5432 dbname=mary user=lamb password=foo); +//connect to a database named mary on the host sheep with a username and password + +$conn_string = host=sheep port=5432 dbname=test user=lamb password=bar; +$dbconn4 = pg_pconnect($conn_string); +//connect to a database named test on the host sheep with a username and password +? +]] +/programlisting + /example + /para + /refsect1 + refsect1 role=seealso reftitle.seealso; para http://cvs.php.net/diff.php/phpdoc/en/reference/pgsql/functions/pg-send-query.xml?r1=1.11r2=1.12ty=u Index: phpdoc/en/reference/pgsql/functions/pg-send-query.xml diff -u phpdoc/en/reference/pgsql/functions/pg-send-query.xml:1.11 phpdoc/en/reference/pgsql/functions/pg-send-query.xml:1.12 --- phpdoc/en/reference/pgsql/functions/pg-send-query.xml:1.11 Mon Apr 4 21:47:56 2005 +++ phpdoc/en/reference/pgsql/functions/pg-send-query.xml Mon Jul 4 01:01:28 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.11 $ -- +!-- $Revision: 1.12 $ -- !-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -- refentry
