Re: Ant documentation

2018-03-11 Thread Gintautas Grigelionis
2018-03-02 13:13 GMT+01:00 Stefan Bodewig : > > All I wanted to say, keeping things visually consistent helps > > understanding. So, my simple set of rules is: > > >- is for attributes > >- is for values > >- is for shell variable names/property name/CLI options and > input > >

Re: Ant documentation

2018-03-05 Thread Gintautas Grigelionis
2018-03-02 13:13 GMT+01:00 Stefan Bodewig : > On 2018-03-02, Gintautas Grigelionis wrote: > > > 2018-03-02 9:54 GMT+01:00 Stefan Bodewig : > > >> On 2018-03-01, Stefan Bodewig wrote: > > On Thu, Mar 1, 2018 at 7:28 AM, Gintautas Grigelionis < > g.grigelio...@gmail.com> wrote: > > > I

Re: Ant documentation

2018-03-02 Thread Stefan Bodewig
On 2018-03-02, Gintautas Grigelionis wrote: > 2018-03-02 9:54 GMT+01:00 Stefan Bodewig : >> On 2018-03-01, Stefan Bodewig wrote: On Thu, Mar 1, 2018 at 7:28 AM, Gintautas Grigelionis < g.grigelio...@gmail.com> wrote: > I tried then to use the replacement tags as consistently as >>

Re: Ant documentation

2018-03-02 Thread Gintautas Grigelionis
2018-03-02 9:54 GMT+01:00 Stefan Bodewig : > On 2018-03-01, Stefan Bodewig wrote: > > >> On Thu, Mar 1, 2018 at 7:28 AM, Gintautas Grigelionis < > >> g.grigelio...@gmail.com> wrote: > > >>> I tried then to use the replacement tags as consistently as possible in > >>> such a large body of text, but

Re: Ant documentation

2018-03-02 Thread Stefan Bodewig
On 2018-03-01, Stefan Bodewig wrote: >> On Thu, Mar 1, 2018 at 7:28 AM, Gintautas Grigelionis < >> g.grigelio...@gmail.com> wrote: >>> I tried then to use the replacement tags as consistently as possible in >>> such a large body of text, but I realised that we perhaps need a kind of a >>> style g

Re: Ant documentation

2018-03-01 Thread Gintautas Grigelionis
2018-03-02 7:44 GMT+01:00 Jan Matèrne (jhm) : > > > > > I made an attempt to convert the manual to HTML 5, the rationale > > > > being > > > > > that HTML 5 deprecates tt tag and recommends to replace it with > > > > > tags like code, kbd, samp and var, which could be used in a more > > > > consis

AW: Ant documentation

2018-03-01 Thread jhm
> > > > I made an attempt to convert the manual to HTML 5, the rationale > > > being > > > > that HTML 5 deprecates tt tag and recommends to replace it with > > > > tags like code, kbd, samp and var, which could be used in a more > > > consistent > > > > way to achieve something closer to a semanti

Re: Ant documentation

2018-03-01 Thread Gintautas Grigelionis
2018-03-01 10:43 GMT+01:00 Jan Matèrne (jhm) : > > > I made an attempt to convert the manual to HTML 5, the rationale > > being > > > that HTML 5 deprecates tt tag and recommends to replace it with tags > > > like code, kbd, samp and var, which could be used in a more > > consistent > > > way to a

AW: Ant documentation

2018-03-01 Thread jhm
> > I made an attempt to convert the manual to HTML 5, the rationale > being > > that HTML 5 deprecates tt tag and recommends to replace it with tags > > like code, kbd, samp and var, which could be used in a more > consistent > > way to achieve something closer to a semantic markup. > > > > I trie

Re: Ant documentation

2018-03-01 Thread Stefan Bodewig
On 2018-03-01, Dominique Devienne wrote: > On Thu, Mar 1, 2018 at 7:28 AM, Gintautas Grigelionis < > g.grigelio...@gmail.com> wrote: >> I tried then to use the replacement tags as consistently as possible in >> such a large body of text, but I realised that we perhaps need a kind of a >> style gu

Re: Ant documentation

2018-03-01 Thread Dominique Devienne
On Thu, Mar 1, 2018 at 7:28 AM, Gintautas Grigelionis < g.grigelio...@gmail.com> wrote: > I made an attempt to convert the manual to HTML 5, the rationale being that > HTML 5 deprecates tt tag and recommends to replace it with tags like code, > kbd, samp and var, which could be used in a more cons

Ant documentation

2018-02-28 Thread Gintautas Grigelionis
I made an attempt to convert the manual to HTML 5, the rationale being that HTML 5 deprecates tt tag and recommends to replace it with tags like code, kbd, samp and var, which could be used in a more consistent way to achieve something closer to a semantic markup. I tried then to use the replaceme

Re: Ant Documentation Page Error (javac task "debug" tag)

2016-07-01 Thread Stefan Bodewig
On 2016-07-01, John Argentieri wrote: > This page has a note which I think may be causing some confusion. Is > the javac "debug" tag for ant really supposed to be "off"/"true"? or > is it really supposed to be "on"/"off"? If so, the last sentence is > incorrect...: Ant understand true/yes/on and

Ant Documentation Page Error (javac task "debug" tag)

2016-07-01 Thread John Argentieri
Dear Ant Devs, This page has a note which I think may be causing some confusion. Is the javac "debug" tag for ant really supposed to be "off"/"true"? or is it really supposed to be "on"/"off"? If so, the last sentence is incorrect...: https://ant.apache.org/manual/Tasks/javac.html Javac Tas

Re: Ant Documentation

2008-01-09 Thread Steve Loughran
Matt Benson wrote: You can also read about the gendoc sandbox Antlib at http://ant.apache.org/antlibs/sandbox.html . For some reason this has been in the sandbox over 2.5 years. I don't know where the time has gone... we use this @work to generate docs for libraries other than Ant itself...

AW: Ant Documentation

2007-12-19 Thread Jan.Materne
> Well, I found the following project on SourceForge, which uses Java's > Doclet API such that running JavaDoc outputs data to XML > instead of HTML: > > http://jeldoclet.sourceforge.net/ > > If the output is XML, then (theoretically) it could be > transformed into > DocBook format. Does this

Re: Ant Documentation

2007-12-18 Thread Matt Benson
You can also read about the gendoc sandbox Antlib at http://ant.apache.org/antlibs/sandbox.html . For some reason this has been in the sandbox over 2.5 years. I don't know where the time has gone... -Matt --- Tony Rogers <[EMAIL PROTECTED]> wrote: > Hi, > > Thanks for the response. :) > >

Re: Ant Documentation

2007-12-18 Thread Tony Rogers
Hi, Thanks for the response. :) One quick thought… Kevin Jackson wrote: > The docbook route for ant has been discussed a few times previously, I > even got the first part of the manual converted to pdf via saxen+fop, > but the discussion has revolved around a way of making the > documentation

Re: Ant Documentation

2007-12-17 Thread Kevin Jackson
Hi, > I've noticed that many newcomers are offered unit testing and > documentation as good places to start. This works out for me, because > I'm a huge believer in good documentation. > > If I'm browsing the repository correctly, it looks like the manual is > written in HTML. I think it would b

Ant Documentation

2007-12-17 Thread Tony Rogers
Hello, New list member here! My name's Tony. :) (Actually I joined a little while ago, and I meant to send this e-mail at that time, but things got busy for a bit. Things are better now.) I just started to gingerly begin participating in open source stuff. I've been using OSS for years, so as

DO NOT REPLY [Bug 37203] - Parts of the ant documentation link to online J2SDK 1.2 document which is gone

2005-10-22 Thread bugzilla
DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG· RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT . ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND· INSERTED IN THE BUG DATABASE. http://issues.apache.org/bugzilla/show_bu

DO NOT REPLY [Bug 37203] - Parts of the ant documentation link to online J2SDK 1.2 document which is gone

2005-10-22 Thread bugzilla
DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG· RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT . ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND· INSERTED IN THE BUG DATABASE. http://issues.apache.org/bugzilla/show_bu

DO NOT REPLY [Bug 14446] - Include "since" in ant documentation

2005-05-26 Thread bugzilla
DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG· RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT . ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND· INSERTED IN THE BUG DATABASE. http://issues.apache.org/bugzilla/show_bu

Re: Ant documentation

2005-03-10 Thread Steve Loughran
Steve Loughran wrote: Peter Reilly wrote: Steve Loughran wrote: Not unless we move to Java1.5 attributes :) This may be a while I know. I wasnt expecting any pick up there. Not until Jikes adds the support for parsing them, then we could say "ant runs on any platform, but you need jikes or j

Re: Ant documentation

2005-03-09 Thread Steve Loughran
Peter Reilly wrote: Steve Loughran wrote: Not unless we move to Java1.5 attributes :) This may be a while I know. I wasnt expecting any pick up there. Not until Jikes adds the support for parsing them, then we could say "ant runs on any platform, but you need jikes or javac 1.5+ to compile",

Re: Ant documentation

2005-03-09 Thread Stefan Bodewig
On Wed, 09 Mar 2005, Steve Loughran <[EMAIL PROTECTED]> wrote: > I hear that going via TeX gives you the best typesetting. Absolutely! And I'll stop here or I'll start moaning about people forcing me to use Word (fortunately the Office for X version) to create docs that look so much worse than t

RE: Ant documentation

2005-03-09 Thread Dominique Devienne
> From: Stefan Bodewig [mailto:[EMAIL PROTECTED] > > On Wed, 9 Mar 2005, Dominique Devienne <[EMAIL PROTECTED]> wrote: > >> From: Stefan Bodewig [mailto:[EMAIL PROTECTED] > > >> The problem with IntrospectionHelper vs. source code based is that > >> don't know which attributes are required/mutall

Re: Ant documentation

2005-03-09 Thread Stefan Bodewig
On Wed, 9 Mar 2005, Dominique Devienne <[EMAIL PROTECTED]> wrote: >> From: Stefan Bodewig [mailto:[EMAIL PROTECTED] >> The problem with IntrospectionHelper vs. source code based is that >> don't know which attributes are required/mutally exclusive whatever >> via IH. > > Yes and no Stefan. IH is

RE: Ant documentation

2005-03-09 Thread Dominique Devienne
> -Original Message- > From: Dominique Devienne [mailto:[EMAIL PROTECTED] > What I currently have Something else I have, which we coded with a co-worker here, is JavaScript code (that works in IE and FireFox, even though the FireFox's sort() is not stable) which allows to sort HTML tables

AW: Ant documentation

2005-03-09 Thread Jan . Materne
> > Not unless we move to Java1.5 attributes :) > > This may be a while No - I wouldnt change from 1.2 to 1.5 as minimum for Ant ;-) Jan

Re: Ant documentation

2005-03-09 Thread Peter Reilly
Steve Loughran wrote: Not unless we move to Java1.5 attributes :) This may be a while Peter - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] --

Re: Ant documentation

2005-03-09 Thread Peter Reilly
Stefan Bodewig wrote: On Wed, 9 Mar 2005, Matt Benson <[EMAIL PROTECTED]> wrote: --- Peter Reilly <[EMAIL PROTECTED]> wrote: This looks like a really cool method. Agreed; I have been following this discussion and had hoped that (especially with its latest additions) we could utilize

RE: Ant documentation

2005-03-09 Thread Dominique Devienne
> From: Stefan Bodewig [mailto:[EMAIL PROTECTED] > > On Wed, 9 Mar 2005, Matt Benson <[EMAIL PROTECTED]> wrote: > > --- Peter Reilly <[EMAIL PROTECTED]> wrote: > > > >> This looks like a really cool method. > > > > Agreed; I have been following this discussion and had > > hoped that (especially wi

Re: Ant documentation

2005-03-09 Thread Steve Loughran
Stefan Bodewig wrote: On Wed, 9 Mar 2005, Matt Benson <[EMAIL PROTECTED]> wrote: --- Peter Reilly <[EMAIL PROTECTED]> wrote: This looks like a really cool method. Agreed; I have been following this discussion and had hoped that (especially with its latest additions) we could utilize IntrospectionH

AW: Ant documentation

2005-03-09 Thread Jan . Materne
> >It's often frustrating, like IE eating up the space text nodes, > >so the XML syntax highlighting I describe above doesn't work with > >IE, and needs to be done with a proper (standard compliant) XSL > >engine (Xalan, Saxon, FireFox's XSL engine, etc...), but it's > >rewarding work ;-) I like it

RE: Ant documentation

2005-03-09 Thread Dominique Devienne
> From: Peter Reilly [mailto:[EMAIL PROTECTED] > >In what I have in mind, examples are not text (or CDATA sections), > >but actual XML, in order to keep the XML infoset, which is used to > >do the syntax highlighting. And along with syntax highlighting, you > >can add links to actual doc for all th

Re: Ant documentation

2005-03-09 Thread Stefan Bodewig
On Wed, 9 Mar 2005, Matt Benson <[EMAIL PROTECTED]> wrote: > --- Peter Reilly <[EMAIL PROTECTED]> wrote: > >> This looks like a really cool method. > > Agreed; I have been following this discussion and had > hoped that (especially with its latest additions) we > could utilize IntrospectionHelper

Re: Ant documentation

2005-03-09 Thread Matt Benson
--- Peter Reilly <[EMAIL PROTECTED]> wrote: > This looks like a really cool method. Agreed; I have been following this discussion and had hoped that (especially with its latest additions) we could utilize IntrospectionHelper in some way. -Matt > > Dominique Devienne wrote: [SNIP] > > > >What

Re: Ant documentation

2005-03-09 Thread Peter Reilly
This looks like a really cool method. Dominique Devienne wrote: From: Stefan Bodewig [mailto:[EMAIL PROTECTED] The main problem here is that there is no unique answer 8-) Right. I'm partial to XML + XSL myself for example. I like authoring the XML and just have to hit reload to see the HTML.

RE: Ant documentation

2005-03-09 Thread Dominique Devienne
> From: Stefan Bodewig [mailto:[EMAIL PROTECTED] > The main problem here is that there is no unique answer 8-) Right. I'm partial to XML + XSL myself for example. I like authoring the XML and just have to hit reload to see the HTML. I looked at docbook briefly, and found it verbose and unwieldy,

Re: Ant documentation

2005-03-09 Thread jfuller
[EMAIL PROTECTED] wrote .. > > > The main problem here is that there is no unique answer 8-) > > > > > > My guess is the following is more or less true: > > > > > > (1) autogenerate as much of the docs as possible from the Java sources. > > yes within reason opps hit the send button a little t

Re: Ant documentation

2005-03-09 Thread jfuller
> > The main problem here is that there is no unique answer 8-) > > > > My guess is the following is more or less true: > > > > (1) autogenerate as much of the docs as possible from the Java sources. yes within reason > > (2) throw in additional information in an easy to edit format. I would f

Re: Ant documentation

2005-03-09 Thread Steve Loughran
Stefan Bodewig wrote: On Wed, 09 Mar 2005, Kev Jackson <[EMAIL PROTECTED]> wrote: I've read this thread with interest (as you tend to do when your work is 'critiqued' :) ), but I'm still not sure what anyone actually wants, apart from some kind of generated docs that produce nice HTML output, and

Re: Ant documentation

2005-03-09 Thread Stefan Bodewig
On Wed, 09 Mar 2005, Kev Jackson <[EMAIL PROTECTED]> wrote: > I've read this thread with interest (as you tend to do when your > work is 'critiqued' :) ), but I'm still not sure what anyone > actually wants, apart from some kind of generated docs that produce > nice HTML output, and as an added bo

Re: Ant documentation

2005-03-09 Thread Kev Jackson
I tried to use docbook and ended up hating it too. Not enough macros see, you may be describing structure rather than style , but what I want is and , independent of the structure to use. Also, as it doesnt cross-ref across docs, it is not as good as bibtex. I have stopped using it for now;

Re: Ant documentation

2005-03-07 Thread Steve Loughran
Stefan Bodewig wrote: On Wed, 02 Mar 2005, Kev Jackson <[EMAIL PROTECTED]> wrote: Thoughts/comments more than welcome Being a LaTeX guy myself, I've grown some bad feelings towards docbook when I had to use it on one project. It's so powerless in comparision, but maybe that's only due to the def

Re: Ant documentation

2005-03-07 Thread Stefan Bodewig
On Wed, 02 Mar 2005, Kev Jackson <[EMAIL PROTECTED]> wrote: > Thoughts/comments more than welcome Being a LaTeX guy myself, I've grown some bad feelings towards docbook when I had to use it on one project. It's so powerless in comparision, but maybe that's only due to the default stylesheets and

Ant documentation

2005-03-02 Thread Kev Jackson
Since there has been some discussion about prodcuing better docs on the list I thought I'd look into it. I've recently debugged the AspectJ teams docbook, so I've had my head in the docbook format/FOP for a couple of weeks. I've just got a basic transform to PDF done of the first section (real

DO NOT REPLY [Bug 25705] - Various broken links and other errors in Ant documentation

2004-01-20 Thread bugzilla
gzilla/show_bug.cgi?id=25705 Various broken links and other errors in Ant documentation --- Additional Comments From [EMAIL PROTECTED] 2004-01-20 08:38 --- Nice class. But it seems that it can´t handle anchors inside html pages. E.g. it reported on my machine C:\seu\cvs-downloads\ant\an

DO NOT REPLY [Bug 25705] - Various broken links and other errors in Ant documentation

2003-12-22 Thread bugzilla
gzilla/show_bug.cgi?id=25705 Various broken links and other errors in Ant documentation --- Additional Comments From [EMAIL PROTECTED] 2003-12-22 17:57 --- Created an attachment (id=9666) Log of broken links and similar HTML

DO NOT REPLY [Bug 25705] New: - Various broken links and other errors in Ant documentation

2003-12-22 Thread bugzilla
gzilla/show_bug.cgi?id=25705 Various broken links and other errors in Ant documentation Summary: Various broken links and other errors in Ant documentation Product: Ant Version: 1.6.0 Platform: PC OS/Version: Linux Statu

DO NOT REPLY [Bug 22757] - Ant documentation not available

2003-08-28 Thread bugzilla
gzilla/show_bug.cgi?id=22757 Ant documentation not available [EMAIL PROTECTED] changed: What|Removed |Added Status|NEW |RESOLVED Reso

DO NOT REPLY [Bug 22757] New: - Ant documentation not available

2003-08-27 Thread bugzilla
gzilla/show_bug.cgi?id=22757 Ant documentation not available Summary: Ant documentation not available Product: Ant Version: unspecified Platform: Other OS/Version: Other Status: NEW Severity: Major Priority:

Re: Ant Documentation

2003-07-17 Thread Steve Loughran
Andrew Marlow wrote: [EMAIL PROTECTED] writes: Hi Andrew, I must confess I have downloaded your bz2 file but not yet opened it. I am interested by your work, because ant documentation needs to be improved, but my personal inclination would be to perfect the proposal of Erik Hatcher (with xdocs

Re: Ant Documentation

2003-07-17 Thread Erik Hatcher
On Thursday, July 17, 2003, at 01:31 PM, Andrew Marlow wrote: [EMAIL PROTECTED] writes: Hi Andrew, I must confess I have downloaded your bz2 file but not yet opened it. I am interested by your work, because ant documentation needs to be improved, but my personal inclination would be to perfect

Ant Documentation

2003-07-17 Thread Andrew Marlow
[EMAIL PROTECTED] writes: >Hi Andrew, >I must confess I have downloaded your bz2 file but not yet opened it. >I am interested by your work, because ant documentation needs to be >improved, but my personal inclination would be to perfect the proposal of >Erik Hatcher (with xdocs) W

Ant documentation as PDF and HTML

2003-07-09 Thread Andrew Marlow
Guys, I sent the email below to Steve Iseran but he is snowed under and suggested that I post it here. --- I have completed the first pass of the Ant document. And not a moment too soon it seems. Already I see checkin notices about certain page updates. Please check out my web page updates (http:

Re: Ant Documentation

2003-06-29 Thread Andrew Marlow
[EMAIL PROTECTED] writes: >Andrew Marlow wrote: >> Hello, >> The msg below was originally intended for Steve L, another >> Ant developer, but I have had trouble contacting him so >> I am now sending this to a wider audience. > >sorry I have been in crisis, but am glad you are on the main mail list

Re: AW: Ant Documentation

2003-06-29 Thread Andrew Marlow
[EMAIL PROTECTED] writes: >> I am trying to improve the Ant documentation. > >> I am using an approach which, with the help >> of some scripts I am working on, will finally result >> in a DocBook Ant manual. As a stepping stone to this end >> I am doing the documen

Re: Ant Documentation

2003-06-27 Thread Steve Loughran
Ant documentation. I would like to have a single multi-platform open format document. I understand that the project preference is to use DocBook. I am using an approach which, with the help of some scripts I am working on, will finally result in a DocBook Ant manual. As a stepping stone to this end

RE: Ant Documentation

2003-06-27 Thread Jim Fuller
f you would like. also there was no attatchment to your email. cheers, jim fuller > -Original Message- > From: Andrew Marlow [mailto:[EMAIL PROTECTED] > Sent: 27 June 2003 08:36 > To: [EMAIL PROTECTED] > Subject: Re: Ant Documentation > > > Hello, > > Th

AW: Ant Documentation

2003-06-27 Thread Jan . Materne
> I am trying to improve the Ant documentation. Always welcome :-) > I would like to have a single multi-platform open format > document. I understand that the project preference is to > use DocBook. DocBook? That´s really new to me. I only know the plain HTMLs. There are tests ge

Re: Ant Documentation

2003-06-27 Thread Andrew Marlow
Hello, The msg below was originally intended for Steve L, another Ant developer, but I have had trouble contacting him so I am now sending this to a wider audience. I am trying to improve the Ant documentation. I would like to have a single multi-platform open format document. I understand that

DO NOT REPLY [Bug 14446] - Include "since" in ant documentation

2003-03-06 Thread bugzilla
gzilla/show_bug.cgi?id=14446 Include "since" in ant documentation --- Additional Comments From [EMAIL PROTECTED] 2003-03-06 10:52 --- Maybe the @since comment can be used for set() and add|create() also. So it can be used for generating the doko via XDoclet. (There was a discu

DO NOT REPLY [Bug 14446] - Include "since" in ant documentation

2003-03-06 Thread bugzilla
gzilla/show_bug.cgi?id=14446 Include "since" in ant documentation --- Additional Comments From [EMAIL PROTECTED] 2003-03-06 10:49 --- I second this request; at least for every task the doco should give the lowest Ant version where this task surfaced first (similar to the s