[libcxx] r246909 - Add temporary Makefile.sphinx build file to get libcxx.llvm.org/docs going

Eric Fiselier via cfe-commits cfe-commits at lists.llvm.org
Fri Sep 4 22:12:04 PDT 2015


Author: ericwf
Date: Sat Sep  5 00:12:04 2015
New Revision: 246909

URL: http://llvm.org/viewvc/llvm-project?rev=246909&view=rev
Log:
Add temporary Makefile.sphinx build file to get libcxx.llvm.org/docs going

Added:
    libcxx/trunk/docs/Makefile.sphinx

Added: libcxx/trunk/docs/Makefile.sphinx
URL: http://llvm.org/viewvc/llvm-project/libcxx/trunk/docs/Makefile.sphinx?rev=246909&view=auto
==============================================================================
--- libcxx/trunk/docs/Makefile.sphinx (added)
+++ libcxx/trunk/docs/Makefile.sphinx Sat Sep  5 00:12:04 2015
@@ -0,0 +1,34 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = _build
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext default
+
+default: html
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+
+clean:
+	-rm -rf $(BUILDDIR)/*
+
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@# FIXME: Remove this `cp` once HTML->Sphinx transition is completed.
+	@# Kind of a hack, but HTML-formatted docs are on the way out anyway.
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+




More information about the cfe-commits mailing list