ComputerSurge/bind9
3
0
Fork 0
Code Pull Requests 1 Activity

Explicitly specify sphinx-build cache directories

Browse Source 
When sphinx-build is invoked without the -d command line switch, the
default path to the directory in which cached environment and doctree
files are placed is OUTPUTDIR/.doctrees.  This causes the contents of
such cache directories to needlessly be included in BIND release
directories.  Avoid that by employing the -d command line switch to make
each sphinx-build process use a cache directory outside the output
directory.  Make sure these cache directories are separate from each
other as well, to prevent multiple sphinx-build processes running in
parallel from interfering with each other.
This commit is contained in:
Michał Kępień
2021-02-03 12:18:45 +01:00
parent 7e0c374d83
commit 36ea46fbe0
2 changed files with 4 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
doc/arm/Makefile.in
View File

@@ -57,10 +57,10 @@ man:: $(man1_MANS) $(man5_MANS) $(man8_MANS) @PKCS11_MANS@
doc:: @HTMLTARGET@ @PDFTARGET@
html dirhtml:
$(SPHINXBUILD) -b $@ $(ALLSPHINXOPTS) "$(SPHINXBUILDDIR)"/$@
$(SPHINXBUILD) -b $@ -d "$(SPHINXBUILDDIR)"/.doctrees/$@ $(ALLSPHINXOPTS) "$(SPHINXBUILDDIR)"/$@
pdf:
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) "$(SPHINXBUILDDIR)"/latex
$(SPHINXBUILD) -b latex -d "$(SPHINXBUILDDIR)"/.doctrees/$@ $(ALLSPHINXOPTS) "$(SPHINXBUILDDIR)"/latex
make -C "$(SPHINXBUILDDIR)"/latex
cp "$(SPHINXBUILDDIR)"/latex/Bv9ARM.pdf "${builddir}"

4
doc/man/Makefile.in
View File

@@ -182,7 +182,7 @@ man:: ootsetup $(man1_MANS) $(man5_MANS) $(man8_MANS) @DNSTAP_MANS@ @NZD_MANS@ @
doc:: @HTMLTARGET@ @PDFTARGET@
html dirhtml:
$(SPHINXBUILD) -b $@ $(ALLSPHINXOPTS) "$(SPHINXBUILDDIR)"/$@
$(SPHINXBUILD) -b $@ -d "$(SPHINXBUILDDIR)"/.doctrees/$@ $(ALLSPHINXOPTS) "$(SPHINXBUILDDIR)"/$@
# copy in out-of-tree files in case sphinx-build isn't available
.NOTPARALLEL:
@@ -192,7 +192,7 @@ ootsetup: $(MANPAGES_IN)
done
$(MANPAGES_IN): $(MANPAGES_RST)
$(SPHINXBUILD) -b man $(man_SPHINXOPTS) "$(SPHINXBUILDDIR)"/man
$(SPHINXBUILD) -b man -d "$(SPHINXBUILDDIR)"/.doctrees/$@ $(man_SPHINXOPTS) "$(SPHINXBUILDDIR)"/man
-for man in $(MANPAGES_IN); do \
[ -e "$(SPHINXBUILDDIR)"/man/"$$(basename $$man in)" ] && \
cp -f "$(SPHINXBUILDDIR)"/man/"$$(basename $$man in)" "$$man"; \