common/autoconf/help.m4

Mon, 14 Sep 2020 16:42:03 +0100

author
andrew
date
Mon, 14 Sep 2020 16:42:03 +0100
changeset 2554
7f60c2d9823e
parent 2400
9da665f87c4b
child 2408
2e38e8d106de
permissions
-rw-r--r--

Added tag jdk8u272-b08 for changeset 34c6baf21464

ohair@425 1 #
kevinw@2206 2 # Copyright (c) 2011, 2018, Oracle and/or its affiliates. All rights reserved.
ohair@425 3 # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
ohair@425 4 #
ohair@425 5 # This code is free software; you can redistribute it and/or modify it
ohair@425 6 # under the terms of the GNU General Public License version 2 only, as
ohair@425 7 # published by the Free Software Foundation. Oracle designates this
ohair@425 8 # particular file as subject to the "Classpath" exception as provided
ohair@425 9 # by Oracle in the LICENSE file that accompanied this code.
ohair@425 10 #
ohair@425 11 # This code is distributed in the hope that it will be useful, but WITHOUT
ohair@425 12 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
ohair@425 13 # FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
ohair@425 14 # version 2 for more details (a copy is included in the LICENSE file that
ohair@425 15 # accompanied this code).
ohair@425 16 #
ohair@425 17 # You should have received a copy of the GNU General Public License version
ohair@425 18 # 2 along with this work; if not, write to the Free Software Foundation,
ohair@425 19 # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
ohair@425 20 #
ohair@425 21 # Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
ohair@425 22 # or visit www.oracle.com if you need additional information or have any
ohair@425 23 # questions.
ohair@425 24 #
ohair@425 25
erikj@458 26 AC_DEFUN_ONCE([HELP_SETUP_DEPENDENCY_HELP],
erikj@458 27 [
ihse@839 28 AC_CHECK_PROGS(PKGHANDLER, apt-get yum port pkgutil pkgadd)
erikj@458 29 ])
erikj@458 30
erikj@458 31 AC_DEFUN([HELP_MSG_MISSING_DEPENDENCY],
erikj@458 32 [
ihse@839 33 # Print a helpful message on how to acquire the necessary build dependency.
ihse@868 34 # $1 is the help tag: freetype, cups, pulse, alsa etc
ihse@839 35 MISSING_DEPENDENCY=$1
ohair@425 36
ihse@862 37 if test "x$OPENJDK_BUILD_OS_ENV" = "xwindows.cygwin"; then
ihse@862 38 cygwin_help $MISSING_DEPENDENCY
ihse@862 39 elif test "x$OPENJDK_BUILD_OS_ENV" = "xwindows.msys"; then
ihse@862 40 msys_help $MISSING_DEPENDENCY
ihse@862 41 else
ihse@862 42 PKGHANDLER_COMMAND=
ohair@425 43
ihse@862 44 case $PKGHANDLER in
ihse@862 45 apt-get)
ihse@862 46 apt_help $MISSING_DEPENDENCY ;;
ihse@862 47 yum)
ihse@862 48 yum_help $MISSING_DEPENDENCY ;;
ihse@862 49 port)
ihse@862 50 port_help $MISSING_DEPENDENCY ;;
ihse@862 51 pkgutil)
ihse@862 52 pkgutil_help $MISSING_DEPENDENCY ;;
ihse@862 53 pkgadd)
ihse@862 54 pkgadd_help $MISSING_DEPENDENCY ;;
ihse@862 55 esac
ihse@862 56
ihse@862 57 if test "x$PKGHANDLER_COMMAND" != x; then
ihse@862 58 HELP_MSG="You might be able to fix this by running '$PKGHANDLER_COMMAND'."
ihse@862 59 fi
ihse@839 60 fi
erikj@458 61 ])
ohair@425 62
ohair@494 63 cygwin_help() {
ihse@839 64 case $1 in
ohair@494 65 unzip)
ihse@862 66 PKGHANDLER_COMMAND="( cd <location of cygwin setup.exe> && cmd /c setup -q -P unzip )"
ihse@862 67 HELP_MSG="You might be able to fix this by running '$PKGHANDLER_COMMAND'."
ihse@862 68 ;;
ohair@494 69 zip)
ihse@862 70 PKGHANDLER_COMMAND="( cd <location of cygwin setup.exe> && cmd /c setup -q -P zip )"
ihse@862 71 HELP_MSG="You might be able to fix this by running '$PKGHANDLER_COMMAND'."
ihse@862 72 ;;
ohair@494 73 make)
ihse@862 74 PKGHANDLER_COMMAND="( cd <location of cygwin setup.exe> && cmd /c setup -q -P make )"
ihse@862 75 HELP_MSG="You might be able to fix this by running '$PKGHANDLER_COMMAND'."
ihse@862 76 ;;
ihse@868 77 freetype)
kevinw@2220 78 HELP_MSG="
kevinw@2220 79 The freetype library can now be build during the configure process.
kevinw@2220 80 Download the freetype sources and unpack them into an arbitrary directory:
kevinw@2220 81
kevinw@2220 82 wget http://download.savannah.gnu.org/releases/freetype/freetype-2.5.3.tar.gz
kevinw@2220 83 tar -xzf freetype-2.5.3.tar.gz
kevinw@2220 84
kevinw@2220 85 Then run configure with '--with-freetype-src=<freetype_src>'. This will
kevinw@2220 86 automatically build the freetype library into '<freetype_src>/lib64' for 64-bit
kevinw@2220 87 builds or into '<freetype_src>/lib32' for 32-bit builds.
kevinw@2220 88 Afterwards you can always use '--with-freetype-include=<freetype_src>/include'
kevinw@2220 89 and '--with-freetype-lib=<freetype_src>/lib[32|64]' for other builds."
ihse@862 90 ;;
ihse@839 91 esac
ohair@494 92 }
ohair@494 93
ihse@862 94 msys_help() {
ihse@862 95 PKGHANDLER_COMMAND=""
ihse@862 96 }
ihse@862 97
erikj@458 98 apt_help() {
ihse@839 99 case $1 in
ohair@425 100 devkit)
ihse@839 101 PKGHANDLER_COMMAND="sudo apt-get install build-essential" ;;
ohair@425 102 openjdk)
ihse@839 103 PKGHANDLER_COMMAND="sudo apt-get install openjdk-7-jdk" ;;
ohair@425 104 alsa)
ihse@839 105 PKGHANDLER_COMMAND="sudo apt-get install libasound2-dev" ;;
ohair@425 106 cups)
ihse@839 107 PKGHANDLER_COMMAND="sudo apt-get install libcups2-dev" ;;
prr@2400 108 fontconfig)
prr@2400 109 PKGHANDLER_COMMAND="sudo apt-get install libfontconfig1-dev" ;;
ihse@868 110 freetype)
ihse@839 111 PKGHANDLER_COMMAND="sudo apt-get install libfreetype6-dev" ;;
ohair@425 112 pulse)
ihse@839 113 PKGHANDLER_COMMAND="sudo apt-get install libpulse-dev" ;;
ohair@425 114 x11)
ihse@839 115 PKGHANDLER_COMMAND="sudo apt-get install libX11-dev libxext-dev libxrender-dev libxtst-dev libxt-dev" ;;
ohair@425 116 ccache)
ihse@839 117 PKGHANDLER_COMMAND="sudo apt-get install ccache" ;;
ihse@839 118 esac
ohair@425 119 }
ohair@425 120
erikj@458 121 yum_help() {
ihse@839 122 case $1 in
ohair@425 123 devkit)
ihse@839 124 PKGHANDLER_COMMAND="sudo yum groupinstall \"Development Tools\"" ;;
ohair@425 125 openjdk)
ihse@839 126 PKGHANDLER_COMMAND="sudo yum install java-1.7.0-openjdk" ;;
ohair@425 127 alsa)
ihse@839 128 PKGHANDLER_COMMAND="sudo yum install alsa-lib-devel" ;;
ohair@425 129 cups)
ihse@839 130 PKGHANDLER_COMMAND="sudo yum install cups-devel" ;;
prr@2400 131 fontconfig)
prr@2400 132 PKGHANDLER_COMMAND="sudo yum install fontconfig-devel" ;;
ihse@868 133 freetype)
ihse@839 134 PKGHANDLER_COMMAND="sudo yum install freetype-devel" ;;
ohair@425 135 pulse)
ihse@839 136 PKGHANDLER_COMMAND="sudo yum install pulseaudio-libs-devel" ;;
ohair@425 137 x11)
ihse@839 138 PKGHANDLER_COMMAND="sudo yum install libXtst-devel libXt-devel libXrender-devel" ;;
ohair@425 139 ccache)
ihse@839 140 PKGHANDLER_COMMAND="sudo yum install ccache" ;;
ihse@839 141 esac
ohair@425 142 }
ohair@425 143
erikj@458 144 port_help() {
ihse@839 145 PKGHANDLER_COMMAND=""
ohair@425 146 }
ohair@425 147
erikj@458 148 pkgutil_help() {
ihse@839 149 PKGHANDLER_COMMAND=""
ohair@425 150 }
ohair@425 151
erikj@458 152 pkgadd_help() {
ihse@839 153 PKGHANDLER_COMMAND=""
ohair@425 154 }
erikj@458 155
kevinw@2206 156 # This function will check if we're called from the "configure" wrapper while
kevinw@2206 157 # printing --help. If so, we will print out additional information that can
kevinw@2206 158 # only be extracted within the autoconf script, and then exit. This must be
kevinw@2206 159 # called at the very beginning in configure.ac.
kevinw@2206 160 AC_DEFUN_ONCE([HELP_PRINT_ADDITIONAL_HELP_AND_EXIT],
kevinw@2206 161 [
kevinw@2206 162 if test "x$CONFIGURE_PRINT_TOOLCHAIN_LIST" != x; then
kevinw@2206 163 $PRINTF "The following toolchains are available as arguments to --with-toolchain-type.\n"
kevinw@2206 164 $PRINTF "Which are valid to use depends on the build platform.\n"
kevinw@2206 165 for toolchain in $VALID_TOOLCHAINS_all; do
kevinw@2206 166 # Use indirect variable referencing
kevinw@2206 167 toolchain_var_name=TOOLCHAIN_DESCRIPTION_$toolchain
kevinw@2206 168 TOOLCHAIN_DESCRIPTION=${!toolchain_var_name}
kevinw@2206 169 $PRINTF " %-10s %s\n" $toolchain "$TOOLCHAIN_DESCRIPTION"
kevinw@2206 170 done
kevinw@2206 171
kevinw@2206 172 # And now exit directly
kevinw@2206 173 exit 0
kevinw@2206 174 fi
kevinw@2206 175 ])
kevinw@2206 176
erikj@458 177 AC_DEFUN_ONCE([HELP_PRINT_SUMMARY_AND_WARNINGS],
erikj@458 178 [
ihse@839 179 # Finally output some useful information to the user
erikj@458 180
ihse@839 181 printf "\n"
ihse@839 182 printf "====================================================\n"
ihse@839 183 printf "A new configuration has been successfully created in\n"
ihse@839 184 printf "$OUTPUT_ROOT\n"
ihse@839 185 if test "x$CONFIGURE_COMMAND_LINE" != x; then
ihse@839 186 printf "using configure arguments '$CONFIGURE_COMMAND_LINE'.\n"
ihse@839 187 else
ihse@839 188 printf "using default settings.\n"
ihse@839 189 fi
erikj@458 190
ihse@839 191 printf "\n"
ihse@839 192 printf "Configuration summary:\n"
ihse@839 193 printf "* Debug level: $DEBUG_LEVEL\n"
ihse@839 194 printf "* JDK variant: $JDK_VARIANT\n"
ihse@839 195 printf "* JVM variants: $with_jvm_variants\n"
ihse@839 196 printf "* OpenJDK target: OS: $OPENJDK_TARGET_OS, CPU architecture: $OPENJDK_TARGET_CPU_ARCH, address length: $OPENJDK_TARGET_CPU_BITS\n"
ohair@494 197
ihse@839 198 printf "\n"
ihse@839 199 printf "Tools summary:\n"
ihse@839 200 if test "x$OPENJDK_BUILD_OS" = "xwindows"; then
ihse@839 201 printf "* Environment: $WINDOWS_ENV_VENDOR version $WINDOWS_ENV_VERSION (root at $WINDOWS_ENV_ROOT_PATH)\n"
ihse@839 202 fi
ihse@839 203 printf "* Boot JDK: $BOOT_JDK_VERSION (at $BOOT_JDK)\n"
kevinw@2228 204 printf "* Toolchain: $TOOLCHAIN_TYPE ($TOOLCHAIN_DESCRIPTION)\n"
kevinw@2206 205 printf "* C Compiler: Version $CC_VERSION_NUMBER (at $CC)\n"
kevinw@2206 206 printf "* C++ Compiler: Version $CXX_VERSION_NUMBER (at $CXX)\n"
erikj@458 207
ihse@839 208 printf "\n"
ihse@839 209 printf "Build performance summary:\n"
ihse@839 210 printf "* Cores to use: $JOBS\n"
ihse@839 211 printf "* Memory limit: $MEMORY_SIZE MB\n"
kevinw@2203 212 if test "x$CCACHE_STATUS" != "x"; then
kevinw@2203 213 printf "* ccache status: $CCACHE_STATUS\n"
kevinw@2203 214 fi
ihse@839 215 printf "\n"
erikj@458 216
ihse@839 217 if test "x$BUILDING_MULTIPLE_JVM_VARIANTS" = "xyes"; then
ihse@839 218 printf "NOTE: You have requested to build more than one version of the JVM, which\n"
ihse@839 219 printf "will result in longer build times.\n"
ihse@839 220 printf "\n"
ihse@839 221 fi
erikj@458 222
ihse@839 223 if test "x$FOUND_ALT_VARIABLES" != "x"; then
ihse@839 224 printf "WARNING: You have old-style ALT_ environment variables set.\n"
ihse@839 225 printf "These are not respected, and will be ignored. It is recommended\n"
ihse@839 226 printf "that you clean your environment. The following variables are set:\n"
ihse@839 227 printf "$FOUND_ALT_VARIABLES\n"
ihse@839 228 printf "\n"
ihse@839 229 fi
erikj@458 230
ihse@839 231 if test "x$OUTPUT_DIR_IS_LOCAL" != "xyes"; then
ihse@839 232 printf "WARNING: Your build output directory is not on a local disk.\n"
ihse@839 233 printf "This will severely degrade build performance!\n"
ihse@839 234 printf "It is recommended that you create an output directory on a local disk,\n"
ihse@839 235 printf "and run the configure script again from that directory.\n"
ihse@839 236 printf "\n"
ihse@839 237 fi
erikj@458 238
ihse@839 239 if test "x$IS_RECONFIGURE" = "xyes"; then
ihse@839 240 printf "WARNING: The result of this configuration has overridden an older\n"
ihse@839 241 printf "configuration. You *should* run 'make clean' to make sure you get a\n"
ihse@839 242 printf "proper build. Failure to do so might result in strange build problems.\n"
ihse@839 243 printf "\n"
ihse@839 244 fi
kevinw@2228 245
kevinw@2228 246 if test "x$UNSUPPORTED_TOOLCHAIN_VERSION" = "xyes"; then
kevinw@2228 247 printf "WARNING: The toolchain version used is known to have issues. Please\n"
kevinw@2228 248 printf "consider using a supported version unless you know what you are doing.\n"
kevinw@2228 249 printf "\n"
kevinw@2228 250 fi
erikj@458 251 ])

mercurial