Return-Path: 
 <torque-dev-return-5561-apmail-db-torque-dev-archive=db.apache.org@db.apache.org>
Delivered-To: apmail-db-torque-dev-archive@www.apache.org
Received: (qmail 1881 invoked from network); 1 Aug 2005 13:30:51 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 1 Aug 2005 13:30:51 -0000
Received: (qmail 97362 invoked by uid 500); 1 Aug 2005 13:30:51 -0000
Delivered-To: apmail-db-torque-dev-archive@db.apache.org
Received: (qmail 97338 invoked by uid 500); 1 Aug 2005 13:30:50 -0000
Mailing-List: contact torque-dev-help@db.apache.org; run by ezmlm
Precedence: bulk
List-Unsubscribe: <mailto:torque-dev-unsubscribe@db.apache.org>
List-Help: <mailto:torque-dev-help@db.apache.org>
List-Post: <mailto:torque-dev@db.apache.org>
List-Id: "Apache Torque Developers List" <torque-dev.db.apache.org>
Reply-To: "Apache Torque Developers List" <torque-dev@db.apache.org>
Delivered-To: mailing list torque-dev@db.apache.org
Received: (qmail 40651 invoked by uid 99); 1 Aug 2005 13:01:44 -0000
X-ASF-Spam-Status: No, hits=0.0 required=10.0
	tests=
X-Spam-Check-By: apache.org
Received-SPF: neutral (asf.osuosl.org: local policy)
Message-ID: <42EE1D33.6090401@first.fhg.de>
Date: Mon, 01 Aug 2005 15:01:39 +0200
From: Thomas Dudziak <tomdz@first.fhg.de>
User-Agent: Mozilla Thunderbird 1.0.6 (Windows/20050716)
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: Torque Developers List <torque-dev@db.apache.org>
Subject: Re: Using Forrest in DB Torque
References: <1122893762.28010.86.camel@forge.intermeta.de>
	 <42EE02EC.5070300@first.fhg.de>
	 <1122899516.28010.89.camel@forge.intermeta.de>
	 <42EE198C.7010300@first.fhg.de>
 <1122900575.28010.115.camel@forge.intermeta.de>
In-Reply-To: <1122900575.28010.115.camel@forge.intermeta.de>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-OriginalArrivalTime: 01 Aug 2005 13:01:38.0793 (UTC)
 FILETIME=[27916590:01C59699]
X-ITSO-MailScanner: Found to be clean
X-MailScanner-From: tomdz@first.fhg.de
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

Henning Schmiedehausen wrote:

> About using Forrest: Well, we have a lot of docs in Anakia format. If we
> don't have to convert (i.e. Forrest can read Anakia format) _and_ if we
> don't lose the benefits of the maven built docs (which are the lots and
> lots of auto-generated reports like checkstyle, PMD and so on), then I
> think that we could consider this.
> 
> However, this really is also a question for the other torque developers.

 From what I can see in the Torque docs, its mostly adapting the links. 
Forrest uses one dedicated place to put the concrete links, and within 
the page you only use the logical aliases, eg. instead of referencing 
tomcat docs directly, you'd have something like

"<link href="ext:jakarta/tomcat/docs4/jndi-howto">...</link>"

which would be configured to point to 
http://jakarta.apache.org/tomcat/tomcat-4.1-doc/jndi-resources-howto.html 
like this (in site.xml):

<jakarta href="http://jakarta.apache.org/">
   <tomcat href="tomcat/">
     <docs4 href="tomcat-4.1-doc/">
       <jndi-howto href="jndi-resources-howto.html"/>
     </docs>
   </tomcat>
</jakarta>

And Forrest can incorporate auto-generated stuff like JavaDocs, reports 
etc., and it can be run from Maven 
(http://forrest.apache.org/docs_0_70/howto/howto-forrest-from-maven.html).

You might want to have a look into eg. the OJB docs:

http://cvs.apache.org/viewcvs.cgi/db-ojb/src/doc/forrest/src/documentation/content/xdocs/

regards,
Tom

---------------------------------------------------------------------
To unsubscribe, e-mail: torque-dev-unsubscribe@db.apache.org
For additional commands, e-mail: torque-dev-help@db.apache.org