sorting

11 files changed, 263 insertions, 202 deletions

diff --git a/org/ao_abstract_doc_source.org b/org/ao_abstract_doc_source.org
index bfda427..ea334a9 100644
--- a/org/ao_abstract_doc_source.org
+++ b/org/ao_abstract_doc_source.org
@@ -1,4 +1,4 @@
-+TITLE: Emacs config file written in org-mode
+#+TITLE: sdp document abstraction
 #+AUTHOR: Ralph Amissah
 #+EMAIL: ralph.amissah@gmail.com
 #+STARTUP: indent
@@ -9,15 +9,16 @@
 #+OPTIONS: ^:nil _:nil
 #+EXPORT_SELECT_TAGS: export
 #+EXPORT_EXCLUDE_TAGS: noexport
-#+TAGS: Amissah(A) Class(c) tangle(T) template(t) WEB(W) noexport(n)
 #+FILETAGS: :sdp:ao:
+#+TAGS: assert(a) class(c) debug(d) mixin(m) sdp(s) tangle(T) template(t) WEB(W) noexport(n)
 
-* document abstraction
+* document abstraction                                             :abstract:
+[[./sdp.org][sdp]]
 Process markup document, create document abstraction.
 ** initialize
 #+name: abs_init
 #+BEGIN_SRC d                                                  :exports none
-/* initialize */
+/+ initialize +/
 mixin ObjectSetters;
 mixin AssertionsOnMarkupDocumentStructure;
 mixin AssertionsOnBlocks;
@@ -34,7 +35,7 @@ string biblio_tag_name, biblio_tag_entry, book_idx_tmp, st;
 string[1024] biblio_arr_json = biblio_entry_tags_jsonstr;
 JSONValue[1024] bib_arr_json;
 uint[string] line_occur;
-int counter, previous_count, count_biblio_entry, ocn, ocn_, verse_line, bib_entry, heading_pointer, notepoint;
+uint counter, previous_count, count_biblio_entry, ocn, ocn_, verse_line, bib_entry, heading_pointer, notepoint;
 string indent_first, indent_second;
 string[][string][string] bookindex_unordered_hashes;
 bool bullet = true;
@@ -149,7 +150,7 @@ auto dochead_metadata = parseJSON(header_metadata_jsonstr).object;
 #+END_SRC
 
 ** loop: process document body [+7]
-*** scope
+*** scope                                                             :scope:
 #+name: abs_loop_body_00
 #+BEGIN_SRC d                                                  :exports none
 /* scope */
@@ -174,7 +175,7 @@ debug(srclines) {
   }
 }
 #+END_SRC
-*** check whether ocn is on or turned off
+*** check whether ocn is on or turned off                               :ocn:
 #+name: abs_loop_body_00
 #+BEGIN_SRC d                                                  :exports none
 if ((!line.empty) && (ft["ocn_status_multi_obj"] == 0)) {
@@ -218,7 +219,7 @@ if ((!line.empty) && (ft["ocn_status_multi_obj"] == 0)) {
 }
 #+END_SRC
 *** separate regular markup text from code blocks [+6]
-**** code blocks
+**** code blocks                                                 :block:code:
 #+name: abs_loop_body_00
 #+BEGIN_SRC d                                                  :exports none
 if (ft["code"] == 1) {
@@ -253,14 +254,14 @@ if (ft["code"] == 1) {
     }
   }
 #+END_SRC
-**** non code objects (other blocks or regular text) [+5]
+**** non code objects (other blocks or regular text) [+5]          :non_code:
 #+name: abs_loop_body_00
 #+BEGIN_SRC d                                                  :exports none
 } else if (!match(line, rgx.regular_parse_skip)) {
 /* object other than code block object (includes regular text paragraph) */
 #+END_SRC
-***** within block group [+1]
-****** within block group: biblio
+***** within block group [+1]                                  :block:active:
+****** within block group: biblio                                    :biblio:
 #+name: abs_loop_body_non_code_obj
 #+BEGIN_SRC d                                                  :exports none
 if (((match(line, rgx.heading_biblio)
@@ -348,7 +349,7 @@ if (((match(line, rgx.heading_biblio)
     biblio_tag_entry="";
   }
 #+END_SRC
-****** within block group: poem
+****** within block group: poem                                        :poem:
 #+name: abs_loop_body_non_code_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (ft["poem"] == 1) {
@@ -549,7 +550,7 @@ if (((match(line, rgx.heading_biblio)
     }
   }
 #+END_SRC
-****** within block group: group
+****** within block group: group                                      :group:
 #+name: abs_loop_body_non_code_obj
 #+BEGIN_SRC d                                                  :exports none
 /* within block object: group */
@@ -584,7 +585,7 @@ if (((match(line, rgx.heading_biblio)
     }
   }
 #+END_SRC
-****** within block group: block
+****** within block group: block                                      :block:
 #+name: abs_loop_body_non_code_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (ft["block"] == 1) {
@@ -619,7 +620,7 @@ if (((match(line, rgx.heading_biblio)
     }
   }
 #+END_SRC
-****** within block group: quote
+****** within block group: quote                                      :quote:
 #+name: abs_loop_body_non_code_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (ft["quote"] == 1) {
@@ -654,7 +655,7 @@ if (((match(line, rgx.heading_biblio)
     }
   }
 #+END_SRC
-****** within block group: table
+****** within block group: table                                      :table:
 #+name: abs_loop_body_non_code_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (ft["table"] == 1) {
@@ -689,7 +690,7 @@ if (((match(line, rgx.heading_biblio)
     }
   }
 #+END_SRC
-***** not within block group [+4]
+***** not identified as being within block group [+4]
 #+name: abs_loop_body_non_code_obj
 #+BEGIN_SRC d                                                  :exports none
 } else {
@@ -705,8 +706,8 @@ assert(
 );
 assertions_flag_types_block_status_none_or_closed(ft);
 #+END_SRC
-****** open curly block group [+1]
-******* open block group: code
+****** open curly block group [+1]                         :block:curly:open:
+******* open block group: code                                         :code:
 #+name: abs_loop_body_open_block_obj
 #+BEGIN_SRC d                                                  :exports none
 if (auto m = match(line, rgx.block_curly_code_open)) {
@@ -723,7 +724,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
   ft["code"] = 1;
   ft["curly_code"] = 1;
 #+END_SRC
-******* open block group: poem
+******* open block group: poem                                         :poem:
 #+name: abs_loop_body_open_block_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (auto m = match(line, rgx.block_curly_poem_open)) {
@@ -748,7 +749,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
   ft["poem"] = 1;
   ft["curly_poem"] = 1;
 #+END_SRC
-******* open block group: group
+******* open block group: group                                       :group:
 #+name: abs_loop_body_open_block_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (auto m = match(line, rgx.block_curly_group_open)) {
@@ -765,7 +766,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
   ft["group"] = 1;
   ft["curly_group"] = 1;
 #+END_SRC
-******* open block group: block
+******* open block group: block                                       :block:
 #+name: abs_loop_body_open_block_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (auto m = match(line, rgx.block_curly_block_open)) {
@@ -782,7 +783,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
   ft["block"] = 1;
   ft["curly_block"] = 1;
 #+END_SRC
-******* open block group: quote
+******* open block group: quote                                       :quote:
 #+name: abs_loop_body_open_block_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (auto m = match(line, rgx.block_curly_quote_open)) {
@@ -799,7 +800,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
   ft["quote"] = 1;
   ft["curly_quote"] = 1;
 #+END_SRC
-******* open block group: table
+******* open block group: table                                       :table:
 #+name: abs_loop_body_open_block_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (auto m = match(line, rgx.block_curly_table_open)) {
@@ -816,8 +817,8 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
   ft["table"] = 1;
   ft["curly_table"] = 1;
 #+END_SRC
-****** open tic block group [+1]
-******* open block group: code
+****** open tic block group [+1]                             :block:tic:open:
+******* open block group: code                                         :code:
 #+name: abs_loop_body_open_block_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (auto m = match(line, rgx.block_tic_code_open)) {
@@ -834,7 +835,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
   ft["code"] = 1;
   ft["tic_code"] = 1;
 #+END_SRC
-******* open block group: poem
+******* open block group: poem                                         :poem:
 #+name: abs_loop_body_open_block_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (auto m = match(line, rgx.block_tic_poem_open)) {
@@ -859,7 +860,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
   ft["poem"] = 1;
   ft["tic_poem"] = 1;
 #+END_SRC
-******* open block group: group
+******* open block group: group                                       :group:
 #+name: abs_loop_body_open_block_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (auto m = match(line, rgx.block_tic_group_open)) {
@@ -876,7 +877,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
   ft["group"] = 1;
   ft["tic_group"] = 1;
 #+END_SRC
-******* open block group: block
+******* open block group: block                                       :block:
 #+name: abs_loop_body_open_block_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (auto m = match(line, rgx.block_tic_block_open)) {
@@ -893,7 +894,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
   ft["block"] = 1;
   ft["tic_block"] = 1;
 #+END_SRC
-******* open block group: quote
+******* open block group: quote                                       :quote:
 #+name: abs_loop_body_open_block_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (auto m = match(line, rgx.block_tic_quote_open)) {
@@ -910,7 +911,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
   ft["quote"] = 1;
   ft["tic_quote"] = 1;
 #+END_SRC
-******* open block group: table
+******* open block group: table                                       :table:
 #+name: abs_loop_body_open_block_obj
 #+BEGIN_SRC d                                                  :exports none
 } else if (auto m = match(line, rgx.block_tic_table_open)) {
@@ -934,7 +935,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
 /* line not empty */
 /* non blocks (headers, paragraphs) & closed blocks */
 #+END_SRC
-******* asserts
+******* asserts                                                      :assert:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
   assert(
@@ -959,7 +960,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
     );
   }
 #+END_SRC
-******* book index
+******* book index                                                :bookindex:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
   if (auto m = match(line, rgx.book_index)) {
@@ -1008,7 +1009,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
   } else {
   /* not book_index */
 #+END_SRC
-******** matched: comment
+******** matched: comment                                     :comment:match:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
     if (auto m = match(line, rgx.comment)) {
@@ -1036,7 +1037,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
       ft["para"] = 0;
       counter++;
 #+END_SRC
-******** matched: header make
+******** matched: header make                             :header:make:match:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
     } else if (auto m = match(line, rgx.header_make)) {
@@ -1052,7 +1053,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
       line_occur["header_make"]++;
       object["obj"] ~= line ~= "\n";
 #+END_SRC
-******** matched: header metadata
+******** matched: header metadata                     :header:metadata:match:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
     } else if (auto m = match(line, rgx.header_metadata)) {
@@ -1068,7 +1069,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
       line_occur["header_metadata"]++;
       object["obj"] ~= line ~= "\n";
 #+END_SRC
-******** flag set: header make
+******** flag set: header make                             :header:make:flag:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
     } else if (ft["header_make"] == 1
@@ -1083,7 +1084,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
         object["obj"] ~= line ~= "\n";
       }
 #+END_SRC
-******** flag set: header metadata
+******** flag set: header metadata                     :header:metadata:flag:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
     } else if (ft["header_metadata"] == 1
@@ -1107,7 +1108,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
     && (ft["heading"] == 0))) {
     /* heading or para but neither flag nor line exists */
 #+END_SRC
-********* headings found
+********* headings found                                            :heading:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
       if ((to!string(dochead_make["make"]["headings"]).length > 2)
@@ -1177,7 +1178,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
         ft["make_headings"] = 1;
       }
 #+END_SRC
-********* headings make set
+********* headings make set                                         :heading:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
       if ((ft["make_headings"] == 1)
@@ -1230,7 +1231,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
         }
       }
 #+END_SRC
-********* headings match
+********* headings match                                            :heading:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
       if (auto m = match(line, rgx.heading)) {
@@ -1357,7 +1358,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
           tell_l("yellow", strip(line));
         }
 #+END_SRC
-********* para matches
+********* para matches                                                 :para:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
       } else if (line_occur["para"] == 0) {
@@ -1408,7 +1409,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
         line_occur["para"]++;
       }
 #+END_SRC
-******** line exist: header make
+******** line exist: header make                                :header:make:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
     } else if (line_occur["header_make"] > 0) {
@@ -1420,7 +1421,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
       object["obj"] ~= line ~= "\n";
       line_occur["header_make"]++;
 #+END_SRC
-******** line exist: header metadata
+******** line exist: header metadata                        :header:metadata:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
     } else if (line_occur["header_metadata"] > 0) {
@@ -1432,7 +1433,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
       object["obj"] ~= line ~= "\n";
       line_occur["header_metadata"]++;
 #+END_SRC
-******** line exist: heading
+******** line exist: heading                                        :heading:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
     } else if (line_occur["heading"] > 0) {
@@ -1443,7 +1444,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
       object["obj"] ~= line ~= "\n";
       line_occur["heading"]++;
 #+END_SRC
-******** line exist: para
+******** line exist: para                                              :para:
 #+name: abs_loop_body_not_block_obj
 #+BEGIN_SRC d                                                  :exports none
     } else if (line_occur["para"] > 0) {
@@ -1677,7 +1678,7 @@ if (auto m = match(line, rgx.block_curly_code_open)) {
 } else {
 /* line empty */
 #+END_SRC
-******* assert line empty
+******* assert line empty                                            :assert:
 #+name: abs_loop_body_not_block_obj_line_empty
 #+BEGIN_SRC d                                                  :exports none
 /* line.empty, post contents, empty variables: */
@@ -1690,7 +1691,7 @@ assert(
   "code block status: none"
 );
 #+END_SRC
-******* header_make instructions
+******* header_make instructions                   :header:make:instructions:
 #+name: abs_loop_body_not_block_obj_line_empty
 #+BEGIN_SRC d                                                  :exports none
 if ((ft["header_make"] == 1)
@@ -1715,7 +1716,7 @@ if ((ft["header_make"] == 1)
   object.remove("bookindex");
   processing.remove("verse");
 #+END_SRC
-******* header_metadata
+******* header_metadata                                     :header:metadata:
 #+name: abs_loop_body_not_block_obj_line_empty
 #+BEGIN_SRC d                                                  :exports none
 } else if ((ft["header_metadata"] == 1)
@@ -1742,7 +1743,7 @@ if ((ft["header_make"] == 1)
   object.remove("bookindex");
   processing.remove("verse");
 #+END_SRC
-******* heading object
+******* heading object                                       :heading:object:
 #+name: abs_loop_body_not_block_obj_line_empty
 #+BEGIN_SRC d                                                  :exports none
 } else if ((ft["heading"] == 1)
@@ -1800,7 +1801,7 @@ if ((ft["header_make"] == 1)
   processing.remove("verse");
   counter++;
 #+END_SRC
-******* paragraph object
+******* paragraph object                                   :paragraph:object:
 #+name: abs_loop_body_not_block_obj_line_empty
 #+BEGIN_SRC d                                                  :exports none
 } else if ((ft["para"] == 1) && (line_occur["para"] > 0)) {
@@ -1985,7 +1986,7 @@ auto t =
 return t;
 #+END_SRC
 
-* tangles
+* tangles                                                            :tangle:
 ** code structure:                                :ao_abstract_doc_source.d:
 #+name: tangle_ao_abstract_doc_source
 #+BEGIN_SRC d :tangle ../lib/sdp/ao_abstract_doc_source.d :padline no :exports none :noweb yes
diff --git a/org/ao_assertions.org b/org/ao_assertions.org
index 1c29be9..a253e33 100644
--- a/org/ao_assertions.org
+++ b/org/ao_assertions.org
@@ -1,4 +1,4 @@
-#+TITLE: Emacs config file written in org-mode
+#+TITLE: sdp assertions
 #+AUTHOR: Ralph Amissah
 #+EMAIL: ralph.amissah@gmail.com
 #+STARTUP: indent
@@ -9,11 +9,12 @@
 #+OPTIONS: ^:nil _:nil
 #+EXPORT_SELECT_TAGS: export
 #+EXPORT_EXCLUDE_TAGS: noexport
-#+TAGS: Amissah(A) Class(c) WEB(W) noexport(n)
 #+FILETAGS: :sdp:ao:
+#+TAGS: assert(a) class(c) debug(d) mixin(m) sdp(s) tangle(T) template(t) WEB(W) noexport(n)
 
-* assertions
-** mixin template: assertions on markup document structure
+* assertions                                                   :mixin:assert:
+[[./sdp.org][sdp]]
+** mixin template: assertions on markup document structure    :doc_structure:
 #+name: ao_assertions
 #+BEGIN_SRC d                                                  :exports none
 mixin template AssertionsOnMarkupDocumentStructure() {
@@ -215,7 +216,7 @@ mixin template AssertionsOnMarkupDocumentStructure() {
   }
 }
 #+END_SRC
-** mixin template: assertions on blocks
+** mixin template: assertions on blocks                              :blocks:
 #+name: ao_assertions
 #+BEGIN_SRC d                                                  :exports none
 mixin template AssertionsOnBlocks() {
@@ -239,7 +240,7 @@ mixin template AssertionsOnBlocks() {
 }
 #+END_SRC
 
-* tangle
+* tangle                                                             :tangle:
 ** code structure:                                           :ao_assertions.d:
 #+name: tangle_ao_assertions
 #+BEGIN_SRC d :tangle ../lib/sdp/ao_assertions.d :padline no :exports none :noweb yes
diff --git a/org/ao_defaults.org b/org/ao_defaults.org
index 391abbb..73dba74 100644
--- a/org/ao_defaults.org
+++ b/org/ao_defaults.org
@@ -1,4 +1,4 @@
-#+TITLE: Emacs config file written in org-mode
+#+TITLE: sdp defaults
 #+AUTHOR: Ralph Amissah
 #+EMAIL: ralph.amissah@gmail.com
 #+STARTUP: indent
@@ -9,11 +9,12 @@
 #+OPTIONS: ^:nil _:nil
 #+EXPORT_SELECT_TAGS: export
 #+EXPORT_EXCLUDE_TAGS: noexport
-#+TAGS: Amissah(A) Class(c) WEB(W) noexport(n)
 #+FILETAGS: :sdp:ao:
+#+TAGS: assert(a) class(c) debug(d) mixin(m) sdp(s) tangle(T) template(t) WEB(W) noexport(n)
 
-* defaults
-** template: header
+* defaults                                                :template:defaults:
+[[./sdp.org][sdp]]
+** template: header                                                  :header:
 #+name: ao_defaults_templates
 #+BEGIN_SRC d                                                  :exports none
 template SiSUheader() {
@@ -89,7 +90,7 @@ template SiSUheader() {
     },
     "links": {
     }
-  }`;
+  }`; // links
   auto pointer_head_main =
     [
       "creator",
@@ -180,7 +181,7 @@ template SiSUheader() {
   }`;
 }
 #+END_SRC
-** template: flags regex initialize
+** template: flags regex initialize                             :regex_flags:
 #+name: ao_defaults_templates
 #+BEGIN_SRC d                                                  :exports none
 /* regex flags */
@@ -218,7 +219,7 @@ template SiSUrgxInitFlags() {
   ];
 }
 #+END_SRC
-** template: bibliography
+** template: bibliography                                            :biblio:
 #+name: ao_defaults_templates
 #+BEGIN_SRC d                                                  :exports none
 template SiSUbiblio() {
@@ -250,7 +251,7 @@ template SiSUbiblio() {
     "note"                             : "",
     "short_name"                       : "",
     "id"                               : ""
-  }`;
+  }`; // is: book, article, magazine, newspaper, blog, other
   auto biblio_tag_map = [
     "au"                               : "author_raw",
     "ed"                               : "editor_raw",
@@ -269,7 +270,7 @@ template SiSUbiblio() {
   ]; // is: book, article, magazine, newspaper, blog, other
 }
 #+END_SRC
-** template: internal markup
+** template: internal markup                                         :markup:
 #+name: ao_defaults_templates
 #+BEGIN_SRC d                                                  :exports none
 template InternalMarkup() {
@@ -280,7 +281,7 @@ template InternalMarkup() {
 }
 #+END_SRC
 
-* tangles
+* tangles                                                            :tangle:
 ** code structure:                                               :ao_defaults.d:
 #+name: tangle_ao_defaults
 #+BEGIN_SRC d :tangle ../lib/sdp/ao_defaults.d :padline no :exports none :noweb yes
diff --git a/org/ao_emitters_and_interfaces.org b/org/ao_emitters_and_interfaces.org
index d016f7c..3ef1dff 100644
--- a/org/ao_emitters_and_interfaces.org
+++ b/org/ao_emitters_and_interfaces.org
@@ -1,4 +1,4 @@
-#+TITLE: Emacs config file written in org-mode
+#+TITLE: sdp emitters & interfaces
 #+AUTHOR: Ralph Amissah
 #+EMAIL: ralph.amissah@gmail.com
 #+STARTUP: indent
@@ -9,15 +9,16 @@
 #+OPTIONS: ^:nil _:nil
 #+EXPORT_SELECT_TAGS: export
 #+EXPORT_EXCLUDE_TAGS: noexport
-#+TAGS: Amissah(A) Class(c) WEB(W) noexport(n)
 #+FILETAGS: :sdp:ao:
+#+TAGS: assert(a) class(c) debug(d) mixin(m) sdp(s) tangle(T) template(t) WEB(W) noexport(n)
 
 * emitters & interfaces
+[[./sdp.org][sdp]]
 ao_interface.d
 ao_emitter.d
 various emitters and their interfaces (where available)
 ** e:   command line interface/instructions
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class CLI {
@@ -36,7 +37,7 @@ class CLI {
 }
 #+END_SRC
 ** e&i: ocn
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class OCNemitter : AssertOCN {
@@ -55,7 +56,7 @@ class OCNemitter : AssertOCN {
   }
 }
 #+END_SRC
-*** interface assert
+*** interface assert                                       :interface:assert:
 #+name: ao_interface
 #+BEGIN_SRC d                                                  :exports none
 interface AssertOCN {
@@ -65,7 +66,7 @@ interface AssertOCN {
 }
 #+END_SRC
 ** e:   object attributes
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class ObjAttributes {
@@ -222,7 +223,7 @@ class ObjAttributes {
 }
 #+END_SRC
 ** e:   object inline markup munge
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class ObjInlineMarkupMunge {
@@ -406,7 +407,7 @@ class ObjInlineMarkupMunge {
 }
 #+END_SRC
 ** e&i: object inline markup
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class ObjInlineMarkup : AssertObjInlineMarkup {
@@ -465,7 +466,7 @@ class ObjInlineMarkup : AssertObjInlineMarkup {
   }
 }
 #+END_SRC
-*** interface assert
+*** interface assert                                       :interface:assert:
 #+name: ao_interface
 #+BEGIN_SRC d                                                  :exports none
 interface AssertObjInlineMarkup {
@@ -477,7 +478,7 @@ interface AssertObjInlineMarkup {
 }
 #+END_SRC
 ** e&i: object attrib
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class ObjAttrib : AssertObjAttrib {
@@ -567,7 +568,7 @@ class ObjAttrib : AssertObjAttrib {
   }
 }
 #+END_SRC
-*** interface assert
+*** interface assert                                       :interface:assert:
 #+name: ao_interface
 #+BEGIN_SRC d                                                  :exports none
 interface AssertObjAttrib {
@@ -579,7 +580,7 @@ interface AssertObjAttrib {
 }
 #+END_SRC
 ** e:   header document metadata in json
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class HeaderDocMetadataMakeJson {
@@ -774,7 +775,7 @@ class HeaderDocMetadataMakeJson {
 }
 #+END_SRC
 ** e:   header document metadata as hash
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class HeaderMetadataMakeHash {
@@ -827,7 +828,7 @@ class HeaderMetadataMakeHash {
 }
 #+END_SRC
 ** e&i: book index nugget hash
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class BookIndexNuggetHash : AssertBookIndexNuggetHash {
@@ -892,7 +893,7 @@ class BookIndexNuggetHash : AssertBookIndexNuggetHash {
   }
 }
 #+END_SRC
-*** interface assert
+*** interface assert                                       :interface:assert:
 #+name: ao_interface
 #+BEGIN_SRC d                                                  :exports none
 interface AssertBookIndexNuggetHash {
@@ -913,7 +914,7 @@ interface AssertBookIndexNuggetHash {
 }
 #+END_SRC
 ** e&i: book index report
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class BookIndexReport {
@@ -941,7 +942,7 @@ class BookIndexReport {
   }
 }
 #+END_SRC
-*** interface assert
+*** interface assert                                       :interface:assert:
 #+name: ao_interface
 #+BEGIN_SRC d                                                  :exports none
 interface AssertBookIndexReport {
@@ -951,7 +952,7 @@ interface AssertBookIndexReport {
 }
 #+END_SRC
 ** e:   book index report indented
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class BookIndexReportIndent {
@@ -982,7 +983,7 @@ class BookIndexReportIndent {
 }
 #+END_SRC
 ** e:   book index report section
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class BookIndexReportSection {
@@ -1148,7 +1149,7 @@ class BookIndexReportSection {
 }
 #+END_SRC
 ** e:   (end)notes section
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class NotesSection {
@@ -1273,7 +1274,7 @@ class NotesSection {
 }
 #+END_SRC
 ** e:   bibliography
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class Bibliography {
@@ -1345,7 +1346,7 @@ class Bibliography {
 }
 #+END_SRC
 ** e&i: node structure metadata
-*** emitter
+*** emitter                                                         :emitter:
 #+name: ao_emitter
 #+BEGIN_SRC d                                                  :exports none
 class NodeStructureMetadata : AssertNodeJSON {
@@ -1472,7 +1473,7 @@ class NodeStructureMetadata : AssertNodeJSON {
 }
 #+END_SRC
 
-*** interface assert
+*** interface assert                                       :interface:assert:
 #+name: ao_interface
 #+BEGIN_SRC d                                                  :exports none
 interface AssertNodeJSON {
@@ -1574,7 +1575,7 @@ interface AssertNodeJSON {
   }
 }
 #+END_SRC
-* tangles
+* tangles                                                            :tangle:
 ** code structure:                                                :ao_emitter.d:
 #+name: tangle_ao_emitter
 #+BEGIN_SRC d :tangle ../lib/sdp/ao_emitter.d :padline no :exports none :noweb yes
diff --git a/org/ao_markup_source_raw.org b/org/ao_markup_source_raw.org
index 13bce8d..5923116 100644
--- a/org/ao_markup_source_raw.org
+++ b/org/ao_markup_source_raw.org
@@ -1,4 +1,4 @@
-#+TITLE: Emacs config file written in org-mode
+#+TITLE: sdp markup source raw
 #+AUTHOR: Ralph Amissah
 #+EMAIL: ralph.amissah@gmail.com
 #+STARTUP: indent
@@ -9,11 +9,13 @@
 #+OPTIONS: ^:nil _:nil
 #+EXPORT_SELECT_TAGS: export
 #+EXPORT_EXCLUDE_TAGS: noexport
-#+TAGS: Amissah(A) Class(c) WEB(W) noexport(n)
 #+FILETAGS: :sdp:ao:
+#+TAGS: assert(a) class(c) debug(d) mixin(m) sdp(s) tangle(T) template(t) WEB(W) noexport(n)
 
-* markup source raw
-** source string
+* markup source raw                                                  :markup:
+[[./sdp.org][sdp]]
+
+** source string                                                     :string:
 #+name: ao_markup_source_raw
 #+BEGIN_SRC d                                                  :exports none
 final private string markupSourceString(in char[] fn_src) {
@@ -40,7 +42,8 @@ final private string markupSourceString(in char[] fn_src) {
   return source_txt_str;
 }
 #+END_SRC
-** source line array
+
+** source line array                                                  :array:
 #+name: ao_markup_source_raw
 #+BEGIN_SRC d                                                  :exports none
 final private char[][] markupSourceLineArray(in string src_text) {
@@ -49,7 +52,8 @@ final private char[][] markupSourceLineArray(in string src_text) {
   return source_line_arr;
 }
 #+END_SRC
-** insert source content raw line array
+
+** insert source content raw line array                               :array:
 #+name: ao_markup_source_raw
 #+BEGIN_SRC d                                                  :exports none
 final char[][] markupInsertSourceContentRawLineArray(in char[] fn_src) {
@@ -62,7 +66,8 @@ final char[][] markupInsertSourceContentRawLineArray(in char[] fn_src) {
   return source_line_arr;
 }
 #+END_SRC
-** source content raw line array
+
+** source content raw line array                                      :array:
 #+name: ao_markup_source_raw
 #+BEGIN_SRC d                                                  :exports none
 final char[][] markupSourceContentRawLineArray(in char[] fn_src) {
@@ -76,7 +81,7 @@ final char[][] markupSourceContentRawLineArray(in char[] fn_src) {
 }
 #+END_SRC
 
-* tangles
+* tangles                                                            :tangle:
 ** code structure:                                   :ao_markup_source_raw.d:
 #+name: tangle_ao_markup_source_raw
 #+BEGIN_SRC d :tangle ../lib/sdp/ao_markup_source_raw.d :padline no :exports none :noweb yes
diff --git a/org/ao_object_setter.org b/org/ao_object_setter.org
index 83425a3..836e14a 100644
--- a/org/ao_object_setter.org
+++ b/org/ao_object_setter.org
@@ -1,4 +1,4 @@
-#+TITLE: Emacs config file written in org-mode
+#+TITLE: sdp object setter
 #+AUTHOR: Ralph Amissah
 #+EMAIL: ralph.amissah@gmail.com
 #+STARTUP: indent
@@ -9,11 +9,12 @@
 #+OPTIONS: ^:nil _:nil
 #+EXPORT_SELECT_TAGS: export
 #+EXPORT_EXCLUDE_TAGS: noexport
-#+TAGS: Amissah(A) Class(c) WEB(W) noexport(n)
 #+FILETAGS: :sdp:ao:
+#+TAGS: assert(a) class(c) debug(d) mixin(m) sdp(s) tangle(T) template(t) WEB(W) noexport(n)
 
-* object setter
-** comment
+* object setter                                                  :object:set:
+[[./sdp.org][sdp]]
+** struct                                                            :struct:
 #+name: ao_object_setter
 #+BEGIN_SRC d                                                  :exports none
 string[string] contents_comment(in string object) {
@@ -25,7 +26,7 @@ string[string] contents_comment(in string object) {
   return object_set;
 }
 #+END_SRC
-** heading
+** heading                                                          :heading:
 #+name: ao_object_setter
 #+BEGIN_SRC d                                                  :exports none
 string[string] contents_heading(
@@ -51,7 +52,7 @@ string[string] contents_heading(
   return object_set;
 }
 #+END_SRC
-** para
+** para                                                                :para:
 #+name: ao_object_setter
 #+BEGIN_SRC d                                                  :exports none
 string[string] contents_para(
@@ -76,7 +77,7 @@ string[string] contents_para(
   return object_set;
 }
 #+END_SRC
-** block
+** block                                                              :block:
 #+name: ao_object_setter
 #+BEGIN_SRC d                                                  :exports none
 string[string] contents_block(
@@ -95,7 +96,7 @@ string[string] contents_block(
   return object_set;
 }
 #+END_SRC
-** block ocn string
+** block ocn string                                                   :block:
 #+name: ao_object_setter
 #+BEGIN_SRC d                                                  :exports none
 string[string] contents_block_ocn_string(
@@ -115,7 +116,7 @@ string[string] contents_block_ocn_string(
 }
 #+END_SRC
 
-* tangles
+* tangles                                                            :tangle:
 ** code structure:                                          :ao_object_setter.d:
 #+name: tangle_ao_object_setter
 #+BEGIN_SRC d :tangle ../lib/sdp/ao_object_setter.d :padline no :exports none :noweb yes
diff --git a/org/ao_output_debugs.org b/org/ao_output_debugs.org
index 0e730ef..ecad21f 100644
--- a/org/ao_output_debugs.org
+++ b/org/ao_output_debugs.org
@@ -1,4 +1,4 @@
-#+TITLE: Emacs config file written in org-mode
+#+TITLE: sdp output debugs
 #+AUTHOR: Ralph Amissah
 #+EMAIL: ralph.amissah@gmail.com
 #+STARTUP: indent
@@ -9,11 +9,12 @@
 #+OPTIONS: ^:nil _:nil
 #+EXPORT_SELECT_TAGS: export
 #+EXPORT_EXCLUDE_TAGS: noexport
-#+TAGS: Amissah(A) Class(c) WEB(W) noexport(n)
 #+FILETAGS: :sdp:ao:
+#+TAGS: assert(a) class(c) debug(d) mixin(m) sdp(s) tangle(T) template(t) WEB(W) noexport(n)
 
-* output debugs
-** (parent)
+* output debugs                                                :debug:output:
+[[./sdp.org][sdp]]
+** (parent)                                                          :parent:
 #+name: ao_output_debugs
 #+BEGIN_SRC d                                                  :exports none
 debug(parent) {
@@ -33,7 +34,7 @@ debug(parent) {
   }
 }
 #+END_SRC
-** (objects)
+** (objects)                                                        :objects:
 #+name: ao_output_debugs
 #+BEGIN_SRC d                                                  :exports none
 debug(objects) {
@@ -52,7 +53,7 @@ debug(objects) {
   }
 }
 #+END_SRC
-** (headermakejson)
+** (headermakejson)                                             :json:header:
 #+name: ao_output_debugs
 #+BEGIN_SRC d                                                  :exports none
 debug(headermakejson) {
@@ -78,7 +79,7 @@ debug(headermakejson) {
   }
 }
 #+END_SRC
-** (headermetadatajson)
+** (headermetadatajson)                                         :json:header:
 #+name: ao_output_debugs
 #+BEGIN_SRC d                                                  :exports none
 debug(headermetadatajson) {
@@ -183,7 +184,7 @@ debug(headermetadatajson) {
   }
 }
 #+END_SRC
-** (bookindex)
+** (bookindex)                                                    :bookindex:
 #+name: ao_output_debugs
 #+BEGIN_SRC d                                                  :exports none
 debug(bookindex) {
@@ -193,7 +194,7 @@ debug(bookindex) {
   bookindex.bookindex_report_sorted(bookindex_unordered_hashes);
 }
 #+END_SRC
-** (summary) [+1]
+** (summary) [+1]                                                   :summary:
 #+name: ao_output_debugs
 #+BEGIN_SRC d                                                  :exports none
 debug(summary) {
@@ -201,7 +202,7 @@ debug(summary) {
     "last_ocn" : "NA [debug \"checkdoc\" not run]",
   ];
 #+END_SRC
-*** (checkdoc)
+*** (checkdoc)                                                     :checkdoc:
 #+name: ao_output_debugs_summary
 #+BEGIN_SRC d                                                  :exports none
 debug(checkdoc) {
@@ -214,7 +215,7 @@ debug(checkdoc) {
   }
 }
 #+END_SRC
-*** (headings)
+*** (headings)                                                     :headings:
 #+name: ao_output_debugs_summary
 #+BEGIN_SRC d                                                  :exports none
 debug(headings) {
@@ -372,7 +373,7 @@ debug(checkdoc) {
 }
 #+END_SRC
 
-* tangles
+* tangles                                                            :tangle:
 ** code structure:                                          :ao_output_debugs.d:
 #+name: tangle_ao_output_debugs
 #+BEGIN_SRC d :tangle ../lib/sdp/ao_output_debugs.d :padline no :exports none :noweb yes
diff --git a/org/ao_rgx.org b/org/ao_rgx.org
index ff7f207..eecad70 100644
--- a/org/ao_rgx.org
+++ b/org/ao_rgx.org
@@ -1,4 +1,4 @@
-#+TITLE: Emacs config file written in org-mode
+#+TITLE: sdp rgx
 #+AUTHOR: Ralph Amissah
 #+EMAIL: ralph.amissah@gmail.com
 #+STARTUP: indent
@@ -9,11 +9,12 @@
 #+OPTIONS: ^:nil _:nil
 #+EXPORT_SELECT_TAGS: export
 #+EXPORT_EXCLUDE_TAGS: noexport
-#+TAGS: Amissah(A) Class(c) WEB(W) noexport(n)
 #+FILETAGS: :sdp:ao:
+#+TAGS: assert(a) class(c) debug(d) mixin(m) sdp(s) tangle(T) template(t) WEB(W) noexport(n)
 
-* regex
-** misc
+* regex                                                               :regex:
+[[./sdp.org][sdp]]
+** misc                                                                :misc:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* misc */
@@ -38,18 +39,23 @@ static levels_markup             = ctRegex!(`^[A-D1-4]$`);
 static levels_numbered           = ctRegex!(`^[0-9]$`);
 static levels_numbered_headings  = ctRegex!(`^[0-7]$`);
 #+END_SRC
-** markup insert file
+** markup insert file                                           :insert:file:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* insert markup file */
 static insert_src_fn_ssi_or_sst  = ctRegex!(`^<<\s*(?P<path>[a-zA-Z0-9._-]+/)*(?P<filename>[a-zA-Z0-9._-]+[.]ss[ti])$`);
 // static insert_ssi_or_sst_fn      = ctRegex!(`^<<\s*[a-zA-Z0-9._-]+[.]ss[ti]`);
 #+END_SRC
-** header & comments
+** comments                                                         :comment:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
-/* header & comments */
+/* comments */
 static comment                   = ctRegex!(`^%+ `);
+#+END_SRC
+** header                                                            :header:
+#+name: ao_rgx
+#+BEGIN_SRC d                                                  :exports none
+/* header */
 static header                    = ctRegex!(`^@([a-z_]+):(?:\s|$)`);
 static header_make               = ctRegex!(`^@(make):(?:\s|$)`);
 static header_metadata           = ctRegex!(`^@([a-z_]+):(?:\s|$)`);
@@ -57,7 +63,7 @@ static header_sub                = ctRegex!(`^[ ]+:([a-z_]+):\s`);
 static head_main                 = ctRegex!(`^@([a-z_]+):\s*(.*)`, "m");
 static head_sub                  = ctRegex!(`^[ ]*:([a-z_]+):\s+(.+)`, "m");
 #+END_SRC
-** header & paragraph operators
+** header & paragraph operators                          :paragraph:operator:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* heading & paragraph operators */
@@ -73,7 +79,7 @@ static para_indent        = ctRegex!(`^_([1-9]) `);
 static para_indent_hang   = ctRegex!(`^_([0-9])_([0-9]) `);
 static para_attribs       = ctRegex!(`^_(([0-9])(_([0-9]))?|_([1-9])?[*]) `);
 #+END_SRC
-** blocked markup tics
+** blocked markup tics                                            :block:tic:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* blocked markup tics */
@@ -85,7 +91,7 @@ static block_tic_quote_open      = ctRegex!("^`{3} (quote)");
 static block_tic_table_open      = ctRegex!("^`{3} (table)");
 static block_tic_close           = ctRegex!("^(`{3})$","m");
 #+END_SRC
-** blocked markup curly
+** blocked markup curly                                         :block:curly:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* blocked markup curly */
@@ -102,7 +108,7 @@ static block_curly_quote_close   = ctRegex!(`^([}]quote)`);
 static block_curly_table_open    = ctRegex!(`^(table[{].*?$)`);
 static block_curly_table_close   = ctRegex!(`^([}]table)`);
 #+END_SRC
-** inline markup font face mod
+** inline markup font face mod                             :inline:font:face:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* inline markup font face mod */
@@ -115,7 +121,7 @@ static inline_strike             = ctRegex!(`-\{(?P<text>.+?)\}-`);
 static inline_insert             = ctRegex!(`\+\{(?P<text>.+?)\}\+`);
 static inline_mono               = ctRegex!(`#\{(?P<text>.+?)\}#`);
 #+END_SRC
-** inline markup footnotes
+** inline markup footnotes                                  :inline:footnote:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* inline markup footnotes */
@@ -146,7 +152,7 @@ static inline_text_and_note_square_sp        = ctRegex!(`(.+?)~\[[*+]+\s+(.+?)\]
 static inline_text_and_note_square           = ctRegex!(`(.+?)~\[\s*(.+?)\]~`, "mg");
 static inline_note_square_delimiters         = ctRegex!(`(~\[\s*)(.+?)(\]~)`, "mg");
 #+END_SRC
-** inline markup book index
+** inline markup book index                                :inline:bookindex:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* inline markup book index */
@@ -154,7 +160,7 @@ static book_index                = ctRegex!(`^=\{\s*(.+?)\}$`, "m");
 static book_index_open           = ctRegex!(`^=\{\s*([^}]+?)$`);
 static book_index_close          = ctRegex!(`^(.*?)\}$`, "m"); // strip
 #+END_SRC
-** no ocn object
+** no ocn object                                              :ocn:off:object:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* no ocn object */
@@ -162,7 +168,7 @@ static ocn_off                   = ctRegex!(`~#$`, "m");
 static ocn_off_dh                = ctRegex!(`-#$`, "m");
 static ocn_off_all               = ctRegex!(`[~-]#$`, "m");
 #+END_SRC
-** no ocn block
+** no ocn block                                               :ocn:off:block:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* no ocn block */
@@ -172,13 +178,13 @@ static ocn_off_block_close       = ctRegex!(`^--\+#$`);
 // static auto_ocn_ignore           = ctRegex!(`^[+~*$-]{3,}$`); // reminder
 static ocn_block_marks           = ctRegex!(`^--[+~-]#$`);
 #+END_SRC
-** ignore outside code blocks
+** ignore outside code blocks                                    :block:code:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* ignore outside code blocks */
 static regular_parse_skip        = ctRegex!(`^(--[+~-]#|-[\\]{2}-|=[.\\]{2}=)$`); // not structural info
 #+END_SRC
-** line & page breaks
+** line & page breaks                                                 :break:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* line & page breaks */
@@ -191,13 +197,13 @@ static break_string              = ctRegex!(`』`);
 // ancestry, parent
 static parent                    = ctRegex!(`([0-7]):([0-9]+)`);
 #+END_SRC
-** json
+** json                                                                :json:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* json */
 static tailing_comma             = ctRegex!(`,$`, "m");
 #+END_SRC
-** head
+** head                                                              :header:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* head */
@@ -213,14 +219,14 @@ static subhead_notes             = ctRegex!(`^(?:abstract|description)$`, "m");
 static subhead_publisher         = ctRegex!(`^(?:name)$`, "m");
 static subhead_make              = ctRegex!(`^(?:cover_image|home_button_image|home_button_text|footer|headings|num_top|breaks|substitute|bold|italics|emphasis|texpdf_font|css)$`, "m");
 #+END_SRC
-** biblio tags
+** biblio tags                                                  :biblio:tags:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* biblio tags */
 static biblio_tags               = ctRegex!(`^(is|au|author_raw|author|author_arr|editor_raw|ed|editor_arr|ti|title|subtitle|fulltitle|lng|language|trans|src|jo|journal|in|vol|volume|edn|edition|yr|year|pl|place|pb|pub|publisher|url|pg|pages|note|short_name|id):\s+(.+)`);
 static biblio_abbreviations      = ctRegex!(`^(au|ed|ti|lng|jo|vol|edn|yr|pl|pb|pub|pg|pgs|sn)$`);
 #+END_SRC
-** bookindex split
+** bookindex split                                          :bookindex:split:
 #+name: ao_rgx
 #+BEGIN_SRC d                                                  :exports none
 /* bookindex split */
@@ -229,7 +235,7 @@ static bi_main_term_plus_rest_split = ctRegex!(`\s*:\s*`);
 static bi_sub_terms_plus_ocn_offset_split = ctRegex!(`\s*\|\s*`);
 static bi_term_and_ocns_match    = ctRegex!(`^(.+?)\+(\d+)`);
 #+END_SRC
-* tangles
+* tangles                                                            :tangle:
 ** code structure:                                                   :ao_rgx.d:
 #+name: tangle_ao_rgx
 #+BEGIN_SRC d :tangle ../lib/sdp/ao_rgx.d :padline no :exports none :noweb yes
diff --git a/org/ao_scan_inserts.org b/org/ao_scan_inserts.org
index 8aaf377..f595ea5 100644
--- a/org/ao_scan_inserts.org
+++ b/org/ao_scan_inserts.org
@@ -1,4 +1,4 @@
-#+TITLE: Emacs config file written in org-mode
+#+TITLE: sdp scan inserts
 #+AUTHOR: Ralph Amissah
 #+EMAIL: ralph.amissah@gmail.com
 #+STARTUP: indent
@@ -9,11 +9,13 @@
 #+OPTIONS: ^:nil _:nil
 #+EXPORT_SELECT_TAGS: export
 #+EXPORT_EXCLUDE_TAGS: noexport
-#+TAGS: Amissah(A) Class(c) WEB(W) noexport(n)
 #+FILETAGS: :sdp:ao:
+#+TAGS: assert(a) class(c) debug(d) mixin(m) sdp(s) tangle(T) template(t) WEB(W) noexport(n)
 
-* inserts
-** scan inserts (sub-document) source
+* inserts                                                           :inserts:
+[[./sdp.org][sdp]]
+
+** scan inserts (sub-document) source                       :scan_insert_src:
 *** scan subdoc source
 #+name: ao_inserts_scan
 #+BEGIN_SRC d                                                  :exports none
@@ -100,8 +102,8 @@ if (ft1["curly_code"] == 1) {
       markup_sourcesubfile_insert_content.length
     );
   }
-    auto ins = new Inserts();
-  /*
+  auto ins = new Inserts();
+  /+
     1. load file,
     2. read lines;
     3. scan lines,
@@ -109,7 +111,7 @@ if (ft1["curly_code"] == 1) {
     5.   repeat 1
     6. else
     7.   add line to new array;
-  */
+  +/
 } else {
   ft1["header_make"] = 0;
   ft1["header_metadata"] = 0;
@@ -124,7 +126,8 @@ auto contents_ = cont_arbitrary_max_length_set_[0 .. counter["add"]].dup;
 auto t = tuple(contents_, add);
 return t;
 #+END_SRC
-** scan document source
+
+** scan document source                                            :scan_src:
 *** scan doc source
 #+name: ao_doc_scan
 #+BEGIN_SRC d                                                  :exports none
@@ -214,16 +217,16 @@ if (ft["curly_code"] == 1) {
       markup_sourcefile_insert_content.length
     );
   }
-    auto ins = new Inserts();
-    auto t = ins.scan_subdoc_source(
-      markup_sourcefile_insert_content, to!string(fn_src_insert), add
-    );
-    static assert(!isTypeTuple!(t));
-    auto tmparr = t[0];
-    auto addsub = t[1];
-    cont_arbitrary_max_length_set[add .. addsub-1] = tmparr[0 .. $-1];
-    add=addsub;
-  /*
+  auto ins = new Inserts();
+  auto t = ins.scan_subdoc_source(
+    markup_sourcefile_insert_content, to!string(fn_src_insert), add
+  );
+  static assert(!isTypeTuple!(t));
+  auto tmparr = t[0];
+  auto addsub = t[1];
+  cont_arbitrary_max_length_set[add .. addsub-1] = tmparr[0 .. $-1];
+  add=addsub;
+  /+
     1. load file,
     2. read lines;
     3. scan lines,
@@ -231,7 +234,7 @@ if (ft["curly_code"] == 1) {
     5.   repeat 1
     6. else
     7.   add line to new array;
-  ,*/
+  +/
 } else {
   ft["header_make"] = 0;
   ft["header_metadata"] = 0;
@@ -251,14 +254,14 @@ debug(insert) {                              // insert file
 return contents;
 #+END_SRC
 
-* tangles
+* tangles                                                            :tangle:
 ** code structure:                                                 :ao_inserts.d:
 #+name: tangle_ao_inserts
 #+BEGIN_SRC d :tangle ../lib/sdp/ao_scan_inserts.d :padline no :exports none :noweb yes
-/*
+/+
   inserts
   ao_inserts.d
-*/
++/
 mixin template SiSUdocInserts() {
   class Inserts {
     auto scan_subdoc_source(
diff --git a/org/ao_utils.org b/org/ao_utils.org
index 2c3e342..1cc3313 100644
--- a/org/ao_utils.org
+++ b/org/ao_utils.org
@@ -1,4 +1,4 @@
-#+TITLE: Emacs config file written in org-mode
+#+TITLE: sdp utils
 #+AUTHOR: Ralph Amissah
 #+EMAIL: ralph.amissah@gmail.com
 #+STARTUP: indent
@@ -9,10 +9,12 @@
 #+OPTIONS: ^:nil _:nil#+OPTIONS: ^:nil _:nil
 #+EXPORT_SELECT_TAGS: export
 #+EXPORT_EXCLUDE_TAGS: noexport
-#+TAGS: Amissah(A) Class(c) WEB(W) noexport(n)
+#+FILETAGS: :sdp:ao:
+#+TAGS: assert(a) class(c) debug(d) mixin(m) sdp(s) tangle(T) template(t) WEB(W) noexport(n)
 
-* utils
-** set colors for terminal
+* utils                                                               :utils:
+[[./sdp.org][sdp]]
+** set colors for terminal                                  :colors:terminal:
 #+name: ao_utils
 #+BEGIN_SRC d                                                  :exports none
 string[string] scr_txt_color = [
@@ -85,7 +87,20 @@ string[string] scr_txt_marker = [
 ];
 #+END_SRC
 
-* tangles
+* code snippets, use as needed                           :code:snippet:debug:
+** called from
+#+BEGIN_SRC d  :tangle no                                      :exports none
+string functionName = __FUNCTION__,
+string file = __FILE__,
+size_t line = __LINE__) {
+writefln("Called from function %s at file %s, line %s",
+  functionName, file, line);
+#+END_SRC      :tangle no
+#+BEGIN_SRC d                                                  :exports none
+writefln("Inside function %s at file %s, line %s",
+  __FUNCTION__, __FILE__, __LINE__);
+#+END_SRC
+* tangles                                                            :tangle:
 ** code structure:                                                   :ao_util.d:
 #+name: tangle_ao_utils
 #+BEGIN_SRC d :tangle ../lib/sdp/ao_utils.d :padline no :exports none :noweb yes
diff --git a/org/sdp.org b/org/sdp.org
index 70b68f5..885f022 100644
--- a/org/sdp.org
+++ b/org/sdp.org
@@ -1,4 +1,4 @@
-#+TITLE: Emacs config file written in org-mode
+#+TITLE: sdp hub
 #+AUTHOR: Ralph Amissah
 #+EMAIL: ralph.amissah@gmail.com
 #+STARTUP: indent
@@ -9,48 +9,62 @@
 #+OPTIONS: ^:nil _:nil
 #+EXPORT_SELECT_TAGS: export
 #+EXPORT_EXCLUDE_TAGS: noexport
-#+TAGS: Amissah(A) Class(c) WEB(W) noexport(n)
-#+FILETAGS: :sdp:
+#+FILETAGS: :sdp:hub:
+#+TAGS: assert(a) class(c) debug(d) mixin(m) sdp(s) tangle(T) template(t) WEB(W) noexport(n)
 
-* sdp.d                                                             :sdp.d:
+* sdp.d   sisu document parser                                       :sdp.d:
+[[../maker.org][maker.org makefile]]
 Deal with imports.
 Take command line instructions and process files as instructed.
-** imports
+
+** imports                                                           :import:
+[[./ao_abstract_doc_source.org][ao_abstract_doc_source]]
+[[./ao_assertions.org][ao_assertions]]
+[[./ao_defaults.org][ao_defaults]]
+[[./ao_emitters_and_interfaces.org][ao_emitters_and_interfaces: ao_emitter; ao_interface]]
+[[./ao_markup_source_raw.org][ao_markup_source_raw]]
+[[./ao_object_setter.org][ao_object_setter]]
+[[./ao_output_debugs.org][ao_output_debugs]]
+[[./ao_rgx.org][ao_rgx]]
+[[./ao_scan_inserts.org][ao_scan_inserts]]
+[[./ao_utils.org][ao_utils]]
+
 #+name: sdp_imports
 #+BEGIN_SRC d                                                  :exports none
+/+ sdp  sisu document parser +/
 import
-  std.stdio,
+  std.algorithm,
+  std.array,
+  std.container,
   std.file,
   std.exception,
-  // std.path,
-  std.regex,
-  std.utf,
-  std.string,
-  std.array,
   std.json,
+  // std.path,
   std.process,
-  std.typecons,
-  std.algorithm,
   std.range,
-  std.container,
+  std.regex,
+  std.stdio,
+  std.string,
   std.traits,
+  std.typecons,
+  std.utf,
   // std.variant,
-  lib.sdp.ao_output_debugs,        // sdp/ao_output_debugs.d       ao_output_debugs.org
-  lib.sdp.ao_defaults,             // sdp/ao_defaults.d            ao_defaults.arg
-  lib.sdp.ao_rgx,                  // sdp/ao_rgx.d                 ao_rgx.org
-  lib.sdp.ao_interface,            // sdp/ao_interface.d           ao_interface.arg
-  lib.sdp.ao_emitter,              // sdp/ao_emitter.d             ao_emitter.org
-  lib.sdp.ao_scan_inserts,         // sdp/ao_scan_inserts.d        ao_scan_inserts.org
-  lib.sdp.ao_markup_source_raw,    // sdp/ao_markup_source_raw.d   ao_markup_source_raw.org
-  lib.sdp.ao_abstract_doc_source,  // sdp/ao_abstract_doc_source.d ao_abstract_doc_source.org
-  lib.sdp.ao_assertions,           // sdp/ao_assertions.d          ao_assertions.org
-  lib.sdp.ao_object_setter,        // sdp/ao_object_setter.d       ao_object_setter.org
-  lib.sdp.ao_utils;                // sdp/ao_utils.d               ao_utils.org
+  lib.sdp.ao_abstract_doc_source,       // sdp/ao_abstract_doc_source.d
+  lib.sdp.ao_assertions,                // sdp/ao_assertions.d
+  lib.sdp.ao_defaults,                  // sdp/ao_defaults.d
+  lib.sdp.ao_emitter,                   // sdp/ao_emitter.d
+  lib.sdp.ao_interface,                 // sdp/ao_interface.d
+  lib.sdp.ao_markup_source_raw,         // sdp/ao_markup_source_raw.d
+  lib.sdp.ao_object_setter,             // sdp/ao_object_setter.d
+  lib.sdp.ao_output_debugs,             // sdp/ao_output_debugs.d
+  lib.sdp.ao_rgx,                       // sdp/ao_rgx.d
+  lib.sdp.ao_scan_inserts,              // sdp/ao_scan_inserts.d
+  lib.sdp.ao_utils;                     // sdp/ao_utils.d
   // std.conv;
 import std.conv : to;
 #+END_SRC
-** argv [+3]
-*** argv mixins
+** argv [+3]                                                           :argv:
+*** argv mixins & init
 #+name: sdp_argv
 #+BEGIN_SRC d                                                  :exports none
 mixin SiSUheader;
@@ -115,9 +129,9 @@ foreach(cmdlnins; argv) {
   }
 }
 #+END_SRC
-*** each file [+2]
+*** each file [+2]                                                     :file:
 **** filename provided [+1]
-***** scope
+***** scope                                                           :scope:
 #+name: sdp_each_file_do
 #+BEGIN_SRC d                                                  :exports none
 scope(success) {
@@ -147,7 +161,9 @@ enforce(
   "not a sisu markup filename"
 );
 #+END_SRC
-***** send for processing
+***** read file                                                   :file:read:
+[[./ao_markup_source_raw.org][ao_markup_source_raw]]
+
 #+name: sdp_each_file_do
 #+BEGIN_SRC d                                                  :exports none
 auto markup_sourcefile_content =
@@ -163,8 +179,14 @@ debug(insert) {
   writeln("markup source file path: ", markup_src_file_path); // writeln(m.captures[1]);
   writeln(m.captures[2]);
 }
+#+END_SRC
+****** incorporate any inserts
+[[./ao_scan_inserts.org][ao_scan_inserts]]
+
+#+name: sdp_each_file_do
+#+BEGIN_SRC d                                                  :exports none
 if (match(fn_src, rgx.src_fn_master)) {
-/* if master file scan document source for document imports (inserted sub-documents) */
+/+ if master file scan document source for document imports (inserted sub-documents) +/
   auto ins = new Inserts();
   auto markup_master_sourcefile_content =
     ins.scan_doc_source(markup_sourcefile_content, fn_src);
@@ -179,7 +201,11 @@ debug(raw) {
     writeln(line);
   }
 }
-/* process document ao_abstract_doc_source SiSUdocAbstraction::Abstraction return abstraction as tuple */
+#+END_SRC
+***** send for processing                                        :processing:
+#+name: sdp_each_file_do
+#+BEGIN_SRC d                                                  :exports none
+/+ process document ao_abstract_doc_source SiSUdocAbstraction::Abstraction return abstraction as tuple +/
 auto t =
   abs.abstract_doc_source(msc);
 static assert(!isTypeTuple!(t));