Makefile revision 3595
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Copyright (c) 1995, 2010, Oracle and/or its affiliates. All rights reserved.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# This code is free software; you can redistribute it and/or modify it
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# under the terms of the GNU General Public License version 2 only, as
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# published by the Free Software Foundation. Oracle designates this
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# particular file as subject to the "Classpath" exception as provided
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# by Oracle in the LICENSE file that accompanied this code.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# This code is distributed in the hope that it will be useful, but WITHOUT
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# version 2 for more details (a copy is included in the LICENSE file that
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# accompanied this code).
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# You should have received a copy of the GNU General Public License version
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# 2 along with this work; if not, write to the Free Software Foundation,
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# or visit www.oracle.com if you need additional information or have any
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Makefile for building and packaging all of the JDK and the JRE. See
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# also included files.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Make sure we are clear what the default target is
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Check target
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Help target
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganhelp: intro_help target_help variable_help notes_help examples_help
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Intro help message
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark LoganMakefile for the main JDK workspace. \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark LoganDefault behavior is to use the BOOTDIR javac to bootstrap the build and \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganimport in pre-built components like the VM from the JDK_IMPORT_PATH. \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Target help
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan--- Common Targets --- \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganall -- build the core JDK (default target) \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganhelp -- Print out help information \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logancheck -- Check make variable values for correctness \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logansanity -- Perform detailed sanity checks on system and settings \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganopenjdk -- synonym for 'OPENJDK=true all' \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganfastdebug -- build the core JDK in 'fastdebug' mode (-g -O) \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logandebug -- build the core JDK in 'debug' mode (-g) \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganclean -- remove all built and imported files \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganclobber -- same as clean \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logandocs -- run javadoc to generate the JDK documentation \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganimages -- build the jdk and jre image directories \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganimport -- copy in the pre-built components (e.g. VM) \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganimport_product -- copy in the product components \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganimport_fastdebug -- copy in the fastdebug components \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganimport_debug -- copy in the debug components \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganmodules -- build the jdk and jre module images (experimental) \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logancreate_links -- create softlinks in Solaris 32bit build to 64bit dirs \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Variable help (only common ones used by this workspace)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganvariable_help: variable_help_intro variable_list variable_help_end
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# One line descriptions for the variables
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark LoganPARALLEL_COMPILE_JOBS.desc = Solaris/Linux parallel compile run count
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark LoganSLASH_JAVA.desc = Root of all build tools, e.g. /java or J:
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark LoganLANGTOOLS_DIST.desc = langtools dist area used to build
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark LoganJDK_IMPORT_PATH.desc = JDK used to import components of the build
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark LoganDEVTOOLS_PATH.desc = Directory containing zip and unzip
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark LoganCUPS_HEADERS_PATH.desc = Include directory location for CUPS header files
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Make variables to print out (description and value)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Make variables that should refer to directories that exist
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Make variables that should refer to files that exist
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Some are windows specific
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# For pattern rules below, so all are treated the same
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark LoganDO_PRINTVAL_LIST=$(VARIABLE_PRINTVAL_LIST:%=%.printval)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark LoganDO_CHECKDIR_LIST=$(VARIABLE_CHECKDIR_LIST:%=%.checkdir)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark LoganDO_CHECKFIL_LIST=$(VARIABLE_CHECKFIL_LIST:%=%.checkfil)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Complete variable check
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganvariable_check: $(DO_CHECKDIR_LIST) $(DO_CHECKFIL_LIST)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Pattern rule for printing out a variable
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Pattern rule for checking to see if a variable with a directory exists
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan @if [ ! -d $($*) ] ; then \
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan $(ECHO) "WARNING: $* does not exist, try $(MAKE) sanity"; \
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Pattern rule for checking to see if a variable with a file exists
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan @if [ ! -f $($*) ] ; then \
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan $(ECHO) "WARNING: $* does not exist, try $(MAKE) sanity"; \
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Misc notes on help
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan--- Notes --- \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan- All builds use same output directory unless overridden with \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan \t ALT_OUTPUTDIR=<dir>, changing from product to fastdebug you may want \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan \t to use the clean target first. \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan- LANGTOOLS_DIST must refer to a langtools dist area, used to build. \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan- CORBA_DIST must refer to a corba dist area. \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan- JAXP_DIST must refer to a jaxp dist area. \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan- JAXWS_DIST must refer to a jaxws dist area. \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan- JDK_IMPORT_PATH must refer to a compatible build, not all past promoted \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan \t builds or previous release JDK builds will work. \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan- The 'debug' target and 'import_debug' only works when a debug promoted \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan \t build is available, and they currently are not. \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan- The fastest builds have been when the workspace and the BOOTDIR are on \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan \t local disk. \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan--- Examples --- \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan $(MAKE) ALT_OUTPUTDIR=/tmp/foobar fastdebug images \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan $(MAKE) ALT_OUTPUTDIR=/tmp/foobar all docs images \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan $(MAKE) ALT_JDK_IMPORT_PATH=/opt/java/jdk1.7.0 \n\
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# 'all' target intro
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan @$(ECHO) $(PLATFORM) $(ARCH) $(RELEASE) build started: $(shell $(DATE) '+%y-%m-%d %H:%M')
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan# Just in case anyone uses this old name, same as 'build'
$(OTHERSUBDIRS-loop)
$(MKDIR) -p $@
all::
@if [ -r $(WARNING_FILE) ]; then \
echo "Creating link for $$sd"; \
$(CAT) $<; \
@$(RM) $@
$(RM) $@