housekeeping

39 files changed, 323 insertions, 699 deletions

diff --git a/derivation.nix b/derivation.nix
index 83b66ea..2594859 100644
--- a/derivation.nix
+++ b/derivation.nix
@@ -101,6 +101,6 @@ mkDubDerivation rec {
     description = "a sisu like document parser";
     license     = licenses.agpl3Plus;
     platforms   = platforms.linux;
-    maintainers = [ RalphAmissah ];
+    maintainers = [ "RalphAmissah" ];
   };
 }
diff --git a/makefile b/makefile
deleted file mode 100644
index b0d5c8d..0000000
--- a/makefile
+++ /dev/null
@@ -1,617 +0,0 @@
-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_POD = \
-data/pod/accelerando.charles_stross \
-data/pod/alices_adventures_in_wonderland.lewis_carroll \
-data/pod/content.cory_doctorow \
-data/pod/democratizing_innovation.eric_von_hippel \
-data/pod/down_and_out_in_the_magic_kingdom.cory_doctorow \
-data/pod/for_the_win.cory_doctorow \
-data/pod/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman \
-data/pod/free_culture.lawrence_lessig \
-data/pod/free_for_all.peter_wayner \
-data/pod/gpl2.fsf \
-data/pod/gpl3.fsf \
-data/pod/gullivers_travels.jonathan_swift \
-data/pod/little_brother.cory_doctorow \
-data/pod/live-manual \
-data/pod/sisu-manual \
-data/pod/the_autonomous_contract.ralph_amissah \
-data/pod/the_cathedral_and_the_bazaar.eric_s_raymond \
-data/pod/the_public_domain.james_boyle \
-data/pod/the_wealth_of_networks.yochai_benkler \
-data/pod/through_the_looking_glass.lewis_carroll \
-data/pod/two_bits.christopher_kelty \
-data/pod/un_contracts_international_sale_of_goods_convention_1980 \
-data/pod/viral_spiral.david_bollier
-SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND = \
-find data/sisudir/media/text -name *.ss[tm] | sort | xargs
-
-SiSU_MARKUP_SAMPLES_DIR = \
-data/sisudir/media/text/accelerando.charles_stross.sst \
-data/sisudir/media/text/alices_adventures_in_wonderland.lewis_carroll.sst \
-data/sisudir/media/text/content.cory_doctorow.sst \
-data/sisudir/media/text/democratizing_innovation.eric_von_hippel.sst \
-data/sisudir/media/text/down_and_out_in_the_magic_kingdom.cory_doctorow.sst \
-data/sisudir/media/text/ffa_tmp.sst \
-data/sisudir/media/text/for_the_win.cory_doctorow.sst \
-data/sisudir/media/text/free_as_in_freedom_2.richard_stallman_and_the_free_software_revolution.sam_williams.richard_stallman.sst \
-data/sisudir/media/text/free_culture.lawrence_lessig.sst \
-data/sisudir/media/text/free_for_all.peter_wayner.sst \
-data/sisudir/media/text/gpl2.fsf.sst \
-data/sisudir/media/text/gpl3.fsf.sst \
-data/sisudir/media/text/gullivers_travels.jonathan_swift.sst \
-data/sisudir/media/text/little_brother.cory_doctorow.sst \
-data/sisudir/media/text/sisu_markup.sst \
-data/sisudir/media/text/sisu_markup_stress_test.sst \
-data/sisudir/media/text/sisu_markup_test.sst \
-data/sisudir/media/text/table_special_markup.sst \
-data/sisudir/media/text/the_autonomous_contract.ralph_amissah.sst \
-data/sisudir/media/text/the_cathedral_and_the_bazaar.eric_s_raymond.sst \
-data/sisudir/media/text/the_public_domain.james_boyle.sst \
-data/sisudir/media/text/the_wealth_of_networks.yochai_benkler.sst \
-data/sisudir/media/text/through_the_looking_glass.lewis_carroll.sst \
-data/sisudir/media/text/two_bits.christopher_kelty.sst \
-data/sisudir/media/text/un_contracts_international_sale_of_goods_convention_1980.sst \
-data/sisudir/media/text/viral_spiral.david_bollier.sst
-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_
-gitZip:
-	git archive -v --format=tar --prefix=`echo spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT)`/ HEAD | gzip > ../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"
-gitArchive:
-	git archive -v --format=tar --prefix=spine-$(PROG_VER_DECLARED)-tag-$(PROG_VER_GIT)/ HEAD | gzip > ../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"
-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 $${dirs} && \
-	dub upgrade; \
-	cd $${gwd} && \
-	for dir in $${dirs}; 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 update && \
-	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
-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
-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
-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)
-dmd_testrun_find:
-	./bin/spine-dmd -v --source --html --epub --sqlite-discrete \
---sqlite-create --sqlite-update \
---output-dir=tmp/program_output_pod \
-data/pod/sisu-manual
-dmd_testrun_find_pod_source:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-./bin/spine-ldc -v --source --html --epub \
---output-dir=tmp/program_output_pod
-dmd_testrun_find_pod_pod:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-./bin/spine-dmd -v --pod \
---output-dir=tmp/program_output_pod
-dmd_testrun_find_pod_html:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-./bin/spine-dmd -v --html \
---output-dir=tmp/program_output_pod
-dmd_testrun_find_pod_epub:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-./bin/spine-dmd -v --epub \
---output-dir=tmp/program_output_pod
-dmd_testrun_find_pod_all:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-./bin/spine-dmd -v --source --html --epub --sqlite-discrete \
---sqlite-create --sqlite-update \
---output-dir=tmp/program_output_pod
-dmd_testrun_paths_pod_source:
-	./bin/spine-dmd -v --source \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-dmd_testrun_paths_pod_pod:
-	./bin/spine-dmd -v --pod \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-dmd_testrun_paths_pod_html:
-	./bin/spine-dmd -v --html \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-dmd_testrun_paths_pod_epub:
-	./bin/spine-dmd -v --epub \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-dmd_testrun_paths_pod_all:
-	./bin/spine-dmd -v --source --html --epub --sqlite-discrete \
---sqlite-create --sqlite-update \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-gdc_testrun_find:
-	./bin/spine-gdc -v --source --html --epub --sqlite-discrete \
---sqlite-create --sqlite-update \
---output-dir=tmp/program_output_pod \
-data/pod/sisu-manual
-gdc_testrun_find_pod_source:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-./bin/spine-gdc -v --source \
---output-dir=tmp/program_output_pod
-gdc_testrun_find_pod_pod:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-./bin/spine-gdc -v --pod \
---output-dir=tmp/program_output_pod
-gdc_testrun_find_pod_html:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-./bin/spine-gdc -v --html \
---output-dir=tmp/program_output_pod
-gdc_testrun_find_pod_epub:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-./bin/spine-gdc -v --epub \
---output-dir=tmp/program_output_pod
-gdc_testrun_find_pod_all:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-./bin/spine-gdc -v --source --html --epub --sqlite-discrete \
---sqlite-create --sqlite-update \
---output-dir=tmp/program_output_pod
-gdc_testrun_paths:
-	./bin/spine-gdc -v --source --html --epub --sqlite-discrete \
---sqlite-create --sqlite-update \
---output-dir=tmp/program_output_pod \
-data/pod/sisu-manual
-gdc_testrun_paths_pod_source:
-	./bin/spine-gdc -v --source \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-gdc_testrun_paths_pod_pod:
-	./bin/spine-gdc -v --pod \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-gdc_testrun_paths_pod_html:
-	./bin/spine-gdc -v --html \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-gdc_testrun_paths_pod_epub:
-	./bin/spine-gdc -v --epub \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-gdc_testrun_paths_pod_all:
-	./bin/spine-gdc -v --source --html --epub --sqlite-discrete \
---sqlite-create --sqlite-update \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-ldc_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
-ldc_testrun_find_pod_source:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-	./bin/spine-ldc -v --source \
---output-dir=tmp/program_output_pod
-ldc_testrun_find_pod_pod:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-	./bin/spine-ldc -v --pod \
---output-dir=tmp/program_output_pod
-ldc_testrun_find_pod_html:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-	./bin/spine-ldc -v --html \
---output-dir=tmp/program_output_pod
-ldc_testrun_find_pod_epub:
-	$(SiSU_MARKUP_SAMPLES_PODS_FOUND) \
-	./bin/spine-ldc -v --epub \
---output-dir=tmp/program_output_pod
-ldc_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
-ldc_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
-ldc_testrun_paths_pod_source:
-	./bin/spine-ldc -v --source \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-ldc_testrun_paths_pod_pod:
-	./bin/spine-ldc -v --pod \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-ldc_testrun_paths_pod_html:
-	./bin/spine-ldc -v --html \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-ldc_testrun_paths_pod_epub:
-	./bin/spine-ldc -v --epub \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-ldc_testrun_paths_pod_all:
-	./bin/spine-ldc -v --source --html --epub --sqlite-discrete \
---sqlite-create --sqlite-update \
---output-dir=tmp/program_output_pod \
-$(SiSU_MARKUP_SAMPLES_POD)
-dmd_testrun_find_dir_source:
-	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
-./bin/spine-dmd -v --source \
---output-dir=tmp/program_output_dir
-dmd_testrun_find_dir_pod:
-	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
-./bin/spine-dmd -v --pod \
---output-dir=tmp/program_output_dir
-dmd_testrun_find_dir_html:
-	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
-./bin/spine-dmd -v --html \
---output-dir=tmp/program_output_dir
-dmd_testrun_find_dir_epub:
-	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
-./bin/spine-dmd -v --epub \
---output-dir=tmp/program_output_dir
-dmd_testrun_find_dir_all:
-	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
-./bin/spine-dmd -v --source --html --epub --sqlite-discrete \
---sqlite-create --sqlite-update \
---output-dir=tmp/program_output_dir
-dmd_testrun_filelist_dir_source:
-	./bin/spine-dmd -v --source \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-dmd_testrun_filelist_dir_pod:
-	./bin/spine-dmd -v --pod \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-dmd_testrun_filelist_dir_html:
-	./bin/spine-dmd -v --html \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-dmd_testrun_filelist_dir_epub:
-	./bin/spine-dmd -v --epub \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-dmd_testrun_filelist_dir_all:
-	./bin/spine-dmd -v --source --html --epub --sqlite-discrete \
---sqlite-create --sqlite-update \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-gdc_testrun_find_dir_source:
-	./bin/spine-gdc -v --source \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-gdc_testrun_find_dir_pod:
-	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
-./bin/spine-gdc -v --pod \
---output-dir=tmp/program_output_dir
-gdc_testrun_find_dir_html:
-	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
-./bin/spine-gdc -v --html \
---output-dir=tmp/program_output_dir
-gdc_testrun_find_dir_epub:
-	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
-./bin/spine-gdc -v --epub \
---output-dir=tmp/program_output_dir
-gdc_testrun_find_dir_all:
-	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
-./bin/spine-gdc -v --source --html --epub --sqlite-discrete \
---sqlite-create --sqlite-update \
---output-dir=tmp/program_output_dir
-gdc_testrun_filelist_dir_source:
-	./bin/spine-gdc -v --source \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-gdc_testrun_filelist_dir_pod:
-	./bin/spine-gdc -v --pod \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-gdc_testrun_filelist_dir_html:
-	./bin/spine-gdc -v --html \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-gdc_testrun_filelist_dir_epub:
-	./bin/spine-gdc -v --epub \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-gdc_testrun_filelist_dir_all:
-	./bin/spine-gdc -v --source --html --epub --sqlite-discrete \
---sqlite-create --sqlite-update \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-ldc_testrun_find_dir_source:
-	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
-./bin/spine-ldc -v --source \
---output-dir=tmp/program_output_dir
-ldc_testrun_find_dir_pod:
-	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
-./bin/spine-ldc -v --pod \
---output-dir=tmp/program_output_dir
-ldc_testrun_find_dir_html:
-	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
-./bin/spine-ldc -v --html \
---output-dir=tmp/program_output_dir
-ldc_testrun_find_dir_epub:
-	$(SiSU_MARKUP_SAMPLES_DIR_FILES_FOUND) \
-./bin/spine-ldc -v --epub \
---output-dir=tmp/program_output_dir
-ldc_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
-ldc_testrun_filelist_dir_source:
-	./bin/spine-ldc -v --source \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-ldc_testrun_filelist_dir_pod:
-	./bin/spine-ldc -v --pod \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-ldc_testrun_filelist_dir_html:
-	./bin/spine-ldc -v --html \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-ldc_testrun_filelist_dir_epub:
-	./bin/spine-ldc -v --epub \
---output-dir=tmp/program_output_dir \
-$(SiSU_MARKUP_SAMPLES_DIR)
-ldc_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_build_default:
-	nix build -f default.nix && ./result/bin/spine -v
-nix_build_project:
-	nix build -f project.nix && ./result/bin/spine -v
-nix_build_spine:
-	nix build -f spine.nix && ./result/bin/spine -v
-nix-build_default:
-	nix-build default.nix
-gitsnapshot: distclean tangle
-	git commit -a
-.PHONY : all build rebuild debug release \
-	distclean init \
-	tangle gitsnapshot
diff --git a/org/cgi_spine_search.org b/org/cgi_spine_search.org
index b3b2880..6bcc9f3 100644
--- a/org/cgi_spine_search.org
+++ b/org/cgi_spine_search.org
@@ -16,8 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-[[./spine_info.org][spine_info.org]]  [[./][org/]]
-[[./spine_build_scaffold.org][make/build]] VERSION
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+- [[./spine_build_scaffold.org][make/build]] VERSION
 
 #+NAME: year
 #+BEGIN_SRC text
diff --git a/org/compile_time_info.org b/org/compile_time_info.org
index 6635349..bd8f9df 100644
--- a/org/compile_time_info.org
+++ b/org/compile_time_info.org
@@ -16,10 +16,12 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-[[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * compilation info
-[[./spine_build_scaffold.org][make/build]]
-[[./spine.org][spine hub]]  [[./][org/]]
+
+- [[./spine_build_scaffold.org][make/build]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
 
 e.g. do on linux bsd osx not windows:
 version(Windows) {} else { ... }
diff --git a/org/config_d_cfte.org b/org/config_d_cfte.org
index 2f68c05..0a8aaae 100644
--- a/org/config_d_cfte.org
+++ b/org/config_d_cfte.org
@@ -16,6 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * cfte views version.txt configuration.txt (set version & configuration) SET
 
 ** program version: version.txt
diff --git a/org/config_dub.org b/org/config_dub.org
index cd57fa3..8e15900 100644
--- a/org/config_dub.org
+++ b/org/config_dub.org
@@ -16,6 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 ** spine version SET VERSION :version:set:project:
 
 #+NAME: spine_version_set
diff --git a/org/config_git.org b/org/config_git.org
index 3f3ca92..8e5eecb 100644
--- a/org/config_git.org
+++ b/org/config_git.org
@@ -16,6 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * spine
 ** .gitignore :gitignore:
 
diff --git a/org/config_make.org b/org/config_make.org
index 0de4564..813a2a6 100644
--- a/org/config_make.org
+++ b/org/config_make.org
@@ -16,8 +16,7 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-[[./spine.org][spine.org]] VERSION
-[[./spine_info.org][spine_info.org]]  [[../org/][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[../org/][org/]]
 
 * spine
 ** version info SET VERSION :version:set:project:
@@ -47,7 +46,7 @@
 ** makefile :makefile:
 *** tangle
 
-#+HEADER: :tangle ../makefile
+#+HEADER: :tangle ../makefile_
 #+BEGIN_SRC makefile
 <<make_set_var_0_git_version>>
 <<make_set_var_1_dub>>
@@ -1105,7 +1104,7 @@ gitsnapshot: distclean tangle
 ** makefile :makefile:
 *** tangle
 
-#+HEADER: :tangle ../sundry/spine_search_cgi/makefile
+#+HEADER: :tangle ../sundry/spine_search_cgi/makefile_
 #+BEGIN_SRC makefile
 <<make_get_project_cgi_search_dependencies_github>>
 #+END_SRC
diff --git a/org/config_meson.org b/org/config_meson.org
index 760738c..be72994 100644
--- a/org/config_meson.org
+++ b/org/config_meson.org
@@ -16,6 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * spine
 ** version info SET VERSION :version:set:project:
 *** project SET VERSION
diff --git a/org/config_nix.org b/org/config_nix.org
index 443094b..4a0fe52 100644
--- a/org/config_nix.org
+++ b/org/config_nix.org
@@ -844,7 +844,7 @@ meta = with pkgs.lib; {
   description = "a sisu like document parser";
   license     = licenses.agpl3Plus;
   platforms   = platforms.linux;
-  maintainers = [ RalphAmissah ];
+  maintainers = [ "RalphAmissah" ];
 };
 #+END_SRC
 
@@ -1290,7 +1290,7 @@ mkDubDerivation rec {
     description = "a sisu like document parser";
     license     = licenses.agpl3Plus;
     platforms   = platforms.linux;
-    maintainers = [ RalphAmissah ];
+    maintainers = [ "RalphAmissah" ];
   };
 }
 #+END_SRC
diff --git a/org/imports.org b/org/default_imports.org
index 30680ae..243c623 100644
--- a/org/imports.org
+++ b/org/default_imports.org
@@ -16,6 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * imports for _meta_ :meta:
 ** package dir
 
diff --git a/org/default_misc.org b/org/default_misc.org
index 60419d8..af1b344 100644
--- a/org/default_misc.org
+++ b/org/default_misc.org
@@ -16,7 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-[[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * meta defaults  :module:meta:
 ** _module template_
 
diff --git a/org/default_paths.org b/org/default_paths.org
index 413434c..7748ab8 100644
--- a/org/default_paths.org
+++ b/org/default_paths.org
@@ -16,7 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-[[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * source paths
 ** _module template_                                      :module:paths_source:
 
diff --git a/org/default_regex.org b/org/default_regex.org
index 184a13d..44ed98a 100644
--- a/org/default_regex.org
+++ b/org/default_regex.org
@@ -16,9 +16,12 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-[[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * meta ctRegex
-[[./spine.org][spine]]  [[./][org/]]
+
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 https://dlang.org/phobos/std_regex.html
 - Plain string, in which case it's compiled to bytecode before matching.
 - Regex!char (wchar/dchar) that contains a pattern in the form of compiled bytecode.
@@ -425,7 +428,9 @@ auto language_code_and_filename                                    =
 #+END_SRC
 
 * 1. output ctRegex
-[[./spine.org][spine]]  [[./][org/]]
+
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 https://dlang.org/phobos/std_regex.html
 - Plain string, in which case it's compiled to bytecode before matching.
 - Regex!char (wchar/dchar) that contains a pattern in the form of compiled bytecode.
diff --git a/org/default_shared.org b/org/default_shared.org
index af850a0..40031af 100644
--- a/org/default_shared.org
+++ b/org/default_shared.org
@@ -16,7 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-[[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * shared
 ** _module template_ :module:shared:
 
diff --git a/org/doc-reform.org b/org/doc-reform.org
new file mode 100644
index 0000000..d0b73eb
--- /dev/null
+++ b/org/doc-reform.org
@@ -0,0 +1,241 @@
+-*- mode: org -*-
+#+TITLE:       Doc Reform ≅ (doc-reform) hub, spine
+#+DESCRIPTION: documents - structuring, various output representations & search
+#+FILETAGS:    :spine:hub:
+#+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
+#+OPTIONS:     H:3 num:nil toc:t \n:nil @:t ::t |:t ^:nil _:nil -:t f:t *:t <:t
+#+PROPERTY:    header-args  :exports code
+#+PROPERTY:    header-args+ :noweb yes
+##+PROPERTY:    header-args+ :eval yes
+#+PROPERTY:    header-args+ :results no
+#+PROPERTY:    header-args+ :cache no
+#+PROPERTY:    header-args+ :padline no
+
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+- [[./spine_build_scaffold.org][make/build]] VERSION
+
+* spine (sisu document parser) :spine:
+** org dir
+
+- directory listing from ./org where program is developed in emacs org-mode
+
+#+NAME: listdir
+#+HEADER: :results output replace
+#+HEADER: :wrap src text
+#+BEGIN_SRC sh
+ls -1 *\.org
+#+END_SRC
+
+#+RESULTS: listdir
+#+begin_src text
+cgi_spine_search.org
+compile_time_info.org
+config_d_cfte.org
+config_dub.org
+config_git.org
+config_make.org
+config_meson.org
+config_misc.org
+config_nix.org
+default_imports.org
+default_misc.org
+default_paths.org
+default_regex.org
+default_shared.org
+doc-reform.org
+in_source_files.org
+meta_conf_make_meta.org
+meta_debugs.org
+metaverse.org
+out_curate_metadata.org
+out_latex.org
+out_metadata.org
+out_odt.org
+output_hub.org
+output_show.org
+out_sqlite.org
+out_src_pod.org
+out_xmls_css.org
+out_xmls.org
+out_zip.org
+spine_info.org
+spine_markup_sample.org
+spine.org
+util_cgi_rb_fcgi_sqlite_search.org
+util_spine_markup_conversion_from_sisu.org
+util_spine_syntax_highlighting_emacs.org
+util_spine_syntax_highlighting_vim.org
+#+end_src
+
+** spine
+*** spine.org :spine:
+
+- program entry point, takes in command line request and decides how to process
+  - input files are sent to metaverse for processing
+  - output files are sent to the output hub and the requested outputs called
+
+#+NAME: listdir_spine
+#+HEADER: :results output replace
+#+HEADER: :wrap src text
+#+BEGIN_SRC sh
+ls -1 spine\.org
+#+END_SRC
+
+#+RESULTS: listdir_spine
+#+begin_src text
+spine.org
+#+end_src
+
+*** spine.org calls
+**** 0. shared defaults
+
+- regular expressions
+- directory paths
+
+misc and shared look at
+
+#+NAME: listdir_default
+#+HEADER: :results output replace
+#+HEADER: :wrap src text
+#+BEGIN_SRC sh
+ls -1 default_*\.org
+#+END_SRC
+
+#+RESULTS: listdir_default
+#+begin_src text
+default_imports.org
+default_misc.org
+default_paths.org
+default_regex.org
+default_shared.org
+#+end_src
+
+**** 1. input file
+
+- rg "\.readText"
+
+#+NAME: listdir_in
+#+HEADER: :results output replace
+#+HEADER: :wrap src text
+#+BEGIN_SRC sh
+ls -1 in_*\.org
+#+END_SRC
+
+#+RESULTS: listdir_in
+#+begin_src text
+in_source_files.org
+#+end_src
+
+**** 2. meta - intermediate processing
+
+- create the internal document representation for downstream processing
+
+#+NAME: listdir_meta
+#+HEADER: :results output replace
+#+HEADER: :wrap src text
+#+BEGIN_SRC sh
+ls -1 metaverse\.org meta_*\.org
+#+END_SRC
+
+#+RESULTS: listdir_meta
+#+begin_src text
+meta_conf_make_meta.org
+meta_debugs.org
+metaverse.org
+#+end_src
+
+**** 3. outputs
+
+#+NAME: listdir_out
+#+HEADER: :results output replace
+#+HEADER: :wrap src text
+#+BEGIN_SRC sh
+ls -1 output_*\.org out_*\.org
+#+END_SRC
+
+#+RESULTS: listdir_out
+#+begin_src text
+out_curate_metadata.org
+out_latex.org
+out_metadata.org
+out_odt.org
+output_hub.org
+output_show.org
+out_sqlite.org
+out_src_pod.org
+out_xmls_css.org
+out_xmls.org
+out_zip.org
+#+end_src
+
+** misc
+*** spine misc
+
+#+NAME: listdir_spine_misc
+#+HEADER: :results output replace
+#+HEADER: :wrap src text
+#+BEGIN_SRC sh
+ls -1 spine_*\.org
+#+END_SRC
+
+#+RESULTS: listdir_spine_misc
+#+begin_src text
+spine_info.org
+spine_markup_sample.org
+#+end_src
+
+*** config
+
+- configure various things related to the project and its build
+
+#+NAME: listdir_config
+#+HEADER: :results output replace
+#+HEADER: :wrap src text
+#+BEGIN_SRC sh
+ls -1 config_*\.org
+#+END_SRC
+
+#+RESULTS: listdir_config
+#+begin_src text
+config_d_cfte.org
+config_dub.org
+config_git.org
+config_make.org
+config_meson.org
+config_misc.org
+config_nix.org
+#+end_src
+*** utils
+
+#+NAME: listdir_util
+#+HEADER: :results output replace
+#+HEADER: :wrap src text
+#+BEGIN_SRC sh
+ls -1 util_*\.org
+#+END_SRC
+
+#+RESULTS: listdir_util
+#+begin_src text
+util_cgi_rb_fcgi_sqlite_search.org
+util_spine_markup_conversion_from_sisu.org
+util_spine_syntax_highlighting_emacs.org
+util_spine_syntax_highlighting_vim.org
+#+end_src
+
+** cgi spine search
+
+#+NAME: listdir_cgi_search
+#+HEADER: :results output replace
+#+HEADER: :wrap src text
+#+BEGIN_SRC sh
+ls -1 cgi_spine_*\.org
+#+END_SRC
+
+#+RESULTS: listdir_cgi_search
+#+begin_src text
+cgi_spine_search.org
+#+end_src
diff --git a/org/in_source_files.org b/org/in_source_files.org
index 6916f52..68da616 100644
--- a/org/in_source_files.org
+++ b/org/in_source_files.org
@@ -16,7 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-[[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * imports
 ** std
 
@@ -34,7 +35,7 @@ doc_reform.meta,
 doc_reform.io_in.paths_source
 #+END_SRC
 
-* A. get _config file_ (read in)
+* A. get _config file_, read in (.readText) [#A]
 ** _module template_ :module:config_files:
 
 #+HEADER: :tangle "../src/doc_reform/io_in/read_config_files.d"
@@ -278,7 +279,7 @@ static template configReadDocYAML() {
 }
 #+END_SRC
 
-* B. get _markup source_, read file :module:source_files:
+* B. get _markup source_, read file (.readText) [#A]:module:source_files:
 ** _module template_ (includes tuple)
 
 #+HEADER: :tangle "../src/doc_reform/io_in/read_source_files.d"
@@ -535,7 +536,8 @@ split is on first match of level A~ (which is required)
 #+END_SRC
 
 ** get markup source, master file & inserts :masterfile:inserts:
-[[./spine.org][spine]]  [[./][org/]]
+
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
 
 *** scan inserts (sub-document) source :scan_insert_src:
 **** scan subdoc source
diff --git a/org/meta_conf_make_meta.org b/org/meta_conf_make_meta.org
index 389bc0d..78b6645 100644
--- a/org/meta_conf_make_meta.org
+++ b/org/meta_conf_make_meta.org
@@ -28,7 +28,8 @@ string check_input_markup()(
 }
 #+END_SRC
 
-[[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * generic
 ** conf yaml REFERENCE
 
diff --git a/org/meta_debugs.org b/org/meta_debugs.org
index 85df63c..32d5d33 100644
--- a/org/meta_debugs.org
+++ b/org/meta_debugs.org
@@ -16,7 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-[[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * abstraction debugs :module:spine:meta_doc_debugs:
 ** _module template_
 
diff --git a/org/metaverse.org b/org/metaverse.org
index 25b414a..234b53d 100644
--- a/org/metaverse.org
+++ b/org/metaverse.org
@@ -16,7 +16,7 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-- [[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
 
 * 1. Document Abstraction
 Process markup document, create document abstraction.
diff --git a/org/out_curate_metadata.org b/org/out_curate_metadata.org
index a9fc096..2861895 100644
--- a/org/out_curate_metadata.org
+++ b/org/out_curate_metadata.org
@@ -16,6 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * document curate _summary_ :module:spine:metadoc_show_summary:
 
 - html
diff --git a/org/out_latex.org b/org/out_latex.org
index 1999248..06f03e6 100644
--- a/org/out_latex.org
+++ b/org/out_latex.org
@@ -16,7 +16,7 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-- [[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
 - [[./output_hub.org][output_hub]]
 
 * latex
diff --git a/org/out_metadata.org b/org/out_metadata.org
index 3662700..f0106d8 100644
--- a/org/out_metadata.org
+++ b/org/out_metadata.org
@@ -16,6 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * document curate _summary_ :module:spine:metadoc_show_summary:
 
 ** _module template_ metadoc document metadata
diff --git a/org/out_odt.org b/org/out_odt.org
index 3b23e23..43ae3bd 100644
--- a/org/out_odt.org
+++ b/org/out_odt.org
@@ -16,7 +16,7 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-- [[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
 - [[./output_hub.org][output_hub]]
 
 * odt :odt:
diff --git a/org/out_sqlite.org b/org/out_sqlite.org
index a628cc6..5e6216b 100644
--- a/org/out_sqlite.org
+++ b/org/out_sqlite.org
@@ -16,7 +16,7 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-- [[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
 - [[./output_hub.org][output_hub]]
 
 sudo chown ralph:ralph /var/www
diff --git a/org/out_src_pod.org b/org/out_src_pod.org
index 3536687..ca1fa2d 100644
--- a/org/out_src_pod.org
+++ b/org/out_src_pod.org
@@ -16,7 +16,7 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-- [[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
 - [[./output_hub.org][output_hub]]
 
 * pod
diff --git a/org/out_xmls.org b/org/out_xmls.org
index dc5f045..fa2acc0 100644
--- a/org/out_xmls.org
+++ b/org/out_xmls.org
@@ -16,7 +16,7 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-- [[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
 - [[./output_hub.org][output_hub]]
 
 #+NAME: year
diff --git a/org/out_xmls_css.org b/org/out_xmls_css.org
index 9c1bf7a..3b6841c 100644
--- a/org/out_xmls_css.org
+++ b/org/out_xmls_css.org
@@ -16,7 +16,7 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-- [[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
 - [[./output_hub.org][output_hub]]
 
 * output css defaults :module:spine:output_xmls_css:
diff --git a/org/out_zip.org b/org/out_zip.org
index 1869edb..59a43c6 100644
--- a/org/out_zip.org
+++ b/org/out_zip.org
@@ -15,7 +15,7 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-- [[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
 - [[./output_hub.org][output_hub]]
 
 * _zip_ :module:spine:create_zip_file:
diff --git a/org/output_hub.org b/org/output_hub.org
index 01263e7..7c9fb95 100644
--- a/org/output_hub.org
+++ b/org/output_hub.org
@@ -16,7 +16,7 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-- [[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
 
 * output hub [#A]
 ** _module template_ :module:
diff --git a/org/output_show.org b/org/output_show.org
index 6cd0328..8181ee6 100644
--- a/org/output_show.org
+++ b/org/output_show.org
@@ -16,6 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * document abstraction _summary_ :module:spine:metadoc_show_summary:
 ** _module template_ metadoc summary
 - document summary from abstraction
diff --git a/org/spine.org b/org/spine.org
index 8604507..f8e34e3 100644
--- a/org/spine.org
+++ b/org/spine.org
@@ -16,8 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-[[./spine_info.org][spine_info.org]]  [[./][org/]]
-[[./spine_build_scaffold.org][make/build]] VERSION
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+- [[./spine_build_scaffold.org][make/build]] VERSION
 
 * spine (sisu document parser) :spine:
 ** notes
@@ -238,14 +238,14 @@ import
 └── views
     └── version.txt
 
-[[./meta_abstraction.org][meta_abstraction]]
-[[./meta_conf_make_meta.org][meta_conf_make_meta]]
-[[./meta_defaults.org][meta_defaults]]
-[[./meta_output_debugs.org][meta_output_debugs]]
-[[./source_read_files.org][source_read_files]]
-[[./compile_time_info.org][compile time info]]
-[[./output.org][output]]
-[[./spine.org][spine]]
+- [[./doc-reform.org][doc-reform.org]]
+- [[./meta_abstraction.org][meta_abstraction]]
+- [[./meta_conf_make_meta.org][meta_conf_make_meta]]
+- [[./meta_defaults.org][meta_defaults]]
+- [[./meta_output_debugs.org][meta_output_debugs]]
+- [[./source_read_files.org][source_read_files]]
+- [[./compile_time_info.org][compile time info]]
+- [[./output.org][output]]
 
 keep up to date, configuration in
 [[./spine_build_scaffold.org][make/build]]
diff --git a/org/spine_info.org b/org/spine_info.org
index b16e87b..c1a05d1 100644
--- a/org/spine_info.org
+++ b/org/spine_info.org
@@ -16,8 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-[[./spine.org][spine.org]]  [[../org/][org/]]
-[[./spine_build_scaffold.org][spine_build_scaffold.org]]
+- [[./doc-reform.org][doc-reform.org]]  [[../org/][org/]]
+- [[./spine_build_scaffold.org][spine_build_scaffold.org]]
 
 * README :readme:
 ** tangle
diff --git a/org/util_cgi_rb_fcgi_sqlite_search.org b/org/util_cgi_rb_fcgi_sqlite_search.org
index 8f35ad9..340ef4b 100644
--- a/org/util_cgi_rb_fcgi_sqlite_search.org
+++ b/org/util_cgi_rb_fcgi_sqlite_search.org
@@ -16,7 +16,7 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
-- [[./spine.org][spine]]  [[./][org/]]
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
 - [[./output_hub.org][output_hub]]
 
 * cgi
diff --git a/org/util_spine_markup_conversion_from_sisu.org b/org/util_spine_markup_conversion_from_sisu.org
index ea7bc69..3d8d7a1 100644
--- a/org/util_spine_markup_conversion_from_sisu.org
+++ b/org/util_spine_markup_conversion_from_sisu.org
@@ -16,6 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * Markup conversion tools
 
 ** README
diff --git a/org/util_spine_syntax_highlighting_emacs.org b/org/util_spine_syntax_highlighting_emacs.org
index 6bf2b61..be6ad37 100644
--- a/org/util_spine_syntax_highlighting_emacs.org
+++ b/org/util_spine_syntax_highlighting_emacs.org
@@ -16,6 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * Emacs Syntax highlighting
 
 ** README
diff --git a/org/util_spine_syntax_highlighting_vim.org b/org/util_spine_syntax_highlighting_vim.org
index 95680c6..a87ca91 100644
--- a/org/util_spine_syntax_highlighting_vim.org
+++ b/org/util_spine_syntax_highlighting_vim.org
@@ -16,6 +16,8 @@
 #+PROPERTY:    header-args+ :padline no
 #+PROPERTY:    header-args+ :mkdirp yes
 
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
 * Vim Syntax highlighting
 ** filetype
 
diff --git a/sundry/spine_search_cgi/derivation.nix b/sundry/spine_search_cgi/derivation.nix
index 596957e..975e95b 100644
--- a/sundry/spine_search_cgi/derivation.nix
+++ b/sundry/spine_search_cgi/derivation.nix
@@ -110,6 +110,6 @@ mkDubDerivation rec {
     description = "a sisu like document parser";
     license     = licenses.agpl3Plus;
     platforms   = platforms.linux;
-    maintainers = [ RalphAmissah ];
+    maintainers = [ "RalphAmissah" ];
   };
 }
diff --git a/sundry/spine_search_cgi/makefile b/sundry/spine_search_cgi/makefile
deleted file mode 100644
index 5edde7c..0000000
--- a/sundry/spine_search_cgi/makefile
+++ /dev/null
@@ -1,35 +0,0 @@
-get_depends:
-	hwd=$$(echo `pwd`) && \
-	gwd="$${hwd}/src/ext_depends_cgi" && \
-	dirs=$$(echo `ls -gx $${gwd}`) && \
-	license_bsl="Boost Software License 1.0 (BSL-1.0)" && \
-	echo $${hwd} && \
-	echo $${gwd} && \
-	echo $${dirs} && \
-	dub upgrade; \
-	cd $${gwd} && \
-	for dir in $${dirs}; do \
-	  if [ -d $${dir} ]; then \
-	    echo $${dir} && \
-	    if [[ "arsd" == $${dir} ]]; then \
-	      echo $${dir} && \
-	      rm -rf $${dir} && \
-          mkdir $${dir} && \
-          aria2c -o "$${dir}/cgi.d" "https://raw.githubusercontent.com/adamdruppe/arsd/master/cgi.d" && \
-	      cd $${gwd}; \
-	    elif [[ "d2sqlite3" == $${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