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 <[EMAIL PROTECTED]> 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
> 
> 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>
>

Reply via email to