Return-Path: 
 <dev-return-22972-apmail-forrest-dev-archive=forrest.apache.org@forrest.apache.org>
Delivered-To: apmail-forrest-dev-archive@www.apache.org
Received: (qmail 2491 invoked from network); 9 Mar 2006 06:30:28 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 9 Mar 2006 06:30:28 -0000
Received: (qmail 17185 invoked by uid 500); 9 Mar 2006 06:30:28 -0000
Delivered-To: apmail-forrest-dev-archive@forrest.apache.org
Received: (qmail 17145 invoked by uid 500); 9 Mar 2006 06:30:27 -0000
Mailing-List: contact dev-help@forrest.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:dev-help@forrest.apache.org>
list-unsubscribe: <mailto:dev-unsubscribe@forrest.apache.org>
List-Post: <mailto:dev@forrest.apache.org>
Reply-To: dev@forrest.apache.org
List-Id: <dev.forrest.apache.org>
Delivered-To: mailing list dev@forrest.apache.org
Received: (qmail 17134 invoked by uid 99); 9 Mar 2006 06:30:27 -0000
Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 08 Mar 2006 22:30:27 -0800
X-ASF-Spam-Status: No, hits=1.2 required=10.0
	tests=RCVD_IN_SORBS_WEB,SPF_HELO_PASS
X-Spam-Check-By: apache.org
Received-SPF: neutral (asf.osuosl.org: local policy)
Received: from [80.67.18.14] (HELO smtprelay02.ispgateway.de) (80.67.18.14)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 08 Mar 2006 22:30:26 -0800
Received: (qmail 19744 invoked from network); 9 Mar 2006 06:30:02 -0000
Received: from unknown (HELO localhost) (305514@[212.23.126.5])
          (envelope-sender <ferdinand@apache.org>)
          by smtprelay02.ispgateway.de (qmail-ldap-1.03) with SMTP
          for <dev@forrest.apache.org>; 9 Mar 2006 06:30:02 -0000
Date: Thu, 9 Mar 2006 07:29:47 +0100
From: Ferdinand Soethe <ferdinand@apache.org>
X-Priority: 3 (Normal)
Message-ID: <18310574121.20060309072947@soethe.net>
To: dev@forrest.apache.org
Subject: Re: site.xml and tabs.xml
In-Reply-To: <eab855560603071934n51fe8934r@mail.gmail.com>
References: <eab855560603062205t7144c15aq@mail.gmail.com>
 <20060307071320.GR485@igg.indexgeo.com.au>
 <eab855560603062344l24c3dee4g@mail.gmail.com>
 <000301c641e2$07c84ea0$0500a8c0@developer>
 <eab855560603070555t65157b41g@mail.gmail.com> <440DB651.9070101@pcotech.fr>
 <20060307231905.GA3024@igg.indexgeo.com.au>
 <eab855560603071649m1461ca1du@mail.gmail.com>
 <20060308014508.GC3024@igg.indexgeo.com.au>
 <eab855560603071934n51fe8934r@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N


>> Forrest has a lack. Only one set of menu items will
>> be displayed,

In my view this is a feature and not a 'lack'. Or - to put it
differently - one of two ways of handling menus. Keeping everything
open that the user opens is an alternative way of handling menus that
will soon become a pain because the menu will become quite cluttered.

Also, as far as Forrest is concerned, it will increase the likelyhood
that (in larger menus) the selected menu item is in a part of the menu
that requires scrolling to become visible.

>> that is the group that contains the
>> current URL. All other menu groups are closed.

True. Only this group will be displayed in an expanded way.
Although there may be more than one open menu (read on).

Careful about conclusions about behavior drawn from quick examples.
Ime Forrest menus is far to complex to reliably do that.

Talking about your example, here are the complete files I have created
from your example:

site.xml
<?xml version="1.0" encoding="UTF-8"?>
<site label="MyProj" href="" xmlns="http://apache.org/forrest/linkmap/1.0" tab="">
    <menugroup tab="tabone">
        <childone label="childone" >                            
            <childone href="index.html" label="childonelabel" />    
        </childone >                                            
        <childtwo label="childtwo">                             
            <childtwo href="index.html"  label="" />                
        </childtwo>                                             
    </menugroup>                                            
    <childthree label="childthree" tab="tabone">            
        <childthree href="index.html" label="childthreelabel" />
    </childthree>                                           
</site>

tabs.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE tabs PUBLIC "-//APACHE//DTD Cocoon Documentation Tab V1.1//EN" "http://forrest.apache.org/dtd/tab-cocoon-v11.dtd">
<tabs software="MyProj"
  title="MyProj"
  copyright="Foo"
  xmlns:xlink="http://www.w3.org/1999/xlink">
    <tab id="tabone" label="tabone" dir="" />
</tabs>

> Childthree would display the root label, 'childthree', only.

True. Main reason being that

- childthree is the only labeled and thus
  visible group that is associated with tabone.
- there is a reference to index.html in that group so Forrest will
  open that group deep enough to display that menu-item.

If you now put a label to menugroup

site.xml
<?xml version="1.0" encoding="UTF-8"?>
<site label="MyProj" href="" xmlns="http://apache.org/forrest/linkmap/1.0" tab="">
    <menugroup label="menugroup" tab="tabone">                                
        <childone label="childone" >                            
            <childone href="index.html" label="childonelabel" />    
        </childone >                                            
        <childtwo label="childtwo">                             
            <childtwo href="index.html"  label="" />                
        </childtwo>                                             
    </menugroup>                                            
    <childthree label="childthree" tab="tabone">            
        <childthree href="index.html" label="childthreelabel" />
    </childthree>                                           
</site>

you would actually see all three
childgroups open because they all contain a reference to the same
index.html (because you have the same filename (index.htm) and no
directory (href) in the menu parents)!

A bit weird is the display of index in childtwo (a
line below the menu), but that probably has to do with the missing
label for the reference to index.html.

>  It seems that any menu groups which are within the menu group root
> element will open when the tab is selected as long as they have a
> label attribute. The following would seem to show all the items form
> childone and childtwo and the index.hml from childone.

Imo this is the wrong conclusion. Only those will open that contain a
reference to the currently open file.

--
Ferdinand Soethe