db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Rick Hillegas (JIRA)" <j...@apache.org>
Subject [jira] Created: (DERBY-4841) Improve projecthelp for the top level Derby build script
Date Tue, 12 Oct 2010 15:33:35 GMT
Improve projecthelp for the top level Derby build script

                 Key: DERBY-4841
                 URL: https://issues.apache.org/jira/browse/DERBY-4841
             Project: Derby
          Issue Type: Improvement
          Components: Build tools
    Affects Versions:
            Reporter: Rick Hillegas

Ant scripts are supposed to be self-describing. The following command is supposed to describe
the public targets in the current directory:

    ant -projecthelp

Here is the output of this command for the top level build script today:

Main targets:

 checkCompilerLevel     Make sure compiler level is Java 5 level or higher.
 class_size_catalog     create the class size catalog -- a java file
 createBranch           Create a new branch (both docs and code)
 parsers                Build the parsers
 release                Build the release distributions
 setCompilerProperties  Set the ant variables which identify the compiler classpaths. Remove
the autosetProps logic when this target becomes mandatory.
 setInitialProperties   Set the initial properties for this build script. This duplicates
the property setting block in setCompilerProperties. Once we make setCompilerProperties mandatory,
this target should be removed.
 state                  Build SanityState.java
Default target: buildsource

That does not seem like the list of public targets to me. This JIRA can be used as a place
to anchor work which we do on improving the user documentation for our top level build script.

I propose to make some changes to build.xml. Others are welcome to pile on. Here's how it

1) The public targets are the ones which have "description" attributes.

2) So to make a target public, fill in a "description" attribute for it.

3) And to hide a target, move its "description" text into an introductory comment bracketed
by "<!--" and "-->"

This message is automatically generated by JIRA.
You can reply to this email to add a comment to the issue online.

View raw message