[EMAIL PROTECTED] wrote:
Author: crossley
Date: Thu Apr  6 15:47:46 2006
New Revision: 392105

URL: http://svn.apache.org/viewcvs?rev=392105&view=rev
Log:
Remove examples of acronym and definition/@cite until we know how to use them.

See inline...

Modified: 
forrest/trunk/whiteboard/plugins/org.apache.forrest.plugin.input.glossary/src/documentation/content/xdocs/glossary.xml
URL: 
http://svn.apache.org/viewcvs/forrest/trunk/whiteboard/plugins/org.apache.forrest.plugin.input.glossary/src/documentation/content/xdocs/glossary.xml?rev=392105&r1=392104&r2=392105&view=diff
==============================================================================
--- 
forrest/trunk/whiteboard/plugins/org.apache.forrest.plugin.input.glossary/src/documentation/content/xdocs/glossary.xml
 (original)
+++ 
forrest/trunk/whiteboard/plugins/org.apache.forrest.plugin.input.glossary/src/documentation/content/xdocs/glossary.xml
 Thu Apr  6 15:47:46 2006
@@ -23,10 +23,11 @@
     <title>C</title>
     <item id="CSS">
       <term>Cascading Style Sheets</term>
-      <acronym>CSS</acronym>
-      <definition cite="http://www.w3.org/Style/CSS/";>Cascading Style Sheets 
(CSS)
+      <definition>Cascading Style Sheets (CSS)
       is a simple mechanism for adding style (e.g. fonts, colors, spacing) to 
Web
-      documents.</definition>

Cite is used to link to an original source for the definition. Each glossary term can have multiple definitions, some of which may not be our copyright, therefore we need to cite the source.

+      documents.
+      Source: <a href="http://www.w3.org/Style/CSS/";>W3C</a>.

Putting it in the @cite attribute allows us to do this processing in XSLT. We can do clever stuff like "only show defininitions from the w3c".

     <item id="SVG">
       <term>Scalable Vector Graphics</term>
-      <acronym>SVG</acronym>
-      <definition cite="http://www.w3.org/Graphics/SVG/";>SVG is a language for 
describing
+      <definition>Scalable Vector Graphics (SVG) is a language for describing
       two-dimensional graphics and graphical applications in XML.
+      Source: <a href="http://www.w3.org/Graphics/SVG/";>W3C</a>.
       </definition>

Again, putting the accronym in an attribute allows us to do powerful stuff like search for the term associated with this accronym. Why is this not an attribute? Because some terms have multiple accronyms

For complete examples, see the glossary.xml file I originally attached to the issue. This document is rendered at [1]. You can see that the @cite is rendered by the XSLT in almost the same way you have hard coded above. The accronyms are also rendered in a similar way to what you ahve above, for example "Data Definition Language (DDL)".

Ross

[1] http://www.gardler.org/teaching/glossary.html