minor cleaning

4 files changed, 128 insertions, 128 deletions

diff --git a/org/ao_abstract_doc_source.org b/org/ao_abstract_doc_source.org
index e413570..897a3b7 100644
--- a/org/ao_abstract_doc_source.org
+++ b/org/ao_abstract_doc_source.org
@@ -14,7 +14,7 @@
 
 [[./sdp.org][sdp]]  [[./][org/]]
 * 0. Code Skeleton / Outline / Structure (tangles)           :tangle:io:file:
-** 1. ao abstract doc source:                         :ao_abstract_doc_source.d:
+** 1. ao abstract doc source:                       :ao_abstract_doc_source:
 
 #+BEGIN_SRC d :tangle ../src/sdp/ao_abstract_doc_source.d
 /++
@@ -128,7 +128,7 @@ template SiSUdocAbstraction() {
 } /+ ← closed: template SiSUdocAbstraction +/
 #+END_SRC
 
-** 2. ao object setter:                                     :ao_object_setter.d:
+** 2. ao object setter:                                   :ao_object_setter:
 
 #+BEGIN_SRC d :tangle ../src/sdp/ao_object_setter.d
 /++
@@ -145,8 +145,8 @@ template ObjectSetter() {
 * 1. Document Abstraction                                  :abstract:process:
 Process markup document, create document abstraction.
 
-** _1. pre loop processing_                                               :pre:
-*** imports                                                         :imports:
+** _1. pre loop processing_                                              :pre:
+*** imports                                                       :imports:
 
 [[./ao_defaults.org][ao_defaults]]
 
@@ -158,7 +158,7 @@ import
   ao_rgx;                       // sdp/ao_rgx.d
 #+END_SRC
 
-*** mixins                                                           :mixins:
+*** mixins                                                         :mixins:
 
 #+name: abs_mixins
 #+BEGIN_SRC d
@@ -166,7 +166,7 @@ mixin ObjectSetter;
 mixin InternalMarkup;
 #+END_SRC
 
-*** initialize                                                   :initialize:
+*** initialize                                                 :initialize:
 
 #+name: abs_init_struct
 #+BEGIN_SRC d
@@ -483,8 +483,8 @@ auto munge = ObjInlineMarkupMunge();
 string[][string] lev4_subtoc;
 #+END_SRC
 
-** _2. loop: process document body_ [+6]                                 :loop:
-*** loop scope                                                        :scope:
+** _2. loop: process document body_ [+6]                                :loop:
+*** loop scope                                                      :scope:
 
 #+name: abs_in_loop_body_00
 #+BEGIN_SRC d
@@ -515,7 +515,7 @@ debug(srclines) {
 }
 #+END_SRC
 
-*** check whether obj_cite_number is on or turned off                   :ocn:
+*** check whether obj_cite_number is on or turned off                 :ocn:
 
 #+name: abs_in_loop_body_00
 #+BEGIN_SRC d
@@ -525,7 +525,7 @@ if (!line.empty) {
 #+END_SRC
 
 *** [#A] separate regular markup text from code blocks [+5]
-**** code blocks                                                 :block:code:
+**** code blocks                                              :block:code:
 
 #+name: abs_in_loop_body_00_code_block
 #+BEGIN_SRC d
@@ -534,9 +534,9 @@ _code_block_(line, an_object, type);
 continue;
 #+END_SRC
 
-**** non code objects (other blocks or regular text) [+4]          :non_code:
-***** in section (biblio, glossary, blurb) (block group) [+1]  :block:active:
-****** within section: biblio                                        :biblio:
+**** non code objects (other blocks or regular text) [+4]       :non_code:
+***** in section (biblio, glossary, blurb) (block group) [+1] :block:active:
+****** within section: biblio                                   :biblio:
 
 #+name: abs_in_loop_body_non_code_obj
 #+BEGIN_SRC d
@@ -559,7 +559,7 @@ if ((matchFirst(line, rgx.heading_biblio)
   continue;
 #+END_SRC
 
-****** within section: glossary                                    :glossary:
+****** within section: glossary                               :glossary:
 
 if there is a glossary section you need to:
 - extract it
@@ -643,7 +643,7 @@ if there is a glossary section you need to:
   continue;
 #+END_SRC
 
-****** within section: blurb                                          :blurb:
+****** within section: blurb                                     :blurb:
 
 if there is a blurb section you need to:
 - extract it
@@ -741,8 +741,8 @@ if there is a blurb section you need to:
   continue;
 #+END_SRC
 
-***** in blocks [+1]                                           :block:active:
-****** within block: poem                                              :poem:
+***** in blocks [+1]                                       :block:active:
+****** within block: poem                                         :poem:
 
 #+name: abs_in_loop_body_non_code_obj
 #+BEGIN_SRC d
@@ -752,7 +752,7 @@ if there is a blurb section you need to:
   continue;
 #+END_SRC
 
-****** within block: group                                            :group:
+****** within block: group                                       :group:
 
 #+name: abs_in_loop_body_non_code_obj
 #+BEGIN_SRC d
@@ -763,7 +763,7 @@ if there is a blurb section you need to:
   continue;
 #+END_SRC
 
-****** within block: block                                            :block:
+****** within block: block                                       :block:
 
 #+name: abs_in_loop_body_non_code_obj
 #+BEGIN_SRC d
@@ -773,7 +773,7 @@ if there is a blurb section you need to:
   continue;
 #+END_SRC
 
-****** within block: quote                                            :quote:
+****** within block: quote                                       :quote:
 
 #+name: abs_in_loop_body_non_code_obj
 #+BEGIN_SRC d
@@ -783,7 +783,7 @@ if there is a blurb section you need to:
   continue;
 #+END_SRC
 
-****** within block: table                                            :table:
+****** within block: table                                       :table:
 
 #+name: abs_in_loop_body_non_code_obj
 #+BEGIN_SRC d
@@ -821,7 +821,7 @@ continue;
 #+END_SRC
 
 ****** line not empty [+2]
-******* asserts                                                      :assert:
+******* asserts                                                :assert:
 
 #+name: abs_in_loop_body_not_block_obj
 #+BEGIN_SRC d
@@ -848,7 +848,7 @@ if (type["blocks"] == TriState.closing) {
 }
 #+END_SRC
 
-******* book index                                                :bookindex:
+******* book index                                          :bookindex:
 
 #+name: abs_in_loop_body_not_block_obj
 #+BEGIN_SRC d
@@ -867,7 +867,7 @@ if ((matchFirst(line, rgx.book_index))
   /+ not book_index +/
 #+END_SRC
 
-******** matched: comment                                     :comment:match:
+******** matched: comment                              :comment:match:
 
 #+name: abs_in_loop_body_not_block_obj
 #+BEGIN_SRC d
@@ -889,7 +889,7 @@ if ((matchFirst(line, rgx.book_index))
     ++cntr;
 #+END_SRC
 
-******** flag not set & line not exist: heading or para   :heading:paragraph:
+******** flag not set & line not exist: heading or para :heading:paragraph:
 
 #+name: abs_in_loop_body_not_block_obj
 #+BEGIN_SRC d
@@ -928,7 +928,7 @@ if ((matchFirst(line, rgx.book_index))
     }
 #+END_SRC
 
-******** line exist: heading                                        :heading:
+******** line exist: heading                                 :heading:
 
 #+name: abs_in_loop_body_not_block_obj
 #+BEGIN_SRC d
@@ -941,7 +941,7 @@ if ((matchFirst(line, rgx.book_index))
     ++line_occur["heading"];
 #+END_SRC
 
-******** line exist: para                                              :para:
+******** line exist: para                                       :para:
 
 #+name: abs_in_loop_body_not_block_obj
 #+BEGIN_SRC d
@@ -976,7 +976,7 @@ _block_flag_line_empty_(
 
 ****** line empty [+1]
 
-******* assert line empty                                            :assert:
+******* assert line empty                                      :assert:
 
 #+name: abs_in_loop_body_not_block_obj_line_empty
 #+BEGIN_SRC d
@@ -990,7 +990,7 @@ assert(
 );
 #+END_SRC
 
-******* heading object                                       :heading:object:
+******* heading object                                 :heading:object:
 
 #+name: abs_in_loop_body_not_block_obj_line_empty
 #+BEGIN_SRC d
@@ -1065,7 +1065,7 @@ if ((type["heading"] == State.on)
   ++cntr;
 #+END_SRC
 
-******* paragraph object                                   :paragraph:object:
+******* paragraph object                             :paragraph:object:
 
 #+name: abs_in_loop_body_not_block_obj_line_empty
 #+BEGIN_SRC d
@@ -1121,7 +1121,7 @@ if ((type["heading"] == State.on)
 
 *** close non code objects (regular text)
 
-*** regular text objects                                     :text:paragraph:
+*** regular text objects                                   :text:paragraph:
 
 #+name: abs_in_loop_body_01
 #+BEGIN_SRC d
@@ -1154,7 +1154,7 @@ if (the_document_body_section.length > 0) {
 }
 #+END_SRC
 
-** _3. post loop processing_                                             :post:
+** _3. post main-loop processing_                                       :post:
 *** misc
 
 #+name: abs_post
@@ -1175,7 +1175,7 @@ debug(objectrelated2) { // check
 #+END_SRC
 
 *** tie up preparation of document sections
-**** endnotes section (scroll & seg)                               :endnotes:
+**** endnotes section (scroll & seg)                            :endnotes:
 
 #+name: abs_post
 #+BEGIN_SRC d
@@ -1196,7 +1196,7 @@ debug(endnotes) {
 }
 #+END_SRC
 
-**** no glossary section?                                          :glossary:
+**** no glossary section?                                       :glossary:
 
 #+name: abs_post
 #+BEGIN_SRC d
@@ -1224,7 +1224,7 @@ debug(glossary) {
 }
 #+END_SRC
 
-**** bibliography section (objects)                            :bibliography:
+**** bibliography section (objects)                         :bibliography:
 
 #+name: abs_post
 #+BEGIN_SRC d
@@ -1360,7 +1360,7 @@ auto biblio_entry_tags_jsonstr =  `{
   "id"                               : ""
 }`; // is: book, article, magazine, newspaper, blog, other
 
-**** bookindex section (scroll & seg)                            :book:index:
+**** bookindex section (scroll & seg)                         :book:index:
 
 #+name: abs_post
 #+BEGIN_SRC d
@@ -1382,7 +1382,7 @@ debug(bookindex) {                         // bookindex
 }
 #+END_SRC
 
-**** no blurb section?                                                :blurb:
+**** no blurb section?                                             :blurb:
 
 #+name: abs_post
 #+BEGIN_SRC d
@@ -1411,7 +1411,7 @@ debug(blurb) {
 }
 #+END_SRC
 
-**** toc backmatter, table of contents backmatter (scroll & seg)   :contents:
+**** toc backmatter, table of contents backmatter (scroll & seg) :contents:
 
 #+name: abs_post
 #+BEGIN_SRC d
@@ -1548,7 +1548,8 @@ the_document_head_section ~= the_document_body_section[0];
 the_document_body_section=the_document_body_section[1..$];
 #+END_SRC
 
-**** loop: backmatter loop up to lev4: html_segnames, set backmatter pointers
+*** TODO minor loops                                                 :post:
+**** 1. loop: backmatter loop up to lev4: html_segnames, set backmatter pointers
 
 could optimise by
 - skipping second and third pass unless the output html seg or epub is being made!
@@ -1623,7 +1624,7 @@ if (the_blurb_section.length > 1) {
 }
 #+END_SRC
 
-**** [#A] loop: all objects structural relationships (sections, segments, objects)
+**** 2. loop: all objects structural relationships (sections, segments, objects)
 
 needed for DOM structure, segnames & subtoc, backmatter pointers
 
@@ -1911,7 +1912,8 @@ if (the_blurb_section.length > 1) {
 }
 #+END_SRC
 
-*** [#B] the document                                              :document:
+** _4. return document tuple_                                           :post:
+*** the document                                                 :document:
 
 #+name: abs_post
 #+BEGIN_SRC d
@@ -1946,7 +1948,7 @@ destroy(the_bookindex_section);
 destroy(the_blurb_section);
 #+END_SRC
 
-*** [#A] return document tuple                                 :return:tuple:
+*** _return document tuple_                                    :return:tuple:
 
 #+name: abs_post
 #+BEGIN_SRC d
@@ -1957,7 +1959,7 @@ auto t = tuple(
 return t;
 #+END_SRC
 
-** 4. Functions                                           :abstract:function:
+** 5. Functions                                          :abstract:function:
 
 functions used in document abstraction
 
@@ -2255,7 +2257,6 @@ void _code_block_(
 #+END_SRC
 
 ***** biblio block                                               :biblio:
-
 ****** biblio tag map
 
 #+name: abs_functions_block_biblio
@@ -3054,7 +3055,7 @@ void _block_flag_line_empty_(
 }
 #+END_SRC
 
-*** book index                                                     :bookindex:
+*** book index                                                  :bookindex:
 
 #+name: abs_functions_book_index
 #+BEGIN_SRC d
@@ -3200,7 +3201,7 @@ auto _heading_found_(
 }
 #+END_SRC
 
-**** TODO heading make set                                          :heading:
+**** TODO heading make set                                       :heading:
 
 #+name: abs_functions_heading
 #+BEGIN_SRC d
@@ -3262,7 +3263,7 @@ auto _heading_make_set_(
 }
 #+END_SRC
 
-**** heading match                                                   :heading:
+**** heading match                                               :heading:
 
 #+name: abs_functions_heading
 #+BEGIN_SRC d
@@ -3489,7 +3490,7 @@ struct OCNemitter {
 }
 #+END_SRC
 
-***** object inline markup munge                               :markup:inline:
+***** object inline markup munge                          :markup:inline:
 
 #+name: ao_emitters_obj_inline_markup_munge
 #+BEGIN_SRC d
@@ -3724,7 +3725,7 @@ struct ObjInlineMarkupMunge {
 }
 #+END_SRC
 
-***** toc, tags, object inline markup                         :markup:inline:
+***** toc, tags, object inline markup                     :markup:inline:
 ****** open
 
 #+name: ao_emitters_obj_inline_markup
@@ -3734,7 +3735,7 @@ struct ObjInlineMarkup {
   string[string] obj_txt;
 #+END_SRC
 
-****** object inline markup and anchor tags                    :markup:inline:
+****** object inline markup and anchor tags              :markup:inline:
 
 #+name: ao_emitters_obj_inline_markup_and_anchor_tags
 #+BEGIN_SRC d
@@ -3805,7 +3806,7 @@ struct ObjInlineMarkup {
   }
 #+END_SRC
 
-****** toc, table of contents build, gather headings          :markup:inline:
+****** toc, table of contents build, gather headings     :markup:inline:
 
 #+name: ao_emitters_obj_inline_markup_table_of_contents
 #+BEGIN_SRC d
@@ -4181,7 +4182,7 @@ private:
 }
 #+END_SRC
 
-***** object attrib                                               :attributes:
+***** object attrib                                          :attributes:
 ****** attributes structure open, public
 
 #+name: ao_emitters_obj_attributes
@@ -4481,8 +4482,8 @@ struct ObjAttributes {
 }
 #+END_SRC
 
-**** book index                                                   :book:index:
-***** book index nugget hash                                     :hash:nugget:
+**** book index                                               :book:index:
+***** book index nugget hash                                :hash:nugget:
 
 #+name: ao_emitters_book_index_nugget
 #+BEGIN_SRC d
@@ -4561,7 +4562,7 @@ struct BookIndexNuggetHash {
 }
 #+END_SRC
 
-***** book index (sort &) report indented                    :report:indented:
+***** book index (sort &) report indented               :report:indented:
 
 #+name: ao_emitters_book_index_report_indented
 #+BEGIN_SRC d
@@ -4593,7 +4594,7 @@ struct BookIndexReportIndent {
 }
 #+END_SRC
 
-***** book index (sort &) report section                      :report:section:
+***** book index (sort &) report section                 :report:section:
 ****** book index struct open
 
 #+name: ao_emitters_book_index_report_section
@@ -4636,7 +4637,7 @@ struct BookIndexReportSection {
   }
 #+END_SRC
 
-****** book index (sort &) build section                      :report:section:
+****** book index (sort &) build section                :report:section:
 
 #+name: ao_emitters_book_index_report_section
 #+BEGIN_SRC d
@@ -4779,7 +4780,7 @@ struct BookIndexReportSection {
 }
 #+END_SRC
 
-**** (end)notes section                                     :endnotes:section:
+**** (end)notes section                                 :endnotes:section:
 
 #+name: ao_emitters_endnotes
 #+BEGIN_SRC d
@@ -4966,7 +4967,7 @@ struct NotesSection {
 }
 #+END_SRC
 
-**** bibliography                                               :bibliography:
+**** bibliography                                           :bibliography:
 ***** biblio struct open
 
 #+name: ao_emitters_bibliography
@@ -5083,7 +5084,7 @@ struct Bibliography {
 }
 #+END_SRC
 
-**** node structure metadata                         :structure:metadata:node:
+**** node structure metadata                     :structure:metadata:node:
 ***** metadata node struct open
 
 #+name: ao_emitters_metadata
@@ -5336,8 +5337,8 @@ struct NodeStructureMetadata {
 }
 #+END_SRC
 
-*** function assertions                                           :assertions:
-**** mixin template: assertions on markup document structure   :doc_structure:
+*** function assertions                                        :assertions:
+**** mixin template: assertions on markup document structure :doc_structure:
 
 #+name: abs_functions_assertions
 #+BEGIN_SRC d
@@ -5518,7 +5519,7 @@ auto assertions_doc_structure(
 }
 #+END_SRC
 
-**** mixin template: assertions on blocks                             :blocks:
+**** mixin template: assertions on blocks                         :blocks:
 
 #+name: abs_functions_assertions
 #+BEGIN_SRC d
@@ -5550,7 +5551,7 @@ auto assertions_flag_types_block_status_none_or_closed(int[string] type) {
 
 set abstracted objects for downstream processing
 
-** initialize structs                                                :struct:
+** initialize structs                                               :struct:
 *** heading attribute
 
 #+name: ao_structs_init
diff --git a/org/ao_read_source_files.org b/org/ao_read_source_files.org
index 1ab28bf..703ae9e 100644
--- a/org/ao_read_source_files.org
+++ b/org/ao_read_source_files.org
@@ -153,10 +153,6 @@ template SiSUmarkupRaw() {
 }
 #+END_SRC
 
-INSERTS?
-[[./ao_scan_inserts.org][ao_scan_inserts]]
-WORK AREA
-
 * 1. get config file                                                 :config:
 ** read config file, source string (conf.sdl & sisu_document_make) :file:config:
 
@@ -467,7 +463,7 @@ auto markup_src_file_path = fn_pth_full.captures[1];
 string[] insert_file_list =[];
 #+END_SRC
 
-**** loop master scan for inserts (insert documents)
+**** include inserts: _loop master_ scan for inserts (insert documents)
 
 #+name: ao_master_doc_scan_for_insert_filenames_loop
 #+BEGIN_SRC d
diff --git a/org/output.org b/org/output.org
index 6292faa..45cb791 100644
--- a/org/output.org
+++ b/org/output.org
@@ -151,7 +151,7 @@ template SiSUoutputEPub() {
 #+END_SRC
 
 * output functions                                                   :output:
-** sisupod                                                          :sisupod:
+** sisupod                                                         :sisupod:
 *** TODO output files
 
 #+name: source_sisupod_config
@@ -194,9 +194,9 @@ void sisupod_assemble(
 }
 #+END_SRC
 
-** text [#C]                                                           :text:
+** text [#C]                                                          :text:
 ** xml offspring (xhtml html epub)
-*** format xhtml objects                                            :format:
+*** format xhtml objects                                           :format:
 **** misc
 ***** anchor tags
 
@@ -514,7 +514,7 @@ auto endnote(O)(
     }
 #+END_SRC
 
-*** html output [#A]                                                   :html:
+*** html output [#A]                                                 :html:
 **** scroll                                                       :scroll:
 ***** output file
 
@@ -2155,7 +2155,7 @@ auto css_write() {
 }
 #+END_SRC
 
-*** epub [#B]                                                          :epub:
+*** epub [#B]                                                        :epub:
 **** epub special files                                           :format:
 ***** fixed
 ****** mimetype (file)
@@ -2187,7 +2187,7 @@ string epub_container_xml() {
 }
 #+END_SRC
 
-***** TODO constructs (in OEBPS)
+***** constructs (in OEBPS)
 ****** TODO OEBPS/content.opf (register content: files, images etc.)
 
 #+name: output_epub_constructs
@@ -2502,7 +2502,7 @@ void doc_content(C,T)(
 }
 #+END_SRC
 
-**** TODO output files
+**** output files
 
 #+name: output_epub_xhtml_seg
 #+BEGIN_SRC d
@@ -2551,10 +2551,10 @@ void epub_write_output_files(
 }
 #+END_SRC
 
-** pdf [#C]                                                             :pdf:
-** odt                                                                  :odt:
-** sqlite [#B]                                                       :sqlite:
-** pgsql                                                              :pgsql:
+** pdf [#C]                                                            :pdf:
+** odt                                                                 :odt:
+** sqlite [#B]                                                      :sqlite:
+** pgsql                                                             :pgsql:
 * +other+
 ** example head
 
diff --git a/org/sdp.org b/org/sdp.org
index c6d0ad1..9e38ed7 100644
--- a/org/sdp.org
+++ b/org/sdp.org
@@ -14,7 +14,7 @@
 
 [[../maker.org][maker.org makefile]]  [[./][org/]]
 * 0. Code Skeleton / Outline / Structure (tangles)                   :tangle:
-** TODO version.txt: set version (sisu document parser)             :version:
+** TODO version.txt: set version (sisu document parser)            :version:
 
 #+NAME: version_txt
 #+BEGIN_SRC d  :tangle ../views/version.txt
@@ -27,7 +27,7 @@ struct Version {
 enum ver = Version(0, 11, 0);
 #+END_SRC
 
-** TODO sdp src/sdp.d                                               :sdp.d:
+** sdp src/sdp.d                                                       :sdp:
 
 #+BEGIN_SRC d  :tangle ../src/sdp.d :shebang #!/usr/bin/env rdmd
 /+
@@ -37,8 +37,8 @@ enum ver = Version(0, 11, 0);
 <<imports_sdlang>>
 <<imports_std>>
 <<sdp_output_selection>>
-<<sdp_version_mixin>>
-<<std_mixins>>
+<<mixin_sdp_version>>
+<<mixin_pre_main>>
 /++ A SiSU document parser writen in D. +/
 void main(string[] args) {
   <<sdp_mixin>>
@@ -68,7 +68,7 @@ unittest {
 }
 #+END_SRC
 
-* sdp.d   sisu document parser                                       :sdp.d:
+* 1. sdp.d (sisu document parser)                                       :sdp:
 
 - deal with imports
 - get options
@@ -79,9 +79,10 @@ unittest {
   - proess file
   - output
 
-** pre loop init                                                       :init:
-*** imports                                                          :import:
-**** sdp                                                         :import:sdp:
+** 0. pre-loop init                                                   :init:
+*** init
+**** imports                                                      :import:
+***** sdp                                                           :sdp:
 
 #+NAME: imports_sdp
 #+BEGIN_SRC d
@@ -104,7 +105,7 @@ import
   source_sisupod;
 #+END_SRC
 
-***** notes
+****** notes
 ├── src
 │   ├── sdp.d
 │   └── sdp
@@ -114,20 +115,16 @@ import
 └── views
     └── version.txt
 
-[[./compile_time_info.org][compile time info]]
 [[./ao_abstract_doc_source.org][ao_abstract_doc_source]]
-[[./ao_conf_make_meta.org][ao_onf_make_meta]]
-[[./ao_conf_make_meta_native.org][ao_onf_make_meta_native]]
-[[./ao_conf_make_meta_sdlang.org][ao_onf_make_meta_sdlang]]
+[[./ao_conf_make_meta.org][ao_conf_make_meta]]
 [[./ao_defaults.org][ao_defaults]]
 [[./ao_output_debugs.org][ao_output_debugs]]
-[[./ao_read_config_files.org][ao_read_config_files]]
-[[./ao_read_source_files.org][ao_read_source_files]]
 [[./ao_read_source_files.org][ao_read_source_files]]
-[[./ao_rgx.org][ao_rgx]]
-[[./output_hub.org][output hub]]
+[[./compile_time_info.org][compile time info]]
+[[./output.org][output]]
+[[./sdp.org][sdp]]
 
-**** TODO sdlang                                              :import:sdlang:
+***** sdlang                                                     :sdlang:
 keep up to date, configuration in ../maker.org
 check:
 - http://github.com/Abscissa/SDLang-D
@@ -139,12 +136,12 @@ check:
 import sdlang;                            // sdlang.d
 #+END_SRC
 
-***** notes
+****** notes
 
-sdlang.parser,                       // sdlang/parser.d
+sdlang.parser,
 sdlang.exceptions;
 
-**** std                                                         :import:std:
+***** std                                                           :std:
 
 #+NAME: imports_std
 #+BEGIN_SRC d
@@ -169,28 +166,26 @@ private import
   std.conv : to;
 #+END_SRC
 
-***** notes
+****** notes
 std.conv,
-std.path,
-std.stdio,
 std.variant,
 
-**** mixins
-***** version.txt                                                   :version:
+**** mixins                                                        :mixin:
+***** version.txt                                               :version:
 
-#+NAME: sdp_version_mixin
+#+NAME: mixin_sdp_version
 #+BEGIN_SRC d
 mixin(import("version.txt"));
 #+END_SRC
 
-***** std mixins
-#+NAME: std_mixins
+***** pre main mixins
+#+NAME: mixin_pre_main
 #+BEGIN_SRC d
 mixin CompileTimeInfo;
 mixin RgxInit;
 #+END_SRC
 
-*** mixin                                                             :mixin:
+***** sdp "main" mixins                                             :sdp:
 
 #+NAME: sdp_mixin
 #+BEGIN_SRC d
@@ -207,7 +202,7 @@ mixin SiSUoutputDebugs;
 mixin SiSUoutputHub;
 #+END_SRC
 
-*** init                                                               :init:
+**** init                                                           :init:
 
 #+NAME: sdp_args
 #+BEGIN_SRC d
@@ -231,7 +226,7 @@ string arg_unrecognized;
 auto rgx = Rgx();
 #+END_SRC
 
-*** scope (run complete)                                              :scope:
+*** scope (run complete)                                            :scope:
 
 #+NAME: sdp_args
 #+BEGIN_SRC d
@@ -254,7 +249,8 @@ scope(failure) {
 }
 #+END_SRC
 
-*** getopt args for loop                                        :args:getopt:
+*** config files and command line arguements
+**** getopt args for loop                                    :args:getopt:
 
 look into using getopt
 [[http://dlang.org/phobos/std_getopt.html][getopt]]
@@ -346,7 +342,7 @@ foreach(arg; args) {
 }
 #+END_SRC
 
-*** TODO config files (load & read) (so far only SDLang)       :config:files:
+**** TODO config files (load & read) (so far only SDLang)   :config:files:
 
 #+NAME: sdp_conf_files
 #+BEGIN_SRC d
@@ -358,9 +354,8 @@ auto conf_settings_aa = confsdl.configSettingsSDLangToAAmake(sdl_root_configurat
 auto conf_doc_make_aa = confsdl.documentMakeSDLangToAAmake(sdl_root_doc_make);
 #+END_SRC
 
-** each file (loop) [+2]                                         :loop:files:
-*** filename provided [+1]                                     :file:process:
-**** scope (loop)                                                     :scope:
+** _1a. processing: loop each file_ [+2]                          :loop:files:
+*** scope (loop)                                                    :scope:
 
 #+NAME: sdp_each_file_do_scope
 #+BEGIN_SRC d
@@ -388,8 +383,9 @@ enforce(
 );
 #+END_SRC
 
-**** _read in raw file_ (using filename with path)             :file:read:
-[[./ao_markup_source_raw.org][ao_markup_source_raw]]
+*** 0. prepare document, _document abstraction_
+**** 0. _read in raw file_ (using filename with path)            :file:read:
+- [[./ao_read_source_files.org][ao_read_source_files]]
 
 #+NAME: sdp_each_file_do_read_sisu_markup_file
 #+BEGIN_SRC d
@@ -397,7 +393,8 @@ enforce(
 auto read_in_file_string = raw.sourceContent(fn_src);
 #+END_SRC
 
-**** split raw content file into: _doc header & doc content_   :file:read:
+**** 1. split raw content file into: _doc header & doc content_
+- [[./ao_read_source_files.org][ao_read_source_files]]
 
 #+NAME: sdp_each_file_do_split_sisu_markup_file_content_into_header_and_body
 #+BEGIN_SRC d
@@ -413,7 +410,8 @@ debug(header_and_body) {
 }
 #+END_SRC
 
-**** split doc header into: _metadata & make_ :doc:header:metadata:make:
+**** 2. split doc header into: _metadata & make_  :doc:header:metadata:make:
+- [[./ao_conf_make_meta.org][ao_conf_make_meta]]
 
 #+NAME: sdp_each_file_do_split_sisu_markup_file_header_into_make_and_meta
 #+BEGIN_SRC d
@@ -424,7 +422,8 @@ string[string][string] _dochead_make = header_make_and_meta_tuple[0];
 string[string][string] _dochead_meta = header_make_and_meta_tuple[1];
 #+END_SRC
 
-**** [#A] processing: _document abstraction, tuple_           :processing:
+**** 3. processing: _document abstraction, tuple_               :processing:
+- [[./ao_abstract_doc_source.org][ao_abstract_doc_source]]
 
 #+NAME: sdp_each_file_do_document_abstraction
 #+BEGIN_SRC d
@@ -435,7 +434,7 @@ auto doc_abstraction = t[0]; // head ~ toc ~ contents ~ endnotes_seg ~ glossary
 string[] doc_html_segnames = t[1];
 #+END_SRC
 
-**** document _section keys_ sequence
+**** 4. document _section keys_ sequence
 
 #+NAME: sdp_each_file_do_document_abstraction
 #+BEGIN_SRC d
@@ -474,7 +473,8 @@ if ((_opt_action_bool["html"])
 }
 #+END_SRC
 
-**** [#A] _document matters_
+**** 5. _document matters_ (compiled from various sources)
+
 #+NAME: sdp_each_file_do_document_abstraction
 #+BEGIN_SRC d
 struct DocumentMatters {
@@ -514,7 +514,9 @@ struct DocumentMatters {
 auto doc_matters = DocumentMatters();
 #+END_SRC
 
-**** TODO _debug_ (document parts, checkdoc)              :debug:checkdoc:
+*** 1. _output processing_ (post abstraction processing)
+**** 0. _debug_ (document parts, checkdoc)                  :debug:checkdoc:
+- [[./ao_output_debugs.org][ao_output_debugs]]
 
 #+NAME: sdp_each_file_do_debugs_checkdoc
 #+BEGIN_SRC d
@@ -527,7 +529,8 @@ debug(checkdoc) {
 }
 #+END_SRC
 
-**** TODO _process outputs_                                      :outputs:
+**** 1. _process outputs_                                          :outputs:
+- [[./output.org][output]]
 
 #+NAME: sdp_each_file_do_selected_output
 #+BEGIN_SRC d
@@ -540,7 +543,7 @@ if (!(_opt_action_bool["skip_output"])) {
 }
 #+END_SRC
 
-**** scope (on loop exit)                                        :scope:exit:
+*** scope (on loop exit)                                       :scope:exit:
 
 #+NAME: sdp_each_file_do_scope_exit
 #+BEGIN_SRC d
@@ -559,7 +562,7 @@ scope(exit) {
 }
 #+END_SRC
 
-*** no filename provided
+** 1b. no filename provided
 #+NAME: sdp_no_filename_provided
 #+BEGIN_SRC d
 /+ no recognized filename provided +/