svn commit: rev 53823 - forrest/trunk/src/documentation/content/xdocs/docs

[rg...@apache.org]

Author: rgardler
Date: Tue Oct  5 13:25:31 2004
New Revision: 53823

Modified:
   forrest/trunk/src/documentation/content/xdocs/docs/linking.xml
Log:
clarify menu generation for tabs (recomended by Christian Roth)

Modified: forrest/trunk/src/documentation/content/xdocs/docs/linking.xml
==============================================================================
--- forrest/trunk/src/documentation/content/xdocs/docs/linking.xml	(original)
+++ forrest/trunk/src/documentation/content/xdocs/docs/linking.xml	Tue Oct  5 13:25:31 2004
@@ -199,9 +199,16 @@
       <section id="selecting-entries">
         <title>Selecting menu entries</title>
         <p>Forrest decides which menu entries to display, by examining the
-          "<code>tab</code>" attributes in the &s; file. All &s; entries with a
+          "<code>tab</code>" attributes in the &s; file. The children of 
+          all &s; entries with a
           "<code>tab</code>" which is equal to that of the current page, are
-          added to the menu.</p>
+          added to the menu, whilst the element itself forms the root of that
+          part of the menu (see the "<code>community</code>" element in the 
+          example below). Child elements that have a different 
+          "<code>tab</tab>" attribute value will appear in the menu for their
+          parents, and will also form the root of a new menu for a tab with 
+          the appropriate name (see the "<code>howto-samples</code>" element
+          below).</p>
         <p>Consider our &s; example:</p>
           <source>
 &lt;site label="Forrest" href="" <strong>tab="home"</strong>