From: R Veera Kumar Date: Sat, 5 Jun 2021 02:14:27 +0000 (+0530) Subject: Add Makefile modified for sphinx. X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=eddd1f516b52beabf01ce1c24ad88211f943e153;p=ieee754fpu.git Add Makefile modified for sphinx. --- diff --git a/Makefile b/Makefile index 5ddf6b68..9b869879 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,7 @@ PYTHON3 ?= "python3" +.PHONY: help gitupdate Makefile install test htmlupload + gitupdate: git submodule init git submodule update --recursive @@ -12,3 +14,30 @@ test: pypiupload: $(PYTHON3) setup.py sdist upload + +# Minimal makefile for Sphinx documentation +# + +# You can set these variables from the command line. +SPHINXOPTS = +SPHINXBUILD = sphinx-build +SPHINXPROJ = ieee754fpu +SOURCEDIR = . +BUILDDIR = build + +# Put it first so that "make" without argument is like "make help". +help: + @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + +# copies all documentation to libre-soc (libre-soc admins only) +htmlupload: clean html + rsync -HPavz --delete build/html/* \ + libre-soc.org:/var/www/libre-soc.org/docs/ieee754fpu/ + +# Catch-all target: route all unknown targets to Sphinx using the new +# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). +%: Makefile + echo "catch-all falling through to sphinx for document building" + mkdir -p "$(SOURCEDIR)"/src/gen + sphinx-apidoc --ext-autodoc -o "$(SOURCEDIR)"/src/gen ./src/ieee754 + @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)