Mailing-List: contact forrest-dev-help@xml.apache.org; run by ezmlm
Precedence: bulk
Reply-To: forrest-dev@xml.apache.org
Date: Wed, 8 Oct 2003 21:33:00 +1000
From: Jeff Turner <jefft@apache.org>
To: forrest-dev@xml.apache.org, nicolaken@apache.org
Subject: Re: [UPDATE] Forrest source directory layout and resolving
Message-ID: <20031008113300.GH4541@expresso.localdomain>
Mail-Followup-To: forrest-dev@xml.apache.org, nicolaken@apache.org
References: <bkrobi$v7i$1@sea.gmane.org> <blu2tv$1lf$1@sea.gmane.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <blu2tv$1lf$1@sea.gmane.org>
User-Agent: Mutt/1.5.4i

On Tue, Oct 07, 2003 at 11:59:05AM +0200, Nicola Ken Barozzi wrote:
> 
> Here is an updated status on my proceedings about the source directory 
> layout and resolving, divided by the objectives:
> 
> 1 new and cleaner standard layout
> 
> This can only be done properly when we have in place point 2, as it will 
> need a way of defining the source layout. In the meantime I need to 
> remove the images from the resources, as they are skin-specific.
> 
> 2 no more source copying

To report on updates: I've been trying to fix up and commit the old xmaps
that remove the necessity for copying.

It's gradually occurred to me that perhaps we'll never be able to
completely remove the need for copying.  The problems are quite large:

 - The src/documentation/{lib,classes} directory's contents need to be in
   WEB-INF/lib/.  We could hack Jetty's classpath to include these, but
   that's not a very nice solution
 - src/documentation/*.xmap sitemaps need to override their generic
   equivalents, and I still don't know how we could do this.
 - Anything in resources/{images,stylesheets,grammars,schema} could
   potentially be overridden by an identically named file in
   src/documentation/resources/{...}.  This means that for large
   proportions of our sitemap, we'll have to use actions to do an
   if-then-else check.  This will have unhappy consequences to
   readability and speed.

So I've concentrated on eliminating xdoc copying as a first step covering
most needs, and that is almost ready to be checked in.


--Jeff

> This needs point 3 to be done correctly.
> 
> 3 definition of additional user resources
> 
> Tada! :-)
> 
> The real thing to be done here is how users can tell Forrest where to 
> find sources. In this way users can point to the locations they want, 
> and Forrest doesn't need copying and a standard layout can be established.
> 
> This is something that has to be in the more general scope of how 
> Forrest finds the conifiguration, keeping in mind that a single Forrest 
> instance may have to load multiple sites.
> 
> After some thinking, and *plenty* of idea changes, I think I came up 
> with a proposal, which you can read in its own thread. :-)
> 
> 
> -- 
> Nicola Ken Barozzi                   nicolaken@apache.org
>             - verba volant, scripta manent -
>    (discussions get forgotten, just code remains)
> ---------------------------------------------------------------------
> 
>