From 474d6fee33e7eae0033f9d0d4c5f0ba3d7423790 Mon Sep 17 00:00:00 2001 From: "Karl O. Pinc" Date: Tue, 9 May 2023 16:31:42 -0500 Subject: [PATCH] Better comments --- Makefile | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/Makefile b/Makefile index c79b928..b20d399 100644 --- a/Makefile +++ b/Makefile @@ -59,31 +59,35 @@ endif BUILDERNAME := dirhtml endif - +# # Variables +# +PREFIX := doc PDF_NAME := sokwedb_technical.pdf +EMACS_BK_CHR := ~ +# Website location in file system DOC_ROOT := /var/www/html PDF_PATH := $(DOC_ROOT)/$(PDF_NAME) HTML_PATH := $(DOC_ROOT)/doc -PREFIX := doc +# Locations where docs are built by sphinx SPHINX_PREFIX := $(PREFIX)/sphinx-doc SPHINX_BUILDDIR := $(SPHINX_PREFIX)/build SPHINX_BUILT_LATEX := $(SPHINX_BUILDDIR)/latex SPHINX_BUILT_HTML := $(SPHINX_BUILDDIR)/html +# Locations of source files, original m4 and generated STOCK_SRCDIR := $(PREFIX)/src HTML_STATIC_DIR := $(PREFIX)/_static HTML_SRCDIR := $(SPHINX_PREFIX)/$(HTML_SRCDIR) LATEX_SRCDIR := $(SPHINX_PREFIX)/latex_src +# Locations of m4 macros M4_INCLUDE_PATH := include M4_DOC_INCLUDE_PATH := doc/include M4_DB_INCLUDE_PATH := db/include -EMACS_BK_CHR := ~ - # The target sphinx builds for a pdf PDF_TARGET := $(PDF_NAME) @@ -98,10 +102,10 @@ DOC_DEPENDS := Makefile $(wildcard $(M4_INCLUDE_PATH)/*.m4) \ SPHINX_VENV := $(PREFIX)/sphinx-venv SPHINXBUILD := $(SPHINX_VENV)/bin/sphinx-build -n -c $(PREFIX) -M4_BASEDIR := $(STOCK_SRCDIR) - # Intermediate variables for filtering and transforming paths +M4_BASEDIR := $(STOCK_SRCDIR) +# The m4 files that produce rst files M4_FILES := $(call localize,$(call rwildcard,$(M4_BASEDIR)/,*.m4)) M4_FILES := $(filter-out %epilog.inc.m4, $(M4_FILES)) -- 2.34.1