Re: cvs: phpdoc / manual.xml.in /en/reference/pdo reference.xml /en/reference/pdo/functions PDO-construct.xml
| From: | Dan Scott | Date: | Mon, 22 Nov 2004 15:18:58 +0000 |
| Subject: | Re: cvs: phpdoc / manual.xml.in /en/reference/pdo reference.xml /en/reference/pdo/functions PDO-construct.xml | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969365163@lists.php.net to get a copy of this message | ||
Hey Nuno:
The changes to the case of the <link> elements actually broke the
corresponding links in livedocs. :(
Do you anticipate a fix in the XSL to automatically lower-case the URL
for purely relative links (assuming we've agreed on a convention of
all lower-case URLs within the PHP docs)? Or should I revert this
particular change to enable the links to work again?
In looking at the output (http://docs.php.net/en/ref.pdo.html), I
can't help but think that it would be _really_ nice to automatically
generate class/method/properties hierarchical summaries for OO
extensions the same way that the functions are currently
auto-generated today... of course I'm not signing up for that wish
list item right now, heh.
I'll see if I can do anything about it _after_ I finish a good first
cut at the PDO documentation.
Dan
On Thu, 11 Nov 2004 16:57:18 -0000, Nuno Lopes <nlopess@php.net> wrote:
> nlopess Thu Nov 11 11:57:18 2004 EDT
>
> Modified files:
> /phpdoc manual.xml.in
> /phpdoc/en/reference/pdo reference.xml
> /phpdoc/en/reference/pdo/functions PDO-construct.xml
> Log:
> add PDO to the manual toc and fix build
>
> îýõ�Šù¢
> ÔÜVEöhttp://cvs.php.net/diff.php/phpdoc/manual.xml.in?r1=1.197&r2=1.198&ty=u
> Index: phpdoc/manual.xml.in
> diff -u phpdoc/manual.xml.in:1.197 phpdoc/manual.xml.in:1.198
> --- phpdoc/manual.xml.in:1.197 Tue Sep 28 00:35:02 2004
> +++ phpdoc/manual.xml.in Thu Nov 11 11:57:13 2004
> @@ -2,7 +2,7 @@
> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
> "@srcdir@/dtds/dbxml-4.1.2/docbookx.dtd" [
>
> -<!-- $Revision: 1.197 $ -->
> +<!-- $Revision: 1.198 $ -->
>
> <!-- Add translated specific definitions and snippets -->
> <!ENTITY % language-defs SYSTEM "@srcdir@/@LANGDIR@/language-defs.ent">
> @@ -208,6 +208,7 @@
> &reference.overload.reference;
> &reference.parsekit.reference;
> &reference.pdf.reference;
> + &reference.pdo.reference;
> &reference.pfpro.reference;
> &reference.info.reference;
> &reference.posix.reference;
>
> http://cvs.php.net/diff.php/phpdoc/en/reference/pdo/reference.xml?r1=1.5&r2=1.6&ty=u
> Index: phpdoc/en/reference/pdo/reference.xml
> diff -u phpdoc/en/reference/pdo/reference.xml:1.5 phpdoc/en/reference/pdo/reference.xml:1.6
> --- phpdoc/en/reference/pdo/reference.xml:1.5 Thu Nov 11 07:08:51 2004
> +++ phpdoc/en/reference/pdo/reference.xml Thu Nov 11 11:57:17 2004
> @@ -1,5 +1,5 @@
> <?xml version='1.0' encoding='iso-8859-1'?>
> -<!-- $Revision: 1.5 $ -->
> +<!-- $Revision: 1.6 $ -->
> <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. -->
> <reference id="ref.pdo">
> <title>pdo Functions</title>
> @@ -68,7 +68,7 @@
> &reftitle.constructor;
> <itemizedlist>
> <listitem>
> - <para><link linkend='function.pdo-construct'>PDO</link> -
> constructs a new PDO
> + <para><link linkend='function.PDO-construct'>PDO</link> -
> constructs a new PDO
> object</para>
> </listitem>
> </itemizedlist>
> @@ -77,41 +77,41 @@
> &reftitle.methods;
> <itemizedlist>
> <listitem>
> - <para><link
> linkend='function.pdo-begintransaction'>beginTransaction
> + <para><link
> linkend='function.PDO-beginTransaction'>beginTransaction
> </link> - begins a transaction</para>
> </listitem>
> <listitem>
> - <para><link linkend='function.pdo-commit'>commit</link> -
> commits a
> + <para><link linkend='function.PDO-commit'>commit</link> -
> commits a
> transaction</para>
> </listitem>
> <listitem>
> - <para><link linkend='function.pdo-exec'>exec</link> -
> issues an SQL
> + <para><link linkend='function.PDO-exec'>exec</link> -
> issues an SQL
> statement</para>
> </listitem>
> <listitem>
> - <para><link
> linkend='function.pdo-errorcode'>errorCode</link> -
> + <para><link
> linkend='function.PDO-errorCode'>errorCode</link> -
> retrieves an error code, if any, from the database</para>
> </listitem>
> <listitem>
> - <para><link
> linkend='function.pdo-errorinfo'>errorInfo</link> -
> + <para><link
> linkend='function.PDO-errorInfo'>errorInfo</link> -
> retrieves an array of error information, if any, from the
> database</para>
> </listitem>
> <listitem>
> - <para><link
> linkend='function.pdo-lastinsertid'>lastInsertID</link> -
> + <para><link
> linkend='function.PDO-lastInsertId'>lastInsertId</link> -
> retrieves the value of the last row that was inserted into a
> table</para>
> </listitem>
> <listitem>
> - <para><link linkend='function.pdo-prepare'>prepare</link>
> - prepares
> + <para><link linkend='function.PDO-prepare'>prepare</link>
> - prepares
> an SQL statement for execution</para>
> </listitem>
> <listitem>
> - <para><link
> linkend='function.pdo-rollback'>rollback</link> - roll
> + <para><link
> linkend='function.PDO-rollBack'>rollBack</link> - roll
> back a transaction</para>
> </listitem>
> <listitem>
> - <para><link
> linkend='function.pdo-setattribute'>setAttribute</link> -
> + <para><link
> linkend='function.PDO-setAttribute'>setAttribute</link> -
> sets a database connection attribute</para>
> </listitem>
> </itemizedlist>
> @@ -125,39 +125,39 @@
> &reftitle.methods;
> <itemizedlist>
> <listitem>
> - <para><link
> linkend='function.pdostatement-bindcolumn'>bindColumn</link> - binds a
> + <para><link
> linkend='function.PDOStatement-bindColumn'>bindColumn</link> - binds a
> PHP variable to an output column in a result set</para>
> </listitem>
> <listitem>
> - <para><link
> linkend='function.pdostatement-bindparam'>bindParam</link> - binds a
> + <para><link
> linkend='function.PDOStatement-bindParam'>bindParam</link> - binds a
> PHP variable to a parameter in the prepared statement</para>
> </listitem>
> <listitem>
> - <para><link
> linkend='function.pdostatement-errorcode'>errorCode</link> -
> + <para><link
> linkend='function.PDOStatement-errorCode'>errorCode</link> -
> retrieves an error code, if any, from the statement</para>
> </listitem>
> <listitem>
> - <para><link
> linkend='function.pdostatement-errorinfo'>errorInfo</link> -
> + <para><link
> linkend='function.PDOStatement-errorInfo'>errorInfo</link> -
> retrieves an array of error information, if any, from the statement</para>
> </listitem>
> <listitem>
> - <para><link
> linkend='function.pdostatement-execute'>execute</link> - executes a
> + <para><link
> linkend='function.PDOStatement-execute'>execute</link> - executes a
> prepared statement</para>
> </listitem>
> <listitem>
> - <para><link
> linkend='function.pdostatement-fetch'>fetch</link> - fetches a
> + <para><link
> linkend='function.PDOStatement-fetch'>fetch</link> - fetches a
> row from a result set</para>
> </listitem>
> <listitem>
> - <para><link
> linkend='function.pdostatement-fetchall'>fetchAll</link> - fetches an
> + <para><link
> linkend='function.PDOStatement-fetchAll'>fetchAll</link> - fetches an
> array containing all of the rows from a result set</para>
> </listitem>
> <listitem>
> - <para><link
> linkend='function.pdostatement-fetchsingle'>fetchSingle</link> - returns
> + <para><link
> linkend='function.PDOStatement-fetchSingle'>fetchSingle</link> - returns
> the data from the first column in a result set</para>
> </listitem>
> <listitem>
> - <para><link
> linkend='function.pdostatement-rowcount'>rowCount</link> - returns the
> + <para><link
> linkend='function.PDOStatement-rowCount'>rowCount</link> - returns the
> number of rows that were affected by the execution of an SQL statement</para>
> </listitem>
> </itemizedlist>
>
> http://cvs.php.net/diff.php/phpdoc/en/reference/pdo/functions/PDO-construct.xml?r1=1.1&r2=1.2&ty=u
> Index: phpdoc/en/reference/pdo/functions/PDO-construct.xml
> diff -u phpdoc/en/reference/pdo/functions/PDO-construct.xml:1.1
> phpdoc/en/reference/pdo/functions/PDO-construct.xml:1.2
> --- phpdoc/en/reference/pdo/functions/PDO-construct.xml:1.1 Wed Nov 10 17:21:21 2004
> +++ phpdoc/en/reference/pdo/functions/PDO-construct.xml Thu Nov 11 11:57:17 2004
> @@ -1,11 +1,10 @@
> <?xml version='1.0' encoding='iso-8859-1'?>
> -<!-- $Revision: 1.1 $ -->
> -<!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. -->
> +<!-- $Revision: 1.2 $ -->
> <refentry id="function.PDO-construct">
> <refnamediv>
> <refname>PDO::__construct</refname>
> <refpurpose>
> -
> + Creates a PDO instance to represent a connection to a database
> </refpurpose>
> </refnamediv>
> <refsect1>
>