Return-Path: 
 <dev-return-60024-apmail-ant-dev-archive=ant.apache.org@ant.apache.org>
Delivered-To: apmail-ant-dev-archive@www.apache.org
Received: (qmail 47197 invoked from network); 31 Aug 2004 05:41:50 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur-2.apache.org with SMTP; 31 Aug 2004 05:41:50 -0000
Received: (qmail 18798 invoked by uid 500); 31 Aug 2004 05:41:44 -0000
Delivered-To: apmail-ant-dev-archive@ant.apache.org
Received: (qmail 18722 invoked by uid 500); 31 Aug 2004 05:41:43 -0000
Mailing-List: contact dev-help@ant.apache.org; run by ezmlm
Precedence: bulk
List-Unsubscribe: <mailto:dev-unsubscribe@ant.apache.org>
List-Subscribe: <mailto:dev-subscribe@ant.apache.org>
List-Help: <mailto:dev-help@ant.apache.org>
List-Post: <mailto:dev@ant.apache.org>
List-Id: "Ant Developers List" <dev.ant.apache.org>
Reply-To: "Ant Developers List" <dev@ant.apache.org>
Delivered-To: mailing list dev@ant.apache.org
Received: (qmail 18698 invoked by uid 99); 31 Aug 2004 05:41:43 -0000
X-ASF-Spam-Status: No, hits=0.2 required=10.0
	tests=HTML_50_60,HTML_MESSAGE,NO_REAL_NAME
X-Spam-Check-By: apache.org
Received-SPF: pass (hermes.apache.org: local policy)
Received: from [193.109.238.66] (HELO dnsinet.rzf-nrw.de) (193.109.238.66)
  by apache.org (qpsmtpd/0.27.1) with ESMTP; Mon, 30 Aug 2004 22:41:42 -0700
Received: from z011104.bk.fin.local (z011104.bk.fin.local [193.109.238.140])
	by dnsinet.rzf-nrw.de (8.12.10/8.12.10) with ESMTP id i7V5fbvR024453
	for <dev@ant.apache.org>; Tue, 31 Aug 2004 07:41:37 +0200
Received: by z011104.bk.fin.local with Internet Mail Service (5.5.2657.72)
	id <R6182DM7>; Tue, 31 Aug 2004 07:41:37 +0200
Message-ID: <879A5AD5DD0ED511891F0003473A9B560E23F53F@Z011004>
From: Jan.Materne@rzf.fin-nrw.de
To: dev@ant.apache.org
Subject: AW: Request for more access to IntrospectionHelper-stored info
Date: Tue, 31 Aug 2004 07:41:34 +0200
MIME-Version: 1.0
X-Mailer: Internet Mail Service (5.5.2657.72)
Content-Type: multipart/alternative;
	boundary="----_=_NextPart_001_01C48F1D.2D048130"
X-Virus-Checked: Checked
X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N

------_=_NextPart_001_01C48F1D.2D048130
Content-Type: text/plain;
	charset="iso-8859-1"

> Erik Hatcher wrote:
> > Keep us posted on what you come up with!  I created 
> proposal/xdocs to 
> > generate the task reference appendix in JDwA, and tossed it 
> out there as 
> > a possible way to document tasks/types in the hopes it 
> would get more 
> > attention that it has.  I believe Steve has used it to 
> generate task 
> > documentation in Axis, and it has been used a little to 
> generate the 
> > documentation of some of Ant's newer tasks (the HTML pages 
> that don't 
> > quite fit in).  Ant's task documentation could definitely use some 
> > automated generation.
> 
> yes, Axis and SmartFrog tasks are autodocumented, in an 
> ugly-and-brittle 
> manner that needs careful nursing. Still, it is better than 
> hand coding.
> 
> I have been told off by friends for our book lacking 
> autogenerated info 
> on types alongside tasks. A valid point :(
> 
> What I'd like from autocreated stuff is
> 
> -readable docs
> -ability to include samples
> -linking to nested types
> -index docs
> -ease of use by other projects that create ant tasks.
> 
> we are not there -yet.

Dont forget alternative formats: XML, PDF, TeX, Docbook, POD :), Man, ...


Jan

------_=_NextPart_001_01C48F1D.2D048130--