What's the difference in these tags?

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>