housekeeping

35 files changed, 321 insertions, 45 deletions

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