make/README.pre-components
author mullan
Fri, 25 Apr 2008 08:58:07 -0400
changeset 485 a66666a5898c
parent 0 fd16c54261b3
child 1117 78c43ef52a0a
permissions -rw-r--r--
6690169: Specification for BasicPermission.equals() is not consistent Summary: Clarified @return to be consistent with method description Reviewed-by: vinnie
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
     1
README-pre-components:
fd16c54261b3 Initial load
duke
parents:
diff changeset
     2
---------------------
fd16c54261b3 Initial load
duke
parents:
diff changeset
     3
Current pre-components are langtools, jaxws, jaxp, and corba.
fd16c54261b3 Initial load
duke
parents:
diff changeset
     4
fd16c54261b3 Initial load
duke
parents:
diff changeset
     5
Pre-components can use ant to build but must have a make/Makefile for
fd16c54261b3 Initial load
duke
parents:
diff changeset
     6
building (a GNU make Makefile).
fd16c54261b3 Initial load
duke
parents:
diff changeset
     7
All ant knowledge is being isolated in the workspaces that use it.
fd16c54261b3 Initial load
duke
parents:
diff changeset
     8
fd16c54261b3 Initial load
duke
parents:
diff changeset
     9
Also for various reasons it is nice to have a Makefile wrapper over the
fd16c54261b3 Initial load
duke
parents:
diff changeset
    10
running of ant, but in general having to do
fd16c54261b3 Initial load
duke
parents:
diff changeset
    11
anything with shell commands is much easier to do in a Makefile
fd16c54261b3 Initial load
duke
parents:
diff changeset
    12
than in an ant script.
fd16c54261b3 Initial load
duke
parents:
diff changeset
    13
fd16c54261b3 Initial load
duke
parents:
diff changeset
    14
The make/makefile rules are:
fd16c54261b3 Initial load
duke
parents:
diff changeset
    15
fd16c54261b3 Initial load
duke
parents:
diff changeset
    16
 Variables:
fd16c54261b3 Initial load
duke
parents:
diff changeset
    17
  ALT_BOOTDIR           The jdk home to use to build, if provided
fd16c54261b3 Initial load
duke
parents:
diff changeset
    18
  ALT_LANGTOOLS_DIST    The dist area from a langtools build to use, if provided
fd16c54261b3 Initial load
duke
parents:
diff changeset
    19
  ALT_OUTPUTDIR         Parent dir of build and dist directories, if provided
fd16c54261b3 Initial load
duke
parents:
diff changeset
    20
  VARIANT               If DBG, debug build, if OPT, optimized build
fd16c54261b3 Initial load
duke
parents:
diff changeset
    21
  TARGET_CLASS_VERSION  The classfile version number (currently 5)
fd16c54261b3 Initial load
duke
parents:
diff changeset
    22
  ANT_HOME              Home of ant to use, if provided
fd16c54261b3 Initial load
duke
parents:
diff changeset
    23
  FINDBUGS_HOME         Home of findbugs to use, if provided
fd16c54261b3 Initial load
duke
parents:
diff changeset
    24
  QUIET                 If defined, be quiet
fd16c54261b3 Initial load
duke
parents:
diff changeset
    25
  VERBOSE               If defined, be verbose
fd16c54261b3 Initial load
duke
parents:
diff changeset
    26
  JDK_VERSION           Version being built
fd16c54261b3 Initial load
duke
parents:
diff changeset
    27
  FULL_VERSION          Full version string for this jdk build
fd16c54261b3 Initial load
duke
parents:
diff changeset
    28
  MILESTONE             fcs, beta, internal or empty
fd16c54261b3 Initial load
duke
parents:
diff changeset
    29
  BUILD_NUMBER          Number of the jdk build
fd16c54261b3 Initial load
duke
parents:
diff changeset
    30
  JPRT_ARCHIVE_BUNDLE   Path to zip bundle to create for JPRT
fd16c54261b3 Initial load
duke
parents:
diff changeset
    31
fd16c54261b3 Initial load
duke
parents:
diff changeset
    32
 Targets:
fd16c54261b3 Initial load
duke
parents:
diff changeset
    33
  all                   Build everything, including dist
fd16c54261b3 Initial load
duke
parents:
diff changeset
    34
  build                 Build build area
fd16c54261b3 Initial load
duke
parents:
diff changeset
    35
  clean                 Clean up
fd16c54261b3 Initial load
duke
parents:
diff changeset
    36
  clobber               Same as clean (don't ask)
fd16c54261b3 Initial load
duke
parents:
diff changeset
    37
  sanity                Perform any sanity checks, exit non-zero if errors
fd16c54261b3 Initial load
duke
parents:
diff changeset
    38
  jprt_build_product    JPRT product build, zip results into JPRT_ARCHIVE_BUNDLE
fd16c54261b3 Initial load
duke
parents:
diff changeset
    39
  jprt_build_debug      JPRT debug build, zip results into JPRT_ARCHIVE_BUNDLE
fd16c54261b3 Initial load
duke
parents:
diff changeset
    40
  jprt_build_fastdebug  JPRT fastdebug build, zip results into JPRT_ARCHIVE_BUNDLE
fd16c54261b3 Initial load
duke
parents:
diff changeset
    41
fd16c54261b3 Initial load
duke
parents:
diff changeset
    42
Then of course we expect a dist/lib/classes.jar, dist/lib/src.zip and dist/lib/bin.zip.