214997 - build.xml changes: clean and help targets.

Status: VERIFIED FIXED

(Rhino Graveyard :: Core, defect)

Description

[Igor Bukanov]

Current build.xml files do not contain clean target which effectively requires
manually delete build/classes to recompile everything. This is very inconvenient
since full recompilation is often necessary even after trivial changes in java
sources due to And/javac deficiencies.

Another usability improvement would be to separate building of js.jar from
copying sources into build  directory since the latter is rarely needed accept
when generating full distribution. I also suggest to make generation of js.jar
the default target and and a special help target to list most useful targets.

Comment 1

[Igor Bukanov]

Attachment: Adding clean, deepclean, help targets and making possible to invoke build.xml from src and toolsrc standalone

The patch adds clean, deepclean, help targets and reorganize build.xml files so
src/build.xml and toolsrc/build.xml can be used directly to compile/clean
src/toolsrc.

In this way running 
ant -find build.xml compile
or
ant -find build.xml compile

from any nested source directory would compile/clean only files from
corresponding source subtree.

I changed the deafult target in the root build.xml to help which prints:

properties:

help:
     [echo] The following targets are available with this build file:
     [echo] 
     [echo]  clean	 remove all compiled classes and copied property files
     [echo] 
     [echo]  compile	 compile all classes and copy all property files
     [echo]		 into ./build/classes directory
     [echo] 
     [echo]  deepclean	 remove all generated files and directories
     [echo] 
     [echo]  dist	 create rhino1_5R5pre.zip with full Rhino distribution
     [echo] 
     [echo]  help	 print this help
     [echo] 
     [echo]  jar	 create js.jar in ./build/rhino1_5R5pre
     [echo] 
     [echo]  javadoc	 generate generate Rhino API documentation
     [echo]		 in ./build/rhino1_5R5pre/docs/apidocs
     [echo] 
     [echo]  source-zip  create rhino1_5R5pre-sources.zip with all Rhino
     [echo]		 source files necessary to recreate js.jar

Comment 2

[Igor Bukanov]

I committed the patch.

Comment 3

[Phil Schwartau]

Checkin verified -

Comment 4

[Igor Bukanov]

Trageting as resolved against 1.5R5