diff options
author | Lukas Larsson <lukas@erlang.org> | 2020-02-21 10:19:05 +0100 |
---|---|---|
committer | Lukas Larsson <lukas@erlang.org> | 2020-02-24 10:02:51 +0100 |
commit | 48ecc7a66a23be4d3b8bb7976aaae0ba8e72f0e8 (patch) | |
tree | 666910810e54cc16652603cb1ccf05fa8b4d3601 /make | |
parent | 31c270cc9d696763dfbdf0d4438142e87dbb95ec (diff) | |
download | erlang-48ecc7a66a23be4d3b8bb7976aaae0ba8e72f0e8.tar.gz |
Add DOC_TARGETS makefile variable
The variable can be set to pdf, html, man or chunks
and also any combination of the above.
Diffstat (limited to 'make')
-rw-r--r-- | make/doc.mk | 23 | ||||
-rw-r--r-- | make/otp.mk.in | 2 | ||||
-rw-r--r-- | make/otp_release_targets.mk | 12 |
3 files changed, 28 insertions, 9 deletions
diff --git a/make/doc.mk b/make/doc.mk index d45e07e795..cbba59b60d 100644 --- a/make/doc.mk +++ b/make/doc.mk @@ -75,6 +75,8 @@ EMPTY_CHUNK_FILES = $(filter-out $(NO_CHUNKS:%.xml=$(CHUNKSDIR)/%.chunk) $(CHUNK SPECS_FLAGS = -I$(ERL_TOP)/lib -I$(ERL_TOP)/lib/*/include -I$(ERL_TOP)/lib/*/src + + # ---------------------------------------------------- # Targets # ---------------------------------------------------- @@ -85,13 +87,15 @@ $(HTMLDIR)/%.png: %.png $(HTMLDIR)/%.jpg: %.jpg $(INSTALL_DATA) $< $@ -docs: man pdf html chunks $(INFO_FILE) +DOC_TARGETS?=man pdf html chunks + +docs: $(INFO_FILE) $(DOC_TARGETS) $(TOP_PDF_FILE): $(XML_FILES) pdf: $(TOP_PDF_FILE) -html: images $(HTML_REF_MAN_FILE) +html: images $(HTML_REF_MAN_FILE) $(HTMLDIR)/$(APPLICATION).eix man: $(MAN1_FILES) $(MAN2_FILES) $(MAN3_FILES) $(MAN4_FILES) $(MAN5_FILES) $(MAN6_FILES) $(MAN7_FILES) @@ -146,19 +150,27 @@ clean_chunks: # ---------------------------------------------------- include $(ERL_TOP)/make/otp_release_targets.mk -release_docs_spec: docs +$(RELSYSDIR): + $(INSTALL_DIR) "$(RELSYSDIR)" + +release_pdf_spec: pdf $(INSTALL_DIR) "$(RELSYSDIR)/doc/pdf" $(INSTALL_DATA) $(TOP_PDF_FILE) "$(RELSYSDIR)/doc/pdf" + +release_html_spec: html $(INSTALL_DIR) "$(RELSYSDIR)/doc/html" $(INSTALL_DIR_DATA) $(HTMLDIR) "$(RELSYSDIR)/doc/html" ifneq ($(HTML_EXTRA_FILES),) $(INSTALL_DATA) $(HTML_EXTRA_FILES) "$(RELSYSDIR)/doc/html" endif + +release_chunks_spec: chunks ifneq ($(CHUNK_FILES),) $(INSTALL_DIR) "$(RELCHUNKSDIR)/doc/chunks" $(INSTALL_DATA) $(CHUNKSDIR)/* "$(RELCHUNKSDIR)/doc/chunks" endif - $(INSTALL_DATA) $(INFO_FILE) "$(RELSYSDIR)" + +release_man_spec: man ifneq ($(MAN1_FILES),) $(INSTALL_DIR) "$(RELEASE_PATH)/man/man1" $(INSTALL_DATA) $(MAN1DIR)/* "$(RELEASE_PATH)/man/man1" @@ -187,6 +199,9 @@ ifneq ($(MAN7_FILES),) $(INSTALL_DIR) "$(RELEASE_PATH)/man/man7" $(INSTALL_DATA) $(MAN7_FILES) "$(RELEASE_PATH)/man/man7" endif + +release_docs_spec: $(RELSYSDIR) $(INFO_FILE) $(DOC_TARGETS:%=release_%_spec) + $(INSTALL_DATA) $(INFO_FILE) $(RELSYSDIR) ifneq ($(STANDARDS),) $(INSTALL_DIR) "$(RELEASE_PATH)/doc/standard" $(INSTALL_DATA) $(STANDARDS) "$(RELEASE_PATH)/doc/standard" diff --git a/make/otp.mk.in b/make/otp.mk.in index 64061ac7b5..5c1032c894 100644 --- a/make/otp.mk.in +++ b/make/otp.mk.in @@ -271,7 +271,7 @@ DEFAULT_HTML_FILES = \ $(XML_APPLICATION_FILES:%.xml=$(HTMLDIR)/%.kwc) \ $(HTMLDIR)/index.html -DEFAULT_GIF_FILES = $(HTMLDIR)/min_head.gif +DEFAULT_GIF_FILES = # # Flags & Commands diff --git a/make/otp_release_targets.mk b/make/otp_release_targets.mk index eeca2dd5da..fe1f5103ca 100644 --- a/make/otp_release_targets.mk +++ b/make/otp_release_targets.mk @@ -142,8 +142,6 @@ $(HTMLDIR)/$(APPLICATION).eix: $(XML_GEN_FILES) $(SPECS_FILES) -path $(DOCGEN)/priv/dtd_html_entities \ $(DOCGEN)/priv/xsl/db_eix.xsl $(XMLDIR)/book.xml > $@ -docs: $(HTMLDIR)/$(APPLICATION).eix - ## Here awk is used to find all xi:include files in $(BOOK_FILES) ## Then we look into all those files check for xi:includes BOOK_XI_INC_FILES:=$(foreach file,$(BOOK_FILES),$(shell awk -F\" '/xi:include/ {print $$2}' $(file))) $(BOOK_FILES) @@ -207,15 +205,21 @@ endif # Standard release target # ---------------------------------------------------- +pdf man chunks html: $(XML_GEN_FILES) $(SPECS_FILES) $(TOP_SPECS_FILE) +release_man_spec: man +release_pdf_spec: pdf +release_chunks_spec: chunks +release_html_spec: html + ifeq ($(TESTROOT),) -release release_docs release_tests release_html: +release release_docs release_tests: $(MAKE) $(MFLAGS) RELEASE_PATH=$(OTP_DEFAULT_RELEASE_PATH) \ $(TARGET_MAKEFILE) $@_spec else -release release_docs release_tests release_html: +release release_docs release_tests: $(MAKE) $(MFLAGS) RELEASE_PATH="$(TESTROOT)" $(TARGET_MAKEFILE) $@_spec endif |