[Laszlo-dev] For Review: Change 20080813-dda-A Summary: quick fix for unnamed links

[Donald Anderson]

Change 20080813-dda-A by dda at lester.local on 2008-08-13 15:46:48 EDT
     in /Users/dda/laszlo/src/svn/openlaszlo/trunk-doc2
     for http://svn.openlaszlo.org/openlaszlo/trunk

Summary: quick fix for unnamed links

New Features:

Bugs Fixed: (LPP-6429) refguide. <datapath> page differences.

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

Documentation:

Release Notes:

Details:
     Certain links using <xref> to an attribute name, using  
linkend="ClassName.__ivars__.attrname",
     can show up as valid links, but with the title of the link being  
'???'.  I'm not sure exactly
     what the trouble is, there are some indications that linking has  
been reworked in DocBook5:
     see http://www.sagehill.net/docbookxsl/ 
Db5Tools.html#Db5UnivLinking .  I played a little
     with rewriting the <xref> links using <link>.  At any rate, an  
acceptable workaround is
     to replace any <xref> references to attributes to use <link> with  
an explicit name.
     For example:
           <xref linkend="LzDatapointer.__ivars__.rerunxpath"/>
     can be rewritten as:
           <link  
linkend="LzDatapointer.__ivars__.rerunxpath">rerunxpath</link>
     I don't know why, but references to methods work (maybe because  
the ID names for them
     are more straightforward?).

Tests:
     Rebuilt docs, checked by eye.

Files:
M      WEB-INF/lps/lfc/data/LzDatapointer.lzs
M      WEB-INF/lps/lfc/data/LzDatapath.lzs

Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20080813-dda-A.tar



--

Don Anderson
Java/C/C++, Berkeley DB, systems consultant

voice: 617-547-7881
email: dda at ddanderson.com
www: http://www.ddanderson.com



-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.openlaszlo.org/pipermail/laszlo-dev/attachments/20080813/6b0b4fe1/attachment-0001.html