ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Jay Glanville" <dic...@nortelnetworks.com>
Subject RE: [PATCH] attempt 2 at javac refactoring.
Date Thu, 21 Dec 2000 16:04:03 GMT
Diane, what documentation are you looking for?  In my mind, there are three
levels of documentation: code, usage, and delta-purpose.  And I believe in
documentation, 
- Code: Hopefully I commented the code well enough.  I want the person
behind me to quickly understand my intentions.
- Usage: I believe that I modified the index.html document to reflect the
changes to how to use the <javac> task.
- Delta-purpose: Proper documentation of what I changed and why.  In my
second submission, I didn't do much of this type documentation as it would
have virtually been verbatim as my first submission, with the differences
pointed out.

What type of documentation are you looking for, and I'll try my best to
satisfy your needs.  ;-)

JDGlanville

> -----Original Message-----
> From: Diane Holt [mailto:holtdl@yahoo.com]
> Sent: Wednesday, December 20, 2000 3:22 PM
> To: ant-dev@jakarta.apache.org
> Subject: Re: [PATCH] attempt 2 at javac refactoring.
> 
> 
> --- Jay Glanville <dickon@nortelnetworks.com> wrote:
> > In a previous posting, Stefan B had mentioned that after 
> the AntEater
> > proposal, that submissions had almost dried up.  Well, here is my
> > attempt to add some water to the stream.
> 
> I don't know how persnickety the commiters will be about the lack of
> documentation for this, but personally, I'd like to see some. :)
> 
> Thanks,
> Diane

> 

Mime
View raw message