diff --git a/docs/Makefile b/docs/Makefile index ee1f607..b211207 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -1,14 +1,17 @@ # Minimal makefile for Sphinx documentation -# # Environment variables SPHINXOPTS ?= SPHINXBUILD ?= sphinx-build SPHINXAPIDOC ?= sphinx-apidoc APIOPTS = -d 8 -H SasData +DOCSDIR = docs SOURCEDIR = source BUILDDIR = build -CD = cd +DEVDIR = dev +LIBDIR = lib +GENDIR = generated +UP = .. ifdef ComSpec RMDIR = rmdir /s/q @@ -20,27 +23,31 @@ else PATHSEP = $(strip /) endif -LIBDIR = $(BUILDDIR)$(PATHSEP)lib +SASDATABUILD = $(UP)$(PATHSEP)$(BUILDDIR)$(PATHSEP)$(LIBDIR) +DOCSSRC = $(SOURCEDIR) +DEV = $(DOCSSRC)$(PATHSEP)$(DEVDIR) +DEVGEN = $(DEV)$(PATHSEP)$(GENDIR) +DOCSBUILD = $(DOCSSRC)$(PATHSEP)$(BUILDDIR) # Put it first so that "make" without argument is like "make help". help: @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) clean: - -$(RMDIR) "$(SOURCEDIR)$(PATHSEP)dev$(PATHSEP)generated/" "$(BUILDDIR)" + -$(RMDIR) "$(DEVGEN)" "$(DOCSBUILD)" dir: - -$(MKDIR) "$(BUILDDIR)" - -$(MKDIR) "$(LIBDIR)" + -$(MKDIR) "$(DEVGEN)" + -$(MKDIR) "$(DOCSBUILD)" .PHONY: help Makefile # Generate the api docs api: - $(SPHINXAPIDOC) -o "$(SOURCEDIR)$(PATHSEP)dev$(PATHSEP)generated/" $(APIOPTS) "$(LIBDIR)" + $(SPHINXAPIDOC) -o "$(DEVGEN)" $(APIOPTS) "$(SASDATABUILD)" html: dir api - @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + @$(SPHINXBUILD) -M $@ "$(DOCSSRC)" "$(DOCSBUILD)" $(SPHINXOPTS) $(O) # Catch-all target: route all unknown targets to Sphinx using the new # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). diff --git a/docs/source/dev/dev.rst b/docs/source/dev/dev.rst index 100c316..47b8208 100644 --- a/docs/source/dev/dev.rst +++ b/docs/source/dev/dev.rst @@ -6,6 +6,6 @@ Developer Documentation ======================= .. toctree:: - :maxdepth: 1 + :maxdepth: 8 - SasData \ No newline at end of file + SasData \ No newline at end of file