dnrops
/
rust
mirror of https://github.com/rust-lang/rust.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

mk: only build PDFs of the manual and tutorial. 

This restores the old behaviour (as compared to building PDF versions of
all standalone docs), because some of the guides use unicode characters,
which seems to make pdftex unhappy.
This commit is contained in:
Huon Wilson 2014-03-09 15:54:16 +11:00
parent bb8ac2159f
commit b4815ad1ba
1 changed files with 12 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
mk/docs.mk
View File

@ -14,6 +14,9 @@
# #
# The DOCS variable is their names (with no file extension). # The DOCS variable is their names (with no file extension).
# #
# PDF_DOCS lists the targets for which PDF documentation should be
# build.
#
# RUSTDOC_FLAGS_xyz variables are extra arguments to pass to the # RUSTDOC_FLAGS_xyz variables are extra arguments to pass to the
# rustdoc invocation for xyz. # rustdoc invocation for xyz.
# #
@ -28,6 +31,8 @@ DOCS := index tutorial guide-ffi guide-macros guide-lifetimes \
complement-cheatsheet guide-runtime \ complement-cheatsheet guide-runtime \
rust rustdoc rust rustdoc
PDF_DOCS := tutorial rust
RUSTDOC_DEPS_rust := doc/full-toc.inc RUSTDOC_DEPS_rust := doc/full-toc.inc
RUSTDOC_FLAGS_rust := --markdown-in-header=doc/full-toc.inc RUSTDOC_FLAGS_rust := --markdown-in-header=doc/full-toc.inc
@ -45,8 +50,6 @@ PANDOC_TEX_OPTS = $(PANDOC_BASE_OPTS) --include-before-body=doc/version.md \
--from=markdown --include-before-body=doc/footer.tex --to=latex --from=markdown --include-before-body=doc/footer.tex --to=latex
PANDOC_EPUB_OPTS = $(PANDOC_BASE_OPTS) --to=epub PANDOC_EPUB_OPTS = $(PANDOC_BASE_OPTS) --to=epub
# The rustdoc executable... # The rustdoc executable...
RUSTDOC_EXE = $(HBIN2_H_$(CFG_BUILD))/rustdoc$(X_$(CFG_BUILD)) RUSTDOC_EXE = $(HBIN2_H_$(CFG_BUILD))/rustdoc$(X_$(CFG_BUILD))
# ...with rpath included in case --disable-rpath was provided to # ...with rpath included in case --disable-rpath was provided to
@ -146,6 +149,11 @@ doc/footer.tex: $(D)/footer.tex | doc/
# The (english) documentation for each doc item. # The (english) documentation for each doc item.
define DEF_SHOULD_BUILD_PDF_DOC
SHOULD_BUILD_PDF_DOC_$(1) = 1
endef
$(foreach docname,$(PDF_DOCS),$(eval $(call DEF_SHOULD_BUILD_PDF_DOC,$(docname))))
define DEF_DOC define DEF_DOC
# HTML (rustdoc) # HTML (rustdoc)
@ -171,6 +179,7 @@ doc/$(1).tex: $$(D)/$(1).md doc/footer.tex doc/version.md | doc/
$$(CFG_PANDOC) $$(PANDOC_TEX_OPTS) --output=$$@ $$(CFG_PANDOC) $$(PANDOC_TEX_OPTS) --output=$$@
ifneq ($(NO_PDF_DOCS),1) ifneq ($(NO_PDF_DOCS),1)
ifeq ($$(SHOULD_BUILD_PDF_DOC_$(1)),1)
DOC_TARGETS += doc/$(1).pdf DOC_TARGETS += doc/$(1).pdf
doc/$(1).pdf: doc/$(1).tex doc/$(1).pdf: doc/$(1).tex
@$$(call E, pdflatex: $$@) @$$(call E, pdflatex: $$@)
@ -178,6 +187,7 @@ doc/$(1).pdf: doc/$(1).tex
-interaction=batchmode \ -interaction=batchmode \
-output-directory=doc \ -output-directory=doc \
$$< $$<
endif # SHOULD_BUILD_PDF_DOCS_$(1)
endif # NO_PDF_DOCS endif # NO_PDF_DOCS
endif # ONLY_HTML_DOCS endif # ONLY_HTML_DOCS