Return-Path: Delivered-To: apmail-jakarta-ant-dev-archive@apache.org Received: (qmail 80528 invoked from network); 19 Feb 2002 22:12:34 -0000 Received: from unknown (HELO nagoya.betaversion.org) (192.18.49.131) by daedalus.apache.org with SMTP; 19 Feb 2002 22:12:34 -0000 Received: (qmail 3222 invoked by uid 97); 19 Feb 2002 22:12:20 -0000 Delivered-To: qmlist-jakarta-archive-ant-dev@jakarta.apache.org Received: (qmail 3173 invoked by uid 97); 19 Feb 2002 22:12:19 -0000 Mailing-List: contact ant-dev-help@jakarta.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Subscribe: List-Help: List-Post: List-Id: "Ant Developers List" Reply-To: "Ant Developers List" Delivered-To: mailing list ant-dev@jakarta.apache.org Received: (qmail 3096 invoked from network); 19 Feb 2002 22:12:19 -0000 Message-ID: <3C72CDBF.3C38EE4@progress.com> Date: Tue, 19 Feb 2002 17:12:15 -0500 From: "Bill Burton" Organization: Progress Software Corporation X-Mailer: Mozilla 4.76 [en] (Windows NT 5.0; U) X-Accept-Language: en-US MIME-Version: 1.0 To: Ant Developers List Subject: Re: Official direction for xdocs References: <3C6E4B12.7060703@yahoo.com> <3C722F6E.60304@yahoo.com> <3C72A595.D266F02@progress.com> <3C72B0E6.7020306@yahoo.com> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N Hello, Paul Hammant wrote: > > Bill, > > >>In one line : I find it odd that Ant has no default way of building > >>xdocs in its downloadable form. > >> > > > >Because it contains almost no xdocs :) Even if the entire manual was in > >xdocs format, someone downloading an Ant runtime would not need to rebuild > >Ant's docs. > > > I am not really talking about ant as a project, I am talking aboiut it > as a tool for use with other projects. The projects I elude to are > hosted at Apache, but can't be completely built with out of the box Ant, > thus they include their own in their CVS tree. A forked ant if you > like. A forked ant inside, forked inside Apache if you like. I know that's what you were referring to and I was just giving one reason what things are the way they are. > >However, to support what you suggest would require including the > >velocity-1.2-dep.jar with the distribution which currently weighs in at > >474 KB. Then if XDoclet becomes a requirement for generating task xdocs, > >that adds more heft as well. But that would only be needed by those doing > >task development. The thing is most builds don't use this functionality. > >If your's does, then include those jars in your distribution so it will be > >self contained just as you've described for Avalon. > > I am not interested in extracting infor from xdoclet (different to > xdocs) tags, nor velocity. Then by definition your understanding of "xdocs" is entirely different from that used by most of the Jakarta sites. They are built using Anakia, part of the Velocity distribution. Anakia performs similar functionality as XSLT but is somewhat simpler to use. There is also a site.xsl which can be used to generate similar output to that of Anakia's site.vsl. So if you don't want Velocity and Anakia included, then you're assuming an XSLT processor would be included, probably Xalan. > The technology I talk in widespread use on > Apache projects is xml-documents (styled to html for websites) known as > xdocs. Here is a snippet : > > > >

Hello!!!!!!!

> > Yes, I know. The snippet above is based on the Avalon DTD which differs is some respects to that used for xdocs in the other Jakarta sites (and apache.org). The equivalent used for the Jakarta sites looks like:

Subheading text

> >Once the Ant manual has been converted to xdocs, there could be a > >paragraph mentioning how it was generated and where to obtain the support > >to do similar things yourself. It could also contain links to other Ant > >supported ways of generating documenation. > > > Sorry dude, we are talking about different things. You - Ant's own > documents, Me - Son of taskdef No, not at all. > - Paul Built in support for generating HTML from xdocs is not included in the Ant base distribution for the same reasons lots of other stuff isn't included. To provide the support you're asking for in the base distribution requires bundling either the Velocity distribution for Anakia support or Xalan for XSLT support. One of the goals of Ant2 is to be more modular. So there's probably even less chance such support would be included in the base distribution unless it was required for build file templating. -Bill -- To unsubscribe, e-mail: For additional commands, e-mail: