Windows extended CHM does not handle <function> properly.

Hi.
 
This is in the Windows Extended CHM file.
 
Take phpdoc/en/strings/functions/str-repeat.xml
 
Look in the seealso section.
 
There is a difference in the way the see also's are entered ...
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><link linkend="control-structures.for">for</link></member>
    <member><function>str_pad</function></member>
    <member><function>substr_count</function></member>
   </simplelist>
  </para>
 </refsect1>
 
Using make chm_xsl this is translated to the file
phpdoc/htmlhelp/html/function.str-repeat.html
 
The seealso section now looks like (slightly tidied).
 
<div class="refsect1" lang="en">
 <a name="id5929139"></a>
 See Also
 <p></p>
 <table class="simplelist" border="0" summary="Simple list">
  <tr><td><a href="control-structures.for.html"
title="for">for</a></td></tr>
  <tr><td><b class="function">str_pad()</b></td></tr>
  <tr><td><b class="function">substr_count()</b></td></tr>
 </table>
 <p></p>
</div>

This means that none of the see also link to other functions.
 
This is further converted into the CHM files as ...
 
<div class="refsect1" lang="en">
 <a name="id5929139"></a>
 See Also
 <table class="simplelist" border="0" summary="Simple list">
  <tr><td><a href="control-structures.for.html"
title="for">for</a></td></tr>
  <tr><td><b class="function">str_pad()</b></td></tr>
  <tr><td><b class="function">substr_count()</b></td></tr>
 </table>
</div>

(Dropping of empty <p></p> tags).
 
Still no anchors for the functions.
 
The xsl code for this (I think) is in
phpdoc/phpbook/phpbook-xsl/common.xsl around line 373-381 ...
 
<!-- Enclose FUNCTION in links, add parenthesis, make 'em bold. Do not
link if
     current page is description of current function or target is not
available -->
<xsl:template match="function">
  <xsl:variable name="content">
      <b class="{local-name(.)}">
         <xsl:apply-templates/>
          <xsl:text>()</xsl:text>
      </b>
  </xsl:variable>

I suspect this is incorrect.
 
 
I think I could change it so that the an <a> tag is created, but I don't
know how to obey the rest of the comment "Do not link if current page is
description of current function or target is not available".
  
The common.xsl was last changed on   $Id: common.xsl,v 1.4 2007/06/20
22:25:41 bjori Exp $
 
The online version of this page was generated on 2007/06/17 and doesn't
show this problem.

I looked at other xsl files that deal with <xsl:template
match="function"> and they are quite different.

The one in html-chunk.xsl looks the most promising ...

  <xsl:choose>
    <xsl:when test="(ancestor::refentry/@id=$targetid or
ancestor::sect1/@id=$targetid)
                    or string-length($targetid) = 0">
      <b><xsl:copy-of select="$content"/></b>
    </xsl:when>
    <xsl:otherwise>
      <a>
        <xsl:attribute name="href">
          <xsl:value-of select="concat($targetid,$html.ext)"/> 
        </xsl:attribute>
        <xsl:copy-of select="$content"/>
      </a>
    </xsl:otherwise>
  </xsl:choose>

But I don't know anywhere NEAR enough to even try this out. I don't know
XSL at all (though I think I can guess).        
 
Regards
 
Richard Quadling.

--
PHP CHM Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php