Makefile
author ihse
Fri, 16 Jan 2015 16:02:09 +0100
changeset 28902 0c09b47449c8
parent 28286 02d8f96d7c92
child 29662 78c47f0002c3
permissions -rw-r--r--
8069064: Various improvements and fixes in build system Reviewed-by: erikj
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
     1
#
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
     2
# Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved.
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
     3
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
fd16c54261b3 Initial load
duke
parents:
diff changeset
     4
#
fd16c54261b3 Initial load
duke
parents:
diff changeset
     5
# This code is free software; you can redistribute it and/or modify it
fd16c54261b3 Initial load
duke
parents:
diff changeset
     6
# under the terms of the GNU General Public License version 2 only, as
5499
eb0b3e373167 6943119: Rebrand source copyright notices
ohair
parents: 4309
diff changeset
     7
# published by the Free Software Foundation.  Oracle designates this
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
     8
# particular file as subject to the "Classpath" exception as provided
5499
eb0b3e373167 6943119: Rebrand source copyright notices
ohair
parents: 4309
diff changeset
     9
# by Oracle in the LICENSE file that accompanied this code.
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    10
#
fd16c54261b3 Initial load
duke
parents:
diff changeset
    11
# This code is distributed in the hope that it will be useful, but WITHOUT
fd16c54261b3 Initial load
duke
parents:
diff changeset
    12
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
fd16c54261b3 Initial load
duke
parents:
diff changeset
    13
# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
fd16c54261b3 Initial load
duke
parents:
diff changeset
    14
# version 2 for more details (a copy is included in the LICENSE file that
fd16c54261b3 Initial load
duke
parents:
diff changeset
    15
# accompanied this code).
fd16c54261b3 Initial load
duke
parents:
diff changeset
    16
#
fd16c54261b3 Initial load
duke
parents:
diff changeset
    17
# You should have received a copy of the GNU General Public License version
fd16c54261b3 Initial load
duke
parents:
diff changeset
    18
# 2 along with this work; if not, write to the Free Software Foundation,
fd16c54261b3 Initial load
duke
parents:
diff changeset
    19
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
fd16c54261b3 Initial load
duke
parents:
diff changeset
    20
#
5499
eb0b3e373167 6943119: Rebrand source copyright notices
ohair
parents: 4309
diff changeset
    21
# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
eb0b3e373167 6943119: Rebrand source copyright notices
ohair
parents: 4309
diff changeset
    22
# or visit www.oracle.com if you need additional information or have any
eb0b3e373167 6943119: Rebrand source copyright notices
ohair
parents: 4309
diff changeset
    23
# questions.
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    24
#
fd16c54261b3 Initial load
duke
parents:
diff changeset
    25
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    26
# This must be the first rule
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    27
default:
17
bb9f330cd95a 6649672: Adjustments to OUTPUTDIR default and mkdirs to avoid empty directory clutter
ohair
parents: 16
diff changeset
    28
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    29
# Inclusion of this pseudo-target will cause make to execute this file
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    30
# serially, regardless of -j. Recursively called makefiles will not be
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    31
# affected, however. This is required for correct dependency management.
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    32
.NOTPARALLEL:
9618
83db8167c9f6 7043700: Regression for IcedTea builds
ohair
parents: 9309
diff changeset
    33
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    34
# The shell code below will be executed on /usr/ccs/bin/make on Solaris, but not in GNU make.
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    35
# /usr/ccs/bin/make lacks basically every other flow control mechanism.
27595
cff167b3bfa2 8065914: Various improvements and cleanup of build system
ihse
parents: 26548
diff changeset
    36
.TEST_FOR_NON_GNUMAKE:sh=echo You are not using GNU make/gmake, this is a requirement. Check your path. 1>&2 && exit 1
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    37
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    38
# Assume we have GNU make, but check version.
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    39
ifeq ($(strip $(foreach v, 3.81% 3.82% 4.%, $(filter $v, $(MAKE_VERSION)))), )
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    40
  $(error This version of GNU Make is too low ($(MAKE_VERSION)). Check your path, or upgrade to 3.81 or newer.)
874
638ddad10e12 6728161: Add SKIP_BOOT_CYCLE feature to create boot jdk and use it during build
ohair
parents: 668
diff changeset
    41
endif
638ddad10e12 6728161: Add SKIP_BOOT_CYCLE feature to create boot jdk and use it during build
ohair
parents: 668
diff changeset
    42
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    43
# Locate this Makefile
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    44
ifeq ($(filter /%,$(lastword $(MAKEFILE_LIST))),)
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    45
  makefile_path:=$(CURDIR)/$(lastword $(MAKEFILE_LIST))
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    46
else
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    47
  makefile_path:=$(lastword $(MAKEFILE_LIST))
874
638ddad10e12 6728161: Add SKIP_BOOT_CYCLE feature to create boot jdk and use it during build
ohair
parents: 668
diff changeset
    48
endif
27595
cff167b3bfa2 8065914: Various improvements and cleanup of build system
ihse
parents: 26548
diff changeset
    49
root_dir:=$(patsubst %/,%,$(dir $(makefile_path)))
cff167b3bfa2 8065914: Various improvements and cleanup of build system
ihse
parents: 26548
diff changeset
    50
28902
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
    51
ifeq ($(MAIN_TARGETS), )
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
    52
  COMMAND_LINE_VARIABLES:=$(subst =command,,$(filter %=command,$(foreach var,$(.VARIABLES),$(var)=$(firstword $(origin $(var))))))
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
    53
  MAKE_CONTROL_VARIABLES:=LOG CONF SPEC JOBS TEST IGNORE_OLD_CONFIG
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
    54
  UNKNOWN_COMMAND_LINE_VARIABLES:=$(strip $(filter-out $(MAKE_CONTROL_VARIABLES), $(COMMAND_LINE_VARIABLES)))
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
    55
  ifneq ($(UNKNOWN_COMMAND_LINE_VARIABLES), )
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
    56
    $(info Note: Command line contains non-control variables: $(UNKNOWN_COMMAND_LINE_VARIABLES).)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
    57
    $(info Make sure it is not mistyped, and that you intend to override this variable.)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
    58
    $(info 'make help' will list known control variables)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
    59
  endif
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
    60
endif
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
    61
27595
cff167b3bfa2 8065914: Various improvements and cleanup of build system
ihse
parents: 26548
diff changeset
    62
ifneq ($(findstring qp,$(MAKEFLAGS)),)
cff167b3bfa2 8065914: Various improvements and cleanup of build system
ihse
parents: 26548
diff changeset
    63
  # When called with -qp, assume an external part (e.g. bash completion) is trying
cff167b3bfa2 8065914: Various improvements and cleanup of build system
ihse
parents: 26548
diff changeset
    64
  # to understand our targets.
cff167b3bfa2 8065914: Various improvements and cleanup of build system
ihse
parents: 26548
diff changeset
    65
  # Duplication of global targets, needed before ParseConfAndSpec in case we have
cff167b3bfa2 8065914: Various improvements and cleanup of build system
ihse
parents: 26548
diff changeset
    66
  # no configurations.
cff167b3bfa2 8065914: Various improvements and cleanup of build system
ihse
parents: 26548
diff changeset
    67
  help:
28286
02d8f96d7c92 8068726: Tab completion of targets fails when current dir is the output dir
erikj
parents: 27602
diff changeset
    68
  # If both CONF and SPEC are unset, look for all available configurations by
02d8f96d7c92 8068726: Tab completion of targets fails when current dir is the output dir
erikj
parents: 27602
diff changeset
    69
  # setting CONF to the empty string.
02d8f96d7c92 8068726: Tab completion of targets fails when current dir is the output dir
erikj
parents: 27602
diff changeset
    70
  ifeq ($(SPEC), )
02d8f96d7c92 8068726: Tab completion of targets fails when current dir is the output dir
erikj
parents: 27602
diff changeset
    71
    CONF?=
02d8f96d7c92 8068726: Tab completion of targets fails when current dir is the output dir
erikj
parents: 27602
diff changeset
    72
  endif
27595
cff167b3bfa2 8065914: Various improvements and cleanup of build system
ihse
parents: 26548
diff changeset
    73
endif
874
638ddad10e12 6728161: Add SKIP_BOOT_CYCLE feature to create boot jdk and use it during build
ohair
parents: 668
diff changeset
    74
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    75
# ... and then we can include our helper functions
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    76
include $(root_dir)/make/MakeHelpers.gmk
15903
bc0e6cd9d760 8008914: Add nashorn to the tl build
jjg
parents: 15064
diff changeset
    77
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    78
$(eval $(call ParseLogLevel))
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    79
$(eval $(call ParseConfAndSpec))
8441
30f5ad688d4a 7021753: Add a build times report
ohrstrom
parents: 7876
diff changeset
    80
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    81
# Now determine if we have zero, one or several configurations to build.
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    82
ifeq ($(SPEC),)
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    83
  # Since we got past ParseConfAndSpec, we must be building a global target. Do nothing.
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
    84
else
25854
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
    85
  # In Cygwin, the MAKE variable gets messed up if the make executable is called with
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
    86
  # a Windows mixed path (c:/cygwin/bin/make.exe). If that's the case, fix it by removing
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
    87
  # the prepended root_dir.
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
    88
  ifneq ($(findstring :, $(MAKE)), )
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
    89
    MAKE := $(patsubst $(root_dir)%, %, $(MAKE))
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
    90
  endif
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
    91
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
    92
  # We are potentially building multiple configurations.
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
    93
  # First, find out the valid targets
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
    94
  # Run the makefile with an arbitrary SPEC using -p -q (quiet dry-run and dump rules) to find
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
    95
  # available PHONY targets. Use this list as valid targets to pass on to the repeated calls.
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
    96
  all_phony_targets := $(sort $(filter-out $(global_targets), $(strip $(shell \
26548
3b002da2aee1 8058118: Generate modules.list during the build
erikj
parents: 26398
diff changeset
    97
      cd $(root_dir)/make && $(MAKE) -f Main.gmk -p -q FRC SPEC=$(firstword $(SPEC)) \
3b002da2aee1 8058118: Generate modules.list during the build
erikj
parents: 26398
diff changeset
    98
      -I $(root_dir)/make/common | grep "^.PHONY:" | head -n 1 | cut -d " " -f 2-))))
25854
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
    99
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   100
  # Loop through the configurations and call the main-wrapper for each one. The wrapper
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   101
  # target will execute with a single configuration loaded.
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   102
  $(all_phony_targets):
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   103
	@$(if $(TARGET_RUN),,\
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   104
          $(foreach spec,$(SPEC),\
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   105
            (cd $(root_dir) && $(MAKE) SPEC=$(spec) MAIN_TARGETS="$(call GetRealTarget)" \
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   106
	    $(VERBOSE) VERBOSE=$(VERBOSE) LOG_LEVEL=$(LOG_LEVEL) main-wrapper) &&) true)
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   107
	@echo > /dev/null
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   108
	$(eval TARGET_RUN=true)
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   109
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   110
  .PHONY: $(all_phony_targets)
874
638ddad10e12 6728161: Add SKIP_BOOT_CYCLE feature to create boot jdk and use it during build
ohair
parents: 668
diff changeset
   111
25854
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   112
  ifneq ($(MAIN_TARGETS), )
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   113
    # The wrapper target was called so we now have a single configuration. Load the spec file
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   114
    # and call the real Main.gmk.
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   115
    include $(SPEC)
27595
cff167b3bfa2 8065914: Various improvements and cleanup of build system
ihse
parents: 26548
diff changeset
   116
    include $(SRC_ROOT)/make/common/MakeBase.gmk
874
638ddad10e12 6728161: Add SKIP_BOOT_CYCLE feature to create boot jdk and use it during build
ohair
parents: 668
diff changeset
   117
25854
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   118
    ### Clean up from previous run
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   119
    # Remove any build.log from a previous run, if they exist
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   120
    ifneq (,$(BUILD_LOG))
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   121
      ifneq (,$(BUILD_LOG_PREVIOUS))
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   122
        # Rotate old log
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   123
        $(shell $(RM) $(BUILD_LOG_PREVIOUS) 2> /dev/null)
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   124
        $(shell $(MV) $(BUILD_LOG) $(BUILD_LOG_PREVIOUS) 2> /dev/null)
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   125
      else
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   126
        $(shell $(RM) $(BUILD_LOG) 2> /dev/null)
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   127
      endif
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   128
      $(shell $(RM) $(OUTPUT_ROOT)/build-trace-time.log 2> /dev/null)
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   129
    endif
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   130
    # Remove any javac server logs and port files. This
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   131
    # prevents a new make run to reuse the previous servers.
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   132
    ifneq (,$(SJAVAC_SERVER_DIR))
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   133
      $(shell $(MKDIR) -p $(SJAVAC_SERVER_DIR) && $(RM) -rf $(SJAVAC_SERVER_DIR)/*)
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   134
    endif
874
638ddad10e12 6728161: Add SKIP_BOOT_CYCLE feature to create boot jdk and use it during build
ohair
parents: 668
diff changeset
   135
26398
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   136
    # Split out the targets requiring sequential execution. Run these targets separately
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   137
    # from the rest so that the rest may still enjoy full parallel execution.
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   138
    SEQUENTIAL_TARGETS := $(filter dist-clean clean% reconfigure, $(MAIN_TARGETS))
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   139
    PARALLEL_TARGETS := $(filter-out $(SEQUENTIAL_TARGETS), $(MAIN_TARGETS))
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   140
25854
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   141
    main-wrapper:
26398
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   142
        ifneq ($(SEQUENTIAL_TARGETS), )
26548
3b002da2aee1 8058118: Generate modules.list during the build
erikj
parents: 26398
diff changeset
   143
	  (cd $(SRC_ROOT)/make && $(MAKE) -f Main.gmk SPEC=$(SPEC) -j 1 \
26398
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   144
	      $(VERBOSE) VERBOSE=$(VERBOSE) LOG_LEVEL=$(LOG_LEVEL) $(SEQUENTIAL_TARGETS))
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   145
        endif
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   146
        ifneq ($(PARALLEL_TARGETS), )
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   147
	  @$(call AtMakeStart)
26548
3b002da2aee1 8058118: Generate modules.list during the build
erikj
parents: 26398
diff changeset
   148
	  (cd $(SRC_ROOT)/make && $(BUILD_LOG_WRAPPER) $(MAKE) -f Main.gmk SPEC=$(SPEC) -j $(JOBS) \
26398
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   149
	      $(VERBOSE) VERBOSE=$(VERBOSE) LOG_LEVEL=$(LOG_LEVEL) $(PARALLEL_TARGETS) \
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   150
	      $(if $(filter true, $(OUTPUT_SYNC_SUPPORTED)), -O$(OUTPUT_SYNC)))
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   151
	  @$(call AtMakeEnd)
ca1f84f97e20 8057537: Serialize reconfigure and fix make clean-foo foo
erikj
parents: 26128
diff changeset
   152
        endif
25854
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   153
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   154
     .PHONY: main-wrapper
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   155
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   156
   endif
874
638ddad10e12 6728161: Add SKIP_BOOT_CYCLE feature to create boot jdk and use it during build
ohair
parents: 668
diff changeset
   157
endif
638ddad10e12 6728161: Add SKIP_BOOT_CYCLE feature to create boot jdk and use it during build
ohair
parents: 668
diff changeset
   158
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
   159
# Here are "global" targets, i.e. targets that can be executed without specifying a single configuration.
25854
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   160
# If you add more global targets, please update the variable global_targets in MakeHelpers.
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
   161
28902
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   162
# Helper macro to allow $(info) to properly print strings beginning with spaces.
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   163
_:=
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   164
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
   165
help:
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
   166
	$(info )
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
   167
	$(info OpenJDK Makefile help)
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
   168
	$(info =====================)
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
   169
	$(info )
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
   170
	$(info Common make targets)
28902
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   171
	$(info $(_) make [default]         # Compile all modules in langtools, hotspot, jdk, jaxws,)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   172
	$(info $(_)                        # jaxp and corba, and create a runnable "exploded" image)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   173
	$(info $(_) make all               # Compile everything, all repos, docs and images)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   174
	$(info $(_) make images            # Create complete j2sdk and j2re images)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   175
	$(info $(_) make <phase>           # Build the specified phase and everything it depends on)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   176
	$(info $(_)                        # (gensrc, java, copy, libs, launchers, gendata, rmic))
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   177
	$(info $(_) make *-only            # Applies to most targets and disables compling the)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   178
	$(info $(_)                        # dependencies for the target. This is faster but may)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   179
	$(info $(_)                        # result in incorrect build results!)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   180
	$(info $(_) make docs              # Create all docs)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   181
	$(info $(_) make docs-javadoc      # Create just javadocs, depends on less than full docs)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   182
	$(info $(_) make profiles          # Create complete j2re compact profile images)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   183
	$(info $(_) make bootcycle-images  # Build images twice, second time with newly built JDK)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   184
	$(info $(_) make install           # Install the generated images locally)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   185
	$(info $(_) make reconfigure       # Rerun configure with the same arguments as last time)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   186
	$(info $(_) make help              # Give some help on using make)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   187
	$(info $(_) make test              # Run tests, default is all tests (see TEST below))
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
   188
	$(info )
27560
adc258b13e2c 8049367: Modular Run-Time Images
chegar
parents: 26548
diff changeset
   189
	$(info Targets for cleaning)
28902
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   190
	$(info $(_) make clean             # Remove all files generated by make, but not those)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   191
	$(info $(_)                        # generated by configure)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   192
	$(info $(_) make dist-clean        # Remove all files, including configuration)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   193
	$(info $(_) make clean-<outputdir> # Remove the subdir in the output dir with the name)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   194
	$(info $(_) make clean-<phase>     # Remove all build results related to a certain build)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   195
	$(info $(_)                        # phase (gensrc, java, libs, launchers))
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   196
	$(info $(_) make clean-<module>    # Remove all build results related to a certain module)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   197
	$(info $(_) make clean-<module>-<phase> # Remove all build results related to a certain)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   198
	$(info $(_)                        # module and phase)
27560
adc258b13e2c 8049367: Modular Run-Time Images
chegar
parents: 26548
diff changeset
   199
	$(info )
25854
98ce0879ab4c 8054834: Modular Source Code
chegar
parents: 22031
diff changeset
   200
	$(info Targets for specific modules)
28902
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   201
	$(info $(_) make <module>          # Build <module> and everything it depends on.)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   202
	$(info $(_) make <module>-<phase>  # Compile the specified phase for the specified module)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   203
	$(info $(_)                        # and everything it depends on)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   204
	$(info $(_)                        # (gensrc, java, copy, libs, launchers, gendata, rmic))
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
   205
	$(info )
28902
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   206
	$(info Make control variables)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   207
	$(info $(_) CONF=                  # Build all configurations (note, assignment is empty))
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   208
	$(info $(_) CONF=<substring>       # Build the configuration(s) with a name matching)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   209
	$(info $(_)                        # <substring>)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   210
	$(info $(_) SPEC=<spec file>       # Build the configuration given by the spec file)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   211
	$(info $(_) LOG=<loglevel>         # Change the log level from warn to <loglevel>)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   212
	$(info $(_)                        # Available log levels are:)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   213
	$(info $(_)                        # 'warn' (default), 'info', 'debug' and 'trace')
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   214
	$(info $(_)                        # To see executed command lines, use LOG=debug)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   215
	$(info $(_) JOBS=<n>               # Run <n> parallel make jobs)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   216
	$(info $(_)                        # Note that -jN does not work as expected!)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   217
	$(info $(_) IGNORE_OLD_CONFIG=true # Skip tests if spec file is up to date)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   218
	$(info $(_) make test TEST=<test>  # Only run the given test or tests, e.g.)
0c09b47449c8 8069064: Various improvements and fixes in build system
ihse
parents: 28286
diff changeset
   219
	$(info $(_)                        # make test TEST="jdk_lang jdk_net")
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
   220
	$(info )
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
   221
21759
e24e22311718 8027566: Remove the old build system
ihse
parents: 19758
diff changeset
   222
.PHONY: help