Hi.
In trying to resolve a bug with aliases
(http://bugs.php.net/bug.php?id=37143), I've come across this
difference.
The XML for ocicancel is ...
<refentry id="function.ocicancel">
<refnamediv>
<refname>ocicancel</refname>
<refpurpose>&Alias; <function>oci_cancel</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
<function>oci_cancel</function>.
</simpara>
</refsect1>
</refentry>
The XML for ocicloselob is ...
<refentry id="function.ocicloselob">
<refnamediv>
<refname>ocicloselob</refname>
<refpurpose>&Alias; <xref linkend="function.oci-lob-close"
/></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
<xref linkend="function.oci-lob-close" />.
</simpara>
</refsect1>
</refentry>
The main difference is <function> vs <xref>
If you take a look at http://www.php.net/manual/en/ref.oci8.php you will
see that the display types for these two aliases are different ...
ocicancel -- Alias of oci_cancel() (This is in bold)
ocicloselob -- Alias of OCI-Lob->close (This is not in bold).
In the standard CHM Manual (and I had to download one to make sure that
my own compilation wasn't the problem ...) this is shown correctly.
In the Extended CHM Manual (and again, I downloaded one), this is NOT
shown correctly.
Instead, it is shown as ...
ocicancel - Alias of oci_cancel
ocicloselob - Alias of
No bold and a missing method. I tried the different skins too. Just in
case THAT was the issue.
I can say that the build for the Extended CHM Help File is not dealing
with these correctly.
I found
<refpurpose>&Alias; <xref linkend="function.
in only 15 files. They are all in the OCI section (Oracle Functions).
I changed the <xref> to <function> and build my own manual and it all
seems OK so far (passed make test and make test_xml and is building
right now!)
(Twiddle thumbs).
Ah. Just checked the output of make chm_xsl and the two files are
different ...
<a href="function.oci-cancel.html"><b
class="function">oci_cancel()</b></a>
And
<b class="function">function.oci-lob-close()</b>
No anchor for the one that is an alias of a method.
Any ideas?
I've attached the patch. I'd like to fix this, but I don't really know
what is going on to get from .XML to .HTML with chm_xsl.
Regards,
Richard Quadling
Index: ocicloselob.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ocicloselob.xml,v
retrieving revision 1.6
diff -u -r1.6 ocicloselob.xml
--- ocicloselob.xml 7 Sep 2005 09:35:21 -0000 1.6
+++ ocicloselob.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ocicloselob">
<refnamediv>
<refname>ocicloselob</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-lob-close" /></refpurpose>
+ <refpurpose>&Alias; <function>function.oci-lob-close</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-lob-close" />.
+ <function>function.oci-lob-close</function>.
</simpara>
</refsect1>
</refentry>
Index: ocicollappend.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ocicollappend.xml,v
retrieving revision 1.11
diff -u -r1.11 ocicollappend.xml
--- ocicollappend.xml 7 Sep 2005 09:35:21 -0000 1.11
+++ ocicollappend.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ocicollappend">
<refnamediv>
<refname>ocicollappend</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-collection-append"
/></refpurpose>
+ <refpurpose>&Alias;
<function>function.oci-collection-append</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-collection-append" />.
+ <function>function.oci-collection-append</function>.
</simpara>
</refsect1>
</refentry>
Index: ocicollassign.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ocicollassign.xml,v
retrieving revision 1.12
diff -u -r1.12 ocicollassign.xml
--- ocicollassign.xml 7 Sep 2005 09:35:21 -0000 1.12
+++ ocicollassign.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ocicollassign">
<refnamediv>
<refname>ocicollassign</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-collection-assign"
/></refpurpose>
+ <refpurpose>&Alias;
<function>function.oci-collection-assign</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-collection-assign" />.
+ <function>function.oci-collection-assign</function>.
</simpara>
</refsect1>
</refentry>
Index: ocicollassignelem.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ocicollassignelem.xml,v
retrieving revision 1.11
diff -u -r1.11 ocicollassignelem.xml
--- ocicollassignelem.xml 7 Sep 2005 09:35:21 -0000 1.11
+++ ocicollassignelem.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ocicollassignelem">
<refnamediv>
<refname>ocicollassignelem</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-collection-element-assign"
/></refpurpose>
+ <refpurpose>&Alias;
<function>function.oci-collection-element-assign</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-collection-element-assign" />.
+ <function>function.oci-collection-element-assign</function>.
</simpara>
</refsect1>
</refentry>
Index: ocicollgetelem.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ocicollgetelem.xml,v
retrieving revision 1.10
diff -u -r1.10 ocicollgetelem.xml
--- ocicollgetelem.xml 7 Sep 2005 09:35:21 -0000 1.10
+++ ocicollgetelem.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ocicollgetelem">
<refnamediv>
<refname>ocicollgetelem</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-collection-element-get"
/></refpurpose>
+ <refpurpose>&Alias;
<function>function.oci-collection-element-get</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-collection-element-get" />.
+ <function>function.oci-collection-element-get</function>.
</simpara>
</refsect1>
</refentry>
Index: ocicollmax.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ocicollmax.xml,v
retrieving revision 1.12
diff -u -r1.12 ocicollmax.xml
--- ocicollmax.xml 7 Sep 2005 09:35:21 -0000 1.12
+++ ocicollmax.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ocicollmax">
<refnamediv>
<refname>ocicollmax</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-collection-max"
/></refpurpose>
+ <refpurpose>&Alias;
<function>function.oci-collection-max</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-collection-max" />.
+ <function>function.oci-collection-max</function>.
</simpara>
</refsect1>
</refentry>
Index: ocicollsize.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ocicollsize.xml,v
retrieving revision 1.11
diff -u -r1.11 ocicollsize.xml
--- ocicollsize.xml 7 Sep 2005 09:35:21 -0000 1.11
+++ ocicollsize.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ocicollsize">
<refnamediv>
<refname>ocicollsize</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-collection-size"
/></refpurpose>
+ <refpurpose>&Alias;
<function>function.oci-collection-size</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-collection-size" />.
+ <function>function.oci-collection-size</function>.
</simpara>
</refsect1>
</refentry>
Index: ocicolltrim.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ocicolltrim.xml,v
retrieving revision 1.11
diff -u -r1.11 ocicolltrim.xml
--- ocicolltrim.xml 7 Sep 2005 09:35:21 -0000 1.11
+++ ocicolltrim.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ocicolltrim">
<refnamediv>
<refname>ocicolltrim</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-collection-trim"
/></refpurpose>
+ <refpurpose>&Alias;
<function>function.oci-collection-trim</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-collection-trim" />.
+ <function>function.oci-collection-trim</function>.
</simpara>
</refsect1>
</refentry>
Index: ocifreecollection.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ocifreecollection.xml,v
retrieving revision 1.11
diff -u -r1.11 ocifreecollection.xml
--- ocifreecollection.xml 7 Sep 2005 09:35:22 -0000 1.11
+++ ocifreecollection.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ocifreecollection">
<refnamediv>
<refname>ocifreecollection</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-collection-free"
/></refpurpose>
+ <refpurpose>&Alias;
<function>function.oci-collection-free</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-collection-free" />.
+ <function>function.oci-collection-free</function>.
</simpara>
</refsect1>
</refentry>
Index: ocifreedesc.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ocifreedesc.xml,v
retrieving revision 1.11
diff -u -r1.11 ocifreedesc.xml
--- ocifreedesc.xml 7 Sep 2005 09:35:22 -0000 1.11
+++ ocifreedesc.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ocifreedesc">
<refnamediv>
<refname>ocifreedesc</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-lob-free" /></refpurpose>
+ <refpurpose>&Alias; <function>function.oci-lob-free</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-lob-free" />.
+ <function>function.oci-lob-free</function>.
</simpara>
</refsect1>
</refentry>
Index: ociloadlob.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ociloadlob.xml,v
retrieving revision 1.10
diff -u -r1.10 ociloadlob.xml
--- ociloadlob.xml 7 Sep 2005 09:35:22 -0000 1.10
+++ ociloadlob.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ociloadlob">
<refnamediv>
<refname>ociloadlob</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-lob-load" /></refpurpose>
+ <refpurpose>&Alias; <function>function.oci-lob-load</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-lob-load" />.
+ <function>function.oci-lob-load</function>.
</simpara>
</refsect1>
</refentry>
Index: ocisavelob.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ocisavelob.xml,v
retrieving revision 1.11
diff -u -r1.11 ocisavelob.xml
--- ocisavelob.xml 7 Sep 2005 09:35:22 -0000 1.11
+++ ocisavelob.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ocisavelob">
<refnamediv>
<refname>ocisavelob</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-lob-save" /></refpurpose>
+ <refpurpose>&Alias; <function>function.oci-lob-save</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-lob-save" />.
+ <function>function.oci-lob-save</function>.
</simpara>
</refsect1>
</refentry>
Index: ocisavelobfile.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ocisavelobfile.xml,v
retrieving revision 1.11
diff -u -r1.11 ocisavelobfile.xml
--- ocisavelobfile.xml 7 Sep 2005 09:35:22 -0000 1.11
+++ ocisavelobfile.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ocisavelobfile">
<refnamediv>
<refname>ocisavelobfile</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-lob-import" /></refpurpose>
+ <refpurpose>&Alias; <function>function.oci-lob-import</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-lob-import" />.
+ <function>function.oci-lob-import</function>.
</simpara>
</refsect1>
</refentry>
Index: ociwritelobtofile.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/oci8/functions/ociwritelobtofile.xml,v
retrieving revision 1.11
diff -u -r1.11 ociwritelobtofile.xml
--- ociwritelobtofile.xml 7 Sep 2005 09:35:22 -0000 1.11
+++ ociwritelobtofile.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ociwritelobtofile">
<refnamediv>
<refname>ociwritelobtofile</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-lob-export" /></refpurpose>
+ <refpurpose>&Alias; <function>function.oci-lob-export</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-lob-export" />.
+ <function>function.oci-lob-export</function>.
</simpara>
</refsect1>
</refentry>
Index: ociwritetemporarylob.xml
===================================================================
RCS file:
/repository/phpdoc/en/reference/oci8/functions/ociwritetemporarylob.xml,v
retrieving revision 1.6
diff -u -r1.6 ociwritetemporarylob.xml
--- ociwritetemporarylob.xml 7 Sep 2005 09:35:22 -0000 1.6
+++ ociwritetemporarylob.xml 18 Oct 2006 10:26:36 -0000
@@ -3,14 +3,14 @@
<refentry id="function.ociwritetemporarylob">
<refnamediv>
<refname>ociwritetemporarylob</refname>
- <refpurpose>&Alias; <xref linkend="function.oci-lob-writetemporary"
/></refpurpose>
+ <refpurpose>&Alias;
<function>function.oci-lob-writetemporary</function></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<simpara>
&info.function.alias;
- <xref linkend="function.oci-lob-writetemporary" />.
+ <function>function.oci-lob-writetemporary</function>.
</simpara>
</refsect1>
</refentry>
