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>
