Re: policy suggestion: API docs are not for users
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 it as an incidental tool
> > for building someone else's program) should install an ant-dev package,
> > too... but that seems slightly strange to me, since the person is
> > still acting as an end-user for the tool, instead of incorporating
> > it into their program.
>
> While you are correct in saying that in some cases, in order to use ant
> you need to extend it, I do feel that by extending ant, you then become
> an ant developer.
Mmmm... making a custom task is not really being Ant development...
> IMHO, it would be appropriate to have a separate package for those
> intending to extend ant as opposed to use it as-is.
But anyway, what about libx packages? Those are libraries too. Where is the
API documentation of those packages? It seems exactly like that...
Egon
Reply to: