Repeated builds, adding a delete to 'clobber' target and updating BUILDING.html

[Davide Grandi <da...@email.it>]

I've noticed that in repeated builds some directory where left on 
working folder,
even after executing 'clobber' target.

The solution, tested on current trunk, seems to add a line to 'clobber' 
target
and adding a note to BUILDING.html.

The work log is :
----------------------------------------------------------------------
1) checking out trunk
svn co https://svn.apache.org/repos/asf/db/derby/code/trunk .

2) looking deeply (even if now it's empty anyway)
--
C:\Altea\Progetti\Apache\derby\trunk>svn st --no-ignore

C:\Altea\Progetti\Apache\derby\trunk>
--

3) ant buildsource (or ant all - with the same results)
    svn st --no-ignore
--
I       classes
I       classes.pptesting
I       generated
I       release
I       tools\java\junit.jar
--

4) ant clobber
    svn st --no-ignore
--
I       classes.pptesting
I       tools\java\junit.jar
--
so it seems that 'clobber' target should clean also
     classes.pptesting
folder (junit.jar, IMHO, should stay there)

5) restarting from (1) and doing
    ant all
    ant buildjars
    ant clobber
    svn st --no-ignore
--
I       classes.pptesting
I       jars
I       tools\java\junit.jar
--
so it seems that clobber should delete also
     jars
*BUT *target 'cleanjars' already cleans current ${sanity.name} subfolder
so, when doing a full build, the sequence should be
     ant cleanjars
     ant clobber
     ant buildjars
    [ant javadoc]

6) for 'classes.pptesting' folder the related property seems :
        out.pptesting.dir
--
    out.base=${basedir}
    out.pptesting.dir=${out.base}/classes.pptesting
--

7) so, in order to delete it in 'clobber', one should change it to
--
   <target
       name="clobber"
depends="clean,cleangenerated,cleanstate,cleanreleasefiles"
       description="Remove all build artifacts."
   >
     <delete file="${out.base}/changenumber.properties"/>
     <delete file="${basedir}/jacoco.exec"/>
/*<delete dir="${out.pptesting.dir}"/> <!-- added -->*/
   </target>
--

8) Maybe one should also add a note to
     BUILDING.html
stating that for a rebuild the sequence should starts
     ant cleanjars clobber
e.g. :
--
  So, for the *first *build, do this:

     ant -quiet clobber
     ant -quiet buildsource
     ant -quiet buildjars

And for all *subsequent *builds, do this:

     ant -quiet *cleanjars *clobber
     ant -quiet buildsource
     ant -quiet buildjars
--
----------------------------------------------------------------------

Do you agree to these updates ?

Bye, from a sunny plain,

     Davide Grandi

-- 
Ing. Davide Grandi
email  : davide.grandi@email.it