make/UpdateBuildDocs.gmk
author jwilhelm
Tue, 16 May 2017 01:11:26 +0200
changeset 46219 656fa621d3ec
parent 44983 4e216c0475ee
child 45763 2a2e56f4c03b
permissions -rw-r--r--
Merge
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
44078
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
     1
#
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
     2
# Copyright (c) 2017, Oracle and/or its affiliates. All rights reserved.
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
     3
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
     4
#
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
     5
# This code is free software; you can redistribute it and/or modify it
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
     6
# under the terms of the GNU General Public License version 2 only, as
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
     7
# published by the Free Software Foundation.  Oracle designates this
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
     8
# particular file as subject to the "Classpath" exception as provided
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
     9
# by Oracle in the LICENSE file that accompanied this code.
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    10
#
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    11
# This code is distributed in the hope that it will be useful, but WITHOUT
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    12
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    13
# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    14
# version 2 for more details (a copy is included in the LICENSE file that
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    15
# accompanied this code).
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    16
#
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    17
# You should have received a copy of the GNU General Public License version
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    18
# 2 along with this work; if not, write to the Free Software Foundation,
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    19
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    20
#
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    21
# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    22
# or visit www.oracle.com if you need additional information or have any
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    23
# questions.
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    24
#
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    25
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    26
default: all
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    27
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    28
include $(SPEC)
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    29
include MakeBase.gmk
44983
4e216c0475ee 8179453: Add a proper SetupProcessMarkdown
ihse
parents: 44511
diff changeset
    30
include ProcessMarkdown.gmk
44078
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    31
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    32
################################################################################
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    33
# This makefile updates the generated build html documentation.
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    34
#
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    35
################################################################################
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    36
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    37
ifeq ($(PANDOC), )
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    38
  $(info No pandoc executable was detected by configure)
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    39
  $(error Cannot continue)
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    40
endif
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    41
44983
4e216c0475ee 8179453: Add a proper SetupProcessMarkdown
ihse
parents: 44511
diff changeset
    42
GLOBAL_SPECS_DEFAULT_CSS_FILE := $(JDK_TOPDIR)/make/data/docs-resources/specs/resources/jdk-default.css
44078
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    43
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    44
################################################################################
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    45
44511
f3c27401a860 8177955: Add testing documentation
ihse
parents: 44078
diff changeset
    46
DOCS_DIR := $(TOPDIR)/common/doc
44078
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    47
44983
4e216c0475ee 8179453: Add a proper SetupProcessMarkdown
ihse
parents: 44511
diff changeset
    48
$(eval $(call SetupProcessMarkdown, building, \
4e216c0475ee 8179453: Add a proper SetupProcessMarkdown
ihse
parents: 44511
diff changeset
    49
  FILES := $(DOCS_DIR)/building.md, \
4e216c0475ee 8179453: Add a proper SetupProcessMarkdown
ihse
parents: 44511
diff changeset
    50
  DEST := $(DOCS_DIR), \
4e216c0475ee 8179453: Add a proper SetupProcessMarkdown
ihse
parents: 44511
diff changeset
    51
  CSS := $(GLOBAL_SPECS_DEFAULT_CSS_FILE), \
44511
f3c27401a860 8177955: Add testing documentation
ihse
parents: 44078
diff changeset
    52
))
44983
4e216c0475ee 8179453: Add a proper SetupProcessMarkdown
ihse
parents: 44511
diff changeset
    53
TARGETS += $(building)
44511
f3c27401a860 8177955: Add testing documentation
ihse
parents: 44078
diff changeset
    54
44983
4e216c0475ee 8179453: Add a proper SetupProcessMarkdown
ihse
parents: 44511
diff changeset
    55
$(eval $(call SetupProcessMarkdown, testing, \
4e216c0475ee 8179453: Add a proper SetupProcessMarkdown
ihse
parents: 44511
diff changeset
    56
  FILES := $(DOCS_DIR)/testing.md, \
4e216c0475ee 8179453: Add a proper SetupProcessMarkdown
ihse
parents: 44511
diff changeset
    57
  DEST := $(DOCS_DIR), \
4e216c0475ee 8179453: Add a proper SetupProcessMarkdown
ihse
parents: 44511
diff changeset
    58
  CSS := $(GLOBAL_SPECS_DEFAULT_CSS_FILE), \
44511
f3c27401a860 8177955: Add testing documentation
ihse
parents: 44078
diff changeset
    59
  OPTIONS := --toc, \
44078
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    60
))
44983
4e216c0475ee 8179453: Add a proper SetupProcessMarkdown
ihse
parents: 44511
diff changeset
    61
TARGETS += $(testing)
44078
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    62
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    63
################################################################################
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    64
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    65
$(eval $(call IncludeCustomExtension, , UpdateBuildDocs.gmk))
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    66
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    67
################################################################################
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    68
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    69
all: $(TARGETS)
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    70
673240c54c2e 8176509: Use pandoc for converting build readme to html
ihse
parents:
diff changeset
    71
.PHONY: all default