Makefile revision 2589
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License # version 2 for more details (a copy is included in the LICENSE file that # accompanied this code). # You should have received a copy of the GNU General Public License version # 2 along with this work; if not, write to the Free Software Foundation, # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. # Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA # or visit www.oracle.com if you need additional information or have any # Definitions for $(DOCSDIR), $(MKDIR), $(BINDIR), etc. # Get CopyrightLine macro and other shared variables # Url to root of documents # Url to copyright html file # Common line for how to submit a bug or rfe # Url to Java Language Spec # Common Java trademark line # Definitions for imported components # We override whatever the max VM memory setting is here. # NOTE: javadoc will not complete without these larger settings. # WARNING: This could cause thrashing on low memory machines. # List of all possible directories for javadoc to look for sources # NOTE: Quotes are required around sourcepath argument only on Windows. # Otherwise, you get "No packages or classes specified." due # to $(CLASSPATH_SEPARATOR) being interpreted as an end of # command (newline or shell ; character) # List of directories that actually exist # List with classpath separator between them # Prep for javadoc creation, assumes $@ is an index.html file @
if [ -f
"$@" -a
"$?" !=
"" ] ;
then \
$(ECHO) "# Dependencies have changed: $?"; \
# A cache of the directories in ALL_SOURCE_DIRS # Given a list of packages, return a list of files or dirs to be dependent on # (Currently only returning a list of directories) pd=`$(ECHO) $${p} | $(SED) -e 's@[.]@/@g'`; \ # Given a list of packages, add packages that exist to $@, print summary @
if [
"$1" !=
"" ] ;
then \
pd=
`$(ECHO) $${p} | $(SED) -e 's@[.]@/@g'`; \
if [ -d $${
cp}/$${
pd} ] ;
then \
if [
"$${found}" =
"false" ] ;
then \
$(ECHO) "WARNING: Package not found: $${p}"; \
# Print out a summary of the javadoc command about to be run @
$(ECHO) "# Summary for $@";\
# Temporary directory for javadoc creation # Different api directories created from root directory # The non-core api javadocs need to be able to access the root of the core # api directory, so for jdk/api or jre/api to get to the core api/ # directory we would use this: # Common trademark bottom argument (Not sure why this is used sometimes) # Core api bottom argument (with special sauce) # Common javadoc options used by all # Draft used for non-fcs documents # Early access top text (not used in FCS releases) ################################################################# # CORE_PKGS environment variable has been moved to the following file # Load environment variables for API package names that are not part of ################################################################# # Default target is same as docs target, create core api and all others it can ################################################################# # Production Targets -- USE THESE TARGETS WHEN: # a) You're generating docs outside of release engineering's # standard control build. # b) The docs will be pushed to the web and/or included in # the downloaded doc bundle. # Note: Spaces precede ifdef/ifndef indents. Tabs precede target commands (!) @
$(ECHO) "Building core api docs with these values:" @
$(ECHO) "ERROR: Build number must be defined"############################################################# # Java language specification cite TAG_JLS3 = -
tag 'jls3:a:See <cite>$(JLS3_CITE)</cite>:' # Overview file for core apis # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ISO-8859-1" ; \ $(ECHO) "-splitIndex" ; \ # Create a file with the package names in it ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ # Create a file with the package names in it ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-breakiterator" ; \ $(ECHO) "-encoding ascii" ; \ # Create a file with the package names in it ############################################################# # Temporary directory (special generation rules) # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ # Create a file with the package names in it ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ $(ECHO) "-splitIndex" ; \ # Create a file with the package names in it ############################################################# ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ # Create a file with the package names in it ############################################################# ############################################################# ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ # Create a file with the package names in it ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ $(ECHO) "-nodeprecatedlist" ; \ # Create a file with the package names in it ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ $(ECHO) "-nodeprecatedlist" ; \ # Create a file with the package names in it ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ $(ECHO) "-nodeprecatedlist" ; \ # Create a file with the package names in it ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ $(ECHO) "-nodeprecatedlist" ; \ # Create a file with the package names in it ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ $(ECHO) "-nodeprecatedlist" ; \ # Create a file with the package names in it ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ $(ECHO) "-nodeprecatedlist" ; \ # Create a file with the package names in it ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ # Create a file with the package names in it ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ $(ECHO) "-nodeprecatedlist" ; \ # Create a file with the package names in it ############################################################# # Set relative location to core api document root # Run javadoc if the index file is out of date or missing # Create file with javadoc options in it $(ECHO) "-encoding ascii" ; \ $(ECHO) "-nodeprecatedlist" ; \ # Create a file with the package names in it ############################################################# # Get a cache of all the directories $(ECHO) "$(FIND) $${cp} -type f >> $@"; \ $(FIND) $${cp} -type f >> $@; \ ############################################################# #release version of core packages ######## # Maximize performance and ensure that build number & milestone are set. # end of production targets ############################################################# # List the values defined in the makefile hierarchy, to make sure everything # is set properly, and to help identify values we can use instead of making new ones. # * BUILD_NUMBER defaults to b00 if not set on command line with BUILD_NUMBER=<value> # * MILESTONE defaults to internal unless set to beta, rc, or fcs on command line @$(ECHO) --------------Imports--------------------------- @$(ECHO) --------------Imports--------------------------- @$(ECHO) --------------Shared--------------------------- @$(ECHO) --------------Shared--------------------------- @$(ECHO) "RELEASEDOCS_SOURCEPATH" #############################################################