nix flake, mostly things nix

1 files changed, 927 insertions, 0 deletions

diff --git a/org/config_make.org b/org/config_make.org
new file mode 100644
index 0000000..b603bfe
--- /dev/null
+++ b/org/config_make.org
@@ -0,0 +1,927 @@
+-*- mode: org -*-
+#+TITLE:       spine (doc_reform) (project) makefile
+#+DESCRIPTION: makefile for spine
+#+FILETAGS:    :spine:build:tools:
+#+AUTHOR:      Ralph Amissah
+#+EMAIL:       [[mailto:ralph.amissah@gmail.com][ralph.amissah@gmail.com]]
+#+COPYRIGHT:   Copyright (C) 2015 - 2022 Ralph Amissah
+#+LANGUAGE:    en
+#+STARTUP:     content hideblocks hidestars noindent entitiespretty
+#+PROPERTY:    header-args  :exports code
+#+PROPERTY:    header-args+ :noweb yes
+#+PROPERTY:    header-args+ :results no
+#+PROPERTY:    header-args+ :cache no
+#+PROPERTY:    header-args+ :padline no
+#+PROPERTY:    header-args+ :mkdirp yes
+
+- [[./doc-reform.org][doc-reform.org]]  [[../org/][org/]]
+
+#+HEADER: :tangle ../makefile
+#+HEADER: :noweb yes
+#+BEGIN_SRC makefile
+PROG_VER_GIT :=$(shell echo `git describe --long --tags | sed -e "s/^[ a-z_-]\+\([0-9.]\+\)/\1/;s/\([^-]*-g\)/r\1/;s/-/./g"`)
+#PROG_VER_DECLARED :=$(shell echo `cat ./views/version.txt | grep --color=never "enum" | sed 's/.\+(\([0-9]\+\),[ \t]\+\([0-9]\+\),[ \t]\+\([0-9]\+\)[ \t]*).\+/\1.\2.\3/g'`)
+DUB=dub
+DUB_FLAGS=-v --force --compiler=
+PRG_NAME=doc-reform
+PRG_NICKAME=spine
+PRG_NAME_DIR=$(shell echo `echo $(PRG_NAME) | sed -e "s/-/_/g"`)
+PRG_SRC=$(PRG_NAME).d
+PRG_SRCDIR=./src
+PRG_BIN=$(PRG_NAME)
+PRG_BINDIR=./bin
+PRG_DOCDIR=./docs
+EMACSLISP=/usr/share/emacs/site-lisp
+ORG_VER_AVAILABLE=$(shell echo `ls -d ~/.emacs.d/elpa/org-???????? | cut -d '-' -f2`)
+EMACSLISP_ORG=~/.emacs.d/elpa/org-$($(shell echo $(ORG_VER_AVAILABLE)))
+ORG_CONTRIB_VER_AVAILABLE=$(shell echo `ls -d ~/.emacs.d/elpa/org-plus-contrib-???????? | cut -d '-' -f2`)
+EMACSLISP_ORG_CONTRIB=~/.emacs.d/elpa/org-plus-contrib-$($(shell echo $(ORG_CONTRIB_VER_AVAILABLE)))
+ORGFILELIST=$(shell echo `ls -1 org/*.org`)
+ORGFILES=""
+ORGDIR :=$(shell echo `pwd`)
+SiSU_MARKUP_SAMPLES_FIND_PODS= \
+find data/pod -maxdepth 2 -name pod.manifest | cut -f 1-3 -d / | sort
+
+SiSU_MARKUP_SAMPLES_PODS_FOUND= \
+$(SiSU_MARKUP_SAMPLES_FIND_PODS) | xargs
+
+# SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND = \
+# find data/sisudir/media/text -name *.ss[tm] | sort | xargs
+#
+Date                    := `date "+%Y%m%d"`
+SpineBIN                := "${SpineBIN}" # './result/bin'
+SpineOUT                := "${SpineOUT}" # '/srv/www/spine'
+SpinePOD                := "${SpinePOD}" # '~/grotto/repo/git.repo/projects/doc-reform/data/markup/spine-samples/markup/pod'
+SpineSearchActionLocal  := 'http://localhost/spine_search'
+SpineSearchActionRemote := 'https://sisudoc.org/spine_search'
+SpineCGIform            := 'spine_search'
+SpineSQLdb              := 'spine.search.db'
+hwd                     := `pwd`
+gwd                     := `pwd` + "/src/ext_depends"
+deps                    := "`ls -gx './src/ext_depends'`"
+dirs_loc                := "`ls -gx '.'`"
+#dirs                    := "`ls -gx ${gwd}`"
+
+commands:
+	rg --color=always -B1 "^[a-z]\w+:" makefile | less
+
+cmd:
+	rg --color=always -B1 "^[a-z]\w+:" makefile | page
+
+# tangle org files
+org-tangle:
+	cd ./org; \
+	org-tangle *.org; \
+	cd -
+
+# epub output
+out-epub:
+	${SpineBIN}/spine -v \
+	--epub --output=${SpineOUT} ${SpinePOD}/*
+
+# html output with local search links
+out-html:
+	${SpineBIN}/spine -v --generated-by \
+	--curate \
+	--html --html-link-search --html-link-curate --cgi-url-action="${SpineSearchActionLocal}" \
+	--output=${SpineOUT} ${SpinePOD}/*
+
+# latex output
+out-latex:
+	${SpineBIN}/spine -v \
+	--latex \
+	--output=${SpineOUT} ${SpinePOD}/*
+
+# odf output
+out-odf:
+	${SpineBIN}/spine -v \
+	--odf \
+	--output=${SpineOUT} ${SpinePOD}/*
+
+# sqlite output
+out-sqlite:
+	${SpineBIN}/spine -v \
+	--sqlite-update --sqlite-db-filename="${SpineSQLdb}" \
+	--output=${SpineOUT} ${SpinePOD}/*
+
+# generate markup sample output with local search links
+output-samples-local:
+	${SpineBIN}/spine -v \
+	--latex --latex-init \
+	--epub \
+	--html --html-link-search --html-link-pdf --html-link-curate --html-link-markup \
+	--cgi-sqlite-search-filename="${SpineCGIform}" --cgi-url-action="${SpineSearchActionLocal}" \
+	--curate \
+	--sqlite-update --sqlite-db-filename="${SpineSQLdb}" \
+	--output=${SpineOUT} ${SpinePOD}/*
+
+# generate markup sample output with remote search links
+output-samples-remote:
+	${SpineBIN}/spine -v \
+	--generated-by \
+	--latex --latex-init \
+	--epub \
+	--html --html-link-search --html-link-pdf --html-link-curate \
+	--cgi-sqlite-search-filename="${SpineCGIform}" --cgi-url-action="${SpineSearchActionRemote}" \
+	--curate \
+	--sqlite-update --sqlite-db-filename="${SpineSQLdb}" \
+	--output=${SpineOUT} ${SpinePOD}/*
+
+# generate markup sample output with local search links
+output-samples: output-samples-local
+
+# nix build (remote) run
+generate-output-remote: nix-build output-samples-remote
+
+# nix build (local) run
+generate-output-local: nix-build output-samples-local
+
+# preview org files vim
+files-vim:
+	fd --max-depth 6 --type file -g "*" | sort \
+	| fzf \
+	  --preview='bat --color "always" {}' \
+	  --preview-window=right:66% \
+	  --bind="enter:execute(nvim {})"; \
+
+# preview org files emacs
+files-emacs:
+	fd --max-depth 6 --type file -g "*" | sort \
+	| fzf \
+	  --preview='bat --color "always" {}' \
+	  --preview-window=right:66% \
+	  --bind="enter:execute(emacsclient -nw -a -f {})"; \
+
+# preview org files vim
+org-vim:
+	cd ./org; \
+	fd --max-depth 5 --type file -g "*.org" | sort \
+	| fzf \
+	  --preview='bat --color "always" {}' \
+	  --preview-window=right:66% \
+	  --bind="enter:execute(nvim {})"; \
+	cd -
+
+# preview org files emacs
+org-emacs:
+	cd ./org; \
+	fd --max-depth 5 --type file -g "*.org" | sort \
+	| fzf \
+	  --preview='bat --color "always" {}' \
+	  --preview-window=right:66% \
+	  --bind="enter:execute(emacsclient -nw -a -f {})"; \
+	cd -
+
+## search org files (view in vim)
+#org-v find:
+#	cd ./org; \
+#	rg --files-with-matches --no-messages "${find}" | \
+#	fzf --multi --ansi --print0 \
+#	  --preview-window=right:66% \
+#	  --preview="rg --pretty --after-context 3 --before-context 2 -- \"${find}\" {}" \
+#	  --bind="enter:execute(nvim -c \"silent! /${find}\" {1})"; \
+#	cd -
+#
+## search org files (view in emacsclient)
+#org-e find:
+#	cd ./org; \
+#	rg --files-with-matches --no-messages "${find}" | \
+#	fzf --multi --ansi --print0 \
+#	  --preview-window=right:66% \
+#	  --preview="rg --pretty --after-context 3 --before-context 2 -- \"${find}\" {}" \
+#	  --bind="enter:execute(emacsclient -nw -a -f {})"; \
+#	cd -
+#
+## search tips.org files (view in emacs)
+#org-E find:
+#	cd ./org; \
+#	rg --files-with-matches --no-messages "${find}" | \
+#	fzf --multi --ansi --print0 \
+#	  --preview-window=right:66% \
+#	  --preview="rg --pretty --after-context 3 --before-context 2 -- \"${find}\" {}" \
+#	  --bind="enter:execute(emacs {} &)"; \
+#	cd -
+#
+## search for in directory specified (view in vim, uses rg & fzf) ["find" for emacs]
+#sDir-v find dir:
+#	cd ${dir}; \
+#	rg --files-with-matches --no-messages "${find}" | \
+#	fzf --multi --ansi --print0 \
+#	  --preview-window=right:66% \
+#	  --preview="rg --pretty --after-context 3 --before-context 2 -- \"${find}\" {}" \
+#	  --bind="enter:execute(nvim -c \"silent! /${find}\" {1})"; \
+#	cd -
+#
+## search for in directory specified (view in emacs, uses rg & fzf) ["search" for emacs]
+#sDir-e find dir:
+#	cd ${dir}; \
+#	rg --files-with-matches --no-messages "${find}" | \
+#	fzf --multi --ansi --print0 \
+#	  --preview-window=right:66% \
+#	  --preview="rg --pretty --after-context 3 --before-context 2 -- \"${find}\" {}" \
+#	  --bind="enter:execute(emacsclient -nw -a -f {})"; \
+#	cd -
+#
+## search for in directory specified (view in emacs, uses rg & fzf) ["search" for emacs]
+#sDir-E find dir:
+#	cd ${dir}; \
+#	rg --files-with-matches --no-messages "${find}" | \
+#	fzf --multi --ansi --print0 \
+#	  --preview-window=right:66% \
+#	  --preview="rg --pretty --after-context 3 --before-context 2 -- \"${find}\" {}" \
+#	  --bind="enter:execute(emacs {} &)"; \
+#	cd -
+
+# show markup pod source selections
+markup:
+	ls -1 --color=always ${SpinePOD}
+	ls -1 -d --color=always ${SpinePOD}/*/
+
+# show markup pod source tree
+markup-pod-tree:
+	exa -alT --git -I'.git|.dub|*_' --color=always -L5 ${SpinePOD} | less -R
+
+# show markup pod source tree
+tree-src-search-cgi:
+	  exa -alT --git -I'*_' --color=always -L5 ${SpineSearchCGI}/src ${SpineSearchCGI}/views | less -R
+
+# show markup files
+markup-files:
+	cd ${SpinePOD}; \
+	find . -type f -iname "*sst"; \
+	cd -; \
+	echo ${SpinePOD}
+# find ${SpinePOD}/. -type f -iname "*sst"
+
+# preview markup files vim
+markup-files-vim:
+	cd ${SpinePOD}; \
+	fd --max-depth 5 --type file -g "*.ss?" | sort \
+	| fzf \
+	  --preview='bat --color "always" {}' \
+	  --preview-window=right:66% \
+	  --bind="enter:execute(nvim {})"; \
+	cd -
+
+# preview markup files emacs
+markup-files-emacs:
+	cd ${SpinePOD}; \
+	fd --max-depth 5 --type file -g "*.ss?" | sort \
+	| fzf \
+	  --preview='bat --color "always" {}' \
+	  --preview-window=right:66% \
+	  --bind="enter:execute(emacsclient -nw -a -f {})"; \
+	cd -
+
+# markup samples list
+markup-sample: markup-pod-sample
+
+# markup samples list
+markup-pod-sample:
+	find data/pod -name pod.manifest | cut -f 1-3 -d / | sort
+
+# markup samples pod manifests and sst files
+markup-samples: markup-pod-samples markup-file-samples
+
+# markup samples pod manifests
+markup-pod-samples:
+	echo "${SpinePOD}"; \
+	find ${SpinePOD} -name pod.manifest | sort
+
+#find ${SpinePOD} -name pod.manifest | sed -E 's:.+?(([/][^/]+){2})$:\1:'
+
+# markup samples sst files
+markup-file-samples:
+	echo "${SpinePOD}"; \
+	find ${SpinePOD} -name *.ss[tm] | sort
+
+# markup_dir_samples:
+#   find data/sisudir/media/text -name *.ss[tm] | sort
+
+# version_tag:
+#   echo "DRV=0.11.3; git tag -f doc-reform_v$$\{DRV} -m\"doc-reform $$\{DRV}\" HEAD" && \
+#   echo "git tag -f doc-reform_v0.11.3 -m\"doc-reform spine-0.11.3\" HEAD"
+
+# archive spine output (www)
+spineWWWarchive:
+	cd /srv/www ; \
+	rm spine_output.${Date}.tar.bz2 ; \
+	sudo tar --exclude='./spine/latex' --exclude='./spine/pod' --exclude='./spine/*_' -cjf spine_output.${Date}.tar.bz2 ./spine ; \
+	cd -
+
+# rsync archived spine output to Linode
+spineWWWrsyncLinode:
+	rsync -v /srv/www/spine_output.${Date}.tar.bz2 linode:./stage/. ; \
+	rsync -v /var/www/sqlite/spine.search.db linode:./stage/. ; \
+	echo "tar -xf ../spine_output.${Date}.tar.bz2"
+
+# get project external dependencies
+depends_get:
+	dub upgrade; \
+	cd ${gwd} && \
+	echo "${dirs_loc}" && \
+	for dir in ${dirs_loc}; do \
+	  if [[ -d ${dir} ]]; then \
+	    echo ${gwd}/${dir} && \
+	    if [[ "imageformats" == ${dir} ]]; then \
+	      echo ${gwd}/${dir} && \
+	      rm -rvf ${gwd}/${dir} && \
+	      git clone --depth=1 https://github.com/tjhann/${dir} && \
+	      cd ${dir} && \
+	      echo $$PWD && \
+	      echo "${dir} `git rev-parse HEAD | cut -c 1-8`"   > ../${dir}.meta && \
+	      echo "https://github.com/tjhann/${dir}"           >> ../${dir}.meta && \
+	      echo "Boost Software License 1.0 (BSL-1.0)"       >> ../${dir}.meta && \
+	      cd ${gwd} && \
+	      rm -rf ${gwd}/${dir}/.git; \
+	    elif [[ "d2sqlite3" == ${dir}  || "D-YAML" == ${dir} || "tinyendian" == ${dir} ]]; then \
+	      echo ${gwd}/${dir} && \
+	      rm -rvf ${gwd}/${dir} && \
+	      git clone --depth=1 https://github.com/dlang-community/${dir} && \
+	      cd ${gwd}/${dir} && \
+	      echo "${dir} `git rev-parse HEAD | cut -c 1-8`"   > ../${dir}.meta && \
+	      echo "https://github.com/dlang-community/${dir}"  >> ../${dir}.meta && \
+	      echo "Boost Software License 1.0 (BSL-1.0)"       >> ../${dir}.meta && \
+	      cd ${gwd} && \
+	      rm -rf ${gwd}/${dir}/.git; \
+	    fi; \
+	  fi; \
+	done; \
+	cd ${hwd}
+
+# get and set project external dependencies
+depends_set: depends_get
+	dub describe | sed 's~$(shell echo `pwd | sed 's_/_\\/_g'`)~.~g'  > dub_describe.json
+
+# markup_samples:
+# 	find data/pod -name pod.manifest | cut -f 1-3 -d / | sort; \
+# 	find data/sisudir/media/text -name *.ss[tm] | sort
+#
+# markup_pod_samples:
+# 	find data/pod -name pod.manifest | cut -f 1-3 -d / | sort
+#
+# markup_dir_samples:
+# 	find data/sisudir/media/text -name *.ss[tm] | sort
+#
+version_tag:
+	echo "DRV=0.11.3; git tag -f doc-reform_v$$\{DRV} -m\"doc-reform $$\{DRV}\" HEAD" && \
+	echo "git tag -f doc-reform_v0.11.3 -m\"doc-reform spine-0.11.3\" HEAD"
+
+changelog_:
+	git log --pretty=format:'---%+s %+as %ae%+h%d%+b' --no-merges | sed "/^\\s*$$/d" | sed "s/^---$$//" | sed "s/^\(\*\)\+/-/" | sed "s/ \+$$//" > CHANGELOG_
+
+# git changelog for project
+changelog:
+	git log --pretty=format:'---%+s %+as %ae%+h%d%+b' --no-merges | sed "/^\\s*$$/d" | sed "s/^---$$//" | sed "s/^\(\*\)\+/-/" | sed "s/ \+$$//" | sed "s/ \+$//" > CHANGELOG_
+
+#gitZip:
+#	git archive -v --format=tar --prefix=`echo spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT)`/ HEAD | gzip > ./tarballGitHEAD/spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT).tar.gz && \
+#	echo "to unzip: tar -xzf spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT).tar.gz"
+#
+## git archive project, produce current state .tar.gz
+#gitArchive:
+#	git archive -v --format=tar --prefix=spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT)/ HEAD | gzip > ./tarballGitHEAD/spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT).tar.gz && \
+#	echo "to unzip: tar -xzf spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT).tar.gz"
+#
+## git archive project, produce current state .tar.gz
+## gitArchive:
+## 	git archive -v --format=tar --prefix="spine-${PROG_VER_DECLARED}-tag-${PROG_VER_GIT}/" HEAD | gzip > ./tarballGitHEAD/spine-${PROG_VER_DECLARED}-tag-${PROG_VER_GIT}.tar.gz && \
+## 	echo "to unzip: tar -xzf spine-${PROG_VER_DECLARED}-tag-${PROG_VER_GIT}.tar.gz"
+
+# remove test tarball dir
+nixGitHEADtarballClean:
+	if [ -d "./tarballGitHEAD" ]; then \
+	  rm -rv ./tarballGitHEAD; \
+	fi;
+
+## create test tarball
+#nixGitHEADtarballTar:
+#	if [ ! -d "./tarballGitHEAD" ]; then \
+#	  mkdir ./tarballGitHEAD; \
+#	fi; \
+#	git archive -v --format=tar --prefix="spine-${PROG_VER_DECLARED}/" HEAD | \
+#	gzip > ./tarballGitHEAD/spine-${PROG_VER_DECLARED}-tag-${PROG_VER_GIT}.tar.gz && \
+#	cp -v ./tarballGitHEAD/spine-${PROG_VER_DECLARED}-tag-${PROG_VER_GIT}.tar.gz ./tarballGitHEAD/spine-${PROG_VER_DECLARED}.tar.gz && \
+#	echo "to unzip: tar -xzf spine-${PROG_VER_DECLARED}-tag-${PROG_VER_GIT}.tar.gz"; \
+#	echo "to unzip: tar -xzf spine-${PROG_VER_DECLARED}.tar.gz"
+#
+## check test tarball
+#nixGitHEADtarballCheck:
+#	nix flake check file://${hwd}/tarballGitHEAD/spine-${PROG_VER_DECLARED}.tar.gz; \
+#	nix flake lock file://${hwd}/tarballGitHEAD/spine-${PROG_VER_DECLARED}.tar.gz; \
+#	nix flake show file://${hwd}/tarballGitHEAD/spine-${PROG_VER_DECLARED}.tar.gz;
+
+## build test tarball
+#nixGitHEADtarballBuild:
+#	echo "nix build file://${hwd}/tarballGitHEAD/spine-${PROG_VER_DECLARED}.tar.gz#spine --print-build-logs"
+#	nix build file://${hwd}/tarballGitHEAD/spine-${PROG_VER_DECLARED}.tar.gz#spine --print-build-logs
+#	#nix build "./tarballGitHEAD/spine-${PROG_VER_DECLARED}.tar.gz#spine" --print-build-logs
+
+# clean create check & build test tarball
+nixGitHEADtarball: nixGitHEADtarballClean nixGitHEADtarballTar nixGitHEADtarballCheck nixGitHEADtarballBuild
+
+get_depends:
+	hwd=$$(echo `pwd`) && \
+	gwd="${hwd}/src/ext_depends" && \
+	dirs=$$(echo `ls -gx ${gwd}`) && \
+	license_bsl="Boost Software License 1.0 (BSL-1.0)" && \
+	echo ${hwd} && \
+	echo ${gwd} && \
+	echo ${deps} && \
+	dub upgrade; \
+	cd ${gwd} && \
+	for dir in ${deps}; do \
+	  if [ -d ${dir} ]; then \
+	    echo ${dir} && \
+	    if [ "imageformats" == ${dir} ]; then \
+	      echo ${dir} && \
+	      rm -rf ${dir} && \
+	      git clone --depth=1 https://github.com/tjhann/${dir} && \
+	      cd ${dir} && \
+	      echo $$PWD && \
+	      echo "${dir} `git rev-parse HEAD | cut -c 1-8`"   > ../${dir}.meta && \
+	      echo "https://github.com/tjhann/${dir}"          >> ../${dir}.meta && \
+	      echo "${license_bsl}"                            >> ../${dir}.meta && \
+	      cd ${gwd} && \
+	      rm -rf ${dir}/.git; \
+	    elif [[ "d2sqlite3" == ${dir}  || "D-YAML" == ${dir} || "tinyendian" == ${dir} ]]; then \
+	      echo ${dir} && \
+	      rm -rf ${dir} && \
+	      git clone --depth=1 https://github.com/dlang-community/${dir} && \
+	      cd ${dir} && \
+	      echo "${dir} `git rev-parse HEAD | cut -c 1-8`"   > ../${dir}.meta && \
+	      echo "https://github.com/dlang-community/${dir}" >> ../${dir}.meta && \
+	      echo "${license_bsl}"                            >> ../${dir}.meta && \
+	      cd ${gwd} && \
+	      rm -rf ${dir}/.git; \
+	    fi; \
+	  fi; \
+	done; \
+	cd ${hwd}
+
+set_depends: get_depends
+	dub describe | sed 's~$(shell echo `pwd | sed 's_/_\\/_g'`)~.~g'  > dub_describe.json
+
+rm_flakelock:
+	git reset HEAD flake.lock && \
+	touch flake.lock \
+	git rm -f flake.lock
+
+flake_update:
+	git add .; \
+	nix flake lock && \
+	git reset HEAD flake.lock; \
+	cp flake.lock flake.lock_
+
+flake_update_move_lock: flake_update
+	touch flake.lock \
+	git rm -f flake.lock
+
+set_latest: set_depends flake_update rm_flakelock
+
+dub_upgrade:
+	$(DUB) upgrade
+
+default: ldc
+
+all: dmd ldc gdc
+
+all_ver: dmd_ver ldc_ver gdc_ver
+
+all_debug: dmd_debug gdc_debug ldc_debug
+
+meson_clean_build_dir:
+	rm -r build; mkdir build
+
+meson_build: meson_clean_build_dir
+	meson --buildtype=debugoptimized build
+	ninja -C build
+	notify-send -t 0 'D meson build ldc compiled test release executable ready' 'spine'
+
+meson_redo: meson_clean_build_dir meson_build
+
+meson_project_build_clean: clean skel tangle dub_upgrade meson_build
+
+meson: meson_clean_build_dir dub_upgrade meson_build
+
+all_clean: clean tangle dmd ldc gdc
+
+all_ver_clean: clean tangle dmd_ver ldc_ver gdc_ver
+
+all_debug_ver: dmd_debug_ver gdc_debug_ver ldc_debug_ver
+
+all_debug_clean_ver: clean tangle dmd_debug_ver gdc_debug_ver ldc_debug_ver
+
+dmd: dub_upgrade
+	$(DUB) --compiler=dmd --config=dmd --build=release-nobounds
+	notify-send -t 0 'D dmd compiled test release executable ready' 'spine-dmd'
+
+dmd_debug:
+	$(DUB) --compiler=dmd --config=dmd --build=debug
+
+## assumes git tags with program version
+#dmd_ver: dub_upgrade
+#	$(DUB) --compiler=dmd --config=dmd-version
+#	mv bin/spine-dmd-ver bin-archive/spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT)-dmd
+#	notify-send -t 0 'D dmd compiled test release executable ready' 'spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT)-dmd'
+
+dmd_clean_ver: clean tangle dmd_ver
+
+dmd_rel: expunge skel tangle
+	$(DUB) --compiler=dmd --config=spine-release
+
+dmd_rel_tangle: tangle
+	$(DUB) --compiler=dmd --config=spine-dmd
+
+dmd_rel_expunge_tangle: expunge skel tangle dmd_rel_tangle
+
+dmd_debug_tangle: tangle
+	$(DUB) --compiler=dmd --config=spine-dmd-debug
+
+gdc: dub_upgrade
+	$(DUB) --compiler=gdc --config=gdc
+	notify-send -t 0 'D gdc compiled test release executable ready' 'spine-gdc'
+
+gdc_debug:
+	$(DUB) --compiler=gdc --config=gdc --build=debug
+
+## assumes git tags with program version
+#gdc_ver: dub_upgrade
+#	$(DUB) --compiler=gdc --config=gdc-version
+#	mv bin/spine-gdc-ver bin-archive/spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT)-gdc
+#	notify-send -t 0 'D gdc compiled test release executable ready' 'spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT)-gdc'
+
+gdc_clean_ver: clean tangle gdc_ver
+
+gdc_rel: expunge skel tangle
+	$(DUB) --compiler=gdc --config=spine-release
+
+gdc_rel_tangle: tangle
+	$(DUB) --compiler=gdc --config=spine-gdc
+
+gdc_rel_expunge_tangle: expunge skel tangle gdc_rel_tangle
+
+gdc_debug_tangle: tangle
+	$(DUB) --compiler=gdc --config=spine-gdc-debug
+
+ldc: dub_upgrade
+	$(DUB) --compiler=ldc2 --config=ldc --build=release
+	notify-send -t 0 'D ldc compiled test release executable ready' 'spine-ldc'
+
+ldc_debug:
+	$(DUB) --compiler=ldc2 --config=ldc --build=debug
+
+# assumes git tags with program version
+ldc_ver: dub_upgrade
+	$(DUB) --compiler=ldc2 --config=ldc-version
+	mv bin/spine-ldc-ver bin-archive/spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT)-ldc
+	notify-send -t 0 'D ldc2 compiled test release executable ready' 'spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT)-ldc'
+
+ldc_clean_ver: clean tangle ldc_ver
+
+ldc_rel: expunge skel tangle
+	$(DUB) --compiler=ldc2 --config=spine-release
+
+ldc_rel_tangle: tangle
+	$(DUB) --compiler=ldc2 --config=spine-ldc
+
+ldc_rel_expunge_tangle: expunge skel tangle ldc_rel_tangle
+
+ldc_debug_tangle: tangle
+	$(DUB) --compiler=ldc2 --config=spine-ldc-debug
+
+reinit: clean skel tangle
+
+skel:
+	mkdir -p $(PRG_BINDIR); \
+	mkdir -p $(PRG_BINDIR)-archive; \
+	mkdir -p build; \
+	mkdir -p views; \
+	mkdir -p data; \
+	mkdir -p sundry/misc/util/d/cgi/search/cgi-bin/src; \
+	mkdir -p sundry/misc/util/d/tools/markup_conversion; \
+	mkdir -p sundry/misc/editor-syntax-etc/emacs; \
+	mkdir -p sundry/misc/editor-syntax-etc/vim/syntax; \
+	mkdir -p sundry/misc/editor-syntax-etc/vim/colors; \
+	mkdir -p sundry/misc/editor-syntax-etc/vim/ftplugin; \
+	mkdir -p sundry/misc/editor-syntax-etc/vim/rc; \
+	mkdir -p sundry/misc/editor-syntax-etc/vim/templates; \
+	mkdir -p $(PRG_SRCDIR)/$(PRG_NAME_DIR)/conf; \
+	mkdir -p $(PRG_SRCDIR)/$(PRG_NAME_DIR)/io_in; \
+	mkdir -p $(PRG_SRCDIR)/$(PRG_NAME_DIR)/io_out; \
+	mkdir -p $(PRG_SRCDIR)/$(PRG_NAME_DIR)/meta; \
+	mkdir -p $(PRG_SRCDIR)/$(PRG_NAME_DIR)/share; \
+	mkdir -p $(PRG_SRCDIR)/$(PRG_NAME_DIR); \
+	mkdir -p $(PRG_BINDIR);
+
+init: skel
+
+clean:
+	rm -rf build; \
+	rm -rf $(PRG_SRCDIR); \
+	rm -rf $(PRG_DOCDIR);
+
+clean_bin:
+	rm $(PRG_BINDIR)/*
+
+clean_src:
+	rm -rf $(PRG_SRCDIR);
+
+clean_docs:
+	rm -rf $(PRG_DOCDIR)
+
+expunge:
+	rm -f dub.selections.json; \
+	rm -rf build; \
+	rm -rf $(PRG_SRCDIR); \
+	rm -rf $(PRG_BINDIR); \
+	rm -rf $(PRG_DOCDIR);
+
+distclean: expunge
+
+distclean_and_init: expunge
+	mkdir -p views; \
+	mkdir -p sundry/misc/util/d/cgi/search/cgi-bin/src; \
+	mkdir -p sundry/misc/util/d/tools/markup_conversion; \
+	mkdir -p sundry/misc/editor-syntax-etc/emacs; \
+	mkdir -p sundry/misc/editor-syntax-etc/vim/syntax; \
+	mkdir -p sundry/misc/editor-syntax-etc/vim/colors; \
+	mkdir -p sundry/misc/editor-syntax-etc/vim/ftplugin; \
+	mkdir -p sundry/misc/editor-syntax-etc/vim/rc; \
+	mkdir -p sundry/misc/editor-syntax-etc/vim/templates; \
+	mkdir -p $(PRG_SRCDIR)/$(PRG_NAME_DIR); \
+	mkdir -p $(PRG_BINDIR);
+
+ver:
+	echo spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT)
+
+clean_tangle_build: clean tangle build
+
+tangle_build: tangle build
+
+build: $(PRG_SRCDIR)/$(PRG_SRC)
+	$(DC) $(DC_FLAGS) \
+	$(DC_FLAG_BINOF)$(PRG_BINDIR)/$(PRG_BIN) \
+	$(PRG_SRCDIR)/$(PRG_SRC)
+
+rebuild: $(PRG_SRCDIR)/$(PRG_SRC) $(PRG_BINDIR)/$(PRG_BIN).o clean build
+
+makefile_new:
+	make -k tangle_maker
+
+restart: clean tangle
+
+find_pods:
+	$(SiSU_MARKUP_SAMPLES_FIND_PODS)
+
+testrun_find:
+	./bin/spine-ldc -v --source --html --epub --sqlite-discrete \
+	--sqlite-create --sqlite-update \
+	--output-dir=tmp/program_output_pod \
+	data/pod/sisu-manual
+
+testrun_find_pod_source:
+	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
+	./bin/spine-ldc -v --source \
+	--output-dir=tmp/program_output_pod
+
+testrun_find_pod_pod:
+	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
+	./bin/spine-ldc -v --pod \
+	--output-dir=tmp/program_output_pod
+
+testrun_find_pod_html:
+	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
+	./bin/spine-ldc -v --html \
+	--output-dir=tmp/program_output_pod
+
+testrun_find_pod_epub:
+	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
+	./bin/spine-ldc -v --epub \
+	--output-dir=tmp/program_output_pod
+
+testrun_find_pod_all:
+	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
+	./bin/spine-ldc -v --source --html --epub --sqlite-discrete \
+	--sqlite-create --sqlite-update \
+	--output-dir=tmp/program_output_pod
+
+testrun_paths:
+	./bin/spine-ldc -v --source --html --epub --sqlite-discrete \
+	--sqlite-create --sqlite-update \
+	--output-dir=tmp/program_output_pod \
+	data/pod/sisu-manual
+
+testrun_paths_pod_source:
+	./bin/spine-ldc -v --source \
+	--output-dir=tmp/program_output_pod \
+	./markup/pod/*
+
+testrun_paths_pod_pod:
+	./bin/spine-ldc -v --pod \
+	--output-dir=tmp/program_output_pod \
+	./markup/pod/*
+
+testrun_paths_pod_html:
+	./bin/spine-ldc -v --html \
+	--output-dir=tmp/program_output_pod \
+	./markup/pod/*
+
+testrun_paths_pod_epub:
+	./bin/spine-ldc -v --epub \
+	--output-dir=tmp/program_output_pod \
+	./markup/pod/*
+
+testrun_paths_pod_all:
+	./bin/spine-ldc -v --source --html --epub --sqlite-discrete \
+	--sqlite-create --sqlite-update \
+	--output-dir=tmp/program_output_pod \
+	./markup/pod/*
+
+testrun_find_dir_source:
+	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
+	./bin/spine-ldc -v --source \
+	--output-dir=tmp/program_output_dir
+
+testrun_find_dir_pod:
+	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
+	./bin/spine-ldc -v --pod \
+	--output-dir=tmp/program_output_dir
+
+testrun_find_dir_html:
+	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
+	./bin/spine-ldc -v --html \
+	--output-dir=tmp/program_output_dir
+
+testrun_find_dir_epub:
+	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
+	./bin/spine-ldc -v --epub \
+	--output-dir=tmp/program_output_dir
+
+testrun_find_dir_all:
+	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
+	./bin/spine-ldc -v --source --html --epub --sqlite-discrete \
+	--sqlite-create --sqlite-update \
+	--output-dir=tmp/program_output_dir
+
+testrun_filelist_dir_source:
+	./bin/spine-ldc -v --source \
+	--output-dir=tmp/program_output_dir \
+	$(SiSU_MARKUP_SAMPLES_DIR)
+
+testrun_filelist_dir_pod:
+	./bin/spine-ldc -v --pod \
+	--output-dir=tmp/program_output_dir \
+	$(SiSU_MARKUP_SAMPLES_DIR)
+
+testrun_filelist_dir_html:
+	./bin/spine-ldc -v --html \
+	--output-dir=tmp/program_output_dir \
+	$(SiSU_MARKUP_SAMPLES_DIR)
+
+testrun_filelist_dir_epub:
+	./bin/spine-ldc -v --epub \
+	--output-dir=tmp/program_output_dir \
+	$(SiSU_MARKUP_SAMPLES_DIR)
+
+testrun_filelist_dir_all:
+	./bin/spine-ldc -v --source --html --epub --sqlite-discrete \
+	--sqlite-create --sqlite-update \
+	--output-dir=tmp/program_output_dir \
+	$(SiSU_MARKUP_SAMPLES_DIR)
+
+tangle: skel
+	for f in $(ORGFILELIST); do \
+		ORGFILES="$$ORGFILES \"$$f\""; \
+	done; \
+	emacs --batch -Q -q \
+	--eval "(progn \
+		(add-to-list 'load-path \
+			(expand-file-name \"$(EMACSLISP)\")) \
+		(add-to-list 'load-path \
+			(expand-file-name \"$(EMACSLISP_ORG)\" t)) \
+		(add-to-list 'load-path \
+			(expand-file-name \"$(EMACSLISP_ORG_CONTRIB)\" t)) \
+		(require 'org)(require 'ob)(require 'ob-tangle) \
+		(mapc (lambda (file) \
+			(find-file (expand-file-name file \"$(ORGDIR)\")) \
+				(setq-local org-src-preserve-indentation t) \
+			(org-babel-tangle) \
+			(kill-buffer)) '($$ORGFILES)))" 2>&1
+
+tangle_maker:
+	for f in $(ORGFILELIST); do \
+		ORGFILES="\"org/dr_build_scaffold.org\""; \
+	done; \
+	emacs --batch -Q -q \
+	--eval "(progn \
+		(add-to-list 'load-path \
+			(expand-file-name \"$(EMACSLISP)\")) \
+		(add-to-list 'load-path \
+			(expand-file-name \"$(EMACSLISP_ORG)\" t)) \
+		(add-to-list 'load-path \
+			(expand-file-name \"$(EMACSLISP_ORG_CONTRIB)\" t)) \
+		(require 'org)(require 'ob)(require 'ob-tangle) \
+		(mapc (lambda (file) \
+			(find-file (expand-file-name file \".\")) \
+				(setq-local org-src-preserve-indentation t) \
+			(org-babel-tangle) \
+			(kill-buffer)) '($$ORGFILES)))" 2>&1
+
+lorri_shell:
+	lorri shell
+
+# nix-shell
+nix-shell:
+	nix-shell -I .envrc
+
+nix-shell-pure:
+	nix-shell -I .envrc --pure
+
+# nix-shell (with local tools, presumably latest dlang compiler & build tools (ldc & dub))
+nix-shell-updated:
+	nix-shell -I nixpkgs=/nixpkgs-ra/nixpkgs --pure
+
+# shell.nix (with shebang)
+shell:
+	shell.nix
+
+# nix-build spine
+nix-build:
+	nix-build default.nix && ./result/bin/spine -v
+
+# nix-build spine (with local tools, presumably latest dlang compiler & build tools (ldc & dub))
+nix-build-use-tools-new:
+	nix-build -I .envrc
+
+# tangle-build
+tangle-build: org-tangle nix-build
+
+# build-run
+build-run: nix-build output-samples
+
+# tangle-build-run
+tangle-build-run: org-tangle nix-build output-samples
+
+# nix-build spine search
+nix-build-search:
+	cd ./sundry/spine_search_cgi; \
+	nix-build \
+	cd -
+
+_flake-lock-reset:
+	git reset HEAD flake.lock
+
+_flake-show-name:
+	nix search --json 2>/dev/null |jq;
+
+_flake-show-package:
+	nix flake show;
+
+_flake-show-derivation:
+	nix show-derivation |jq;
+
+nix-develop:
+	nix develop -f default.nix -I nixpkgs=/nixpkgs-ra/nixpkgs
+
+# nix flake show
+flake-show: _flake-show-package _flake-show-name _flake-show-derivation
+
+# nix-build flake spine
+flake-build: _flake-show-name
+	nix build --print-build-logs
+
+# nix-build flake spine
+flake-reset-build: _flake-lock-reset _flake-show-name
+	nix build --print-build-logs
+
+# nix-build flake spine debug
+flake-build-debug:
+	nix build --debug
+
+# nix-build spine (with local tools, presumably latest dlang compiler & build tools (ldc & dub))
+flake-build-use-tools-new:
+	nix build --print-build-logs -I nixpkgs=/nixpkgs-ra/nixpkgs
+
+# tangle-build-flake
+flake-tangle-build: org-tangle flake-build
+
+# build-flake-run
+flake-build-run: flake-build output-samples
+
+# tangle-build-run
+flake-tangle-build-run: org-tangle flake-build output-samples
+
+# nix-build spine search
+flake-build-search:
+	cd ./sundry/spine_search_cgi; \
+	nix build --print-build-logs \
+	cd -
+
+gitsnapshot: distclean tangle
+	git commit -a
+
+.PHONY : all build rebuild debug release \
+	distclean init \
+	tangle gitsnapshot
+#+END_SRC