make/README.pre-components
author sundar
Fri, 12 Jul 2013 20:12:29 +0530
changeset 18873 7907640d3be5
parent 3305 7ca56c8ba510
permissions -rw-r--r--
Merge
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
3305
7ca56c8ba510 6854244: change source/target used to compile JDK to 7
jjg
parents: 1117
diff changeset
    21
  TARGET_CLASS_VERSION  The classfile version number (currently 7)
0
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
  QUIET                 If defined, be quiet
fd16c54261b3 Initial load
duke
parents:
diff changeset
    24
  VERBOSE               If defined, be verbose
fd16c54261b3 Initial load
duke
parents:
diff changeset
    25
  JDK_VERSION           Version being built
fd16c54261b3 Initial load
duke
parents:
diff changeset
    26
  FULL_VERSION          Full version string for this jdk build
fd16c54261b3 Initial load
duke
parents:
diff changeset
    27
  MILESTONE             fcs, beta, internal or empty
fd16c54261b3 Initial load
duke
parents:
diff changeset
    28
  BUILD_NUMBER          Number of the jdk build
fd16c54261b3 Initial load
duke
parents:
diff changeset
    29
  JPRT_ARCHIVE_BUNDLE   Path to zip bundle to create for JPRT
fd16c54261b3 Initial load
duke
parents:
diff changeset
    30
fd16c54261b3 Initial load
duke
parents:
diff changeset
    31
 Targets:
fd16c54261b3 Initial load
duke
parents:
diff changeset
    32
  all                   Build everything, including dist
fd16c54261b3 Initial load
duke
parents:
diff changeset
    33
  build                 Build build area
fd16c54261b3 Initial load
duke
parents:
diff changeset
    34
  clean                 Clean up
fd16c54261b3 Initial load
duke
parents:
diff changeset
    35
  clobber               Same as clean (don't ask)
fd16c54261b3 Initial load
duke
parents:
diff changeset
    36
  sanity                Perform any sanity checks, exit non-zero if errors
fd16c54261b3 Initial load
duke
parents:
diff changeset
    37
  jprt_build_product    JPRT product build, zip results into JPRT_ARCHIVE_BUNDLE
fd16c54261b3 Initial load
duke
parents:
diff changeset
    38
  jprt_build_debug      JPRT debug build, zip results into JPRT_ARCHIVE_BUNDLE
fd16c54261b3 Initial load
duke
parents:
diff changeset
    39
  jprt_build_fastdebug  JPRT fastdebug build, zip results into JPRT_ARCHIVE_BUNDLE
fd16c54261b3 Initial load
duke
parents:
diff changeset
    40
fd16c54261b3 Initial load
duke
parents:
diff changeset
    41
Then of course we expect a dist/lib/classes.jar, dist/lib/src.zip and dist/lib/bin.zip.