RE: [PHP-DOC] What's the difference in these tags?

Hi. It actually didn't work. I used make chm_xsl and examined the .html files before they are processed from phpdoc/htmlhelp/html into phpdoc/htmlhelp/htmlout. So this suggests that one of the xsl files is not right OR there reading of the function list is in some way wrong. The function is wrapped in <b>...</b> but not <a>. This suggests that the function cannot be found to link to and only the fact that the XML file says it is a function gets the bold wrapper. Something I'm not sure about is the case sensitivity of the xsl:value-of function. I'm going to try that as it SEEMS that the only aliases missing have a different case, but only when using the Extended CHM and not the normal CHM. Argh! So, this is still a fix in progress. And I don't even use the OCI, but I reported the bug so I should at least try and fix it! And thank you for your support on getting an account. I probably will now. And thank you for your comments on my emails. I'm just as wordy IRL. Richard. > -----Original Message----- > From: Philip Olson [mailto:philip@roshambo.org] > Sent: 18 October 2006 16:31 > To: Richard A. Quadling > Subject: Re: [PHP-DOC] What's the difference in these tags? > > > You always have the most thorough emails... ;-) > > Use <function>, 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> > >