Build Targets

This appendix lists some targets available for building the MIDP Reference Implementation. Many targets that operate on the source files are in the top-level makefile, GNUmakefile. The file is in the directory midpInstallDir\build\win32\kvm on Windows 2000 and
midpInstallDir/build/linux or midpInstallDir/build/solaris on a UNIX^® platform.

The targets that create API documentation are in either the makefile midpInstallDir\build\share\makefiles\Docs.gmk or the makefile midpInstallDir\build\share\makefiles\Release.gmk. The build environment uses the Javadoc™ software to create documentation targets.

A.1 Basic Build Targets

The following table describes the main build targets for the MIDP Reference Implementation build environment.

TABLE 8 – Basic Build Targets
Target	Purpose	Description
all	Release bundle	Creates a MIDP Reference Implementation executable and builds the examples. This is the default target.
auction audiodemo demos fonts games manyballs photoalbum pushpuzzle stock	Release bundle	Builds the named example.
example	Release bundle	Builds all of the examples.
classes.zip	Release bundle	Compiles and preverifies Java programming language files.
clean	Preparation for creating a new build.	Removes all the class files, object files, and other temporary build files from the MIDP Reference Implementation build environment. It does not remove virtual machine (VM) tools or cryptographic object files.
reallyclean	Preparation for creating a new build.	Removes everything in the `clean` target, plus the contents of the midpInstallDir`\build\appdb` storage directory and all VM tools. It does not remove VM tools or cryptographic object files.
insanelyclean	Preparation for creating a new build.	Removes everything in the `reallyclean` target and all crytographic object files. Note: Do not use the `insanelyclean` target unless you have the SSL source files supplied under special agreement with Sun Microsystems. If you use this target but do not have access to the cryptographic source, you will not be able to rebuild the MIDP Reference Implementation executable without reinstalling MIDP Reference Implementation.
docs_html	Documentation	Generates the API reference documentation in HTML for the MIDP Reference Implementation and CLDC classes.

A.2 Advanced Build Targets

The following table describes some special-purpose targets for creating release documentation and bundles for external use. These build targets are not typically used. For example, the targets that create release bundles are intended to meet the needs of the expert group deploying the specification and the initial reference implementation.

TABLE 9 – Advanced Build Targets
Target	Target Purpose	Description
midp-src	Release bundle	Creates a source bundle that includes the MIDP Reference Implementation reference implementation source code.
midp-docs	Documentation	Creates a documentation bundle that includes the combined CLDC and MIDP Reference Implementation API reference documentation.
midp-dist	Release bundle	Creates a release bundle that includes a MIDP Reference Implementation executable and reference implementation.
docs_all	Documentation	Generates the API reference documentation in HTML for the MIDP Reference Implementation and CLDC classes, including their private fields and methods.
docs_mid	Documentation	Generates the API reference documentation in HTML for the MIDP Reference Implementation classes. Because this target does not create API documentation for CLDC, it does not include links to CLDC classes and methods.

Appendix A

Build Targets

A.1 Basic Build Targets

A.2 Advanced Build Targets