2020-03-08 06:45:05 +08:00
|
|
|
# Minimal makefile for Sphinx documentation
|
2010-10-11 05:45:45 +08:00
|
|
|
#
|
|
|
|
|
2020-03-08 06:45:05 +08:00
|
|
|
# You can set these variables from the command line, and also
|
|
|
|
# from the environment for the first two.
|
|
|
|
SPHINXOPTS ?=
|
|
|
|
SPHINXBUILD ?= sphinx-build
|
|
|
|
SOURCEDIR = .
|
2010-10-11 05:45:45 +08:00
|
|
|
BUILDDIR = _build
|
|
|
|
|
2020-03-08 06:45:05 +08:00
|
|
|
# Put it first so that "make" without argument is like "make help".
|
|
|
|
help:
|
|
|
|
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
|
|
|
|
|
|
|
|
.PHONY: help Makefile
|
|
|
|
|
|
|
|
# Catch-all target: route all unknown targets to Sphinx using the new
|
|
|
|
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
|
|
|
|
%: Makefile
|
|
|
|
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
|
|
|
|
|
2010-10-11 05:45:45 +08:00
|
|
|
|
2015-09-22 20:02:11 +08:00
|
|
|
REGENDOC_ARGS := \
|
2019-04-03 23:10:16 +08:00
|
|
|
--normalize "/[ \t]+\n/\n/" \
|
2019-04-04 04:06:51 +08:00
|
|
|
--normalize "~\$$REGENDOC_TMPDIR~/home/sweet/project~" \
|
|
|
|
--normalize "~/path/to/example~/home/sweet/project~" \
|
2019-09-18 21:10:25 +08:00
|
|
|
--normalize "/in \d.\d\ds/in 0.12s/" \
|
2015-09-22 20:02:11 +08:00
|
|
|
--normalize "@/tmp/pytest-of-.*/pytest-\d+@PYTEST_TMPDIR@" \
|
2017-05-13 04:17:40 +08:00
|
|
|
--normalize "@pytest-(\d+)\\.[^ ,]+@pytest-\1.x.y@" \
|
|
|
|
--normalize "@py-(\d+)\\.[^ ,]+@py-\1.x.y@" \
|
|
|
|
--normalize "@pluggy-(\d+)\\.[.\d,]+@pluggy-\1.x.y@" \
|
2017-05-13 04:51:20 +08:00
|
|
|
--normalize "@hypothesis-(\d+)\\.[.\d,]+@hypothesis-\1.x.y@" \
|
2017-05-13 04:38:50 +08:00
|
|
|
--normalize "@Python (\d+)\\.[^ ,]+@Python \1.x.y@"
|
2015-09-22 20:02:11 +08:00
|
|
|
|
2019-04-04 00:04:50 +08:00
|
|
|
regen: REGENDOC_FILES:=*.rst */*.rst
|
2015-04-02 16:38:25 +08:00
|
|
|
regen:
|
2021-10-04 14:56:26 +08:00
|
|
|
# need to reset cachedir to the non-tox default
|
|
|
|
PYTHONDONTWRITEBYTECODE=1 \
|
|
|
|
PYTEST_ADDOPTS="-pno:hypothesis -p no:hypothesispytest -Wignore::pytest.PytestUnknownMarkWarning -o cache_dir=.pytest_cache" \
|
|
|
|
COLUMNS=76 \
|
|
|
|
regendoc --update ${REGENDOC_FILES} ${REGENDOC_ARGS}
|
2015-04-02 16:38:25 +08:00
|
|
|
|
2020-03-08 06:45:05 +08:00
|
|
|
.PHONY: regen
|