Aha!

The file-entities.ent has the function names in mixed case. I'm trying
the build with the alias' xml files having the same case in the
<function> tag as in the file-entities.ent.

Watch this space!

Richard. 

> -----Original Message-----
> From: Richard A. Quadling [mailto:[EMAIL PROTECTED] 
> Sent: 19 October 2006 08:35
> To: Philip Olson; [email protected]
> Subject: 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:[EMAIL PROTECTED]
> > 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>
> > 
> > 
> 

Reply via email to