|
@@ -14,6 +14,8 @@ ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
|
|
# the i18n builder cannot share the environment and doctrees with the others
|
|
# the i18n builder cannot share the environment and doctrees with the others
|
|
I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
|
|
I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
|
|
|
|
|
|
|
|
+DEPEND = autoxml.rst
|
|
|
|
+
|
|
.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
|
|
.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
|
|
|
|
|
|
help:
|
|
help:
|
|
@@ -41,40 +43,40 @@ help:
|
|
@echo " install to generate manpages and copy them to \$$(DESTDIR)/usr/share/man"
|
|
@echo " install to generate manpages and copy them to \$$(DESTDIR)/usr/share/man"
|
|
|
|
|
|
clean:
|
|
clean:
|
|
- -rm -rf $(BUILDDIR)/*
|
|
|
|
|
|
+ -rm -rf $(BUILDDIR)/* $(DEPEND)
|
|
|
|
|
|
-html:
|
|
|
|
|
|
+html: $(DEPEND)
|
|
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
|
|
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
|
|
@echo
|
|
@echo
|
|
@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
|
|
@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
|
|
|
|
|
|
-dirhtml:
|
|
|
|
|
|
+dirhtml: $(DEPEND)
|
|
$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
|
|
$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
|
|
@echo
|
|
@echo
|
|
@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
|
|
@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
|
|
|
|
|
|
-singlehtml:
|
|
|
|
|
|
+singlehtml: $(DEPEND)
|
|
$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
|
|
$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
|
|
@echo
|
|
@echo
|
|
@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
|
|
@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
|
|
|
|
|
|
-pickle:
|
|
|
|
|
|
+pickle: $(DEPEND)
|
|
$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
|
|
$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
|
|
@echo
|
|
@echo
|
|
@echo "Build finished; now you can process the pickle files."
|
|
@echo "Build finished; now you can process the pickle files."
|
|
|
|
|
|
-json:
|
|
|
|
|
|
+json: $(DEPEND)
|
|
$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
|
|
$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
|
|
@echo
|
|
@echo
|
|
@echo "Build finished; now you can process the JSON files."
|
|
@echo "Build finished; now you can process the JSON files."
|
|
|
|
|
|
-htmlhelp:
|
|
|
|
|
|
+htmlhelp: $(DEPEND)
|
|
$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
|
|
$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
|
|
@echo
|
|
@echo
|
|
@echo "Build finished; now you can run HTML Help Workshop with the" \
|
|
@echo "Build finished; now you can run HTML Help Workshop with the" \
|
|
".hhp project file in $(BUILDDIR)/htmlhelp."
|
|
".hhp project file in $(BUILDDIR)/htmlhelp."
|
|
|
|
|
|
-qthelp:
|
|
|
|
|
|
+qthelp: $(DEPEND)
|
|
$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
|
|
$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
|
|
@echo
|
|
@echo
|
|
@echo "Build finished; now you can run "qcollectiongenerator" with the" \
|
|
@echo "Build finished; now you can run "qcollectiongenerator" with the" \
|
|
@@ -83,7 +85,7 @@ qthelp:
|
|
@echo "To view the help file:"
|
|
@echo "To view the help file:"
|
|
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/core-admin.qhc"
|
|
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/core-admin.qhc"
|
|
|
|
|
|
-devhelp:
|
|
|
|
|
|
+devhelp: $(DEPEND)
|
|
$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
|
|
$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
|
|
@echo
|
|
@echo
|
|
@echo "Build finished."
|
|
@echo "Build finished."
|
|
@@ -92,30 +94,30 @@ devhelp:
|
|
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/core-admin"
|
|
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/core-admin"
|
|
@echo "# devhelp"
|
|
@echo "# devhelp"
|
|
|
|
|
|
-epub:
|
|
|
|
|
|
+epub: $(DEPEND)
|
|
$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
|
|
$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
|
|
@echo
|
|
@echo
|
|
@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
|
|
@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
|
|
|
|
|
|
-latex:
|
|
|
|
|
|
+latex: $(DEPEND)
|
|
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
|
|
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
|
|
@echo
|
|
@echo
|
|
@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
|
|
@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
|
|
@echo "Run \`make' in that directory to run these through (pdf)latex" \
|
|
@echo "Run \`make' in that directory to run these through (pdf)latex" \
|
|
"(use \`make latexpdf' here to do that automatically)."
|
|
"(use \`make latexpdf' here to do that automatically)."
|
|
|
|
|
|
-latexpdf:
|
|
|
|
|
|
+latexpdf: $(DEPEND)
|
|
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
|
|
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
|
|
@echo "Running LaTeX files through pdflatex..."
|
|
@echo "Running LaTeX files through pdflatex..."
|
|
$(MAKE) -C $(BUILDDIR)/latex all-pdf
|
|
$(MAKE) -C $(BUILDDIR)/latex all-pdf
|
|
@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
|
|
@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
|
|
|
|
|
|
-text:
|
|
|
|
|
|
+text: $(DEPEND)
|
|
$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
|
|
$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
|
|
@echo
|
|
@echo
|
|
@echo "Build finished. The text files are in $(BUILDDIR)/text."
|
|
@echo "Build finished. The text files are in $(BUILDDIR)/text."
|
|
|
|
|
|
-man:
|
|
|
|
|
|
+man: $(DEPEND)
|
|
$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
|
|
$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
|
|
for file in $(BUILDDIR)/man/*.[12345678]; do \
|
|
for file in $(BUILDDIR)/man/*.[12345678]; do \
|
|
gzip -f $$file; \
|
|
gzip -f $$file; \
|
|
@@ -123,41 +125,44 @@ man:
|
|
@echo
|
|
@echo
|
|
@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
|
|
@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
|
|
|
|
|
|
-texinfo:
|
|
|
|
|
|
+texinfo: $(DEPEND)
|
|
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
|
|
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
|
|
@echo
|
|
@echo
|
|
@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
|
|
@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
|
|
@echo "Run \`make' in that directory to run these through makeinfo" \
|
|
@echo "Run \`make' in that directory to run these through makeinfo" \
|
|
"(use \`make info' here to do that automatically)."
|
|
"(use \`make info' here to do that automatically)."
|
|
|
|
|
|
-info:
|
|
|
|
|
|
+info: $(DEPEND)
|
|
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
|
|
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
|
|
@echo "Running Texinfo files through makeinfo..."
|
|
@echo "Running Texinfo files through makeinfo..."
|
|
make -C $(BUILDDIR)/texinfo info
|
|
make -C $(BUILDDIR)/texinfo info
|
|
@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
|
|
@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
|
|
|
|
|
|
-gettext:
|
|
|
|
|
|
+gettext: $(DEPEND)
|
|
$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
|
|
$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
|
|
@echo
|
|
@echo
|
|
@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
|
|
@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
|
|
|
|
|
|
-changes:
|
|
|
|
|
|
+changes: $(DEPEND)
|
|
$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
|
|
$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
|
|
@echo
|
|
@echo
|
|
@echo "The overview file is in $(BUILDDIR)/changes."
|
|
@echo "The overview file is in $(BUILDDIR)/changes."
|
|
|
|
|
|
-linkcheck:
|
|
|
|
|
|
+linkcheck: $(DEPEND)
|
|
$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
|
|
$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
|
|
@echo
|
|
@echo
|
|
@echo "Link check complete; look for any errors in the above output " \
|
|
@echo "Link check complete; look for any errors in the above output " \
|
|
"or in $(BUILDDIR)/linkcheck/output.txt."
|
|
"or in $(BUILDDIR)/linkcheck/output.txt."
|
|
|
|
|
|
-doctest:
|
|
|
|
|
|
+doctest: $(DEPEND)
|
|
$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
|
|
$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
|
|
@echo "Testing of doctests in the sources finished, look at the " \
|
|
@echo "Testing of doctests in the sources finished, look at the " \
|
|
"results in $(BUILDDIR)/doctest/output.txt."
|
|
"results in $(BUILDDIR)/doctest/output.txt."
|
|
|
|
|
|
|
|
|
|
|
|
+autoxml.rst: ../relaxng/qubes.rng example.xml
|
|
|
|
+ ../qubes/rngdoc.py $+ > $@
|
|
|
|
+
|
|
.PHONY: install
|
|
.PHONY: install
|
|
install: man
|
|
install: man
|
|
mkdir -p $(DESTDIR)/usr/share/man/man1
|
|
mkdir -p $(DESTDIR)/usr/share/man/man1
|