[Laszlo-checkins] r10059 - openlaszlo/trunk/docs/src/xsl

[dda@openlaszlo.org]

Author: dda
Date: 2008-06-27 07:30:42 -0700 (Fri, 27 Jun 2008)
New Revision: 10059

Modified:
   openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl
Log:
Change 20080627-dda-V by dda at lester.local on 2008-06-27 10:18:07 EDT
    in /Users/dda/laszlo/src/svn/openlaszlo/trunk-doc4
    for http://svn.openlaszlo.org/openlaszlo/trunk

Summary: doc: resolved semi-broken links from inherited attributes

New Features:

Bugs Fixed: LPP-6337 (refguide. No anchors are generated for the attributes in tables...)

Technical Reviewer: ptw (pending)
QA Reviewer: (pending)
Doc Reviewer: liorio (pending)

Documentation:

Release Notes:

Details:
   - Added anchors for attributes within table elements.

   - Looks like there were anchors previously via <term/> elements
     (before the attribute list became a true table), but now they appear
     not be generated at all.  These seem part of a framework to generate
     cross references, and some part of it may still be used, so I've left that in place.
     But the ids for the <term/> elements have been changed (to @id.term) so as
     not to conflict with the new anchors just added.  I don't know if this
     will have any side effects, but navigation to the new anchors work.

   - Somehow the link from the 'Attributes' header to the info-attributes.html page
     was lost in a recent checkin, this has been restored. 

Tests:



Modified: openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl	2008-06-27 14:27:56 UTC (rev 10058)
+++ openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl	2008-06-27 14:30:42 UTC (rev 10059)
@@ -521,7 +521,7 @@
     <xsl:variable name="visible-members" select="$members[contains($visibility.filter, at access)]"/>
     <xsl:if test="count($visible-members) > 0 or $hasinherited">
       <variablelist>
-        <title><xsl:value-of select="$title"/></title>
+        <title><link linkend="info-attributes"><xsl:value-of select="$title"/></link></title>
         <xsl:if test="count($visible-members) > 0">
           <informaltable frame="none" pgwide="1">
             <tgroup cols="5" colsep="0" rowsep="0">
@@ -1481,7 +1481,12 @@
 
     <!-- don't generate a term if this is an event -->
     <xsl:if test="not(&isevent;)">
-      <term id="{@id}" xreflabel="{$xref}">
+        <!-- TODO [dda 2008-06-27] This no longer generates
+             an anchor, needed to find attributes on the page.
+             <anchor/> added below, and renamed this @id.term to
+             avoid multiple ID warnings.  Not sure this term
+             is needed or helpful any longer.  -->
+      <term id="{concat(@id,'.term')}" xreflabel="{$xref}">
         <!-- how to get the indexterm to use a different name than xreflabel? -->
         <indexterm zone="{@id}">
           <primary>
@@ -1496,6 +1501,7 @@
     </xsl:if>
     <row>
       <entry role="attrname">
+        <anchor id="{@id}"/>
         <literal>
           <xsl:value-of select="@name"/>
         </literal>