Return-Path: Delivered-To: apmail-jakarta-ant-dev-archive@apache.org Received: (qmail 75812 invoked from network); 6 Jan 2003 08:58:23 -0000 Received: from exchange.sun.com (192.18.33.10) by daedalus.apache.org with SMTP; 6 Jan 2003 08:58:23 -0000 Received: (qmail 6267 invoked by uid 97); 6 Jan 2003 08:59:49 -0000 Delivered-To: qmlist-jakarta-archive-ant-dev@jakarta.apache.org Received: (qmail 6251 invoked by uid 97); 6 Jan 2003 08:59:48 -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 6239 invoked by uid 98); 6 Jan 2003 08:59:47 -0000 X-Antivirus: nagoya (v4218 created Aug 14 2002) Message-ID: <006d01c2b562$915feac0$030200c0@DJ0X820J> From: "Antoine Levy-Lambert" To: "Ant Developers List" References: <0809B8DB-2106-11D7-9914-000393A564E6@ehatchersolutions.com> <3E18C35C.1030804@chalko.com> <3E18C3C8.2040202@gmx.de> Subject: Re: XDoclet and Ant descriptor generation Date: Mon, 6 Jan 2003 10:04:06 +0100 MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 5.50.4522.1200 X-MIMEOLE: Produced By Microsoft MimeOLE V5.50.4522.1200 X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N I agree with Christopher Lenz >>Specifying links to external examples that get merged in in the >>generation process sounds much more reasonable to me. I think there could be links with sample "build.xml" files illustrating how to use a task, or links with gif or jpeg files if something needs to be illustrated graphically. The question (for Erik) is : what is the correct syntax to specify such links in the java source files, so that they get processed properly by the xdoc build, and the results are seen in the html documentation of the task, but not in the Javadoc API documentation ? Antoine ----- Original Message ----- From: "Christopher Lenz" To: "Ant Developers List" Sent: Monday, January 06, 2003 12:46 AM Subject: Re: XDoclet and Ant descriptor generation > Nick Chalko wrote: > > Erik Hatcher wrote: > >> On Sunday, January 5, 2003, at 04:57 PM, Nick Chalko wrote: > >>> Why not * @antdoc.example snippet="" > >>> * description="Generates a default bar" > >>> Lets keep as much as possible in the the source file. > >> > >> Because its a real pain to HTML encode all the <> symbols and its much > >> easier to have an external file with samples clearly formatted and > >> styled in HTML I believe. > > > > > > Won't xodlet handle the xml excaping for us. If not we should patch > > xdoclet. > > Even if, you don't *really* want to put large (read: anything larger > then ), multi-line examples in the attribute of an XDoclet tag, do > you? > > Specifying links to external examples that get merged in in the > generation process sounds much more reasonable to me. > > -- > Christopher Lenz > /=/ cmlenz at gmx.de > > > -- > To unsubscribe, e-mail: > For additional commands, e-mail: > -- To unsubscribe, e-mail: For additional commands, e-mail: