common/makefiles/JavaCompilation.gmk
changeset 12258 6ec26f6cc53e
child 12801 948f8ad66ee7
equal deleted inserted replaced
12251:a6e6d42203e6 12258:6ec26f6cc53e
       
     1 #
       
     2 # Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved.
       
     3 # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
       
     4 #
       
     5 # This code is free software; you can redistribute it and/or modify it
       
     6 # under the terms of the GNU General Public License version 2 only, as
       
     7 # published by the Free Software Foundation.  Oracle designates this
       
     8 # particular file as subject to the "Classpath" exception as provided
       
     9 # by Oracle in the LICENSE file that accompanied this code.
       
    10 #
       
    11 # This code is distributed in the hope that it will be useful, but WITHOUT
       
    12 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
       
    13 # FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
       
    14 # version 2 for more details (a copy is included in the LICENSE file that
       
    15 # accompanied this code).
       
    16 #
       
    17 # You should have received a copy of the GNU General Public License version
       
    18 # 2 along with this work; if not, write to the Free Software Foundation,
       
    19 # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
       
    20 #
       
    21 # Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
       
    22 # or visit www.oracle.com if you need additional information or have any
       
    23 # questions.
       
    24 #
       
    25 
       
    26 # The complexity of this makefile is not the fault of make, but the fault
       
    27 # of javac and javah. The basic problems are:
       
    28 #
       
    29 #    1) Compiling a single Java source file unpredictably generates anything
       
    30 #       between zero (0!) and an infinite number of .class files!
       
    31 #    2) There is no hint, for which classes javah needs to be run,
       
    32 #       and it happily generates .h files for classes with no native methods.
       
    33 #    3) javac and javah do not cleanup anything, for example if an internal
       
    34 #       class (potentially with native methods) is removed from a Java source file.
       
    35 #
       
    36 # This makefile is a tribute to GNU make. And yes, it was harder to write than it is
       
    37 # to read. The include/excludes of directories and files are only a temporary measure
       
    38 # to work around the messy jdk sources that put platform specific code in src/share/classes.
       
    39 #
       
    40 # We should move most of the functionality of this makefile into a
       
    41 # smart javac/javah/javadoc/jar combo tool. sjavac ?
       
    42 #
       
    43 # I.e. 1) It always generates a single output, a zip-file from a number of source roots.
       
    44 #         The zip file contains information that enable incremental builds with full 
       
    45 #         dependency tracking between packages.
       
    46 #      2) It automatically generates the right .h files.
       
    47 #      3) It keeps its house clean.
       
    48 #      *) Generates intermediate files to be used for javadoc generation later.
       
    49 #      and does all the other useful things that this makefile does, such as:
       
    50 #          use all cores for compilation, reuse the running JVM for all compilations,
       
    51 #          and has pubapi dependency tracking to minimize the number of files
       
    52 #          that need to be recompiled during an incremental build.
       
    53 # 
       
    54 # A zip file, or several zip files combined, can then be converted to a .jar file, or to a .jmod file.
       
    55 #
       
    56 # This would make this makefile much much simpler. I.e. make can be used
       
    57 # for its real purpose, track dependencies and trigger a recompile if a
       
    58 # dependency has changed.
       
    59 #
       
    60 # When you read this source. Remember that $(sort ...) has the side effect
       
    61 # of removing duplicates. It is actually this side effect that is
       
    62 # desired whenever sort is used below!
       
    63 
       
    64 ifeq  (,$(_MAKEBASE_GMK))
       
    65     $(error You must include MakeBase.gmk prior to including JavaCompilation.gmk)
       
    66 endif
       
    67 
       
    68 FALSE_FIND_PATTERN:=-name FILE_NAME_THAT_DOESNT_EXIST
       
    69 
       
    70 # If compilation of java package fails, then the public api file for that
       
    71 # package will not be genereated. We add this fallback rule to generate
       
    72 # an empty pubapi file. 
       
    73 %.api:
       
    74 	if test ! -f $@; then $(MKDIR) -p $(@D); $(TOUCH) $@; fi
       
    75 
       
    76 define SetupJavaCompiler
       
    77     # param 1 is for example BOOT_JAVAC or NEW_JAVAC
       
    78     # This is the name later used to decide which java compiler to use.
       
    79     # param 2-9 are named args.
       
    80     #   JVM:=The jvm used to run the javac/javah command
       
    81     #   JAVAC:=The javac jar and bootstrap classpath changes, or just bin/javac if JVM is left out
       
    82     #   JAVAH:=The javah jar and bootstrap classpath changes, or just bin/javah if JVM is left out
       
    83     #   FLAGS:=Flags to be supplied to javac
       
    84     #   MODE:=SINGLE_THREADED_BATCH (primarily for old javac) or MULTI_CORE_CONCURRENT
       
    85     #      only for MULTI_CORE_CONCURRENT are the options below relevant:
       
    86     #   SERVER_DIR:=Use a javac server (-XDserver) and store the server related files here
       
    87     #   SERVER_JVM:=Use this JVM for the server. Defaults to the JVM above.
       
    88     #   USE_DEPS:=true means use -XDdeps,-XDpubapi and -XDnativeapi to track java dependencies
       
    89     $(if $2,$1_$(strip $2))
       
    90     $(if $3,$1_$(strip $3))
       
    91     $(if $4,$1_$(strip $4))
       
    92     $(if $5,$1_$(strip $5))
       
    93     $(if $6,$1_$(strip $6))
       
    94     $(if $7,$1_$(strip $7))
       
    95     $(if $8,$1_$(strip $8))
       
    96     $(if $9,$1_$(strip $9))
       
    97 
       
    98     ifeq ($$($1_MODE),MULTI_CORE_CONCURRENT)
       
    99 	ifneq (,$$($1_SERVER_DIR))
       
   100             # A javac server has been requested.
       
   101             # The port file contains the tcp/ip on which the server listens
       
   102             # and the cookie necessary to talk to the server.
       
   103             $1_JAVAC_PORTFILE:=$$($1_SERVER_DIR)/$1.port
       
   104             ifeq ($$($1_SERVER_JVM),)
       
   105                 # You can use a different JVM to run the background javac server.
       
   106                 # But if not set, it defaults to the same JVM that is used to start
       
   107                 # the javac command.
       
   108                 $1_SERVER_JVM:=$$($1_JVM)
       
   109             endif
       
   110             # Set the $1_REMOTE to spawn a background javac server.
       
   111 	    $1_REMOTE:=-XDserver:portfile=$$($1_JAVAC_PORTFILE),poolsize=$(JAVAC_SERVER_CORES),javac=$$(subst $$(SPACE),%20,$$(subst $$(COMMA),%2C,$$(strip $$($1_SERVER_JVM) $$($1_JAVAC))))
       
   112         endif
       
   113     endif
       
   114 endef
       
   115 
       
   116 define SetupArchive
       
   117     # param 1 is for example ARCHIVE_MYPACKAGE
       
   118     # param 2 are the dependecies
       
   119     # param 3,4,5,6,7,8,9 are named args.
       
   120     #    SRCS:=List of directories in where to find files to add to archive
       
   121     #    SUFFIXES:=File suffixes to include in jar
       
   122     #    INCLUDES:=List of directories/packages in SRCS that should be included
       
   123     #    EXCLUDES:=List of directories/packages in SRCS that should be excluded
       
   124     #    EXCLUDE_FILES:=List of files in SRCS that should be excluded
       
   125     #    EXTRA_FILES:=List of files in SRCS that should be included regardless of suffix match.
       
   126     #    JAR:=Jar file to create
       
   127     #    MANIFEST:=Optional manifest file template.
       
   128     #    JARMAIN:=Optional main class to add to manifest
       
   129     #    SETUP:=The Java(h) compiler setup, needed to run javah.
       
   130     #    HEADERS:=Directory to put headers in
       
   131     #    SKIP_METAINF:=Set to prevent contents of an META-INF directory to be automatically 
       
   132     #                  added to the archive.
       
   133     #    EXTRA_MANIFEST_ATTR:=Extra attribute to add to manifest.
       
   134     $(if $3,$1_$(strip $3))
       
   135     $(if $4,$1_$(strip $4))
       
   136     $(if $5,$1_$(strip $5))
       
   137     $(if $6,$1_$(strip $6))
       
   138     $(if $7,$1_$(strip $7))
       
   139     $(if $8,$1_$(strip $8))
       
   140     $(if $9,$1_$(strip $9))
       
   141     $(if $(10),$1_$(strip $(10)))
       
   142     $(if $(11),$1_$(strip $(11)))
       
   143     $(if $(12),$1_$(strip $(12)))
       
   144     $(if $(13),$1_$(strip $(13)))
       
   145     $(if $(14),$1_$(strip $(14)))
       
   146 
       
   147     $1_JVM   := $$($$($1_SETUP)_JVM)
       
   148     $1_JAVAH := $$($$($1_SETUP)_JAVAH)
       
   149     $1_JARMAIN:=$(strip $$($1_JARMAIN))
       
   150     $1_JARNAME:=$$(notdir $$($1_JAR))
       
   151     $1_MANIFEST_FILE:=$$(dir $$($1_JAR))_the.$$($1_JARNAME)_manifest
       
   152     $1_DELETESS_FILE:=$$(dir $$($1_JAR))_the.$$($1_JARNAME)_deletess
       
   153     $1_DELETES_FILE:=$$(dir $$($1_JAR))_the.$$($1_JARNAME)_deletes
       
   154     $1_PUBAPI_NOTIFICATIONS_FILE:=$$(dir $$($1_JAR))_the.$$($1_JARNAME)_pubapi_notifications
       
   155     $1_NATIVEAPI_NOTIFICATIONS_FILE:=$$(dir $$($1_JAR))_the.$$($1_JARNAME)_native_notifications
       
   156     $1_NATIVEAPI_FILE:=$$(dir $$($1_JAR))_the.$$($1_JARNAME)_native
       
   157     $1_BIN:=$$(dir $$($1_JAR))
       
   158     ifeq (,$$($1_SUFFIXES))
       
   159         # No suffix was set, default to classes.
       
   160         $1_SUFFIXES:=.class
       
   161     endif
       
   162     # Convert suffixes to a find expression
       
   163     $1_FIND_PATTERNS:=$(FALSE_FIND_PATTERN) $$(patsubst %,$(SPACE)-o$(SPACE)-name$(SPACE)$(DQUOTE)*%$(DQUOTE),$$($1_SUFFIXES))
       
   164     ifneq (,$$($1_INCLUDES))
       
   165         $1_GREP_INCLUDES:=| $(GREP) $$(foreach src,$$($1_SRCS),$$(addprefix -e$(SPACE)$$(src)/,$$($1_INCLUDES)))
       
   166     endif
       
   167     ifneq (,$$($1_EXCLUDES)$$($1_EXCLUDE_FILES))
       
   168         $1_GREP_EXCLUDES:=| $(GREP) -v $$(foreach src,$$($1_SRCS),$$(addprefix -e$(SPACE)$$(src)/,$$($1_EXCLUDES) $$($1_EXCLUDE_FILES)))
       
   169     endif
       
   170 
       
   171     # Utility macros, to make the shell script receipt somewhat easier to dechipher.
       
   172 
       
   173     # The capture contents macro finds all files (matching the patterns, typically
       
   174     # .class and .prp) that are newer than the jar-file, ie the new content to be put into the jar.
       
   175     $1_CAPTURE_CONTENTS=$$(foreach src,$$($1_SRCS),(($(FIND) $$(src) -type f -a \( $$($1_FIND_PATTERNS) \) -a -newer $$@ $$($1_GREP_INCLUDES) $$($1_GREP_EXCLUDES) && $(ECHO) $$($1_EXTRA_FILES)) | $(SED) 's|$$(src)/||g' > $$(src)/_the.$$($1_JARNAME)_contents) && )
       
   176     # The capture metainf macro finds all files below the META-INF directory that are newer than the jar-file.
       
   177     ifeq (,$$($1_SKIP_METAINF))
       
   178         $1_CAPTURE_METAINF =$$(foreach src,$$($1_SRCS),($(FIND) $$(src)/META-INF -type f -a -newer $$@ 2> /dev/null | $(SED) 's|$$(src)/||g' >> $$(src)/_the.$$($1_JARNAME)_contents ) && )
       
   179     endif
       
   180     # The capture deletes macro finds all deleted files and concatenates them. The resulting file
       
   181     # tells us what to remove from the jar-file.
       
   182     $1_CAPTURE_DELETES=$$(foreach src,$$($1_SRCS),($(FIND) $$(src) -name _the.package.deleted -newer $$@ -exec $(SED) 's|$$(src)||g' \{\} >> $$($1_DELETES_FILE) \;) &&)
       
   183     # The capture pubapi notifications scans for pubapi change notifications. If such notifications are
       
   184     # found, then we will build the classes leading up to the jar again, to take into account the new timestamps
       
   185     # on the changed pubapi files.
       
   186     $1_CAPTURE_PUBAPI_NOTIFICATIONS=$$(foreach src,$$($1_SRCS),\
       
   187                     (cd $$(src) && \
       
   188                     $(FIND) . -name _the.package.api.notify -exec dirname \{\} \; >> $$($1_PUBAPI_NOTIFICATIONS_FILE) ; \
       
   189                     true) &&)
       
   190     # The capture nativeapi macro scans for native api change notificiations. If such notifications are
       
   191     # found, then we will run javah on the changed classes. It also collects all classes with native methods
       
   192     # to be used to find out which classes no longer has native methods, to trigger deletion of those .h files.
       
   193     $1_CAPTURE_NATIVEAPI=$$(foreach src,$$($1_SRCS),\
       
   194                     (cd $$(src) && \
       
   195                     $(FIND) . -name _the.package.native.notify | $(SED) 's/package.native.notify/package.native/' | \
       
   196                             $(XARGS) $(CAT)  | $(GREP) '^TYPE ' | $(SED) 's/.*TYPE //' >> $$($1_NATIVEAPI_NOTIFICATIONS_FILE) ; \
       
   197                     $(FIND) . -name _the.package.native -exec $(CAT) \{\} \; | $(SED) -n 's/^TYPE //p' >> $$($1_NATIVEAPI_FILE) ; \
       
   198                     true) &&)
       
   199     # The update contents macro updates the jar file with the previously capture contents.
       
   200     $1_UPDATE_CONTENTS=$$(foreach src,$$($1_SRCS),\
       
   201                     (cd $$(src) && \
       
   202                      if [ -s _the.$$($1_JARNAME)_contents ]; then \
       
   203                          $(ECHO) "  updating" `$(WC) -l _the.$$($1_JARNAME)_contents | $(AWK) '{ print $$$$1 }'` files && \
       
   204                          $(JAR) uf $$@ @_the.$$($1_JARNAME)_contents; \
       
   205                      fi) &&)
       
   206     # The s-variants of the above macros are used when the jar is created from scratch.
       
   207     $1_SCAPTURE_CONTENTS=$$(foreach src,$$($1_SRCS),\
       
   208                     (($(FIND) $$(src) -type f -a \( $$($1_FIND_PATTERNS) \) $$($1_GREP_INCLUDES) $$($1_GREP_EXCLUDES) && $(ECHO) $$($1_EXTRA_FILES)) | $(SED) 's|$$(src)/||g' > $$(src)/_the.$$($1_JARNAME)_contents) && )
       
   209     ifeq (,$$($1_SKIP_METAINF))
       
   210         $1_SCAPTURE_METAINF=$$(foreach src,$$($1_SRCS),\
       
   211                     ($(FIND) $$(src)/META-INF -type f 2> /dev/null | $(SED) 's|$$(src)/||g' >> $$(src)/_the.$$($1_JARNAME)_contents) && )
       
   212     endif
       
   213     $1_SUPDATE_CONTENTS=$$(foreach src,$$($1_SRCS),\
       
   214                     (cd $$(src) && $(JAR) uf $$@ @$$(src)/_the.$$($1_JARNAME)_contents) &&)
       
   215     # The TOUCH macro is used to make sure all timestamps are identical for package files and the pubapi files.
       
   216     # If we do not do this, we get random recompilations, the next time we run make, since the order of package building is random,
       
   217     # ie independent of package --dependes on-> public api of another package. This is of course
       
   218     # due to the fact that Java source often (always?) has circular dependencies. (Thus there is no correct order
       
   219     # to compile packages, and we can just as well do them in a random order. Which we do.)
       
   220     $1_TOUCH_API_FILES=$$(foreach src,$$($1_SRCS),\
       
   221                     ($(FIND) $$(src) -name _the.package.api -exec $(TOUCH) -r $$($1_JAR) \{\} \; ; true) && \
       
   222                     ($(FIND) $$(src) -name _the.package -exec $(TOUCH) -r $$($1_JAR) \{\} \; ; true) &&)
       
   223     # Use a slightly shorter name for logging, but with enough path to identify this jar.
       
   224     $1_NAME:=$$(subst $$(OUTPUT_ROOT)/,,$$($1_JAR))
       
   225     # Here is the rule that creates/updates the jar file.
       
   226     $$($1_JAR) : $2
       
   227 	$(MKDIR) -p $$($1_BIN)
       
   228 	if [ -n "$$($1_MANIFEST)" ]; then \
       
   229 		$(SED) -e "s#@@RELEASE@@#$(RELEASE)#"           \
       
   230 		       -e "s#@@COMPANY_NAME@@#$(COMPANY_NAME)#" $$($1_MANIFEST) > $$($1_MANIFEST_FILE); \
       
   231 	else \
       
   232 		$(RM) $$($1_MANIFEST_FILE) && $(TOUCH) $$($1_MANIFEST_FILE); \
       
   233 	fi
       
   234 	$(ECHO) "Main-Class: $$(strip $$($1_JARMAIN))" >> $$($1_MANIFEST_FILE)
       
   235 	if [ -n "$$($1_EXTRA_MANIFEST_ATTR)" ]; then \
       
   236 		$(ECHO) "$$($1_EXTRA_MANIFEST_ATTR)" >> $$($1_MANIFEST_FILE); \
       
   237 	fi
       
   238 	+if [ -s $$@ ]; then \
       
   239 		$(RM) -r $$($1_PUBAPI_NOTIFICATIONS_FILE) && \
       
   240 		$$($1_CAPTURE_PUBAPI_NOTIFICATIONS) \
       
   241 		if [ -s $$($1_PUBAPI_NOTIFICATIONS_FILE) ]; then \
       
   242 			$(ECHO) Public api change detected in: && \
       
   243 			$(CAT) $$($1_PUBAPI_NOTIFICATIONS_FILE) | $(TR) '/' '.' | $(SED) 's|^..||g' | $(SED) 's|\.$$$$||g' | $(AWK) '{print "  "$$$$1}' && \
       
   244 			$$(foreach src,$$($1_SRCS),($(FIND) $$(src) -name _the.package.api.notify $(FIND_DELETE); true) &&) \
       
   245 			$(MAKE) -f $(word 1,$(MAKEFILE_LIST)) $$($1_JAR) ; \
       
   246 		else \
       
   247 			$(ECHO) Modifying $$($1_NAME) && \
       
   248 			$$($1_CAPTURE_CONTENTS) \
       
   249 			$$($1_CAPTURE_METAINF) \
       
   250 			$(RM) $$($1_DELETES_FILE) && \
       
   251 			$$($1_CAPTURE_DELETES) \
       
   252 			$(CAT) $$($1_DELETES_FILE) > $$($1_DELETESS_FILE) && \
       
   253 			if [ -s $$($1_DELETESS_FILE) ]; then \
       
   254 				$(ECHO) "  deleting" `$(WC) -l $$($1_DELETESS_FILE) | $(AWK) '{ print $$$$1 }'` files && \
       
   255 	                        $(ZIP) -q -d $$@ `$(CAT) $$($1_DELETESS_FILE)` ; \
       
   256 			fi && \
       
   257 			$$($1_UPDATE_CONTENTS) true && \
       
   258 			$$($1_TOUCH_API_FILES) true && \
       
   259 			$(RM) -r $$($1_NATIVEAPI_NOTIFICATIONS_FILE) $$($1_NATIVEAPI_FILE) && \
       
   260 			$$($1_CAPTURE_NATIVEAPI) true && \
       
   261 			if [ "x$$($1_JAVAH)" != "x" ] && [ -s $$($1_NATIVEAPI_NOTIFICATIONS_FILE) ]; then \
       
   262 				$(ECHO) Native api change detected in: && $(CAT) $$($1_NATIVEAPI_NOTIFICATIONS_FILE) && \
       
   263 		                $$($1_JVM) $$($1_JAVAH) "-Xbootclasspath/p:$$($1_JAR)" -d $$($1_HEADERS) @$$($1_NATIVEAPI_NOTIFICATIONS_FILE) ; \
       
   264 	    		fi && \
       
   265 			$(TOUCH) $$($1_NATIVEAPI_FILE)_prev ; \
       
   266 			($(GREP) -xvf $$($1_NATIVEAPI_FILE) $$($1_NATIVEAPI_FILE)_prev > $$($1_NATIVEAPI_FILE)_deleted; true) && \
       
   267 			$(CP) $$($1_NATIVEAPI_FILE) $$($1_NATIVEAPI_FILE)_prev && \
       
   268 			if [ -s $$($1_NATIVEAPI_FILE)_deleted ]; then \
       
   269 				$(ECHO) Native methods dropped from classes: && $(CAT) $$($1_NATIVEAPI_FILE)_deleted && \
       
   270 				$(RM) `$(CAT) $$($1_NATIVEAPI_FILE)_deleted | $(SED) -e 's|\.|_|g' -e 's|.*|$$($1_HEADERS)/&.h $$($1_HEADERS)/&_*|'` ; \
       
   271 			fi && \
       
   272 			$$(foreach src,$$($1_SRCS),($(FIND) $$(src) -name _the.package.api.notify $(FIND_DELETE); true) &&) true ; \
       
   273 		fi ; \
       
   274 	else \
       
   275 		$(ECHO) Creating $$($1_NAME) && $(JAR) cfm $$@ $$($1_MANIFEST_FILE) && \
       
   276 	        $$($1_SCAPTURE_CONTENTS) \
       
   277 		$$($1_SCAPTURE_METAINF) \
       
   278 		$$($1_SUPDATE_CONTENTS) \
       
   279 		$$($1_TOUCH_API_FILES) true && \
       
   280 		$(RM) -r $$($1_NATIVEAPI_NOTIFICATIONS_FILE) $$($1_NATIVEAPI_FILE) && \
       
   281 		$$($1_CAPTURE_NATIVEAPI) true && \
       
   282 		if [ "x$$($1_JAVAH)" != "x" ] && [ -s $$($1_NATIVEAPI_FILE) ]; then \
       
   283 			$(ECHO) Generating native api headers for `$(CAT) $$($1_NATIVEAPI_FILE) | $(WC) -l` classes && \
       
   284 			$(RM) $$($1_HEADERS)/*.h && \
       
   285 			$$($1_JVM) $$($1_JAVAH) "-Xbootclasspath/p:$$($1_JAR)" -d $$($1_HEADERS) @$$($1_NATIVEAPI_FILE) && \
       
   286 			$(CP) $$($1_NATIVEAPI_FILE) $$($1_NATIVEAPI_FILE)_prev ; \
       
   287 		fi && \
       
   288 		$$(foreach src,$$($1_SRCS),($(FIND) $$(src) -name "*.notify" $(FIND_DELETE); true) &&) true ; \
       
   289 	fi; 
       
   290 
       
   291 endef
       
   292 
       
   293 define append_to
       
   294     $(ECHO) "$1" >> $2
       
   295 endef
       
   296 
       
   297 define SetupZipArchive
       
   298     # param 1 is for example ZIP_MYSOURCE
       
   299     # param 2,3,4,5,6,7,8,9 are named args.
       
   300     #    SRC,ZIP,INCLUDES,EXCLUDES,EXCLUDE_FILES
       
   301     $(if $2,$1_$(strip $2))
       
   302     $(if $3,$1_$(strip $3))
       
   303     $(if $4,$1_$(strip $4))
       
   304     $(if $5,$1_$(strip $5))
       
   305     $(if $6,$1_$(strip $6))
       
   306     $(if $7,$1_$(strip $7))
       
   307     $(if $8,$1_$(strip $8))
       
   308     $(if $9,$1_$(strip $9))
       
   309 
       
   310     # Find all files in the source tree.
       
   311     $1_ALL_SRCS := $$(foreach i,$$($1_SRC), $$(shell $(FIND) $$i -type f -a ! -name "_the.*"))
       
   312 
       
   313     ifneq ($$($1_INCLUDES),)
       
   314         $1_SRC_INCLUDES := $$(foreach i,$$($1_SRC),$$(addprefix $$i/,$$(addsuffix /%,$$($1_INCLUDES))))
       
   315         $1_ZIP_INCLUDES := $$(addprefix -i$(SPACE)$(DQUOTE),$$(addsuffix /*$(DQUOTE),$$($1_INCLUDES)))
       
   316         $1_ALL_SRCS     := $$(filter $$($1_SRC_INCLUDES),$$($1_ALL_SRCS))
       
   317     endif
       
   318     ifneq ($$($1_EXCLUDES),)
       
   319         $1_SRC_EXCLUDES := $$(foreach i,$$($1_SRC),$$(addprefix $$i/,$$(addsuffix /%,$$($1_EXCLUDES))))
       
   320         $1_ZIP_EXCLUDES := $$(addprefix -x$(SPACE)$(DQUOTE),$$(addsuffix /*$(DQUOTE),$$($1_EXCLUDES)))
       
   321         $1_ALL_SRCS     := $$(filter-out $$($1_SRC_EXCLUDES),$$($1_SRCS))
       
   322     endif
       
   323 
       
   324     # Use a slightly shorter name for logging, but with enough path to identify this zip.
       
   325     $1_NAME:=$$(subst $$(OUTPUT_ROOT)/,,$$($1_ZIP))
       
   326 
       
   327     # Now $1_ALL_SRCS should contain all sources that are going to be put into the zip.
       
   328     # I.e. the zip -i and -x options should match the filtering done in the makefile.
       
   329     # Explicitly excluded files can be given with absolute path. The patsubst solution
       
   330     # isn't perfect but the likelyhood of an absolute path to match something in a src
       
   331     # dir is very small.
       
   332     $$($1_ZIP) : $$($1_ALL_SRCS)
       
   333 		$(MKDIR) -p $$(@D)
       
   334 		$(ECHO) Updating $$($1_NAME)
       
   335 		$$(foreach i,$$($1_SRC),(cd $$i && $(ZIP) -qru $$@ . $$($1_ZIP_INCLUDES) $$($1_ZIP_EXCLUDES) -x \*_the.\* $$(addprefix -x$(SPACE),$$(patsubst $$i/%,%,$$($1_EXCLUDE_FILES)))) ;) true
       
   336 		$(TOUCH) $$@
       
   337 endef
       
   338 
       
   339 define add_file_to_copy
       
   340     # param 1 = BUILD_MYPACKAGE
       
   341     # parma 2 = The source file to copy.
       
   342     $2_TARGET:=$2
       
   343     # Remove the source prefix. 
       
   344     $$(foreach i,$$($1_SRC),$$(eval $$(call remove_string,$$i,$2_TARGET)))
       
   345     # Now we can setup the depency that will trigger the copying.
       
   346     $$($1_BIN)$$($2_TARGET) : $2
       
   347 	$(MKDIR) -p $$(@D)
       
   348 	$(CP) $$< $$@
       
   349 	$(CHMOD) -f ug+w $$@
       
   350 
       
   351     # And do not forget this target
       
   352     $1_ALL_COPY_TARGETS += $$($1_BIN)$$($2_TARGET)
       
   353 endef
       
   354 
       
   355 
       
   356 # This macro is used only for properties files that are to be
       
   357 # copied over to the classes directory in cleaned form:
       
   358 # Previously this was inconsistently done in different repositories.
       
   359 # This is the new clean standard.
       
   360 define add_file_to_copy_and_clean
       
   361     # param 1 = BUILD_MYPACKAGE
       
   362     # parma 2 = The source file to copy and clean.
       
   363     $2_TARGET:=$2
       
   364     # Remove the source prefix. 
       
   365     $$(foreach i,$$($1_SRC),$$(eval $$(call remove_string,$$i,$2_TARGET)))
       
   366     # Now we can setup the depency that will trigger the copying.
       
   367     $$($1_BIN)$$($2_TARGET) : $2
       
   368 	$(MKDIR) -p $$(@D)
       
   369 	$(ECHO) Cleaning $$($2_TARGET)
       
   370 	$(CAT) $$< | $(SED) -e 's/\([^\\]\):/\1\\:/g' -e  's/\([^\\]\)=/\1\\=/g' -e 's/#.*/#/g' \
       
   371                    | $(SED) \
       
   372 -e 's/\\u0020/\x20/g' \
       
   373 -e 's/\\u003A/\x3A/g' \
       
   374 -e 's/\\u006B/\x6B/g' \
       
   375 -e 's/\\u0075/\x75/g' \
       
   376 -e 's/\\u00A0/\xA0/g' \
       
   377 -e 's/\\u00A3/\xA3/g' \
       
   378 -e 's/\\u00B0/\xB0/g' \
       
   379 -e 's/\\u00B7/\xB7/g' \
       
   380 -e 's/\\u00BA/\xBA/g' \
       
   381 -e 's/\\u00BF/\xBF/g' \
       
   382 -e 's/\\u00C0/\xC0/g' \
       
   383 -e 's/\\u00C1/\xC1/g' \
       
   384 -e 's/\\u00C2/\xC2/g' \
       
   385 -e 's/\\u00C4/\xC4/g' \
       
   386 -e 's/\\u00C5/\xC5/g' \
       
   387 -e 's/\\u00C8/\xC8/g' \
       
   388 -e 's/\\u00C9/\xC9/g' \
       
   389 -e 's/\\u00CA/\xCA/g' \
       
   390 -e 's/\\u00CD/\xCD/g' \
       
   391 -e 's/\\u00CE/\xCE/g' \
       
   392 -e 's/\\u00D3/\xD3/g' \
       
   393 -e 's/\\u00D4/\xD4/g' \
       
   394 -e 's/\\u00D6/\xD6/g' \
       
   395 -e 's/\\u00DA/\xDA/g' \
       
   396 -e 's/\\u00DC/\xDC/g' \
       
   397 -e 's/\\u00DD/\xDD/g' \
       
   398 -e 's/\\u00DF/\xDF/g' \
       
   399 -e 's/\\u00E0/\xE0/g' \
       
   400 -e 's/\\u00E1/\xE1/g' \
       
   401 -e 's/\\u00E2/\xE2/g' \
       
   402 -e 's/\\u00E3/\xE3/g' \
       
   403 -e 's/\\u00E4/\xE4/g' \
       
   404 -e 's/\\u00E5/\xE5/g' \
       
   405 -e 's/\\u00E6/\xE6/g' \
       
   406 -e 's/\\u00E7/\xE7/g' \
       
   407 -e 's/\\u00E8/\xE8/g' \
       
   408 -e 's/\\u00E9/\xE9/g' \
       
   409 -e 's/\\u00EA/\xEA/g' \
       
   410 -e 's/\\u00EB/\xEB/g' \
       
   411 -e 's/\\u00EC/\xEC/g' \
       
   412 -e 's/\\u00ED/\xED/g' \
       
   413 -e 's/\\u00EE/\xEE/g' \
       
   414 -e 's/\\u00EF/\xEF/g' \
       
   415 -e 's/\\u00F1/\xF1/g' \
       
   416 -e 's/\\u00F2/\xF2/g' \
       
   417 -e 's/\\u00F3/\xF3/g' \
       
   418 -e 's/\\u00F4/\xF4/g' \
       
   419 -e 's/\\u00F5/\xF5/g' \
       
   420 -e 's/\\u00F6/\xF6/g' \
       
   421 -e 's/\\u00F9/\xF9/g' \
       
   422 -e 's/\\u00FA/\xFA/g' \
       
   423 -e 's/\\u00FC/\xFC/g' \
       
   424 -e 's/\\u0020/\x20/g' \
       
   425 -e 's/\\u003f/\x3f/g' \
       
   426 -e 's/\\u006f/\x6f/g' \
       
   427 -e 's/\\u0075/\x75/g' \
       
   428 -e 's/\\u00a0/\xa0/g' \
       
   429 -e 's/\\u00a3/\xa3/g' \
       
   430 -e 's/\\u00b0/\xb0/g' \
       
   431 -e 's/\\u00ba/\xba/g' \
       
   432 -e 's/\\u00bf/\xbf/g' \
       
   433 -e 's/\\u00c1/\xc1/g' \
       
   434 -e 's/\\u00c4/\xc4/g' \
       
   435 -e 's/\\u00c5/\xc5/g' \
       
   436 -e 's/\\u00c8/\xc8/g' \
       
   437 -e 's/\\u00c9/\xc9/g' \
       
   438 -e 's/\\u00ca/\xca/g' \
       
   439 -e 's/\\u00cd/\xcd/g' \
       
   440 -e 's/\\u00d6/\xd6/g' \
       
   441 -e 's/\\u00dc/\xdc/g' \
       
   442 -e 's/\\u00dd/\xdd/g' \
       
   443 -e 's/\\u00df/\xdf/g' \
       
   444 -e 's/\\u00e0/\xe0/g' \
       
   445 -e 's/\\u00e1/\xe1/g' \
       
   446 -e 's/\\u00e2/\xe2/g' \
       
   447 -e 's/\\u00e3/\xe3/g' \
       
   448 -e 's/\\u00e4/\xe4/g' \
       
   449 -e 's/\\u00e5/\xe5/g' \
       
   450 -e 's/\\u00e7/\xe7/g' \
       
   451 -e 's/\\u00e8/\xe8/g' \
       
   452 -e 's/\\u00e9/\xe9/g' \
       
   453 -e 's/\\u00ea/\xea/g' \
       
   454 -e 's/\\u00eb/\xeb/g' \
       
   455 -e 's/\\u00ec/\xec/g' \
       
   456 -e 's/\\u00ed/\xed/g' \
       
   457 -e 's/\\u00ee/\xee/g' \
       
   458 -e 's/\\u00ef/\xef/g' \
       
   459 -e 's/\\u00f0/\xf0/g' \
       
   460 -e 's/\\u00f1/\xf1/g' \
       
   461 -e 's/\\u00f2/\xf2/g' \
       
   462 -e 's/\\u00f3/\xf3/g' \
       
   463 -e 's/\\u00f4/\xf4/g' \
       
   464 -e 's/\\u00f5/\xf5/g' \
       
   465 -e 's/\\u00f6/\xf6/g' \
       
   466 -e 's/\\u00f7/\xf7/g' \
       
   467 -e 's/\\u00f8/\xf8/g' \
       
   468 -e 's/\\u00f9/\xf9/g' \
       
   469 -e 's/\\u00fa/\xfa/g' \
       
   470 -e 's/\\u00fc/\xfc/g' \
       
   471 -e 's/\\u00ff/\xff/g' \
       
   472 		   | $(SED) -e '/^#/d' -e '/^$$$$/d' \
       
   473 		            -e :a -e '/\\$$$$/N; s/\\\n//; ta' \
       
   474 			    -e 's/^[ \t]*//;s/[ \t]*$$$$//' \
       
   475 			    -e 's/\\=/=/' | LANG=C sort > $$@
       
   476 	$(CHMOD) -f ug+w $$@
       
   477 
       
   478     # And do not forget this target
       
   479     $1_ALL_COPY_CLEAN_TARGETS += $$($1_BIN)$$($2_TARGET)
       
   480 endef
       
   481 
       
   482 define add_java_package
       
   483     # param 1 = BUILD_MYPACKAGE
       
   484     # param 2 = the package target file (_the.package)
       
   485     # param 3 = src roots, all of them, separated with space
       
   486     # param 4 = bin root
       
   487     # param 5 = include these dependecies
       
   488     # param 6 = not used
       
   489     # param 7 = if non-empty, then use -Xdeps and -Xpubapi
       
   490     # param 8 = xremote configuration, or empty.
       
   491     # param 9 = javac command
       
   492     # param 10 = javac flags
       
   493     # param 11 = exclude these files!
       
   494     # param 12 = only include these files!
       
   495     # param 13 = javah command
       
   496     # param 14 = override src roots to be passed into -sourcepath, ugly ugly ugly, do not use this!
       
   497     #            it is only here to workaround ugly things in the source code in the jdk that ought
       
   498     #            to be fixed instead!
       
   499     ifdef $2_USED_BY
       
   500         $$(error Attempting to add the package $2 from $3 which is already added with sources from $$($2_USED_BY))
       
   501     endif
       
   502     $2_USED_BY:=$3
       
   503     # Remove the _the.package file to get the target bin dir for the classes in this package.
       
   504     $2_PACKAGE_BDIR:=$(dir $2)
       
   505     # The source roots separated with a path separator (: or ; depending on os)
       
   506     # (The patsubst is necessary to trim away unnecessary spaces.)
       
   507     ifneq ($(14),)
       
   508       $2_SRCROOTSC:=$(subst $(SPACE),$(PATH_SEP),$(strip $(patsubst %,%,$(14))))
       
   509     else
       
   510       $2_SRCROOTSC:=$(subst $(SPACE),$(PATH_SEP),$(strip $(patsubst %,%,$3)))
       
   511     endif
       
   512     # Suffix the package path to the src roots, to get a list of all possible source locations
       
   513     # for this package.
       
   514     $2_PACKAGE_SDIRS:=$$(foreach i,$3,$$(subst $4,$$i,$$($2_PACKAGE_BDIR)))
       
   515     # Use wildcard in all potential source locations to find the actual sources.
       
   516     $2_PACKAGE_SRCS:=$$(filter-out $(11),$$(wildcard $$(addsuffix *.java,$$($2_PACKAGE_SDIRS))))
       
   517     ifneq ($(12),)
       
   518       # Filter on include file filter if set.
       
   519       $2_PACKAGE_SRCS:=$$(filter $(12),$$($2_PACKAGE_SRCS))
       
   520     endif
       
   521     # Generate a proper package name from the file name.
       
   522     $2_PACKAGE:=$(patsubst .%.,%,$(subst /,.,$(subst $4,,$(dir $2))))
       
   523     # Use a javac server for this package?
       
   524     $2_REMOTE:=$8
       
   525 
       
   526     # Include previously generated information about what classes are output by this package
       
   527     # and what sources were used for the compile.
       
   528     -include $$($2_PACKAGE_BDIR)_the.package.d
       
   529 
       
   530     # Include the notify, file, that exists if the package has been compiled during a previous make round.
       
   531     # I.e. we are now dealing with a compile triggered by a pubapi change.
       
   532     -include $$($2_PACKAGE_BDIR)_the.package.notify
       
   533 
       
   534     # If the notify file existed, then $$($2_NOTIFIED) will be equal to true.
       
   535     # Use this information to block dependency tracking for this package. 
       
   536     # This is necessary to cut the circular dependency chains that are so common in Java sources.
       
   537 
       
   538     ifneq ($$($2_NOTIFIED),true)
       
   539         # No need to block, since this package has not yet been recompiled.
       
   540         # Thus include previously generated dependency information. (if it exists)
       
   541         -include $$($2_PACKAGE_BDIR)_the.package.dddd
       
   542 #    else
       
   543 #        $$(info WAS NOTIFIED $2)
       
   544     endif
       
   545 
       
   546     # Should we create proper dependencies between packages?
       
   547     ifneq ($7,)
       
   548       # The flag: -XDpubapi:file=foo,package=mypack,notify writes a file foo that contains a 
       
   549       # database of the public api of the classes supplied on the command line and are
       
   550       # inside the package mypack. If foo already exists, javac will only write to foo,
       
   551       # if there is a change in the pubapi. I.e. we can use the timestamp of this file
       
   552       # for triggering dependencies. "notify" means create a "file" suffixed with notify
       
   553       # if the pubapi really changed. 
       
   554       $2_PUBAPI=-XDpubapi=file=$$($2_PACKAGE_BDIR)_the.package.api,notify,package=$$($2_PACKAGE)
       
   555       # The flag: -XDnativeapi:file=foo,package=mypack,notify works similar to pubabi, but
       
   556       # instead tracks native methods. This file can be used to trigger dependencies for
       
   557       # native compilations.
       
   558       $2_NATIVEAPI=-XDnativeapi=file=$$($2_PACKAGE_BDIR)_the.package.native,notify,package=$$($2_PACKAGE)
       
   559       # The flag -XDdeps:file=foo.deps,groupon=package writes a foo.deps file containing packages dependencies:
       
   560       #     java.net : java.io java.lang
       
   561       # I.e. the classes in .net depend on the public apis of java.io and java.lang
       
   562       # The dependencies can be grouped on classes instead (groupon=class)
       
   563       #     java.net.Bar : java.io.Socket java.lang.String
       
   564       $2_DEPS:=-XDdeps=file=$$($2_PACKAGE_BDIR)_the.package.deps,groupon=package
       
   565       # The next command rewrites the deps output from javac into a proper makefile dependency.
       
   566       # The dependencies are always to an .api file generated by the pubapi option above.
       
   567       # This is necessary since java package dependencies are almost always circular.
       
   568       $2_APPEND_DEPS:=($(CAT) $$($2_PACKAGE_BDIR)_the.package.deps | $(TR) '.' '/' | $(AWK) '{ print "$4/" $$$$3 }' | sort > $$($2_PACKAGE_BDIR)_the.package.ddd && $(GREP) -f $$($2_PACKAGE_BDIR)_the.package.ddd $5 | $(AWK) '{ print "$(dir $2)_the.package : " $$$$1 "_the.package.api" }' > $$($2_PACKAGE_BDIR)_the.package.dddd ; true)
       
   569     else
       
   570         # If not using dependencies, use $2 as fallback to trigger regeneration of javah header files.
       
   571         # This will generate a surplus of header files, but this does not hurt compilation.
       
   572         $2_NATIVEAPICHANGE_TRIGGER:=$2
       
   573         $2_FETCH_NATIVEAPICHANGE_CLASSES:=$(CAT) $$($2_PACKAGE_BDIR)_the.package.now|$(GREP) -v '\$$$$'|$(SED) -e 's|$4/||g'|$(SED) 's|.class||g'| $(TR) '/' '.'
       
   574     endif 
       
   575 
       
   576     # The _the.package file is dependent on the java files inside the package.
       
   577     # Fill the _the.package file with a list of the java files and compile them
       
   578     # to class files.
       
   579     $2 : $$($2_PACKAGE_SRCS)
       
   580 	$(MKDIR) -p $$($2_PACKAGE_BDIR)
       
   581 	$(RM) $2.tmp
       
   582 	$$(call ListPathsSafely,$2_PACKAGE_SRCS,\n, >> $2.tmp)
       
   583 	$(ECHO) $$($2_PACKAGE_BDIR)*.class | $(GREP) -v \*.class | $(TR) ' ' '\n' > $$($2_PACKAGE_BDIR)_the.package.prev
       
   584 	$(RM) $$($2_PACKAGE_BDIR)*.class $$($2_PACKAGE_BDIR)*.notify $$($2_PACKAGE_BDIR)*.deleted
       
   585 	$(ECHO) Compiling `$(WC) $2.tmp | $(TR) -s ' ' | $(CUT) -f 2 -d ' '` files in package $(patsubst $4/%/,%,$(dir $2.tmp))
       
   586 	$9 $$($2_REMOTE) $$($2_DEPS) $$($2_PUBAPI) $$($2_NATIVEAPI) $(10) -implicit:none -sourcepath "$$($2_SRCROOTSC)" -d $4 @$2.tmp
       
   587 	$(ECHO) $$($2_PACKAGE_BDIR)*.class | $(GREP) -v \*.class | $(TR) ' ' '\n' > $$($2_PACKAGE_BDIR)_the.package.now
       
   588 	($(GREP) -xvf $$($2_PACKAGE_BDIR)_the.package.now $$($2_PACKAGE_BDIR)_the.package.prev > $$($2_PACKAGE_BDIR)_the.package.deleted;true)
       
   589 	$(ECHO) $1_CLASSES += `$(CAT) $$($2_PACKAGE_BDIR)_the.package.now` | \
       
   590 		$(SED) 's/\$$$$/\$$$$\$$$$/g' > $$($2_PACKAGE_BDIR)_the.package.d
       
   591 	$(ECHO) $1_JAVAS += $$($2_PACKAGE_SRCS) >> $$($2_PACKAGE_BDIR)_the.package.d
       
   592 	$(ECHO) $2_NOTIFIED:=true > $$($2_PACKAGE_BDIR)_the.package.notify
       
   593 	$$($2_APPEND_DEPS)
       
   594 	$$($2_COPY_FILES)
       
   595 	$(MV) -f $2.tmp $2
       
   596 endef
       
   597 
       
   598 define remove_string
       
   599     $2 := $$(subst $1,,$$($2))
       
   600 endef
       
   601 
       
   602 define replace_space_with_pathsep
       
   603     $1:=$(subst $(SPACE),$(PATH_SEP),$(strip $(patsubst %,%,$2)))
       
   604 endef
       
   605 
       
   606 define SetupJavaCompilation
       
   607     # param 1 is for example BUILD_MYPACKAGE
       
   608     # param 2,3,4,5,6,7,8 are named args.
       
   609     #    SETUP:=must point to a previously setup java compiler, for example: SETUP:=BOOTJAVAC
       
   610     #    JVM:=path to ..bin/java
       
   611     #    ADD_JAVAC_FLAGS:=javac flags to append to the default ones.
       
   612     #    SRC:=one or more directories to search for sources
       
   613     #    BIN:=store classes here
       
   614     #    INCLUDES:=myapp.foo means will only compile java files in myapp.foo or any of its sub-packages.
       
   615     #    EXCLUDES:=myapp.foo means will do not compile java files in myapp.foo or any of its sub-packages.
       
   616     #    COPY:=.prp means copy all prp files to the corresponding package in BIN.
       
   617     #    CLEAN:=.properties means copy and clean all properties file to the corresponding package in BIN.
       
   618     #    COPY_FILES:=myapp/foo/setting.txt means copy this file over to the package myapp/foo
       
   619     #    SRCZIP:=Create a src.zip based on the found sources and copied files.
       
   620     #    INCLUDE_FILES:="com/sun/SolarisFoobar.java" means only compile this file!
       
   621     #    EXCLUDE_FILES:="com/sun/SolarisFoobar.java" means do not compile this particular file!
       
   622     #                   "SolarisFoobar.java" means do not compile SolarisFoobar, wherever it is found.
       
   623     #    JAVAC_SOURCE_PATH_UGLY_OVERRIDE:=Don't use this. This forces an explicit -sourcepath to javac.
       
   624     #                                     Its only here until we cleanup some nasty source code pasta in the jdk.
       
   625     #    HEADERS:=path to directory where all generated c-headers are written.
       
   626     $(if $2,$1_$(strip $2))
       
   627     $(if $3,$1_$(strip $3))
       
   628     $(if $4,$1_$(strip $4))
       
   629     $(if $5,$1_$(strip $5))
       
   630     $(if $6,$1_$(strip $6))
       
   631     $(if $7,$1_$(strip $7))
       
   632     $(if $8,$1_$(strip $8))
       
   633     $(if $9,$1_$(strip $9))
       
   634     $(if $(10),$1_$(strip $(10)))
       
   635     $(if $(11),$1_$(strip $(11)))
       
   636     $(if $(12),$1_$(strip $(12)))
       
   637     $(if $(13),$1_$(strip $(13)))
       
   638     $(if $(14),$1_$(strip $(14)))
       
   639 
       
   640 # Extract the info from the java compiler setup.
       
   641 $1_MODE := $$($$($1_SETUP)_MODE)
       
   642 ifneq (SINGLE_THREADED_BATCH,$$($1_MODE))
       
   643     ifneq (MULTI_CORE_CONCURRENT,$$($1_MODE))
       
   644         $$(error The Java compilation $1 refers to a non-existant java compiler setup $$($1_SETUP))
       
   645     endif
       
   646 endif
       
   647 $1_USE_DEPS := $$($$($1_SETUP)_USE_DEPS)
       
   648 $1_REMOTE := $$($$($1_SETUP)_REMOTE)
       
   649 $1_JVM   := $$($$($1_SETUP)_JVM)
       
   650 $1_JAVAC := $$($$($1_SETUP)_JAVAC)
       
   651 $1_JAVAH := $$($$($1_SETUP)_JAVAH)
       
   652 $1_FLAGS := $$($$($1_SETUP)_FLAGS) $(JAVAC_FLAGS) $$($1_ADD_JAVAC_FLAGS)
       
   653 ifeq (,$$($1_HEADERS))
       
   654     $1_HEADERS := $$($1_BIN)
       
   655 endif
       
   656 
       
   657 # Handle addons and overrides.
       
   658 $1_SRC:=$$(call ADD_SRCS,$$($1_SRC))
       
   659 # Make sure the dirs exist.
       
   660 $$(shell $(MKDIR) -p $$($1_SRC) $$($1_BIN))
       
   661 # Find all files in the source trees.
       
   662 $1_ALL_SRCS := $$(filter-out $(OVR_SRCS),$$(foreach i,$$($1_SRC),$$(shell $(FIND) $$i -type f)))
       
   663 # Extract the java files.
       
   664 ifneq ($$($1_EXCLUDE_FILES),)
       
   665   $1_EXCLUDE_FILES_PATTERN:=$$(addprefix %,$$($1_EXCLUDE_FILES))
       
   666 endif
       
   667 $1_SRCS     := $$(filter-out $$($1_EXCLUDE_FILES_PATTERN),$$(filter %.java,$$($1_ALL_SRCS)))
       
   668 ifneq ($$($1_INCLUDE_FILES),)
       
   669   $1_INCLUDE_FILES:=$$(foreach i,$$($1_SRC),$$(addprefix $$i/,$$($1_INCLUDE_FILES)))
       
   670   $1_SRCS := $$(filter $$($1_INCLUDE_FILES), $$($1_SRCS))
       
   671 endif
       
   672 $1_PKGS     := $$(sort $$(dir $$($1_SRCS)))
       
   673 # Remove the source root from each found path.
       
   674 $$(foreach i,$$($1_SRC),$$(eval $$(call remove_string,$$i,$1_PKGS)))
       
   675 $1_PKGS     := $$(sort $$($1_PKGS))
       
   676 # There can be only a single bin dir root, no need to foreach over the roots.
       
   677 $1_BINS     := $$(shell $(FIND) $$($1_BIN) -name "*.class")
       
   678 
       
   679 # Now we have a list of all java files to compile: $$($1_SRCS)
       
   680 # and we have a list of all existing class files: $$($1_BINS)
       
   681 
       
   682 # Prepend the source/bin path to the filter expressions.
       
   683 ifneq ($$($1_INCLUDES),)
       
   684   $1_SRC_INCLUDES := $$(foreach i,$$($1_SRC),$$(addprefix $$i/,$$(addsuffix /%,$$($1_INCLUDES))))
       
   685   $1_PKG_INCLUDES := $$(addprefix /,$$(addsuffix /%,$$($1_INCLUDES)))
       
   686   $1_BIN_INCLUDES := $$(addprefix $$($1_BIN)/,$$(addsuffix /%,$$($1_INCLUDES)))
       
   687   $1_SRCS     := $$(filter $$($1_SRC_INCLUDES),$$($1_SRCS))
       
   688   $1_PKGS     := $$(filter $$($1_PKG_INCLUDES),$$($1_PKGS))
       
   689   $1_BINS     := $$(filter $$($1_BIN_INCLUDES),$$($1_BINS))
       
   690 endif
       
   691 ifneq ($$($1_EXCLUDES),)
       
   692   $1_SRC_EXCLUDES := $$(foreach i,$$($1_SRC),$$(addprefix $$i/,$$(addsuffix /%,$$($1_EXCLUDES))))
       
   693   $1_PKG_EXCLUDES := $$(addprefix /,$$(addsuffix /%,$$($1_EXCLUDES)))
       
   694   $1_BIN_EXCLUDES := $$(addprefix $$($1_BIN)/,$$(addsuffix /%,$$($1_EXCLUDES)))
       
   695   $1_SRCS     := $$(filter-out $$($1_SRC_EXCLUDES),$$($1_SRCS))
       
   696   $1_PKGS     := $$(filter-out $$($1_PKG_EXCLUDES),$$($1_PKGS))
       
   697   $1_BINS     := $$(filter-out $$($1_BIN_EXCLUDES),$$($1_BINS))
       
   698 endif
       
   699 
       
   700 # Find all files to be copied from source to bin.
       
   701 ifneq (,$$($1_COPY))
       
   702     # Rewrite list of patterns into a find statement.
       
   703     $1_COPY_PATTERN:=$(FALSE_FIND_PATTERN) $$(patsubst %,$(SPACE)-o$(SPACE)-name$(SPACE)$(DQUOTE)*%$(DQUOTE),$$($1_COPY))
       
   704     # Search for all files to be copied.
       
   705     $1_ALL_COPIES := $$(foreach i,$$($1_SRC), $$(shell $(FIND) $$i \( $$($1_COPY_PATTERN) \) -a -type f))
       
   706     # Copy these explicitly
       
   707     $1_ALL_COPIES += $$($1_COPY_FILES)
       
   708     # Copy must also respect filters.
       
   709     ifneq (,$$($1_INCLUDES))
       
   710         $1_ALL_COPIES := $$(filter $$($1_SRC_INCLUDES),$$($1_ALL_COPIES))
       
   711     endif
       
   712     ifneq (,$$($1_EXCLUDES))
       
   713         $1_ALL_COPIES := $$(filter-out $$($1_SRC_EXCLUDES),$$($1_ALL_COPIES))
       
   714     endif
       
   715     ifneq (,$$($1_EXCLUDE_FILES))
       
   716         $1_ALL_COPIES := $$(filter-out $$($1_EXCLUDE_FILES_PATTERN),$$($1_ALL_COPIES))
       
   717     endif
       
   718     # All files below META-INF are always copied.
       
   719     $1_ALL_COPIES += $$(foreach i,$$($1_SRC), $$(shell $(FIND) $$i/META-INF -type f 2> /dev/null))
       
   720     ifneq (,$$($1_ALL_COPIES))
       
   721         # Yep, there are files to be copied!
       
   722         $1_ALL_COPY_TARGETS:=
       
   723         $$(foreach i,$$($1_ALL_COPIES),$$(eval $$(call add_file_to_copy,$1,$$i)))
       
   724         # Now we can depend on $$($1_ALL_COPY_TARGETS) to copy all files!
       
   725     endif
       
   726 endif
       
   727 
       
   728 # Find all property files to be copied and cleaned from source to bin.
       
   729 ifneq (,$$($1_CLEAN))
       
   730     # Rewrite list of patterns into a find statement.
       
   731     $1_CLEAN_PATTERN:=$(FALSE_FIND_PATTERN) $$(patsubst %,$(SPACE)-o$(SPACE)-name$(SPACE)$(DQUOTE)*%$(DQUOTE),$$($1_CLEAN))
       
   732     # Search for all files to be copied.
       
   733     $1_ALL_CLEANS := $$(foreach i,$$($1_SRC), $$(shell $(FIND) $$i \( $$($1_CLEAN_PATTERN) \) -a -type f))
       
   734     # Copy and clean must also respect filters.
       
   735     ifneq (,$$($1_INCLUDES))
       
   736         $1_ALL_CLEANS := $$(filter $$($1_SRC_INCLUDES),$$($1_ALL_CLEANS))
       
   737     endif
       
   738     ifneq (,$$($1_EXCLUDES))
       
   739         $1_ALL_CLEANS := $$(filter-out $$($1_SRC_EXCLUDES),$$($1_ALL_CLEANS))
       
   740     endif
       
   741     ifneq (,$$($1_EXCLUDE_FILES))
       
   742         $1_ALL_CLEANS := $$(filter-out $$($1_EXCLUDE_FILES_PATTERN),$$($1_ALL_CLEANS))
       
   743     endif
       
   744     ifneq (,$$($1_ALL_CLEANS))
       
   745         # Yep, there are files to be copied and cleaned!
       
   746         $1_ALL_COPY_CLEAN_TARGETS:=
       
   747         $$(foreach i,$$($1_ALL_CLEANS),$$(eval $$(call add_file_to_copy_and_clean,$1,$$i)))
       
   748         # Now we can depend on $$($1_ALL_COPY_CLEAN_TARGETS) to copy all files!
       
   749     endif
       
   750 endif
       
   751 
       
   752 # Find all the directories that contain java sources, each directory
       
   753 # corresponds to a package because we expect the source
       
   754 # code to be organized in this standardized way!
       
   755 $1_SDIRS := $$(sort $$(dir $$($1_SRCS)))
       
   756 # Now prefix each package with the bin root.
       
   757 $1_BDIRS := $$(foreach i,$$($1_PKGS),$$(addprefix $$($1_BIN),$$i))
       
   758 # Now create a list of the packages that are about to compile. This list is
       
   759 # later used to filter out dependencies that point outside of this set.
       
   760 $$(shell $(RM) $$($1_BIN)/_the.list_of_packages)
       
   761 $$(eval $$(call ListPathsSafelyNow,$1_BDIRS,\n, >> $$($1_BIN)/_the.list_of_packages))
       
   762 
       
   763 ifeq ($$($1_MODE),SINGLE_THREADED_BATCH)
       
   764     # Ok, we will feed all the found java files into a single javac invocation.
       
   765     # There can be no dependency checking, nor incremental builds. It is
       
   766     # the best we can do with the old javac. If the javac supports a javac server
       
   767     # then we can use the javac server.
       
   768 
       
   769     # We can depend on this target file to trigger a regeneration of all the sources
       
   770     $1 := $$($1_ALL_COPY_TARGETS) $$($1_ALL_COPY_CLEAN_TARGETS) $$($1_BIN)/_the.batch
       
   771 
       
   772     # Prep the source paths.
       
   773     ifneq ($$($1_JAVAC_SOURCE_PATH_UGLY_OVERRIDE),)
       
   774       $$(eval $$(call replace_space_with_pathsep,$1_SRCROOTSC,$$($1_JAVAC_SOURCE_PATH_UGLY_OVERRIDE)))
       
   775     else
       
   776       $$(eval $$(call replace_space_with_pathsep,$1_SRCROOTSC,$$($1_SRC)))
       
   777     endif
       
   778 
       
   779     # Create a sed expression to remove the source roots and to replace / with .
       
   780     # and remove .java at the end. 
       
   781     $1_REWRITE_INTO_CLASSES:=$$(foreach i,$$($1_SRC),-e 's|$$i/||g') -e 's|/|.|g' -e 's|.java$$$$||g'
       
   782 
       
   783     # Here is the batch rules that depends on all the sources.
       
   784     $$($1_BIN)/_the.batch: $$($1_SRCS)
       
   785 	$(MKDIR) -p $$(@D)
       
   786 	$(RM) $$($1_BIN)/_the.batch $$($1_BIN)/_the.batch.tmp
       
   787 	$$(call ListPathsSafely,$1_SRCS,\n, >> $$($1_BIN)/_the.batch.tmp)
       
   788 	$(ECHO) Compiling `$(WC) $$($1_BIN)/_the.batch.tmp | $(TR) -s ' ' | $(CUT) -f 2 -d ' '` files in batch $1
       
   789 	($$($1_JVM) $$($1_JAVAC) $$($1_FLAGS) -implicit:none -sourcepath "$$($1_SRCROOTSC)" -d $$($1_BIN) @$$($1_BIN)/_the.batch.tmp && \
       
   790 	 $$(if $$($1_JAVAH),\
       
   791              $(CAT) $$($1_BIN)/_the.batch.tmp | $(XARGS) $(GREP) -E "[[:space:]]native[[:space:]]|@GenerateNativeHeader" |\
       
   792              $(GREP) -v '*' | $(GREP) -v '//' | $(CUT) -f 1 -d ':' | $(SORT) -u |\
       
   793              $(SED) $$($1_REWRITE_INTO_CLASSES) > $$($1_BIN)/_the.batch.natives && \
       
   794          if test -s $$($1_BIN)/_the.batch.natives; then \
       
   795              $$($1_JVM) $$($1_JAVAH) "-Xbootclasspath/p:$$($1_BIN)" -d $$($1_HEADERS) @$$($1_BIN)/_the.batch.natives ; \
       
   796          fi &&) \
       
   797          $(MV) $$($1_BIN)/_the.batch.tmp $$($1_BIN)/_the.batch)
       
   798 else
       
   799     # Ok, we have a modern javac server running!
       
   800     # Since a single Java file can generate zero to an infinity number of .class files
       
   801     # the exact number and names of the .class files will only be known after the compile.
       
   802     # Thus after the compile, a list of the generated classes will be stored in _the.package.d
       
   803     # which is included by the makefile during the next compile. These .d files will
       
   804     # add the generated class names to the BUILD_MYPACKAGE_CLASSES variable and used java file names
       
   805     # to the BUILD_MYPACKAGE_JAVAS variable.
       
   806     $1_CLASSES := 
       
   807     $1_JAVAS   := 
       
   808     # Create a file in each package that represents the package dependency.
       
   809     # This file (_the.package) will also contain a list of the source files
       
   810     # to be compiled for this package.
       
   811     $1 := $$(sort $$(patsubst %,%_the.package,$$($1_BDIRS)))
       
   812     # Now call add_java_package for each package to create the dependencies.
       
   813     $$(foreach p,$$($1),$$(eval $$(call add_java_package,$1,$$p,$$($1_SRC),$$($1_BIN),$$($1_BIN)/_the.list_of_packages,NOTUSED,$$($1_USE_DEPS),$$($1_REMOTE),$$($1_JVM) $$($1_JAVAC),$$($1_FLAGS),$$($1_EXCLUDE_FILES_PATTERN) $(OVR_SRCS),$$($1_INCLUDE_FILES),$$($1_JVM) $$($1_JAVAH),$$($1_JAVAC_SOURCE_PATH_UGLY_OVERRIDE))))
       
   814     # All dependencies are setup, now we only need to depend on $1 (aka $(BUILD_MYPACKAGE))
       
   815     # and they will automatically be built!
       
   816 
       
   817     # Now add on any files to copy targets
       
   818     $1 := $$($1_ALL_COPY_TARGETS) $$($1_ALL_COPY_CLEAN_TARGETS) $$($1)
       
   819     # Remove the set of found classes from the set of all previously known classes
       
   820     # and the remainder is the set of missing classes.
       
   821     $1_MISSING_CLASSES:=$$(filter-out $$($1_BINS),$$($1_CLASSES))
       
   822     $1_PKGS_MISSING_CLASSES:=$$(sort $$(dir $$($1_MISSING_CLASSES)))
       
   823     # Remove the set of found java files from the set of all previously known java files
       
   824     # the remainder is Java files that have gone missing.
       
   825     $1_MISSING_JAVAS:=$$(filter-out $$($1_SRCS),$$($1_JAVAS))
       
   826     $1_PKGS_MISSING_JAVAS:=$$(sort $$(dir $$($1_MISSING_JAVAS)))
       
   827     # Remove each source root from the found paths.
       
   828     $$(foreach i,$$($1_SRC),$$(eval $$(call remove_string,$$i,$1_PKGS_MISSING_JAVAS)))
       
   829     # Finally remove duplicates and prefix with the binary path instead.
       
   830     $1_PKGS_MISSING_JAVAS:= $$(addprefix $$($1_BIN),$$(sort $$($1_PKGS_MISSING_JAVAS)))
       
   831 
       
   832     # Remove the set of all theoretical classes from the set of found classes.
       
   833     # the remainder is the set of superfluous classes.
       
   834     $1_SUPERFLUOUS_CLASSES:=$$(sort $$(filter-out $$($1_CLASSES),$$($1_BINS)))
       
   835     $1_PKGS_SUPERFLUOUS_CLASSES:=$$(sort $$(dir $$($1_SUPERFLUOUS_CLASSES)))
       
   836 
       
   837     # Now delete the _the.package files inside the problematic dirs.
       
   838     # This will force a rebuild of these packages!
       
   839     $1_FOO:=$$(sort $$($1_PKGS_MISSING_CLASSES) \
       
   840                                                  $$($1_PKGS_SUPERFLUOUS_CLASSES) \
       
   841                                                  $$($1_PKGS_MISSING_JAVAS))
       
   842 #    ifneq (,$$($1_FOO))
       
   843 #            $$(info MESSED UP PACKAGES $$($1_FOO))
       
   844 #    endif
       
   845 
       
   846     $$(shell $(RM) $$(addsuffix _the.package,$$(sort $$($1_PKGS_MISSING_CLASSES) \
       
   847                                                  $$($1_PKGS_SUPERFLUOUS_CLASSES) \
       
   848                                                  $$($1_PKGS_MISSING_JAVAS))))
       
   849 
       
   850     # Normal makefile dependencies based on timestamps will detect the normal use case
       
   851     # when Java files are simply added or modified.
       
   852 endif
       
   853 
       
   854 ifneq (,$$($1_JAR))
       
   855 
       
   856     ifeq (,$$($1_SUFFIXES))
       
   857         $1_SUFFIXES:=.class $$($1_CLEAN) $$($1_COPY)
       
   858     endif
       
   859 
       
   860     # A jar file was specified. Set it up.
       
   861     $$(eval $$(call SetupArchive,ARCHIVE_$1,$$($1),\
       
   862 	SRCS:=$$($1_BIN),\
       
   863 	SUFFIXES:=$$($1_SUFFIXES),\
       
   864 	EXCLUDE:=$$($1_EXCLUDES),\
       
   865 	INCLUDES:=$$($1_INCLUDES),\
       
   866 	EXTRA_FILES:=$$($1_ALL_COPY_TARGETS) $$($1_ALL_COPY_CLEAN_TARGETS),\
       
   867 	JAR:=$$($1_JAR),\
       
   868 	JARMAIN:=$$($1_JARMAIN),\
       
   869 	MANIFEST:=$$($1_MANIFEST),\
       
   870 	EXTRA_MANIFEST_ATTR:=$$($1_EXTRA_MANIFEST_ATTR),\
       
   871 	HEADERS:=$$($1_HEADERS),\
       
   872 	SETUP:=$$($1_SETUP)))
       
   873 endif
       
   874 
       
   875 ifneq (,$$($1_SRCZIP))
       
   876     # A srczip file was specified. Set it up.
       
   877     $$(eval $$(call SetupZipArchive,ARCHIVE_$1,\
       
   878 		SRC:=$$($1_SRC),\
       
   879 		ZIP:=$$($1_SRCZIP),\
       
   880 		INCLUDES:=$$($1_INCLUDES),\
       
   881 		EXCLUDES:=$$($1_EXCLUDES),\
       
   882 		EXCLUDE_FILES:=$$($1_EXCLUDE_FILES)))
       
   883 endif
       
   884 
       
   885 endef
       
   886 
       
   887