db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rick Hillegas <rick.hille...@oracle.com>
Subject Re: [jira] Updated: (DERBY-3986) Stop dropping build artifacts in the subversion-controlled source tree
Date Tue, 21 Sep 2010 19:21:26 GMT
Dag H. Wanvik wrote:
> Thanks for doing this cleanup, Rick!
>
> "Rick Hillegas (JIRA)" <jira@apache.org> writes:
>
>   
>> o Leave the other clean targets: clean, cleangenerated, cleanstate, clobber
>>     
>
> With so many similar souding targets it would nice to have good
> explanations of their differences in BUILDING.html. But maybe you
> already did that :)
>
> Dag
>
>   
Hi Dag,

I agree that our build scripts need better documentation. I can imagine 
two kinds of readers for this documentation:

1) People who need a bugfix and who want to build a distribution from 
the living, growing end of a branch.

2) People who are contributing patches to Derby and who want to 
understand the intricate details of our build environment.

I would like to keep BUILDING.html simple so that it addresses the needs 
of the first class of people but does not dismay them with too much 
detail. In order to help the second class of people, a good next step 
would be to systematically comment our public build targets so that "ant 
-projecthelp" describes our build system better. I have created a JIRA 
for this task: https://issues.apache.org/jira/browse/DERBY-4809.

Thanks,
-Rick

Mime
View raw message