Re: What's the difference in these tags?

Hello Richard! You always have the most thorough emails! ;-) Use <function>, and feel free to (a) get a php.net account and (b) commit the patch :) Regards, Philip http://doc.php.net/php/dochowto/ On Oct 18, 2006, at 4:25 AM, Richard A. Quadling wrote:

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 <oci8.diff.txt>