Re: policy suggestion: API docs are not for users

2003-01-03 Thread T. Alexander Popiel
In message: <[EMAIL PROTECTED]> Mark Howard <[EMAIL PROTECTED]> writes: [on creating custom tasks for ant] >When you say frequently, how often do you mean. I personally have never >had to extend ant (and so never needed the api). It really depends on what you're doing. If all you

Re: policy suggestion: API docs are not for users

2003-01-03 Thread T. Alexander Popiel
In message: <[EMAIL PROTECTED]> Mark Howard <[EMAIL PROTECTED]> writes: [on creating custom tasks for ant] >When you say frequently, how often do you mean. I personally have never >had to extend ant (and so never needed the api). It really depends on what you're doing. If all you

Re: policy suggestion: API docs are not for users

2003-01-03 Thread Ben Hill
Just my 2$ worth, but I use Ant in two different ways: Firstly I use Ant to automate my development effort, building components and apps and deploying to my app server etc. I also use Ant as a installation tool for applications I send to users. So I sent a mini copy of Ant, my app source (or bina

Re: policy suggestion: API docs are not for users

2003-01-03 Thread Ben Hill
Just my 2$ worth, but I use Ant in two different ways: Firstly I use Ant to automate my development effort, building components and apps and deploying to my app server etc. I also use Ant as a installation tool for applications I send to users. So I sent a mini copy of Ant, my app source (or bina

Re: policy suggestion: API docs are not for users

2003-01-02 Thread Egon Willighagen
On Thursday 02 January 2003 22:36, Joe Phillips wrote: > On Tue, 2002-12-31 at 17:53, T. Alexander Popiel wrote: > > Thus, the API is in the end-user docs, not just the developer docs. > > I suppose that one could argue that anyone trying to use ant for > > their own programs (instead of just using

Re: policy suggestion: API docs are not for users

2003-01-02 Thread Joe Phillips
On Tue, 2002-12-31 at 17:53, T. Alexander Popiel wrote: > Thus, the API is in the end-user docs, not just the developer docs. > I suppose that one could argue that anyone trying to use ant for > their own programs (instead of just using it as an incidental tool > for building someone else's progra

Re: policy suggestion: API docs are not for users

2003-01-02 Thread Mark Howard
On Tue, 2002-12-31 at 22:53, T. Alexander Popiel wrote: > > Ant is as much a framework as a tool; Thanks for the reply. I didn't know that much about ant - I had thought it was a mere application. When you say frequently, how often do you mean. I personally have never had to extend ant (and so

Re: policy suggestion: API docs are not for users

2003-01-02 Thread Egon Willighagen
On Thursday 02 January 2003 22:36, Joe Phillips wrote: > On Tue, 2002-12-31 at 17:53, T. Alexander Popiel wrote: > > Thus, the API is in the end-user docs, not just the developer docs. > > I suppose that one could argue that anyone trying to use ant for > > their own programs (instead of just using

Re: policy suggestion: API docs are not for users

2003-01-02 Thread Joe Phillips
On Tue, 2002-12-31 at 17:53, T. Alexander Popiel wrote: > Thus, the API is in the end-user docs, not just the developer docs. > I suppose that one could argue that anyone trying to use ant for > their own programs (instead of just using it as an incidental tool > for building someone else's progra

Re: policy suggestion: API docs are not for users

2003-01-02 Thread Mark Howard
On Tue, 2002-12-31 at 22:53, T. Alexander Popiel wrote: > > Ant is as much a framework as a tool; Thanks for the reply. I didn't know that much about ant - I had thought it was a mere application. When you say frequently, how often do you mean. I personally have never had to extend ant (and so

Re: policy suggestion: API docs are not for users

2002-12-31 Thread T. Alexander Popiel
In message: <[EMAIL PROTECTED]> Mark Howard <[EMAIL PROTECTED]> writes: >Hi, > I've just noticed that the user documentation package for ant (a tool, >not a library) contains 15 MB of API references. I've since filed bug >#174876 asking for this to be removed. Sadly, having the API

Re: policy suggestion: API docs are not for users

2002-12-31 Thread T. Alexander Popiel
In message: <[EMAIL PROTECTED]> Mark Howard <[EMAIL PROTECTED]> writes: >Hi, > I've just noticed that the user documentation package for ant (a tool, >not a library) contains 15 MB of API references. I've since filed bug >#174876 asking for this to be removed. Sadly, having the API

policy suggestion: API docs are not for users

2002-12-31 Thread Mark Howard
Hi, I've just noticed that the user documentation package for ant (a tool, not a library) contains 15 MB of API references. I've since filed bug #174876 asking for this to be removed. I think it might be useful for a comment to be added to section 2.3 of policy - Java Programs. perhaps something

policy suggestion: API docs are not for users

2002-12-31 Thread Mark Howard
Hi, I've just noticed that the user documentation package for ant (a tool, not a library) contains 15 MB of API references. I've since filed bug #174876 asking for this to be removed. I think it might be useful for a comment to be added to section 2.3 of policy - Java Programs. perhaps something