ocda, single out, use more structs

5 files changed, 6582 insertions, 7157 deletions

diff --git a/org/ocda.org b/org/ocda.org
index 46dc72c..44a184a 100644
--- a/org/ocda.org
+++ b/org/ocda.org
@@ -17,7 +17,7 @@
 
 - [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
 
-* 1. (Object-Centric) Document Abstraction
+* (Object-Centric) Document Abstraction
 Process markup document, create document abstraction.
 
 ** _module template_ :module:metadoc_from_src:
@@ -33,251 +33,20 @@ Process markup document, create document abstraction.
 +/
 module doc_reform.meta.metadoc_from_src;
 template docAbstraction() {
-                                                                                /+ ↓ abstraction imports +/
-  <<abs_top_imports>>
-                                                                                /+ ↓ abstraction mixins +/
-  <<abs_top_mixins>>
-                                                                                /+ ↓ abstraction struct init +/
-  <<abs_top_init_struct_enum>>
-  <<abs_top_init_struct_general>>
-  <<abs_top_init_generic_object_struct_heading_ancestors>>
-  <<abs_top_init_generic_object_struct_dom_markup_tags>>
-  <<abs_top_init_generic_object_struct_dom_collapsed_tags>>
-  <<abs_top_init_ocn_emit>>
-  <<abs_top_init_inline_markup_faces>>
-  <<abs_top_init_string_links_and_images>>
-  <<abs_top_init_trail>>
-  <<abs_inline_para_tag_associations>>
-                                                                                /+ ↓ abstract marked up document +/
-  @system auto docAbstraction(CMM,Opt,Mf) (
-    char[][]           markup_sourcefile_content,
-    CMM                conf_make_meta,
-    Opt                opt_action,
-    Mf                 manifested,
-    bool               _new_doc
-  ) {
-    static auto rgx = RgxI();
-                                                                                /+ ↓ abstraction init +/
-    <<abs_init_rest_0>>
-    <<abs_init_rest_1>>
-                                                                                /+ abstraction init ↑ +/
-    <<make_tests>>
-                                                                                /+ ↓ ↻ loop markup document/text line by line +/
-    srcDocLoop:
-    foreach (line; markup_sourcefile_content) {                                 /+ ↓ markup document/text line by line +/
-                                                                                // "line" variable can be empty but should never be null
-      <<abs_in_loop_body_00_0>>
-      <<abs_in_loop_body_00_1>>
-      if ( pith["block_is"] == eN.blk_is.code
-        && pith["block_state"] == eN.blk_state.on
-      ) {
-        <<abs_in_loop_body_00_code_block>>
-      } else if (!matchFirst(line, rgx.skip_from_regular_parse)) {              /+ object other than "code block" object +/
-                                                                                /+ (includes regular text paragraph, headings & blocks other than code) +/
-                                                                                /+ heading, glossary, blurb, poem, group, block, quote, table +/
-        <<abs_in_loop_body_non_code_obj_fontface_markup>>
-        <<abs_in_loop_body_non_code_obj_in_biblio>>
-        <<abs_in_loop_body_non_code_obj_in_glossary>>
-        <<abs_in_loop_body_non_code_obj_in_blurb>>
-        <<abs_in_loop_body_non_code_obj_in_block>>
-          <<abs_in_loop_body_non_code_obj_in_block_quote>>
-          <<abs_in_loop_body_non_code_obj_in_block_group>>
-          <<abs_in_loop_body_non_code_obj_in_block_block>>
-          <<abs_in_loop_body_non_code_obj_in_block_poem>>
-          <<abs_in_loop_body_non_code_obj_in_block_table>>
-        } else {                                                                /+ not within a block group +/
-          <<abs_in_loop_body_open_block_obj_assert>>
-          if (line.matchFirst(rgx.block_open)) {
-            <<abs_in_loop_body_open_block_obj>>
-          } else if (!line.empty) {                                             /+ line not empty +/
-                                                                                /+ non blocks (headings, paragraphs) & closed blocks +/
-            <<abs_in_loop_body_not_block_obj_assert>>
-            <<abs_in_loop_body_not_block_obj_bookindex>>
-            <<abs_in_loop_body_not_block_obj_not_bookindex>>
-              <<abs_in_loop_body_not_block_obj_not_bookindex_a_comment>>
-              <<abs_in_loop_body_not_block_obj_not_bookindex_a_para_type>>
-              <<abs_in_loop_body_not_block_obj_not_bookindex_a_heading>>
-              <<abs_in_loop_body_not_block_obj_not_bookindex_a_para>>
-            <<abs_in_loop_body_not_block_obj_not_bookindex_close>>
-          } else if (pith["block_state"] == eN.blk_state.closing) {             /+ line empty, with blocks flag +/
-            <<abs_in_loop_body_not_block_obj_line_empty_blocks_flags>>
-          } else {                                                              /+ line.empty, post contents, empty variables: +/
-            <<abs_in_loop_body_not_block_obj_line_empty_assert>>
-            <<abs_in_loop_body_not_block_obj_line_empty_heading_obj>>
-            <<abs_in_loop_body_not_block_obj_line_empty_para_obj>>
-          }                                                                     // close else for line empty
-        }                                                                       // close else for not the above
-      }                                                                         // close after non code, other blocks or regular text
-      <<abs_in_loop_body_reloop_get_prior_state>>
-    }                                                                           /+ ← srcDocLoop closed: loop markup document/text line by line +/
-    /+ ↓ post loop markup document/text +/
-    <<abs_loop_body_exit_eof_xml_dom_tail>>
-    <<abs_post_endnote_tuple>>
-    <<abs_post_glossary_nugget>>
-    <<abs_post_biblio_init>>
-    <<abs_post_biblio>>
-    <<abs_post_biblio_debug_write>>
-    <<abs_post_bookindex>>
-    <<abs_post_no_blurb>>
-    <<abs_post_contents>>
-    <<abs_post_separate_doc_head_and_doc_body>>
-    <<abs_post_heading_ancestors_markup>>
-    <<abs_post_heading_ancestors_collapsed>>
-    <<abs_post_loop_section_body_get_ancestors>>
-    <<abs_post_loop_section_endnotes>>
-    <<abs_post_loop_section_glossary>>
-    <<abs_post_loop_section_biblio>>
-    <<abs_post_loop_section_bookindex>>
-    <<abs_post_loop_section_blurb>>
-    <<abs_post_loop_all_obj_get_heading_decendants>>
-    <<abs_post_loop_all_obj_get_image_names>>
-    <<abs_post_loop_all_obj_get_image_dimensions>>
-    <<abs_post_loop_all_obj_get_links>>
-    <<abs_post_loop_section_head>>
-    <<abs_post_loop_section_toc>>
-    <<abs_post_reloop_section_body>>
-    <<abs_post_reloop_section_endnotes>>
-    <<abs_post_reloop_section_glossary_get_numbering>>
-    <<abs_post_reloop_section_biblio_get_numbering>>
-    <<abs_post_reloop_section_bookindex_get_index>>
-    <<abs_post_reloop_section_blurb_get_numbering>>
-    <<abs_post_reloop_section_all_get_decendants>>
-    <<abs_post_heading_obj_reinitialize>>
-    <<abs_post_the_document>>
-    <<abs_post_document_parts_keys>>
-    <<abs_post_document_segnames>>
-    <<abs_post_document_reinitialize>>
-    <<abs_struct_doc_has>>
-    <<abs_return_tuple>>
-                                                                                /+ post loop markup document/text ↑ +/
-  }                                                                             /+ ← closed: abstract doc source +/
-                                                                                /+ ↓ abstraction functions +/
-  <<abs_functions_object_reset>>
-  <<abs_functions_header_set_common>>
-  <<abs_functions_ocn_status>>
-  <<abs_functions_substitutions_user_requested>>
-  <<abs_functions_substitutions_fontface>>
-  <<abs_functions_block_open>>
-    <<abs_functions_block_regex>>
-    <<abs_functions_block_curly_open_code>>
-    <<abs_functions_block_curly_open_poem>>
-    <<abs_functions_block_curly_open_group>>
-    <<abs_functions_block_curly_open_block>>
-    <<abs_functions_block_curly_open_quote>>
-    <<abs_functions_block_curly_open_table>>
-    <<abs_functions_block_curly_open_table_special>>
-    <<abs_functions_block_tic_open_code>>
-    <<abs_functions_block_tic_open_poem>>
-    <<abs_functions_block_tic_open_group>>
-    <<abs_functions_block_tic_open_block>>
-    <<abs_functions_block_tic_open_quote>>
-    <<abs_functions_block_tic_open_table>>
-  <<abs_functions_block_close>>
-  <<abs_functions_block_quote>>
-  <<abs_functions_block_group>>
-  <<abs_functions_block_block>>
-  <<abs_functions_block_poem>>
-  <<abs_functions_block_code>>
-  <<abs_functions_block_table>>
-  <<abs_functions_block_biblio_map_tags>>
-  <<abs_functions_block_biblio_text_block>>
-  <<abs_functions_block_line_status_empty_table_closed>>
-  <<abs_functions_block_line_status_empty_block_close_function_open>>
-      <<abs_functions_block_line_status_empty_block_quote>>
-      <<abs_functions_block_line_status_empty_block_group>>
-      <<abs_functions_block_line_status_empty_block_block>>
-      <<abs_functions_block_line_status_empty_block_poem>>
-      <<abs_functions_block_line_status_empty_block_code>>
-      <<abs_functions_block_line_status_empty_block_table>>
-  <<abs_functions_block_line_status_empty_block_close_function_close>>
-  <<abs_functions_book_index>>
-  <<abs_functions_heading_found>>
-  <<abs_functions_heading_make_set>>
-  <<abs_functions_heading_matched>>
-  <<abs_functions_para_matched>>
-  <<abs_functions_para_font_faces_line>>
-  <<abs_functions_table_instructions>>
-  <<abs_functions_table_munge_array>>
-  <<abs_functions_table_munge_substantive>>
-  <<abs_functions_table_munge_substantive_special>>
-                                                                                /+ abstraction functions ↑ +/
-                                                                                /+ ↓ abstraction function emitters +/
-  <<meta_emitters_ocn>>
-                                                                                /+ +/
-  <<meta_emitters_obj_inline_markup_munge_function_open>>
-    <<meta_emitters_obj_inline_markup_munge_function_markup_images>>
-    <<meta_emitters_obj_inline_markup_munge_function_markup_footnotes_endnotes>>
-    <<meta_emitters_obj_inline_markup_munge_function_object_notes_and_links>>
-    <<meta_emitters_obj_inline_markup_munge_function_heading>>
-    <<meta_emitters_obj_inline_markup_munge_function_para>>
-    <<meta_emitters_obj_inline_markup_munge_function_quote>>
-    <<meta_emitters_obj_inline_markup_munge_function_group>>
-    <<meta_emitters_obj_inline_markup_munge_function_block>>
-    <<meta_emitters_obj_inline_markup_munge_function_verse>>
-    <<meta_emitters_obj_inline_markup_munge_function_code>>
-    <<meta_emitters_obj_inline_markup_munge_function_table>>
-    <<meta_emitters_obj_inline_markup_munge_function_comment>>
-  <<meta_emitters_obj_inline_markup_munge_function_close>>
-  <<meta_emitters_obj_inline_markup_function_open>>
-    <<meta_emitters_obj_inline_markup_and_anchor_tags_and_misc>>
-    <<meta_emitters_obj_inline_markup_table_of_contents>>
-  <<meta_emitters_obj_inline_markup_private_function_open>>
-    <<meta_emitters_obj_inline_markup_heading_numbering_and_segment_anchor_tags>>
-    <<meta_emitters_obj_inline_segment_anchor_tags_manufacture>>
-  <<meta_emitters_obj_inline_markup_private_function_close>>
-                                                                                /+ +/
-  <<meta_emitters_obj_attributes>>
-    <<meta_emitters_obj_attributes_public>>
-    <<meta_emitters_obj_attributes_private>>
-    <<meta_emitters_obj_attributes_private_an_attribute_txt_para_and_blocks>>
-    <<meta_emitters_obj_attributes_private_an_attribute_txt_heading>>
-    <<meta_emitters_obj_attributes_private_an_attribute_txt_para>>
-    <<meta_emitters_obj_attributes_private_an_attribute_txt_quote>>
-    <<meta_emitters_obj_attributes_private_an_attribute_txt_group>>
-    <<meta_emitters_obj_attributes_private_an_attribute_txt_block>>
-    <<meta_emitters_obj_attributes_private_an_attribute_txt_verse>>
-    <<meta_emitters_obj_attributes_private_an_attribute_txt_code>>
-    <<meta_emitters_obj_attributes_private_an_attribute_txt_table>>
-    <<meta_emitters_obj_attributes_private_an_attribute_txt_comment>>
-    <<meta_emitters_obj_attributes_private_json>>
-  <<meta_emitters_obj_attributes_private_close>>
-                                                                                /+ +/
-  <<meta_emitters_bookindex_nugget>>
-  <<meta_emitters_bookindex_report_indented>>
-  <<meta_emitters_bookindex_report_section_function_open>>
-    <<meta_emitters_bookindex_report_section_function_write_section>>
-    <<meta_emitters_bookindex_report_section_function_build_abstraction>>
-  <<meta_emitters_bookindex_report_section_function_close>>
-                                                                                /+ +/
-  <<meta_emitters_endnotes_function_open>>
-    <<meta_emitters_endnotes_function_gather_notes>>
-    <<meta_emitters_endnotes_function_gathered_notes>>
-    <<meta_emitters_endnotes_function_endnote_objects>>
-  <<meta_emitters_endnotes_function_close>>
-                                                                                /+ +/
-  <<meta_emitters_bibliography_function_open>>
-    <<meta_emitters_bibliography_function_biblio_sorted>>
-    <<meta_emitters_bibliography_function_biblio_unsorted_json_object_array>>
-    <<meta_emitters_bibliography_function_biblio_sort_json>>
-    <<meta_emitters_bibliography_function_biblio_sorted_json>>
-  <<meta_emitters_bibliography_function_close>>
-                                                                                /+ +/
-  <<meta_emitters_metadata_function_open>>
-    <<meta_emitters_metadata_function_node_location>>
-    <<meta_emitters_metadata_function_heading>>
-  <<meta_emitters_metadata_function_close>>
-                                                                                /+ abstraction functions emitters ↑ +/
-                                                                                /+ ↓ abstraction functions assertions +/
-  <<abs_functions_assertions>>
-                                                                                /+ abstraction functions assertions ↑ +/
-}                                                                               /+ ← closed: template docAbstraction +/
-<<template_doc_sect_keys_seq>>
+  /+ ↓ abstraction imports +/
+  <<docInitialize>>
+  <<docAbstraction>>
+  <<docSortOut>>
+}
+template docSectKeysSeq() {
+  <<docSectKeysSeq>>
+}
 #+END_SRC
 
-** 1. _pre loop process ing_ :pre:
-*** imports :imports:
+** docInitialize
 
-#+NAME: abs_top_imports
+#+NAME: docInitialize
+#+HEADER: :noweb yes
 #+BEGIN_SRC d
 import
   std.algorithm,
@@ -291,22 +60,11 @@ import
   doc_reform.meta.rgx,
   doc_reform.meta.metadoc_object_setter,
   doc_reform.meta.rgx;
-#+END_SRC
-
-*** mixins :mixins:
-
-#+NAME: abs_top_mixins
-#+BEGIN_SRC d
+/+ ↓ abstraction mixins +/
 mixin ObjectSetter;
 mixin InternalMarkup;
 mixin spineRgxIn;
-#+END_SRC
-
-*** initialize :initialize:
-**** declare enum
-
-#+NAME: abs_top_init_struct_enum
-#+BEGIN_SRC d
+/+ ↓ abstraction struct init +/
 @safe static auto eN() {
   struct _e {
     enum bi {
@@ -359,15 +117,19 @@ mixin spineRgxIn;
   }
   return _e();
 }
-#+END_SRC
-
-**** initialize general
-
-#+NAME: abs_top_init_struct_general
-#+BEGIN_SRC d
 /+ initialize +/
 ObjGenericComposite[] the_document_toc_section, the_document_head_section, the_document_body_section, the_document_bibliography_section, the_document_glossary_section, the_document_blurb_section, the_document_xml_dom_tail_section;
-string[string] an_object, processing;
+struct _theDoc {
+  ObjGenericComposite[] toc;
+  ObjGenericComposite[] head;
+  ObjGenericComposite[] body;
+  ObjGenericComposite[] bibliography;
+  ObjGenericComposite[] glossary;
+  ObjGenericComposite[] bookindex;
+  ObjGenericComposite[] blurb;
+  ObjGenericComposite[] endnotes;
+}
+string[string] an_object, processing, object_notes;
 string an_object_key;
 string[] anchor_tags;
 string anchor_tag;
@@ -449,12 +211,6 @@ alias TxtAndAnchorTagPlusHasFootnotesUrlsImages = Tuple!(
    bool,   "has_images_without_dimensions",
 );
 enum DomTags { none, open, close, close_and_open, open_still, }
-#+END_SRC
-
-**** method heading ancestors
-
-#+NAME: abs_top_init_generic_object_struct_heading_ancestors
-#+BEGIN_SRC d
 @safe pure ObjGenericComposite obj_heading_ancestors()(
   ObjGenericComposite  obj,
   string[]             lv_ancestors_txt,
@@ -508,12 +264,6 @@ enum DomTags { none, open, close, close_and_open, open_still, }
   }
   return obj;
 }
-#+END_SRC
-
-**** method dom markup tags
-
-#+NAME: abs_top_init_generic_object_struct_dom_markup_tags
-#+BEGIN_SRC d
 @safe pure ObjGenericComposite obj_dom_structure_set_markup_tags()(
   ObjGenericComposite  obj,
   int[]                dom,
@@ -558,12 +308,6 @@ enum DomTags { none, open, close, close_and_open, open_still, }
   obj.metainfo.dom_structure_markedup_tags_status = dom.dup;
   return obj;
 }
-#+END_SRC
-
-**** method dom collapsed tags
-
-#+NAME: abs_top_init_generic_object_struct_dom_collapsed_tags
-#+BEGIN_SRC d
 @safe pure ObjGenericComposite obj_dom_set_collapsed_tags()(
   ObjGenericComposite  obj,
   int[]                dom,
@@ -608,21 +352,9 @@ enum DomTags { none, open, close, close_and_open, open_still, }
   obj.metainfo.dom_structure_collapsed_tags_status = dom.dup;
   return obj;
 }
-#+END_SRC
-
-**** method ocn emit
-
-#+NAME: abs_top_init_ocn_emit
-#+BEGIN_SRC d
 @safe static  OCNset ocn_emit(int ocn_status_flag) {
   return object_citation_number.ocn_emitter(ocn_status_flag);
 }
-#+END_SRC
-
-**** inline markup faces
-
-#+NAME: abs_top_init_inline_markup_faces
-#+BEGIN_SRC d
 @safe auto inline_markup_faces(L)(L line) {
   static auto rgx = RgxI();
   static auto mkup = InlineMarkup();
@@ -634,12 +366,6 @@ enum DomTags { none, open, close, close_and_open, open_still, }
   }
   return line;
 }
-#+END_SRC
-
-**** string links & images
-
-#+NAME: abs_top_init_string_links_and_images
-#+BEGIN_SRC d
 @safe static string links_and_images()(string obj_txt) {
   static auto rgx = RgxI();
   static auto mkup = InlineMarkup();
@@ -680,12 +406,6 @@ enum DomTags { none, open, close, close_and_open, open_still, }
   }
   return obj_txt;
 }
-#+END_SRC
-
-**** trail
-
-#+NAME: abs_top_init_trail
-#+BEGIN_SRC d
 /+ book index variables +/
 string book_idx_tmp;
 string[][string][string] bookindex_unordered_hashes;
@@ -693,12 +413,6 @@ string[][string][string] bookindex_unordered_hashes;
 ObjGenericComposite comp_obj_heading, comp_obj_location, comp_obj_block, comp_obj_code, comp_obj_poem_ocn, comp_obj_comment;
 auto node_construct = NodeStructureMetadata();
 enum sObj { content, anchor_tag, notes_reg, notes_star, links, image_no_dimensions }
-#+END_SRC
-
-*** inline para tag associations
-
-#+NAME: abs_inline_para_tag_associations
-#+BEGIN_SRC d
 @safe string[string][string] inline_para_link_anchor()(
   string[string]          an_object,
   string[string]          tag_in_seg,
@@ -717,2278 +431,1791 @@ enum sObj { content, anchor_tag, notes_reg, notes_star, links, image_no_dimensio
 }
 #+END_SRC
 
-*** scope
+** docAbstraction
 
-#+NAME: abs_init_rest_0
-#+BEGIN_SRC d
-scope(success) {
-}
-scope(failure) {
-}
-scope(exit) {
-  destroy(the_document_toc_section);
-  destroy(the_document_head_section);
-  destroy(the_document_body_section);
-  destroy(the_document_bibliography_section);
-  destroy(the_document_glossary_section);
-  destroy(the_document_blurb_section);
-  destroy(the_document_xml_dom_tail_section);
-  destroy(an_object);
-  destroy(processing);
-  destroy(biblio_arr_json);
-  previous_length = 0;
-  reset_note_numbers = true;
-  lev_anchor_tag = "";
-  anchor_tag = "";
-  // dom_structure_collapsed_tags_status        = [ 0, 0, 0, 0, 0, 0, 0, 0, 0,];
-  // dom_structure_markedup_tags_status_buffer  = [ 0, 0, 0, 0, 0, 0, 0, 0, 0,];
-  // dom_structure_collapsed_tags_status_buffer = [ 0, 0, 0, 0, 0, 0, 0, 0, 0,];
-}
-#+END_SRC
-
-*** init rest
-
-#+NAME: abs_init_rest_1
-#+BEGIN_SRC d
-mixin spineNode;
-auto node_para_int_    = node_metadata_para_int;
-auto node_para_str_    = node_metadata_para_str;
-ObjGenericComposite comp_obj_heading_, comp_obj_para, comp_obj_toc;
-line_occur = [
-  "heading"  : 0,
-  "para"     : 0,
-  "glossary" : 0,
-  "blurb"    : 0,
-];
-uint[string] dochas = [
-  "inline_links"      : 0,
-  "inline_notes"      : 0,
-  "inline_notes_star" : 0,
-  "codeblock"         : 0,
-  "table"             : 0,
-  "block"             : 0,
-  "group"             : 0,
-  "poem"              : 0,
-  "quote"             : 0,
-  "images"            : 0,
-];
-uint[string] pith = [
-  "ocn"                            : 1,
-  "section"                        : 0,
-  "txt_is"                         : 0,
-  "block_is"                       : 0,
-  "block_state"                    : 0,
-  "block_delim"                    : 0,
-  "make_headings"                  : 0,
-  "dummy_heading_status"           : 0,
-  "dummy_heading_multiple_objects" : 0,
-  "no_ocn_multiple_objects"        : 0,
-  "verse_new"                      : 0,
-];
-string[string] object_number_poem = [
-  "start" : "",
-  "end"   : ""
-];
-string[] lv_ancestors_txt = [ "", "", "", "", "", "", "", "", ];
-int[string] lv = [
-  "lv" : eN.bi.off,
-  "h0" : eN.bi.off,
-  "h1" : eN.bi.off,
-  "h2" : eN.bi.off,
-  "h3" : eN.bi.off,
-  "h4" : eN.bi.off,
-  "h5" : eN.bi.off,
-  "h6" : eN.bi.off,
-  "h7" : eN.bi.off,
-  "lev_int_collapsed" : 0,
-];
-int[string] collapsed_lev = [
-  "h0" : eN.bi.off,
-  "h1" : eN.bi.off,
-  "h2" : eN.bi.off,
-  "h3" : eN.bi.off,
-  "h4" : eN.bi.off,
-  "h5" : eN.bi.off,
-  "h6" : eN.bi.off,
-  "h7" : eN.bi.off
-];
-string[string] heading_match_str = [
-  "h_A": "^(none)",
-  "h_B": "^(none)",
-  "h_C": "^(none)",
-  "h_D": "^(none)",
-  "h_1": "^(none)",
-  "h_2": "^(none)",
-  "h_3": "^(none)",
-  "h_4": "^(none)"
-];
-Regex!char[string] heading_match_rgx = [
-  "h_A": regex(r"^(none)"),
-  "h_B": regex(r"^(none)"),
-  "h_C": regex(r"^(none)"),
-  "h_D": regex(r"^(none)"),
-  "h_1": regex(r"^(none)"),
-  "h_2": regex(r"^(none)"),
-  "h_3": regex(r"^(none)"),
-  "h_4": regex(r"^(none)")
-];
-string _anchor_tag;
-string toc_txt_;
-an_object["glossary_nugget"]                                   = "";
-an_object["blurb_nugget"]                                      = "";
-comp_obj_heading_                                              = comp_obj_heading_.init;
-comp_obj_heading_.metainfo.is_of_part                          = "frontmatter";
-comp_obj_heading_.metainfo.is_of_section                       = "toc";
-comp_obj_heading_.metainfo.is_of_type                          = "para";
-comp_obj_heading_.metainfo.is_a                                = "heading";
-comp_obj_heading_.text                                         = "Table of Contents";
-comp_obj_heading_.metainfo.ocn                                 = 0;
-comp_obj_heading_.metainfo.identifier                          = "";
-comp_obj_heading_.metainfo.dummy_heading                       = false;
-comp_obj_heading_.metainfo.object_number_off                   = true;
-comp_obj_heading_.metainfo.object_number_type                  = 0;
-comp_obj_heading_.tags.segment_anchor_tag_epub                 = "toc";
-comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
-comp_obj_heading_.tags.in_segment_html                         = comp_obj_heading_.tags.anchor_tag_html;
-comp_obj_heading_.metainfo.heading_lev_markup                  = 4;
-comp_obj_heading_.metainfo.heading_lev_collapsed               = 1;
-comp_obj_heading_.metainfo.parent_ocn                          = 1;
-comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
-comp_obj_heading_.ptr.html_segnames                            = html_segnames_ptr;
-comp_obj_heading_.tags.anchor_tags                             = ["toc"];
-comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 1, 0, 0, 0];
-comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 1, 0, 0, 0, 0, 0];
-tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-auto toc_head                                                  = comp_obj_heading_;
-html_segnames_ptr_cntr++;
-the_document_toc_section = [toc_head];
-static auto mkup = InlineMarkup();
-static auto munge = ObjInlineMarkupMunge();
-auto note_section = NotesSection();
-auto bookindex_extract_hash = BookIndexNuggetHash();
-string[][string] lev4_subtoc;
-string[][string] segnames = ["html": ["toc"], "epub": ["toc"]];
-int cnt1 = 1; int cnt2 = 1; int cnt3 = 1;
-#+END_SRC
-
-*** make tests
-
-#+NAME: make_tests
-#+BEGIN_SRC d
-enum Substitute { match, markup, }
-debug (substitutions) {
-  writeln(__LINE__, ":", __FILE__, ": DEBUG substitutions:");
-  if (!(conf_make_meta.make.headings.empty)) {
-    writeln(conf_make_meta.make.headings);
-  }
-  if (conf_make_meta.make.substitute) {
-    foreach(substitution_pair; conf_make_meta.make.substitute) {
-       writeln("regex to match:       ", substitution_pair[Substitute.match]);
-       writeln("substitution to make: ", substitution_pair[Substitute.markup]);
-    }
-  }
-  if (conf_make_meta.make.bold) {
-    writeln("regex to match:       ", conf_make_meta.make.bold[Substitute.match]);
-    writeln("substitution to make: ", conf_make_meta.make.bold[Substitute.markup]);
-  }
-  if (conf_make_meta.make.emphasis) {
-    writeln("regex to match:       ", conf_make_meta.make.emphasis[Substitute.match]);
-    writeln("substitution to make: ", conf_make_meta.make.emphasis[Substitute.markup]);
-  }
-  if (conf_make_meta.make.italics) {
-    writeln("regex to match:       ", conf_make_meta.make.italics[Substitute.match]);
-    writeln("substitution to make: ", conf_make_meta.make.italics[Substitute.markup]);
-  }
-}
-#+END_SRC
-
-** 2. ↻ *LOOP* _loop: process document body_ :loop:document:
-*** Loop scope :scope:
-
-#+NAME: abs_in_loop_body_00_0
-#+BEGIN_SRC d
-/+ scope +/
-scope(exit) { }
-scope(failure) {
-  stderr.writefln(
-    "\n%s\n%s\n\n%s:%s\nFAILED while processing the file: ❮❮ %s ❯❯ on line with text:\n%s\n",
-    __MODULE__, __FUNCTION__,
-    __FILE__, __LINE__,
-    manifested.src.filename, line,
-  );
-}
-debug(source) {
-  writeln(line);
-}
-debug(srclines) {
-  if (!line.empty) {
-    writefln("* %s", line);
-  }
-}
-#+END_SRC
-
-*** check whether object number is on or turned off :ocn:
-
-#+NAME: abs_in_loop_body_00_1
-#+BEGIN_SRC d
-if (!line.empty) {
-  pith = line._check_ocn_status_(pith);
-}
-#+END_SRC
-
-*** separate _code blocks_ from _other markup text_ [+5] [#A]
-**** _code blocks_ :block:code:
-
-#+NAME: abs_in_loop_body_00_code_block
-#+BEGIN_SRC d
-/+ block object: code +/
-line.flow_txt_block_code(an_object, pith);
-continue;
-#+END_SRC
-
-**** _non code objects_ (non-code blocks & regular text: by line) [+4] :non_code:
-***** inline fontface markup
-
-#+NAME: abs_in_loop_body_non_code_obj_fontface_markup
-#+BEGIN_SRC d
-line = line.inline_markup_faces; // by text line (rather than by text object), linebreaks in para problematic
-#+END_SRC
-
-***** in section (biblio, glossary, blurb) +(block group)+ [+1] :block:
-****** in section: biblio :biblio:
-
-#+NAME: abs_in_loop_body_non_code_obj_in_biblio
-#+BEGIN_SRC d
-if (line.matchFirst(rgx.heading_biblio)
-|| (pith["section"] == eN.sect.bibliography
-  && ((!(line.matchFirst(rgx.heading_glossary)))
-  && (!(line.matchFirst(rgx.heading_blurb)))
-  && (!(line.matchFirst(rgx.heading)))
-  && (!(line.matchFirst(rgx.comment)))))
-) {
-  pith["section"] = eN.sect.bibliography;
-  if (opt_action.backmatter && opt_action.section_biblio) {
-    line.flow_txt_block_biblio(pith, bib_entry, biblio_entry_str_json, biblio_arr_json);
-    debug(bibliobuild) {
-      writeln("-  ", biblio_entry_str_json);
-      writeln("-> ", biblio_arr_json.length);
-    }
-  }
-  continue;
-#+END_SRC
-
-****** in section: glossary :glossary:
-
-if there is a glossary section you need to:
-- extract it
-- create standard headings
-- markup contents in standard way like regular paragraphs
-  - need indentation and regular paragraph inline markup
-- reconstitute the document with the glossary section following the endnotes
-
-#+NAME: abs_in_loop_body_non_code_obj_in_glossary
-#+BEGIN_SRC d
-} else if (line.matchFirst(rgx.heading_glossary)
-|| (pith["section"] == eN.sect.glossary
-  && ((!(line.matchFirst(rgx.heading_biblio)))
-  && (!(line.matchFirst(rgx.heading_blurb)))
-  && (!(line.matchFirst(rgx.heading)))
-  && (!(line.matchFirst(rgx.comment)))))
-) {
-  /+ within section (block object): glossary +/
-  debug(glossary) {
-    writeln(__LINE__);
-    writeln(line);
-  }
-  pith["section"] = eN.sect.glossary;
-  if (opt_action.backmatter && opt_action.section_glossary) {
-    indent = [
-      "hang_position" : 0,
-      "base_position" : 0,
-    ];
-    bullet = false;
-    pith["txt_is"]           = eN.txt_is.para;
-    line_occur["para"]       = eN.bi.off;
-    an_object_key = "glossary_nugget";
-    if (line.matchFirst(rgx.heading_glossary)) {
-      {
-        comp_obj_heading_                                = comp_obj_heading_.init;
-        comp_obj_heading_.metainfo.is_of_part            = "backmatter";
-        comp_obj_heading_.metainfo.is_of_section         = "glossary";
-        comp_obj_heading_.metainfo.is_of_type            = "para";
-        comp_obj_heading_.metainfo.is_a                  = "heading";
-        comp_obj_heading_.text                           = "Glossary";
-        comp_obj_heading_.metainfo.ocn                   = 0;
-        comp_obj_heading_.metainfo.identifier            = "";
-        comp_obj_heading_.metainfo.dummy_heading         = false;
-        comp_obj_heading_.metainfo.object_number_off     = false;
-        comp_obj_heading_.metainfo.object_number_type    = 0;
-        comp_obj_heading_.tags.segment_anchor_tag_epub   = "_part_glossary";
-        comp_obj_heading_.tags.anchor_tag_html           = comp_obj_heading_.tags.segment_anchor_tag_epub;
-        comp_obj_heading_.tags.in_segment_html           = "glossary";
-        comp_obj_heading_.tags.anchor_tags               = ["section_glossary"];
-        comp_obj_heading_.metainfo.heading_lev_markup    = 1;
-        comp_obj_heading_.metainfo.heading_lev_collapsed = 1;
-        comp_obj_heading_.metainfo.parent_ocn            = 1;
-        comp_obj_heading_.metainfo.parent_lev_markup     = 0;
-        comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 0, 0, 0, 0];
-        comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 0, 0, 0, 0, 0, 0];
-        the_document_glossary_section                    ~= comp_obj_heading_;
-        tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-        tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-      }
-      {
-        comp_obj_heading_                                = comp_obj_heading_.init;
-        comp_obj_heading_.metainfo.is_of_part            = "backmatter";
-        comp_obj_heading_.metainfo.is_of_section         = "glossary";
-        comp_obj_heading_.metainfo.is_of_type            = "para";
-        comp_obj_heading_.metainfo.is_a                  = "heading";
-        comp_obj_heading_.text                           = "Glossary";
-        comp_obj_heading_.metainfo.ocn                   = 0;
-        comp_obj_heading_.metainfo.identifier            = "";
-        comp_obj_heading_.metainfo.dummy_heading         = true;
-        comp_obj_heading_.metainfo.object_number_off     = true;
-        comp_obj_heading_.metainfo.object_number_type    = 0;
-        comp_obj_heading_.tags.segment_anchor_tag_epub   = "glossary";
-        comp_obj_heading_.tags.anchor_tag_html           = comp_obj_heading_.tags.segment_anchor_tag_epub;
-        comp_obj_heading_.tags.in_segment_html           = comp_obj_heading_.tags.anchor_tag_html;
-        comp_obj_heading_.metainfo.heading_lev_markup    = 4;
-        comp_obj_heading_.metainfo.heading_lev_collapsed = 2;
-        comp_obj_heading_.metainfo.parent_ocn            = 1;
-        comp_obj_heading_.metainfo.parent_lev_markup     = 0;
-        comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 1, 0, 0, 0];
-        comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 1, 0, 0, 0, 0, 0];
-        comp_obj_heading_.tags.anchor_tags               = ["glossary"];
-        the_document_glossary_section                    ~= comp_obj_heading_;
-        tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-        tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-      }
-    } else {
-      an_object = line.flow_para_match_(an_object, an_object_key, indent, bullet, pith, line_occur);
-      comp_obj_para                               = comp_obj_para.init;
-      comp_obj_para.metainfo.is_of_part           = "backmatter";
-      comp_obj_para.metainfo.is_of_section        = "glossary";
-      comp_obj_para.metainfo.is_of_type           = "para";
-      comp_obj_para.metainfo.is_a                 = "glossary";
-      comp_obj_para.text                          = links_and_images(line.to!string.strip).replaceFirst(rgx.para_attribs, "");
-      comp_obj_para.metainfo.ocn                  = 0;
-      comp_obj_para.metainfo.identifier           = "";
-      comp_obj_para.metainfo.object_number_off    = true;
-      comp_obj_para.metainfo.object_number_type   = 0;
-      comp_obj_para.attrib.indent_hang            = indent["hang_position"];
-      comp_obj_para.attrib.indent_base            = indent["base_position"];
-      comp_obj_para.attrib.bullet                 = bullet;
-      the_document_glossary_section               ~= comp_obj_para;
-    }
-    pith["ocn"] = eN.ocn.on;
-  }
-  continue;
-#+END_SRC
-
-****** in section: blurb :blurb:
-
-if there is a blurb section you need to:
-- extract it
-- create standard headings (or use line provided in 1~ heading)
-- markup contents in standard way like regular paragraphs
-  - need regular paragraph inline markup
-- reconstitute the document with the blurb section at the very end of the doucment
-
-#+NAME: abs_in_loop_body_non_code_obj_in_blurb
+#+NAME: docAbstraction
+#+HEADER: :noweb yes
 #+BEGIN_SRC d
-} else if (line.matchFirst(rgx.heading_blurb)
-|| (pith["section"] == eN.sect.blurb
-  && ((!(line.matchFirst(rgx.heading_glossary)))
-  && (!(line.matchFirst(rgx.heading_biblio)))
-  && (!(line.matchFirst(rgx.heading)))
-  && (!(line.matchFirst(rgx.comment)))))
+@system auto docAbstraction(CMM,Opt,Mf) (
+  char[][]           markup_sourcefile_content,
+  CMM                conf_make_meta,
+  Opt                opt_action,
+  Mf                 manifested,
+  bool               _new_doc
 ) {
-  pith["section"] = eN.sect.blurb;
-  debug(blurb) {
-    writeln(__LINE__);
-    writeln(line);
-  }
-  if (opt_action.backmatter && opt_action.section_blurb) {
-    indent = [
-      "hang_position" : 0,
-      "base_position" : 0,
-    ];
-    bullet = false;
-    if (auto m = line.matchFirst(rgx.para_indent)) {
-      debug(paraindent) {
-        writeln(line);
-      }
-      indent["hang_position"] = (m["indent"]).to!int;
-      indent["base_position"] = (m["indent"]).to!int;
-    } else if (line.matchFirst(rgx.para_bullet)) {
-      debug(parabullet) {
-        writeln(line);
-      }
-      bullet = true;
-    } else if (auto m = line.matchFirst(rgx.para_indent_hang)) {
-      debug(paraindenthang) {
-        writeln(line);
-      }
-      indent = [
-        "hang_position" : (m["hang"]).to!int,
-        "base_position" : (m["indent"]).to!int,
-      ];
-    } else if (auto m = line.matchFirst(rgx.para_bullet_indent)) {
-      debug(parabulletindent) {
-        writeln(line);
-      }
-      indent = [
-        "hang_position" : (m["indent"]).to!int,
-        "base_position" : (m["indent"]).to!int,
-      ];
-      bullet = true;
-    }
-    pith["txt_is"]           = eN.txt_is.para;
-    line_occur["para"]       = eN.bi.off;
-    an_object_key = "blurb_nugget";
-    if (line.matchFirst(rgx.heading_blurb)) {
-      {
-        comp_obj_heading_                                              = comp_obj_heading_.init;
-        comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
-        comp_obj_heading_.metainfo.is_of_section                       = "blurb";
-        comp_obj_heading_.metainfo.is_of_type                          = "para";
-        comp_obj_heading_.metainfo.is_a                                = "heading";
-        comp_obj_heading_.text                                         = "Blurb";
-        comp_obj_heading_.metainfo.ocn                                 = 0;
-        comp_obj_heading_.metainfo.identifier                          = "";
-        comp_obj_heading_.metainfo.dummy_heading                       = false;
-        comp_obj_heading_.metainfo.object_number_off                   = false;
-        comp_obj_heading_.metainfo.object_number_type                  = 0;
-        comp_obj_heading_.tags.segment_anchor_tag_epub                 = "_part_blurb";
-        comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
-        comp_obj_heading_.tags.in_segment_html                         = "blurb";
-        comp_obj_heading_.tags.anchor_tags                             = ["section_blurb"];
-        comp_obj_heading_.metainfo.heading_lev_markup                  = 1;
-        comp_obj_heading_.metainfo.heading_lev_collapsed               = 1;
-        comp_obj_heading_.metainfo.parent_ocn                          = 1;
-        comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
-        comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 0, 0, 0, 0];
-        comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 0, 0, 0, 0, 0, 0];
-        the_document_blurb_section                                     ~= comp_obj_heading_;
-        tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-        tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-      }
-      {
-        comp_obj_heading_                                              = comp_obj_heading_.init;
-        comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
-        comp_obj_heading_.metainfo.is_of_section                       = "blurb";
-        comp_obj_heading_.metainfo.is_of_type                          = "para";
-        comp_obj_heading_.metainfo.is_a                                = "heading";
-        comp_obj_heading_.text                                         = "Blurb";
-        comp_obj_heading_.metainfo.ocn                                 = 0;
-        comp_obj_heading_.metainfo.identifier                          = "";
-        comp_obj_heading_.metainfo.dummy_heading                       = true;
-        comp_obj_heading_.metainfo.object_number_off                   = true;
-        comp_obj_heading_.metainfo.object_number_type                  = 0;
-        comp_obj_heading_.tags.segment_anchor_tag_epub                 = "blurb";
-        comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
-        comp_obj_heading_.tags.in_segment_html                         = comp_obj_heading_.tags.anchor_tag_html;
-        comp_obj_heading_.metainfo.heading_lev_markup                  = 4;
-        comp_obj_heading_.metainfo.heading_lev_collapsed               = 2;
-        comp_obj_heading_.metainfo.parent_ocn                          = 1;
-        comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
-        comp_obj_heading_.tags.anchor_tags                             = ["blurb"];
-        comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 1, 0, 0, 0];
-        comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 1, 0, 0, 0, 0, 0];
-        the_document_blurb_section                                     ~= comp_obj_heading_;
-        tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-        tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-      }
-    } else if (line.matchFirst(rgx.headings)
-    && (opt_action.backmatter && opt_action.section_blurb)) {
-      comp_obj_heading_                                              = comp_obj_heading_.init;
-      comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
-      comp_obj_heading_.metainfo.is_of_section                       = "blurb";
-      comp_obj_heading_.metainfo.is_of_type                          = "para";
-      comp_obj_heading_.metainfo.is_a                                = "heading";
-      comp_obj_heading_.text                                         = line.to!string;
-      comp_obj_heading_.metainfo.ocn                                 = 0;
-      comp_obj_heading_.metainfo.identifier                          = "";
-      comp_obj_heading_.metainfo.dummy_heading                       = false;
-      comp_obj_heading_.metainfo.object_number_off                   = true;
-      comp_obj_heading_.metainfo.object_number_type                  = 0;
-      comp_obj_heading_.tags.segment_anchor_tag_epub                 = "blurb";
-      comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
-      comp_obj_heading_.tags.in_segment_html                         = comp_obj_heading_.tags.anchor_tag_html;
-      comp_obj_heading_.metainfo.heading_lev_markup                  = an_object["lev_markup_number"].to!int;    // make int, remove need to conv
-      comp_obj_heading_.metainfo.heading_lev_collapsed               = an_object["lev_collapsed_number"].to!int; // make int, remove need to conv
-      comp_obj_heading_.metainfo.parent_ocn                          = 1;
-      comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
-      the_document_blurb_section                                     ~= comp_obj_heading_;
-      tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-      tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-    } else if (!(line.empty)) {
-      an_object = line.flow_para_match_(an_object, an_object_key, indent, bullet, pith, line_occur);
-      comp_obj_para                               = comp_obj_para.init;
-      comp_obj_para.metainfo.is_of_part           = "backmatter";
-      comp_obj_para.metainfo.is_of_section        = "blurb";
-      comp_obj_para.metainfo.is_of_type           = "para";
-      comp_obj_para.metainfo.is_a                 = "blurb";
-      comp_obj_para.text                          = links_and_images(line.to!string.strip).replaceFirst(rgx.para_attribs, "");
-      comp_obj_para.metainfo.ocn                  = 0;
-      comp_obj_para.metainfo.identifier           = "";
-      comp_obj_para.metainfo.object_number_off    = true;
-      comp_obj_para.metainfo.object_number_type   = 0;
-      comp_obj_para.attrib.indent_hang            = indent["hang_position"];
-      comp_obj_para.attrib.indent_base            = indent["base_position"];
-      comp_obj_para.has.inline_links              = true;
-      comp_obj_para.attrib.bullet                 = bullet;
-      the_document_blurb_section                  ~= comp_obj_para;
-    }
-    pith["ocn"] = eN.ocn.on;
-  }
-  continue;
-#+END_SRC
-
-***** in blocks [+1] :block:
-
-#+NAME: abs_in_loop_body_non_code_obj_in_block
-#+BEGIN_SRC d
-} else if (pith["block_state"] == eN.blk_state.on) {
-#+END_SRC
-
-****** in block: quote :quote:
-
-#+NAME: abs_in_loop_body_non_code_obj_in_block_quote
-#+BEGIN_SRC d
-if (pith["block_is"]    == eN.blk_is.quote) {
-  line = line
-    ._doc_header_and_make_substitutions_(conf_make_meta)
-    ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
-  an_object = line.flow_txt_block_quote(an_object, pith);
-  continue;
-#+END_SRC
-
-****** in block: group :group:
-
-#+NAME: abs_in_loop_body_non_code_obj_in_block_group
-#+BEGIN_SRC d
-} else if (pith["block_is"]    == eN.blk_is.group) {
-  line = line
-    ._doc_header_and_make_substitutions_(conf_make_meta)
-    ._doc_header_and_make_substitutions_fontface_(conf_make_meta)
-    .replaceAll(rgx.para_delimiter, mkup.br_line_spaced ~ "$1");
-  an_object = line.flow_txt_block_group(an_object, pith);
-  continue;
-#+END_SRC
-
-****** in block: block :block:
-
-#+NAME: abs_in_loop_body_non_code_obj_in_block_block
-#+BEGIN_SRC d
-} else if (pith["block_is"]    == eN.blk_is.block) {
-  line = line
-    ._doc_header_and_make_substitutions_(conf_make_meta)
-    ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
-  if (auto m = line.match(rgx.spaces_keep)) {
-    line = line
-      .replaceAll(rgx.spaces_keep, (m.captures[1]).translate([ ' ' : mkup.nbsp ]));
-  }
-  an_object = line.flow_txt_block_block(an_object, pith);
-  continue;
-#+END_SRC
-
-****** in block: poem :poem:
-
-#+NAME: abs_in_loop_body_non_code_obj_in_block_poem
-#+BEGIN_SRC d
-} else if (pith["block_is"]    == eN.blk_is.poem) {
-  an_object = line.flow_txt_block_poem(an_object, pith, cntr, object_number_poem, conf_make_meta, tag_in_seg);
-  continue;
-#+END_SRC
-
-****** in block: table :table:
-
-#+NAME: abs_in_loop_body_non_code_obj_in_block_table
-#+BEGIN_SRC d
-} else if (pith["block_is"]    == eN.blk_is.table) {
-  an_object = line.flow_txt_block_table(an_object, pith, conf_make_meta);
-  continue;
-}
-#+END_SRC
-
-***** not identified as being within block group (could still be, or not) [+3]
-****** assert
-
-#+NAME: abs_in_loop_body_open_block_obj_assert
-#+BEGIN_SRC d
-assert(
-  (pith["block_state"] == eN.blk_state.off)
-  || (pith["block_state"] == eN.blk_state.closing),
-  "block status: none or closed"
-);
-#+END_SRC
-
-****** catch misc +block open+
-
-#+NAME: abs_in_loop_body_open_block_obj
-#+BEGIN_SRC d
-if (line.matchFirst(rgx.block_poem_open)) {                                    /+ poem to verse exceptions! +/
-  object_reset(an_object);
-  processing.remove("verse");
-  object_number_poem["start"] = obj_cite_digits.object_number.to!string;
-}
-line.flow_txt_block_start(pith, dochas, object_number_poem);
-continue;
-#+END_SRC
-
-****** line not empty [+2]
-******* asserts :assert:
-
-#+NAME: abs_in_loop_body_not_block_obj_assert
-#+BEGIN_SRC d
-assert(
-  !line.empty,
-  "line tested, line not empty surely:\n  \"" ~ line ~ "\""
-);
-assert(
-  (pith["block_state"] == eN.blk_state.off)
-  || (pith["block_state"] == eN.blk_state.closing),
-  "code block status: none or closed"
-);
-if (pith["block_state"] == eN.blk_state.closing) {
-  debug(check) {
-    writeln(__LINE__);
-    writeln(line);
-  }
-  assert(
-    line.matchFirst(rgx.book_index_item)
-    || line.matchFirst(rgx.book_index_item_open)
-    || pith["section"] == eN.sect.book_index,
-    "\nblocks closed, unless followed by book index, non-matching line:\n  \""
-    ~ line ~ "\""
-  );
-}
-#+END_SRC
-
-******* book index :bookindex:
-
-#+NAME: abs_in_loop_body_not_block_obj_bookindex
-#+BEGIN_SRC d
-if (line.matchFirst(rgx.book_index_item)
-|| line.matchFirst(rgx.book_index_item_open)
-|| pith["section"] == eN.sect.book_index)  {                            /+ book_index +/
-  an_object = line.flow_book_index_(an_object, book_idx_tmp, pith, opt_action);
-#+END_SRC
-
-******* not book index [+1]
-
-#+NAME: abs_in_loop_body_not_block_obj_not_bookindex
-#+BEGIN_SRC d
-} else {                                                                       /+ not book_index +/
-#+END_SRC
-
-******** matched: comment :comment:match:
-
-#+NAME: abs_in_loop_body_not_block_obj_not_bookindex_a_comment
-#+BEGIN_SRC d
-an_object_key = "body_nugget";
-if (auto m = line.matchFirst(rgx.comment)) {                                 /+ matched comment +/
-  debug(comment) {
-    writeln(line);
-  }
-  an_object[an_object_key]                ~= line ~= "\n";
-  comp_obj_comment                        = comp_obj_comment.init;
-  comp_obj_comment.metainfo.is_of_part    = "comment"; // breaks flow
-  comp_obj_comment.metainfo.is_of_section = "comment"; // breaks flow
-  comp_obj_comment.metainfo.is_of_type    = "comment";
-  comp_obj_comment.metainfo.is_a          = "comment";
-  comp_obj_comment.text                   = an_object[an_object_key].strip;
-  the_document_body_section               ~= comp_obj_comment;
-  flow_common_reset_(line_occur, an_object, pith);
-  processing.remove("verse");
-  ++cntr;
-#+END_SRC
-
-******** flag !set & line !exist: heading or para :heading:paragraph:
-
-#+NAME: abs_in_loop_body_not_block_obj_not_bookindex_a_para_type
-#+BEGIN_SRC d
-} else if ((line_occur["para"] == eN.bi.off
-  && line_occur["heading"] == eN.bi.off)
-  && pith["txt_is"] == eN.txt_is.off
-) {                             /+ heading or para but neither flag nor line exists +/
-  if ((conf_make_meta.make.headings.length > 2)
-  && (pith["make_headings"] == eN.bi.off)) {                      /+ heading found +/
-    heading_match_str = line.flow_heading_found_(heading_match_str, conf_make_meta.make.headings, heading_match_rgx, pith);
-  }
-  if (pith["make_headings"] == eN.bi.on
-    && (line_occur["para"] == eN.bi.off
-    && line_occur["heading"] == eN.bi.off)
-    && pith["txt_is"] == eN.txt_is.off
-  ) {                           /+ heading make set +/
-    line = line.flow_heading_make_set_(line_occur, heading_match_rgx, pith);
-  }
-  /+ TODO node info: all headings identified at this point,
-     - extract node info here??
-     - how long can it wait?
-     - should be incorporated in composite objects
-     - should happen before endnote links set (they need to be moved down?)
-  +/
-  if (line.matchFirst(rgx.headings)) {                                        /+ heading match +/
-    line = line._doc_header_and_make_substitutions_(conf_make_meta);
-    an_object = line.flow_heading_matched_(
-      an_object,
-      line_occur,
-      an_object_key,
-      lv,
-      collapsed_lev,
-      pith,
-      conf_make_meta,
-    );
-  } else if (line_occur["para"] == eN.bi.off) {                              /+ para match +/
-    an_object_key = "body_nugget";
-    line = line
-      ._doc_header_and_make_substitutions_(conf_make_meta)
-      ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
-    an_object = line.flow_para_match_(an_object, an_object_key, indent, bullet, pith, line_occur);
-  }
-#+END_SRC
-
-******** line exist: heading :heading:
-
-#+NAME: abs_in_loop_body_not_block_obj_not_bookindex_a_heading
-#+BEGIN_SRC d
-} else if (line_occur["heading"] > eN.bi.off) {                              /+ heading +/
-  debug(heading) {
-    writeln(line);
-  }
-  an_object[an_object_key] ~= line ~= "\n";
-  ++line_occur["heading"];
-#+END_SRC
-
-******** line exist: para :para:
-
-#+NAME: abs_in_loop_body_not_block_obj_not_bookindex_a_para
-#+BEGIN_SRC d
-} else if (line_occur["para"] > eN.bi.off) {                                 /+ paragraph +/
-  debug(para) {
-    writeln(an_object_key, "-> ", line);
-  }
-  line = line
-    ._doc_header_and_make_substitutions_(conf_make_meta)
-    ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
-  an_object[an_object_key] ~= " " ~ line;
-  ++line_occur["para"];
-}
-#+END_SRC
-
-******** not book index close
-
-#+NAME: abs_in_loop_body_not_block_obj_not_bookindex_close
-#+BEGIN_SRC d
-}
-#+END_SRC
-
-****** line empty, with block flag
-
-#+NAME: abs_in_loop_body_not_block_obj_line_empty_blocks_flags
-#+BEGIN_SRC d
-an_object = line.flow_block_flag_line_empty_(
-  an_object,
-  bookindex_extract_hash,
-  the_document_body_section,
-  bookindex_unordered_hashes,
-  obj_cite_digits,
-  comp_obj_heading,
-  cntr,
-  pith,
-  object_number_poem,
-  conf_make_meta,
-  tag_in_seg,
-);
-#+END_SRC
-
-****** line empty [+1]
-******* assert line empty :assert:
-
-#+NAME: abs_in_loop_body_not_block_obj_line_empty_assert
-#+BEGIN_SRC d
-assert(
-  line.empty,
-  "\nline should be empty:\n  \""
-  ~ line ~ "\""
-);
-assert(
-  (pith["block_state"] == eN.blk_state.off),
-  "code block status: none"
-);
-#+END_SRC
-
-******* heading object :heading:object:
-
-#+NAME: abs_in_loop_body_not_block_obj_line_empty_heading_obj
-#+BEGIN_SRC d
-if (_new_doc) {
-  tag_assoc   = tag_assoc.init;
-  lv0to3_tags = lv0to3_tags.init;
-  tag_in_seg  = tag_in_seg.init;
-}
-if (pith["txt_is"] == eN.txt_is.heading
-  && line_occur["heading"] > eN.bi.off
-) {                                      /+ heading object (current line empty) +/
-  obj_cite_digits = (an_object["lev_markup_number"].to!int == 0)
-  ? ocn_emit(eN.ocn.reset)
-  : ocn_emit(pith["ocn"]);
-  an_object["is"] = "heading";
-  an_object_key = "body_nugget";
-  TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_object_and_anchor_tags_tuple
-    = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, ((_new_doc) ? Yes._new_doc : No._new_doc));
-  an_object["substantive"] = substantive_object_and_anchor_tags_tuple[sObj.content];
-  anchor_tag = substantive_object_and_anchor_tags_tuple[sObj.anchor_tag];
-  if (_new_doc) {
-    cnt1 = 1;
-    cnt2 = 1;
-    cnt3 = 1;
-    _new_doc = false;
-  }
-  if (
-    an_object["lev_markup_number"].to!int == 4
-    && (!(anchor_tag.empty)
-    || (lv0to3_tags.length > 0))
-  ) {
-    tag_in_seg["seg_lv4"]    = anchor_tag;
-    tag_in_seg["seg_lv1to4"] = anchor_tag;
-    lev_anchor_tag = anchor_tag;
-    tag_assoc[anchor_tag]["seg_lv4"]    = tag_in_seg["seg_lv4"];
-    tag_assoc[anchor_tag]["seg_lv1to4"] = tag_in_seg["seg_lv1to4"];
-    if (lv0to3_tags.length > 0) { /+ names used for html markup segments 1 to 4 (rather than epub which has separate segments for A to D) +/
-      foreach (lv0_to_lv3_html_tag; lv0to3_tags) {
-        tag_assoc[lv0_to_lv3_html_tag]["seg_lv4"] = anchor_tag;
-      }
-    }
-    anchor_tag_ = anchor_tag;
-    lv0to3_tags = lv0to3_tags.init;
-  } else if (an_object["lev_markup_number"].to!int > 4) {
-    tag_in_seg["seg_lv4"]    = anchor_tag_;
-    tag_in_seg["seg_lv1to4"] = anchor_tag_;
-    lev_anchor_tag           = anchor_tag;
-    tag_assoc[anchor_tag]["seg_lv4"] = tag_in_seg["seg_lv4"];
-    tag_assoc[anchor_tag]["seg_lv1to4"] = tag_in_seg["seg_lv1to4"];
-  } else if (an_object["lev_markup_number"].to!int < 4) {
-    string segn;
-    switch (an_object["lev_markup_number"].to!int) {                           /+ names used for epub markup segments A to D +/
-    case 0:
-      segn = "_the_title";
-      goto default;
-    case 1:
-      segn = "_part_" ~ cnt1.to!string;
-      ++cnt1;
-      goto default;
-    case 2:
-      segn = "_part_" ~ cnt1.to!string ~ "_" ~ cnt2.to!string;
-      ++cnt2;
-      goto default;
-    case 3:
-      segn =  "_part_" ~ cnt1.to!string ~ "_" ~ cnt2.to!string ~ "_" ~ cnt3.to!string;
-      ++cnt3;
-      goto default;
-    default:
-      lv0to3_tags ~= obj_cite_digits.object_number.to!string;
-      lv0to3_tags ~= segn;
-      tag_in_seg["seg_lv4"]    = segn; // for html segname need following lv4 not yet known
-      tag_in_seg["seg_lv1to4"] = segn;
-      break;
-    }
-  }
-  an_object["bookindex_nugget"]
-    = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
-  bookindex_unordered_hashes
-    = bookindex_extract_hash.bookindex_nugget_hash(an_object["bookindex_nugget"], obj_cite_digits, tag_in_seg);
-  /+ (incrementally build toc) table of contents here! +/
-  _anchor_tag                   = obj_cite_digits.identifier;
-  the_document_toc_section      = obj_im.flow_table_of_contents_gather_headings(
-    an_object,
-    conf_make_meta,
-    tag_in_seg,
-    _anchor_tag,
-    lev4_subtoc,
-    the_document_toc_section,
-  );
-  if (an_object["lev_markup_number"] == "4") {
-    segnames["html"] ~= tag_in_seg["seg_lv4"];
-    html_segnames_ptr = html_segnames_ptr_cntr;
-    html_segnames_ptr_cntr++;
+  static auto rgx = RgxI();
+  /+ ↓ abstraction init +/
+  scope(success) {
   }
-  if (an_object["lev_markup_number"].to!int <= 4) {
-    segnames["epub"] ~= tag_in_seg["seg_lv1to4"];
+  scope(failure) {
   }
-  auto comp_obj_heading
-    = node_construct.node_emitter_heading(
-      an_object["substantive"],
-      an_object["lev_markup_number"],
-      an_object["lev_collapsed_number"],
-      an_object["dummy_heading_status"],
-      tag_in_seg,
-      lev_anchor_tag,
-      tag_assoc,
-      obj_cite_digits,                              // OCNset
-      cntr,                                         // int
-      heading_ptr,                                  // int
-      lv_ancestors_txt,                             // string[]
-      an_object["is"],                              // string
-      html_segnames_ptr,                            // int
-      substantive_object_and_anchor_tags_tuple[sObj.notes_reg],
-      substantive_object_and_anchor_tags_tuple[sObj.notes_star],
-      substantive_object_and_anchor_tags_tuple[sObj.links],
-    );
-  ++heading_ptr;
-  debug(segments) {
-    writeln(an_object["lev_markup_number"]);
-    writeln(tag_in_seg["seg_lv4"]);
-    writeln(tag_in_seg["seg_lv1to4"]);
-  }
-  the_document_body_section ~= comp_obj_heading;
-  debug(objectrelated1) { // check
-    writeln(line);
-  }
-  flow_common_reset_(line_occur, an_object, pith);
-  an_object.remove("lev");
-  an_object.remove("lev_markup_number");
-  processing.remove("verse");
-  ++cntr;
-#+END_SRC
-
-******* paragraph object :paragraph:object:
-
-#+NAME: abs_in_loop_body_not_block_obj_line_empty_para_obj
-#+BEGIN_SRC d
-} else if (pith["txt_is"] == eN.txt_is.para
-  && line_occur["para"] > eN.bi.off
-) {
-  /+ paragraph object (current line empty) +/
-  /+ repeated character paragraph separator +/
-  if ((an_object[an_object_key].to!string).matchFirst(rgx.repeated_character_line_separator)) {
-    pith["ocn"] = eN.ocn.off;
+  scope(exit) {
+    destroy(the_document_toc_section);
+    destroy(the_document_head_section);
+    destroy(the_document_body_section);
+    destroy(the_document_bibliography_section);
+    destroy(the_document_glossary_section);
+    destroy(the_document_blurb_section);
+    destroy(the_document_xml_dom_tail_section);
+    destroy(an_object);
+    destroy(processing);
+    destroy(biblio_arr_json);
+    previous_length = 0;
+    reset_note_numbers = true;
+    lev_anchor_tag = "";
+    anchor_tag = "";
   }
-  obj_cite_digits = ocn_emit(pith["ocn"]);
-  an_object["bookindex_nugget"]
-    = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
-  bookindex_unordered_hashes
-    = bookindex_extract_hash.bookindex_nugget_hash(an_object["bookindex_nugget"], obj_cite_digits, tag_in_seg);
-  an_object["is"] = "para";
-  auto comp_obj_heading
-    = node_construct.node_location_emitter(
-      content_non_header,
-      tag_in_seg,
-      lev_anchor_tag,
-      tag_assoc,
-      obj_cite_digits,
-      cntr,
-      heading_ptr-1,
-      an_object["is"],
-    );
-  TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
-    = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
-  an_object["substantive"] = substantive_obj_misc_tuple[sObj.content];
-  anchor_tag = substantive_obj_misc_tuple[sObj.anchor_tag];
-  comp_obj_para                                       = comp_obj_para.init;
-  comp_obj_para.metainfo.is_of_part                   = "body";
-  comp_obj_para.metainfo.is_of_section                = "body";
-  comp_obj_para.metainfo.is_of_type                   = "para";
-  comp_obj_para.metainfo.is_a                         = "para";
-  comp_obj_para.text                                  = an_object["substantive"].to!string.strip;
-  comp_obj_para.tags.html_segment_anchor_tag_is       = tag_in_seg["seg_lv4"];
-  comp_obj_para.tags.epub_segment_anchor_tag_is       = tag_in_seg["seg_lv1to4"];
-  comp_obj_para.metainfo.ocn                          = obj_cite_digits.object_number;
-  comp_obj_para.metainfo.identifier                   = obj_cite_digits.identifier;
-  comp_obj_para.metainfo.object_number_off            = (obj_cite_digits.off == 0)   ? true : false; // TODO
-  comp_obj_para.metainfo.o_n_book_index               = obj_cite_digits.bkidx;
-  comp_obj_para.metainfo.object_number_type           = obj_cite_digits.type;
-  comp_obj_para.attrib.indent_hang                    = indent["hang_position"];
-  comp_obj_para.attrib.indent_base                    = indent["base_position"];
-  comp_obj_para.attrib.bullet                         = bullet;
-  comp_obj_para.tags.anchor_tags                      = [anchor_tag]; anchor_tag="";
-  comp_obj_para.has.inline_notes_reg                  = substantive_obj_misc_tuple[sObj.notes_reg];
-  comp_obj_para.has.inline_notes_star                 = substantive_obj_misc_tuple[sObj.notes_star];
-  comp_obj_para.has.inline_links                      = substantive_obj_misc_tuple[sObj.links];
-  comp_obj_para.has.image_without_dimensions          = substantive_obj_misc_tuple[sObj.image_no_dimensions];
-  the_document_body_section                           ~= comp_obj_para;
-  tag_assoc                                           = an_object.inline_para_link_anchor(tag_in_seg, tag_assoc);
-  flow_common_reset_(line_occur, an_object, pith);
-  indent = [
-    "hang_position" : 0,
-    "base_position" : 0,
+  mixin spineNode;
+  auto node_para_int_    = node_metadata_para_int;
+  auto node_para_str_    = node_metadata_para_str;
+  ObjGenericComposite comp_obj_heading_, comp_obj_para, comp_obj_toc;
+  line_occur = [
+    "heading"  : 0,
+    "para"     : 0,
+    "glossary" : 0,
+    "blurb"    : 0,
   ];
-  bullet = false;
-  processing.remove("verse");
-  ++cntr;
-} else {
-  // could be useful to test line variable should be empty and never null
-}
-#+END_SRC
-
-*** regular _text objects_ identified :text:paragraph:
-
-#+NAME: abs_in_loop_body_reloop_get_prior_state
-#+BEGIN_SRC d
-/+ unless (the_document_body_section.length == 0) ? +/
-if (the_document_body_section.length > 0) {
-  if (((the_document_body_section[$-1].metainfo.is_a == "para")
-    || (the_document_body_section[$-1].metainfo.is_a == "heading")
-    || (the_document_body_section[$-1].metainfo.is_a == "quote")
-    || (the_document_body_section[$-1].metainfo.is_a == "group")
-    || (the_document_body_section[$-1].metainfo.is_a == "block")
-    || (the_document_body_section[$-1].metainfo.is_a == "verse"))
-  && (the_document_body_section.length > previous_length)) {
-    if ((the_document_body_section[$-1].metainfo.is_a == "heading")
-    && (the_document_body_section[$-1].metainfo.heading_lev_markup < 5)) {
-      pith["section"] = eN.sect.unset;
-    }
-    if (the_document_body_section[$-1].metainfo.is_a == "verse") {             /+ scan for endnotes for whole poem (each verse in poem) +/
-      foreach (i; previous_length .. the_document_body_section.length) {
-        if (the_document_body_section[i].metainfo.is_a == "verse") {
-          if ((the_document_body_section[i].text).match(
-            rgx.inline_notes_al_all_note
-          )) {
-            note_section.gather_notes_for_endnote_section(
-              the_document_body_section,
-              tag_in_seg,
-              (i).to!int,
-            );
-          }
-        }
-      }
-    } else {                                                                   /+ scan object for endnotes +/
-      previous_length = the_document_body_section.length.to!int;
-      if ((the_document_body_section[$-1].text).match(
-        rgx.inline_notes_al_all_note
-      )) {
-        previous_count = (the_document_body_section.length -1).to!int;
-        note_section.gather_notes_for_endnote_section(
-          the_document_body_section,
-          tag_in_seg,
-          (the_document_body_section.length-1).to!int,
-        );
-      }
-    }
-    previous_length = the_document_body_section.length.to!int;
-  }
-}
-#+END_SRC
-
-** 3. _post main-loop processing_ :post:
-*** misc
-
-/+
-  Backmatter:
-  - endnotes
-  - glossary
-  - bibliography / references
-  - book index
-  - blurb
-+/
-
-*** tie up preparation of document sections
-**** in section: xml_dom_tail_section
-
-eof xml_dom_tail_section
-
-#+NAME: abs_loop_body_exit_eof_xml_dom_tail
-#+BEGIN_SRC d
-{ // EOF
+  uint[string] dochas = [
+    "inline_links"      : 0,
+    "inline_notes"      : 0,
+    "inline_notes_star" : 0,
+    "codeblock"         : 0,
+    "table"             : 0,
+    "block"             : 0,
+    "group"             : 0,
+    "poem"              : 0,
+    "quote"             : 0,
+    "images"            : 0,
+  ];
+  uint[string] pith = [
+    "ocn"                            : 1,
+    "section"                        : 0,
+    "txt_is"                         : 0,
+    "block_is"                       : 0,
+    "block_state"                    : 0,
+    "block_delim"                    : 0,
+    "make_headings"                  : 0,
+    "dummy_heading_status"           : 0,
+    "dummy_heading_multiple_objects" : 0,
+    "no_ocn_multiple_objects"        : 0,
+    "verse_new"                      : 0,
+  ];
+  string[string] object_number_poem = [
+    "start" : "",
+    "end"   : ""
+  ];
+  string[] lv_ancestors_txt = [ "", "", "", "", "", "", "", "", ];
+  int[string] lv = [
+    "lv" : eN.bi.off,
+    "h0" : eN.bi.off,
+    "h1" : eN.bi.off,
+    "h2" : eN.bi.off,
+    "h3" : eN.bi.off,
+    "h4" : eN.bi.off,
+    "h5" : eN.bi.off,
+    "h6" : eN.bi.off,
+    "h7" : eN.bi.off,
+    "lev_int_collapsed" : 0,
+  ];
+  int[string] collapsed_lev = [
+    "h0" : eN.bi.off,
+    "h1" : eN.bi.off,
+    "h2" : eN.bi.off,
+    "h3" : eN.bi.off,
+    "h4" : eN.bi.off,
+    "h5" : eN.bi.off,
+    "h6" : eN.bi.off,
+    "h7" : eN.bi.off
+  ];
+  string[string] heading_match_str = [
+    "h_A": "^(none)",
+    "h_B": "^(none)",
+    "h_C": "^(none)",
+    "h_D": "^(none)",
+    "h_1": "^(none)",
+    "h_2": "^(none)",
+    "h_3": "^(none)",
+    "h_4": "^(none)"
+  ];
+  Regex!char[string] heading_match_rgx = [
+    "h_A": regex(r"^(none)"),
+    "h_B": regex(r"^(none)"),
+    "h_C": regex(r"^(none)"),
+    "h_D": regex(r"^(none)"),
+    "h_1": regex(r"^(none)"),
+    "h_2": regex(r"^(none)"),
+    "h_3": regex(r"^(none)"),
+    "h_4": regex(r"^(none)")
+  ];
+  string _anchor_tag;
+  string toc_txt_;
+  an_object["glossary_nugget"]                                   = "";
+  an_object["blurb_nugget"]                                      = "";
   comp_obj_heading_                                              = comp_obj_heading_.init;
-  comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
-  comp_obj_heading_.metainfo.is_of_section                       = "tail";
+  comp_obj_heading_.metainfo.is_of_part                          = "frontmatter";
+  comp_obj_heading_.metainfo.is_of_section                       = "toc";
   comp_obj_heading_.metainfo.is_of_type                          = "para";
   comp_obj_heading_.metainfo.is_a                                = "heading";
-  comp_obj_heading_.text                                         = "";
+  comp_obj_heading_.text                                         = "Table of Contents";
   comp_obj_heading_.metainfo.ocn                                 = 0;
   comp_obj_heading_.metainfo.identifier                          = "";
   comp_obj_heading_.metainfo.dummy_heading                       = false;
-  comp_obj_heading_.metainfo.object_number_off                   = false;
+  comp_obj_heading_.metainfo.object_number_off                   = true;
   comp_obj_heading_.metainfo.object_number_type                  = 0;
-  comp_obj_heading_.tags.segment_anchor_tag_epub                 = "_part_eof";
+  comp_obj_heading_.tags.segment_anchor_tag_epub                 = "toc";
   comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
-  comp_obj_heading_.tags.in_segment_html                         = "tail";
-  comp_obj_heading_.tags.anchor_tags                             = ["section_eof"];
-  comp_obj_heading_.metainfo.heading_lev_markup                  = 1;
+  comp_obj_heading_.tags.in_segment_html                         = comp_obj_heading_.tags.anchor_tag_html;
+  comp_obj_heading_.metainfo.heading_lev_markup                  = 4;
   comp_obj_heading_.metainfo.heading_lev_collapsed               = 1;
   comp_obj_heading_.metainfo.parent_ocn                          = 1;
   comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
-  comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 0, 0, 0, 0, 0, 0, 0, 0];
-  comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 0, 0, 0, 0, 0, 0, 0, 0];
-  the_document_xml_dom_tail_section                              ~= comp_obj_heading_;
+  comp_obj_heading_.ptr.html_segnames                            = html_segnames_ptr;
+  comp_obj_heading_.tags.anchor_tags                             = ["toc"];
+  comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 1, 0, 0, 0];
+  comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 1, 0, 0, 0, 0, 0];
   tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
   tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-}
-#+END_SRC
-
-**** endnotes section (scroll & seg) :endnotes:
-
-#+NAME: abs_post_endnote_tuple
-#+BEGIN_SRC d
-auto en_tuple = note_section.endnote_objects(obj_cite_digits, opt_action);
-auto the_document_endnotes_section = en_tuple[0];
-obj_cite_digits = en_tuple[1];
-debug(endnotes) {
-  writefln("%s %s",
-    __LINE__,
-    the_document_endnotes_section.length
-  );
-  foreach (o; the_document_endnotes_section) {
-    writeln(o);
-  }
-}
-#+END_SRC
-
-**** no glossary section? :glossary:
-
-#+NAME: abs_post_glossary_nugget
-#+BEGIN_SRC d
-if (an_object["glossary_nugget"].length == 0) {
-  comp_obj_heading_                                   = comp_obj_heading_.init;
-  comp_obj_heading_.metainfo.is_of_part               = "empty";
-  comp_obj_heading_.metainfo.is_of_section            = "empty";
-  comp_obj_heading_.metainfo.is_of_type               = "para";
-  comp_obj_heading_.metainfo.is_a                     = "heading";
-  comp_obj_heading_.text                              = "(skip) there is no Glossary section";
-  comp_obj_heading_.metainfo.ocn                      = 0;
-  comp_obj_heading_.metainfo.identifier               = "";
-  comp_obj_heading_.metainfo.dummy_heading            = true;
-  comp_obj_heading_.metainfo.object_number_off        = true;
-  comp_obj_heading_.metainfo.object_number_type       = 0;
-  comp_obj_heading_.metainfo.heading_lev_markup       = 1;
-  comp_obj_heading_.metainfo.heading_lev_collapsed    = 1;
-  comp_obj_heading_.metainfo.parent_ocn               = 1;
-  comp_obj_heading_.metainfo.parent_lev_markup        = 0;
-  the_document_glossary_section                       ~= comp_obj_heading_;
-}
-debug(glossary) {
-  foreach (gloss; the_document_glossary_section) {
-    writeln(gloss.text);
-  }
-}
-#+END_SRC
-
-**** bibliography section (objects) :bibliography:
-
-#+NAME: abs_post_biblio_init
-#+BEGIN_SRC d
-auto biblio_unsorted_incomplete = biblio_arr_json.dup;
-auto biblio = Bibliography();
-auto biblio_ordered
-  = biblio.flow_bibliography_(biblio_unsorted_incomplete, bib_arr_json);
-#+END_SRC
-
-#+NAME: abs_post_biblio
-#+BEGIN_SRC d
-if (biblio_ordered.length > 0) {
-  {
-    comp_obj_heading_                                 = comp_obj_heading_.init;
-    comp_obj_heading_.metainfo.is_of_part             = "backmatter";
-    comp_obj_heading_.metainfo.is_of_section          = "bibliography";
-    comp_obj_heading_.metainfo.is_of_type             = "para";
-    comp_obj_heading_.metainfo.is_a                   = "heading";
-    comp_obj_heading_.text                            = "Bibliography";
-    comp_obj_heading_.metainfo.ocn                    = 0;
-    comp_obj_heading_.metainfo.identifier             = "";
-    comp_obj_heading_.metainfo.dummy_heading          = false;
-    comp_obj_heading_.metainfo.object_number_off      = false;
-    comp_obj_heading_.metainfo.object_number_type     = 0;
-    comp_obj_heading_.tags.segment_anchor_tag_epub    = "_part_bibliography";
-    comp_obj_heading_.tags.anchor_tag_html            = comp_obj_heading_.tags.segment_anchor_tag_epub;
-    comp_obj_heading_.tags.in_segment_html            = "bibliography";
-    comp_obj_heading_.tags.anchor_tags                = ["section_bibliography"];
-    comp_obj_heading_.metainfo.heading_lev_markup     = 1;
-    comp_obj_heading_.metainfo.heading_lev_collapsed  = 1;
-    comp_obj_heading_.metainfo.parent_ocn             = 1;
-    comp_obj_heading_.metainfo.parent_lev_markup      = 0;
-    comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 0, 0, 0, 0];
-    comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 0, 0, 0, 0, 0, 0];
-    the_document_bibliography_section                 ~= comp_obj_heading_;
-    tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-    tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-  }
-  {
-    comp_obj_heading_                                 = comp_obj_heading_.init;
-    comp_obj_heading_.metainfo.is_of_part             = "backmatter";
-    comp_obj_heading_.metainfo.is_of_section          = "bibliography";
-    comp_obj_heading_.metainfo.is_of_type             = "para";
-    comp_obj_heading_.metainfo.is_a                   = "heading";
-    comp_obj_heading_.text                            = "Bibliography";
-    comp_obj_heading_.metainfo.ocn                    = 0;
-    comp_obj_heading_.metainfo.identifier             = "";
-    comp_obj_heading_.metainfo.dummy_heading          = true;
-    comp_obj_heading_.metainfo.object_number_off      = true;
-    comp_obj_heading_.metainfo.object_number_type     = 0;
-    comp_obj_heading_.tags.segment_anchor_tag_epub    = "bibliography";
-    comp_obj_heading_.tags.anchor_tag_html            = comp_obj_heading_.tags.segment_anchor_tag_epub;
-    comp_obj_heading_.tags.in_segment_html            = comp_obj_heading_.tags.anchor_tag_html;
-    comp_obj_heading_.metainfo.heading_lev_markup     = 4;
-    comp_obj_heading_.metainfo.heading_lev_collapsed  = 2;
-    comp_obj_heading_.metainfo.parent_ocn             = 1;
-    comp_obj_heading_.metainfo.parent_lev_markup      = 0;
-    comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 1, 0, 0, 0];
-    comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 1, 0, 0, 0, 0, 0];
-    comp_obj_heading_.tags.anchor_tags                = ["bibliography"];
-    the_document_bibliography_section                 ~= comp_obj_heading_;
-    tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-    tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-  }
-  {
-    string out_;
-    foreach (entry; biblio_ordered) {
-      out_ = format("%s \"%s\"%s%s%s%s%s%s%s%s%s.",
-        ((entry["author"].str.empty) ? entry["editor"].str : entry["author"].str),
-        entry["fulltitle"].str,
-        ((entry["journal"].str.empty) ? "" : ", " ~ mkup.ff_i ~ mkup.italic ~ mkup.ff_o ~ entry["journal"].str ~ mkup.ff_c ~ mkup.italic),
-        ((entry["volume"].str.empty) ? "" : ", " ~ entry["volume"].str),
-        ((entry["in"].str.empty) ? "" : ", " ~ entry["in"].str),
-        ((!(entry["author"].str.empty) && (!(entry["editor"].str.empty))) ? entry["editor"].str : ""),
-        ", " ~ entry["year"].str,
-        ((entry["pages"].str.empty) ? "" : ", " ~ entry["pages"].str),
-        ((entry["publisher"].str.empty) ? "" : ", " ~ entry["publisher"].str),
-        ((entry["place"].str.empty) ? "" : ", " ~ entry["place"].str),
-        ((entry["url"].str.empty) ? "" : ", [" ~ entry["url"].str ~ "]"),
-      );
-      comp_obj_para                                   = comp_obj_para.init;
-      comp_obj_para.metainfo.is_of_part               = "backmatter";
-      comp_obj_para.metainfo.is_of_section            = "bibliography";
-      comp_obj_para.metainfo.is_of_type               = "para";
-      comp_obj_para.metainfo.is_a                     = "bibliography";
-      comp_obj_para.text                              = out_.to!string.strip;
-      comp_obj_para.metainfo.ocn                      = 0;
-      comp_obj_para.metainfo.identifier               = "";
-      comp_obj_para.metainfo.object_number_off        = true;
-      comp_obj_para.metainfo.object_number_type       = 0;
-      comp_obj_para.attrib.indent_hang                = 0;
-      comp_obj_para.attrib.indent_base                = 1;
-      comp_obj_para.attrib.bullet                     = bullet;
-      comp_obj_para.tags.anchor_tags                  = [anchor_tag];
-      the_document_bibliography_section               ~= comp_obj_para;
-    }
-  }
-} else {
-  comp_obj_heading_                                   = comp_obj_heading_.init;
-  comp_obj_heading_.metainfo.is_of_part               = "empty";
-  comp_obj_heading_.metainfo.is_of_section            = "empty";
-  comp_obj_heading_.metainfo.is_of_type               = "para";
-  comp_obj_heading_.metainfo.is_a                     = "heading";
-  comp_obj_heading_.text                              = "(skip) there is no Bibliography";
-  comp_obj_heading_.metainfo.ocn                      = 0;
-  comp_obj_heading_.metainfo.identifier               = "";
-  comp_obj_heading_.metainfo.dummy_heading            = true;
-  comp_obj_heading_.metainfo.object_number_off        = true;
-  comp_obj_heading_.metainfo.object_number_type       = 0;
-  comp_obj_heading_.metainfo.heading_lev_markup       = 1;
-  comp_obj_heading_.metainfo.heading_lev_collapsed    = 1;
-  comp_obj_heading_.metainfo.parent_ocn               = 1;
-  comp_obj_heading_.metainfo.parent_lev_markup        = 0;
-  the_document_bibliography_section                   ~= comp_obj_heading_;
-}
-#+END_SRC
-
-#+NAME: abs_post_biblio_debug_write
-#+BEGIN_SRC d
-debug(bibliosection) {
-  foreach (o; the_document_bibliography_section) {
-    writeln(o.text);
-  }
-}
-#+END_SRC
-
-***** bibliography components
-
-#+BEGIN_SRC d
-JSONValue biblio_entry_tags_jsonstr =  `{
-  "is"                               : "",
-  "sortby_deemed_author_year_title"  : "",
-  "deemed_author"                    : "",
-  "author_raw"                       : "",
-  "author"                           : "",
-  "author_arr"                       : [ "" ],
-  "editor_raw"                       : "",
-  "editor"                           : "",
-  "editor_arr"                       : [ "" ],
-  "title"                            : "",
-  "subtitle"                         : "",
-  "fulltitle"                        : "",
-  "language"                         : "",
-  "trans"                            : "",
-  "src"                              : "",
-  "journal"                          : "",
-  "in"                               : "",
-  "volume"                           : "",
-  "edition"                          : "",
-  "year"                             : "",
-  "place"                            : "",
-  "publisher"                        : "",
-  "url"                              : "",
-  "pages"                            : "",
-  "note"                             : "",
-  "short_name"                       : "",
-  "id"                               : ""
-}`; // is: book, article, magazine, newspaper, blog, other
-#+END_SRC
-
-**** bookindex section (scroll & seg) :book:index:
-
-#+NAME: abs_post_bookindex
-#+BEGIN_SRC d
-auto bi = BookIndexReportSection();
-auto bi_tuple
-  = bi.bookindex_build_abstraction_section(
-    bookindex_unordered_hashes,
-    obj_cite_digits,
-    opt_action,
-  );
-destroy(bookindex_unordered_hashes);
-auto the_document_bookindex_section = bi_tuple[0];
-obj_cite_digits = bi_tuple[1];
-debug(bookindex) {
-  foreach (bi_entry; the_document_bookindex_section) {
-    writeln(bi_entry);
-  }
-}
-#+END_SRC
-
-**** no blurb section? :blurb:
-
-#+NAME: abs_post_no_blurb
-#+BEGIN_SRC d
-if (an_object["blurb_nugget"].length == 0) {
-  comp_obj_heading_                                   = comp_obj_heading_.init;
-  comp_obj_heading_.metainfo.is_of_part               = "empty";
-  comp_obj_heading_.metainfo.is_of_section            = "empty";
-  comp_obj_heading_.metainfo.is_of_type               = "para";
-  comp_obj_heading_.metainfo.is_a                     = "heading";
-  comp_obj_heading_.text                              = "(skip) there is no Blurb section";
-  comp_obj_heading_.metainfo.ocn                      = 0;
-  comp_obj_heading_.metainfo.identifier               = "";
-  comp_obj_para.metainfo.object_number_off            = true;
-  comp_obj_para.metainfo.object_number_type           = 0;
-  comp_obj_heading_.tags.segment_anchor_tag_epub      = "";
-  comp_obj_heading_.tags.anchor_tag_html              = "";
-  comp_obj_heading_.tags.in_segment_html              = "";
-  comp_obj_heading_.metainfo.heading_lev_markup       = 1;
-  comp_obj_heading_.metainfo.heading_lev_collapsed    = 1;
-  comp_obj_heading_.metainfo.parent_ocn               = 1;
-  comp_obj_heading_.metainfo.parent_lev_markup        = 0;
-  the_document_blurb_section                          ~= comp_obj_heading_;
-}
-debug(blurb) {
-  foreach (blurb; the_document_blurb_section) {
-    writeln(blurb.text);
-  }
-}
-#+END_SRC
-
-**** toc backmatter, table of contents backmatter (scroll & seg) :contents:
-
-#+NAME: abs_post_contents
-#+BEGIN_SRC d
-indent = [
-  "hang_position" : 1,
-  "base_position" : 1,
-];
-comp_obj_toc                                          = comp_obj_toc.init;
-comp_obj_toc.metainfo.is_of_part                      = "frontmatter";
-comp_obj_toc.metainfo.is_of_section                   = "toc";
-comp_obj_toc.metainfo.is_of_type                      = "para";
-comp_obj_toc.metainfo.is_a                            = "toc";
-comp_obj_toc.metainfo.ocn                             = 0;
-comp_obj_toc.metainfo.identifier                      = "";
-comp_obj_toc.metainfo.object_number_off               = true;
-comp_obj_toc.metainfo.object_number_type              = 0;
-comp_obj_toc.attrib.indent_hang                       = indent["hang_position"];
-comp_obj_toc.attrib.indent_base                       = indent["base_position"];
-comp_obj_toc.attrib.bullet                            = false;
-if (the_document_endnotes_section.length > 1) {
-  toc_txt_ = format("%s%s%s%s#%s%s",
-    mkup.lnk_o,
-    "Endnotes",
-    mkup.lnk_c,
-    mkup.url_o,
-    "endnotes",
-    mkup.url_c,
-  );
-  toc_txt_= toc_txt_.links_and_images;
-  comp_obj_toc.text                                   = toc_txt_.to!string.strip;
-  comp_obj_toc.has.inline_links                       = true;
-  the_document_toc_section                            ~= comp_obj_toc;
-}
-if (the_document_glossary_section.length > 1) {
-  toc_txt_ = format("%s%s%s%s#%s%s",
-    mkup.lnk_o,
-    "Glossary",
-    mkup.lnk_c,
-    mkup.url_o,
-    "glossary",
-    mkup.url_c,
-  );
-  toc_txt_= toc_txt_.links_and_images;
-  comp_obj_toc.text                                   = toc_txt_.to!string.strip;
-  comp_obj_toc.has.inline_links                       = true;
-  the_document_toc_section                            ~= comp_obj_toc;
-}
-if (the_document_bibliography_section.length > 1){
-  toc_txt_ = format("%s%s%s%s#%s%s",
-    mkup.lnk_o,
-    "Bibliography",
-    mkup.lnk_c,
-    mkup.url_o,
-    "bibliography",
-    mkup.url_c,
-  );
-  toc_txt_= toc_txt_.links_and_images;
-  comp_obj_toc.text                                   = toc_txt_.to!string.strip;
-  comp_obj_toc.has.inline_links                       = true;
-  the_document_toc_section                            ~= comp_obj_toc;
-}
-if (the_document_bookindex_section.length > 1) {
-  toc_txt_ = format("%s%s%s%s#%s%s",
-    mkup.lnk_o,
-    "Book Index",
-    mkup.lnk_c,
-    mkup.url_o,
-    "bookindex",
-    mkup.url_c,
-  );
-  toc_txt_= toc_txt_.links_and_images;
-  comp_obj_toc.text                                   = toc_txt_.to!string.strip;
-  comp_obj_toc.has.inline_links                       = true;
-  the_document_toc_section                            ~= comp_obj_toc;
-}
-if (the_document_blurb_section.length > 1) {
-  toc_txt_ = format("%s%s%s%s#%s%s",
-    mkup.lnk_o,
-    "Blurb",
-    mkup.lnk_c,
-    mkup.url_o,
-    "blurb",
-    mkup.url_c,
-  );
-  toc_txt_= toc_txt_.links_and_images;
-  comp_obj_toc.has.inline_links                       = true;
-  comp_obj_toc.text                                   = toc_txt_.to!string.strip;
-  the_document_toc_section                            ~= comp_obj_toc;
-}
-debug(toc) {
-  writefln(
-    "%s %s",
-    __LINE__,
-  );
-  foreach (toc_linked_heading; the_document_toc_section) {
-    writeln(mkup.indent_by_spaces_provided(toc_linked_heading.attrib.indent_hang), toc_linked_heading.text);
-  }
-}
-#+END_SRC
-
-**** doc head (separate document head from body, make space for toc)
-
-#+NAME: abs_post_separate_doc_head_and_doc_body
-#+BEGIN_SRC d
-the_document_head_section ~= the_document_body_section[0];
-the_document_body_section = the_document_body_section[1..$];
-#+END_SRC
-
-*** ↻ *LOOPs* _post main-loop loops_ :loop:post: WORKON
-**** 1. ↻ _Loop as required_ (e.g. backmatter): loop up to lev4, extract html segnames, set pointers
-
-this extra loop is used/needed to determine pre and (in particular) next segment
-for html, that is then used in a subsequent loop
-
-NOTE there are issues attempting to do this on first pass as:
-  - backmatter is created out of sequence and
-  - it is not certain which are present
-
-  - it is quite neat to have all in one place as we have here
-
-  - could optimise a bit by
-    - skipping this loop unless the html seg or epub output is selected
-
-***** Methods
-****** get ancestors markup
-
-#+NAME: abs_post_heading_ancestors_markup
-#+BEGIN_SRC d
-@safe int[] _get_ancestors_markup(O)(O obj, ref int[] _ancestors_markup) {
-  if (obj.metainfo.is_a == "heading") {
-    debug(dom) {
-      writeln(obj.text);
-    }
-    if (obj.metainfo.heading_lev_markup == 1) {
-      _ancestors_markup = [
-        _ancestors_markup[0],
-        0,0,0,0,0,0,0
-      ];
-    }
-    if (obj.metainfo.heading_lev_markup == 2) {
-      _ancestors_markup = [
-        _ancestors_markup[0],
-        _ancestors_markup[1],
-        0,0,0,0,0,0
-      ];
-    }
-    if (obj.metainfo.heading_lev_markup == 3) {
-      _ancestors_markup = [
-        _ancestors_markup[0],
-        _ancestors_markup[1],
-        _ancestors_markup[2],
-        0,0,0,0,0
-      ];
+  auto toc_head                                                  = comp_obj_heading_;
+  html_segnames_ptr_cntr++;
+  the_document_toc_section = [toc_head];
+  static auto mkup = InlineMarkup();
+  static auto munge = ObjInlineMarkupMunge();
+  auto note_section = NotesSection();
+  auto bookindex_extract_hash = BookIndexNuggetHash();
+  string[][string] lev4_subtoc;
+  string[][string] segnames = ["html": ["toc"], "epub": ["toc"]];
+  int cnt1 = 1; int cnt2 = 1; int cnt3 = 1;
+  /+ abstraction init ↑ +/
+  enum Substitute { match, markup, }
+  debug (substitutions) {
+    writeln(__LINE__, ":", __FILE__, ": DEBUG substitutions:");
+    if (!(conf_make_meta.make.headings.empty)) {
+      writeln(conf_make_meta.make.headings);
     }
-    if (obj.metainfo.heading_lev_markup == 4) {
-      _ancestors_markup = [
-        _ancestors_markup[0],
-        _ancestors_markup[1],
-        _ancestors_markup[2],
-        _ancestors_markup[3],
-        0,0,0,0
-      ];
+    if (conf_make_meta.make.substitute) {
+      foreach(substitution_pair; conf_make_meta.make.substitute) {
+         writeln("regex to match:       ", substitution_pair[Substitute.match]);
+         writeln("substitution to make: ", substitution_pair[Substitute.markup]);
+      }
     }
-    if (obj.metainfo.heading_lev_markup == 5) {
-      _ancestors_markup = [
-        _ancestors_markup[0],
-        _ancestors_markup[1],
-        _ancestors_markup[2],
-        _ancestors_markup[3],
-        _ancestors_markup[4],
-        0,0,0
-      ];
+    if (conf_make_meta.make.bold) {
+      writeln("regex to match:       ", conf_make_meta.make.bold[Substitute.match]);
+      writeln("substitution to make: ", conf_make_meta.make.bold[Substitute.markup]);
     }
-    if (obj.metainfo.heading_lev_markup == 6) {
-      _ancestors_markup = [
-        _ancestors_markup[0],
-        _ancestors_markup[1],
-        _ancestors_markup[2],
-        _ancestors_markup[3],
-        _ancestors_markup[4],
-        _ancestors_markup[5],
-        0,0
-      ];
+    if (conf_make_meta.make.emphasis) {
+      writeln("regex to match:       ", conf_make_meta.make.emphasis[Substitute.match]);
+      writeln("substitution to make: ", conf_make_meta.make.emphasis[Substitute.markup]);
     }
-    if (obj.metainfo.heading_lev_markup == 7) {
-      _ancestors_markup = [
-        _ancestors_markup[0],
-        _ancestors_markup[1],
-        _ancestors_markup[2],
-        _ancestors_markup[3],
-        _ancestors_markup[4],
-        _ancestors_markup[5],
-        _ancestors_markup[6],
-        0
-      ];
+    if (conf_make_meta.make.italics) {
+      writeln("regex to match:       ", conf_make_meta.make.italics[Substitute.match]);
+      writeln("substitution to make: ", conf_make_meta.make.italics[Substitute.markup]);
     }
-    if (obj.metainfo.heading_lev_markup == 8) {
-      _ancestors_markup = [
-        _ancestors_markup[0],
-        _ancestors_markup[1],
-        _ancestors_markup[2],
-        _ancestors_markup[3],
-        _ancestors_markup[4],
-        _ancestors_markup[5],
-        _ancestors_markup[6],
-        _ancestors_markup[7]
-      ];
+  }
+  auto loopMarkupSrcByLine(
+    char[][]         markup_sourcefile_content,
+    string[string]   an_object,
+    uint[string]     pith,
+  ) {
+    struct _loopMarkupSrcByLineStruct {
+      ObjGenericComposite[] toc;
+      ObjGenericComposite[] body;
+      ObjGenericComposite[] glossary;
+      ObjGenericComposite[] blurb;
+      string[string]        object_notes;
+      string[][string]      segnames;
+    }
+    _loopMarkupSrcByLineStruct ret;
+    srcDocLoopLineByLine_:
+    foreach (line; markup_sourcefile_content) {
+      /+ ↓ markup document/text line by line +/
+      // "line" variable can be empty but should never be null
+      /+ scope +/
+      scope(exit) { }
+      scope(failure) {
+        stderr.writefln(
+          "\n%s\n%s\n\n%s:%s\nFAILED while processing the file: ❮❮ %s ❯❯ on line with text:\n%s\n",
+          __MODULE__, __FUNCTION__,
+          __FILE__, __LINE__,
+          manifested.src.filename, line,
+        );
+      }
+      debug(source) {
+        writeln(line);
+      }
+      debug(srclines) {
+        if (!line.empty) { writefln("* %s", line); }
+      }
+      if (!line.empty) { pith = line._check_ocn_status_(pith); }
+      if ( pith["block_is"] == eN.blk_is.code
+        && pith["block_state"] == eN.blk_state.on
+      ) {
+        /+ block object: code +/
+        {
+          auto _get = line.txt_by_line_block_code(an_object, pith);
+          an_object = _get.this_object;
+          pith      = _get.pith;
+        }
+        continue;
+      } else if (!matchFirst(line, rgx.skip_from_regular_parse)) {
+        /+ object other than "code block" object +/
+        /+ (includes regular text paragraph, headings & blocks other than code) +/
+        /+ heading, glossary, blurb, poem, group, block, quote, table +/
+        line = line.inline_markup_faces; // by text line (rather than by text object), linebreaks in para problematic
+        if (line.matchFirst(rgx.heading_biblio)
+        || (pith["section"] == eN.sect.bibliography
+          && ((!(line.matchFirst(rgx.heading_glossary)))
+          && (!(line.matchFirst(rgx.heading_blurb)))
+          && (!(line.matchFirst(rgx.heading)))
+          && (!(line.matchFirst(rgx.comment)))))
+        ) {
+          pith["section"] = eN.sect.bibliography;
+          if (opt_action.backmatter && opt_action.section_biblio) {
+            {
+              auto _get = line.txt_by_line_block_biblio(pith, bib_entry, biblio_entry_str_json, biblio_arr_json);
+              {
+                pith                  = _get.pith;
+                bib_entry             = _get.bib_entry;
+                biblio_entry_str_json = _get.biblio_entry_str_json;
+                biblio_arr_json       = _get.biblio_arr_json;
+              }
+            }
+            debug(bibliobuild) {
+              writeln("-  ", biblio_entry_str_json);
+              writeln("-> ", biblio_arr_json.length);
+            }
+          }
+          continue;
+        } else if (line.matchFirst(rgx.heading_glossary)
+        || (pith["section"] == eN.sect.glossary
+          && ((!(line.matchFirst(rgx.heading_biblio)))
+          && (!(line.matchFirst(rgx.heading_blurb)))
+          && (!(line.matchFirst(rgx.heading)))
+          && (!(line.matchFirst(rgx.comment)))))
+        ) {
+          /+ within section (block object): glossary +/
+          debug(glossary) {
+            writeln(__LINE__);
+            writeln(line);
+          }
+          pith["section"] = eN.sect.glossary;
+          if (opt_action.backmatter && opt_action.section_glossary) {
+            indent = [
+              "hang_position" : 0,
+              "base_position" : 0,
+            ];
+            bullet = false;
+            pith["txt_is"]           = eN.txt_is.para;
+            line_occur["para"]       = eN.bi.off;
+            an_object_key = "glossary_nugget";
+            if (line.matchFirst(rgx.heading_glossary)) {
+              {
+                comp_obj_heading_                                = comp_obj_heading_.init;
+                comp_obj_heading_.metainfo.is_of_part            = "backmatter";
+                comp_obj_heading_.metainfo.is_of_section         = "glossary";
+                comp_obj_heading_.metainfo.is_of_type            = "para";
+                comp_obj_heading_.metainfo.is_a                  = "heading";
+                comp_obj_heading_.text                           = "Glossary";
+                comp_obj_heading_.metainfo.ocn                   = 0;
+                comp_obj_heading_.metainfo.identifier            = "";
+                comp_obj_heading_.metainfo.dummy_heading         = false;
+                comp_obj_heading_.metainfo.object_number_off     = false;
+                comp_obj_heading_.metainfo.object_number_type    = 0;
+                comp_obj_heading_.tags.segment_anchor_tag_epub   = "_part_glossary";
+                comp_obj_heading_.tags.anchor_tag_html           = comp_obj_heading_.tags.segment_anchor_tag_epub;
+                comp_obj_heading_.tags.in_segment_html           = "glossary";
+                comp_obj_heading_.tags.anchor_tags               = ["section_glossary"];
+                comp_obj_heading_.metainfo.heading_lev_markup    = 1;
+                comp_obj_heading_.metainfo.heading_lev_collapsed = 1;
+                comp_obj_heading_.metainfo.parent_ocn            = 1;
+                comp_obj_heading_.metainfo.parent_lev_markup     = 0;
+                comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 0, 0, 0, 0];
+                comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 0, 0, 0, 0, 0, 0];
+                the_document_glossary_section                    ~= comp_obj_heading_;
+                tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+                tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+              }
+              {
+                comp_obj_heading_                                = comp_obj_heading_.init;
+                comp_obj_heading_.metainfo.is_of_part            = "backmatter";
+                comp_obj_heading_.metainfo.is_of_section         = "glossary";
+                comp_obj_heading_.metainfo.is_of_type            = "para";
+                comp_obj_heading_.metainfo.is_a                  = "heading";
+                comp_obj_heading_.text                           = "Glossary";
+                comp_obj_heading_.metainfo.ocn                   = 0;
+                comp_obj_heading_.metainfo.identifier            = "";
+                comp_obj_heading_.metainfo.dummy_heading         = true;
+                comp_obj_heading_.metainfo.object_number_off     = true;
+                comp_obj_heading_.metainfo.object_number_type    = 0;
+                comp_obj_heading_.tags.segment_anchor_tag_epub   = "glossary";
+                comp_obj_heading_.tags.anchor_tag_html           = comp_obj_heading_.tags.segment_anchor_tag_epub;
+                comp_obj_heading_.tags.in_segment_html           = comp_obj_heading_.tags.anchor_tag_html;
+                comp_obj_heading_.metainfo.heading_lev_markup    = 4;
+                comp_obj_heading_.metainfo.heading_lev_collapsed = 2;
+                comp_obj_heading_.metainfo.parent_ocn            = 1;
+                comp_obj_heading_.metainfo.parent_lev_markup     = 0;
+                comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 1, 0, 0, 0];
+                comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 1, 0, 0, 0, 0, 0];
+                comp_obj_heading_.tags.anchor_tags               = ["glossary"];
+                the_document_glossary_section                    ~= comp_obj_heading_;
+                tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+                tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+              }
+            } else {
+              {
+                auto _get = line.flow_para_match_(an_object, an_object_key, indent, bullet, pith, line_occur);
+                {
+                  an_object     = _get.this_object;
+                  an_object_key = _get.this_object_key;
+                  pith          = _get.pith;
+                  indent        = _get.indent;
+                  bullet        = _get.bullet;
+                  line_occur    = _get.line_occur;
+                }
+              }
+              comp_obj_para                               = comp_obj_para.init;
+              comp_obj_para.metainfo.is_of_part           = "backmatter";
+              comp_obj_para.metainfo.is_of_section        = "glossary";
+              comp_obj_para.metainfo.is_of_type           = "para";
+              comp_obj_para.metainfo.is_a                 = "glossary";
+              comp_obj_para.text                          = links_and_images(line.to!string.strip).replaceFirst(rgx.para_attribs, "");
+              comp_obj_para.metainfo.ocn                  = 0;
+              comp_obj_para.metainfo.identifier           = "";
+              comp_obj_para.metainfo.object_number_off    = true;
+              comp_obj_para.metainfo.object_number_type   = 0;
+              comp_obj_para.attrib.indent_hang            = indent["hang_position"];
+              comp_obj_para.attrib.indent_base            = indent["base_position"];
+              comp_obj_para.attrib.bullet                 = bullet;
+              the_document_glossary_section               ~= comp_obj_para;
+            }
+            pith["ocn"] = eN.ocn.on;
+          }
+          continue;
+        } else if (line.matchFirst(rgx.heading_blurb)
+        || (pith["section"] == eN.sect.blurb
+          && ((!(line.matchFirst(rgx.heading_glossary)))
+          && (!(line.matchFirst(rgx.heading_biblio)))
+          && (!(line.matchFirst(rgx.heading)))
+          && (!(line.matchFirst(rgx.comment)))))
+        ) {
+          pith["section"] = eN.sect.blurb;
+          debug(blurb) {
+            writeln(__LINE__);
+            writeln(line);
+          }
+          if (opt_action.backmatter && opt_action.section_blurb) {
+            indent = [
+              "hang_position" : 0,
+              "base_position" : 0,
+            ];
+            bullet = false;
+            if (auto m = line.matchFirst(rgx.para_indent)) {
+              debug(paraindent) {
+                writeln(line);
+              }
+              indent["hang_position"] = (m["indent"]).to!int;
+              indent["base_position"] = (m["indent"]).to!int;
+            } else if (line.matchFirst(rgx.para_bullet)) {
+              debug(parabullet) {
+                writeln(line);
+              }
+              bullet = true;
+            } else if (auto m = line.matchFirst(rgx.para_indent_hang)) {
+              debug(paraindenthang) {
+                writeln(line);
+              }
+              indent = [
+                "hang_position" : (m["hang"]).to!int,
+                "base_position" : (m["indent"]).to!int,
+              ];
+            } else if (auto m = line.matchFirst(rgx.para_bullet_indent)) {
+              debug(parabulletindent) {
+                writeln(line);
+              }
+              indent = [
+                "hang_position" : (m["indent"]).to!int,
+                "base_position" : (m["indent"]).to!int,
+              ];
+              bullet = true;
+            }
+            pith["txt_is"]           = eN.txt_is.para;
+            line_occur["para"]       = eN.bi.off;
+            an_object_key = "blurb_nugget";
+            if (line.matchFirst(rgx.heading_blurb)) {
+              {
+                comp_obj_heading_                                              = comp_obj_heading_.init;
+                comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
+                comp_obj_heading_.metainfo.is_of_section                       = "blurb";
+                comp_obj_heading_.metainfo.is_of_type                          = "para";
+                comp_obj_heading_.metainfo.is_a                                = "heading";
+                comp_obj_heading_.text                                         = "Blurb";
+                comp_obj_heading_.metainfo.ocn                                 = 0;
+                comp_obj_heading_.metainfo.identifier                          = "";
+                comp_obj_heading_.metainfo.dummy_heading                       = false;
+                comp_obj_heading_.metainfo.object_number_off                   = false;
+                comp_obj_heading_.metainfo.object_number_type                  = 0;
+                comp_obj_heading_.tags.segment_anchor_tag_epub                 = "_part_blurb";
+                comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
+                comp_obj_heading_.tags.in_segment_html                         = "blurb";
+                comp_obj_heading_.tags.anchor_tags                             = ["section_blurb"];
+                comp_obj_heading_.metainfo.heading_lev_markup                  = 1;
+                comp_obj_heading_.metainfo.heading_lev_collapsed               = 1;
+                comp_obj_heading_.metainfo.parent_ocn                          = 1;
+                comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
+                comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 0, 0, 0, 0];
+                comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 0, 0, 0, 0, 0, 0];
+                the_document_blurb_section                                     ~= comp_obj_heading_;
+                tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+                tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+              }
+              {
+                comp_obj_heading_                                              = comp_obj_heading_.init;
+                comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
+                comp_obj_heading_.metainfo.is_of_section                       = "blurb";
+                comp_obj_heading_.metainfo.is_of_type                          = "para";
+                comp_obj_heading_.metainfo.is_a                                = "heading";
+                comp_obj_heading_.text                                         = "Blurb";
+                comp_obj_heading_.metainfo.ocn                                 = 0;
+                comp_obj_heading_.metainfo.identifier                          = "";
+                comp_obj_heading_.metainfo.dummy_heading                       = true;
+                comp_obj_heading_.metainfo.object_number_off                   = true;
+                comp_obj_heading_.metainfo.object_number_type                  = 0;
+                comp_obj_heading_.tags.segment_anchor_tag_epub                 = "blurb";
+                comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
+                comp_obj_heading_.tags.in_segment_html                         = comp_obj_heading_.tags.anchor_tag_html;
+                comp_obj_heading_.metainfo.heading_lev_markup                  = 4;
+                comp_obj_heading_.metainfo.heading_lev_collapsed               = 2;
+                comp_obj_heading_.metainfo.parent_ocn                          = 1;
+                comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
+                comp_obj_heading_.tags.anchor_tags                             = ["blurb"];
+                comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 1, 0, 0, 0];
+                comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 1, 0, 0, 0, 0, 0];
+                the_document_blurb_section                                     ~= comp_obj_heading_;
+                tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+                tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+              }
+            } else if (line.matchFirst(rgx.headings)
+            && (opt_action.backmatter && opt_action.section_blurb)) {
+              comp_obj_heading_                                              = comp_obj_heading_.init;
+              comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
+              comp_obj_heading_.metainfo.is_of_section                       = "blurb";
+              comp_obj_heading_.metainfo.is_of_type                          = "para";
+              comp_obj_heading_.metainfo.is_a                                = "heading";
+              comp_obj_heading_.text                                         = line.to!string;
+              comp_obj_heading_.metainfo.ocn                                 = 0;
+              comp_obj_heading_.metainfo.identifier                          = "";
+              comp_obj_heading_.metainfo.dummy_heading                       = false;
+              comp_obj_heading_.metainfo.object_number_off                   = true;
+              comp_obj_heading_.metainfo.object_number_type                  = 0;
+              comp_obj_heading_.tags.segment_anchor_tag_epub                 = "blurb";
+              comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
+              comp_obj_heading_.tags.in_segment_html                         = comp_obj_heading_.tags.anchor_tag_html;
+              comp_obj_heading_.metainfo.heading_lev_markup                  = an_object["lev_markup_number"].to!int;    // make int, remove need to conv
+              comp_obj_heading_.metainfo.heading_lev_collapsed               = an_object["lev_collapsed_number"].to!int; // make int, remove need to conv
+              comp_obj_heading_.metainfo.parent_ocn                          = 1;
+              comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
+              the_document_blurb_section                                     ~= comp_obj_heading_;
+              tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+              tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+            } else if (!(line.empty)) {
+              {
+                auto _get = line.flow_para_match_(an_object, an_object_key, indent, bullet, pith, line_occur);
+                {
+                  an_object     = _get.this_object;
+                  an_object_key = _get.this_object_key;
+                  pith          = _get.pith;
+                  indent        = _get.indent;
+                  bullet        = _get.bullet;
+                  line_occur    = _get.line_occur;
+                }
+              }
+              comp_obj_para                               = comp_obj_para.init;
+              comp_obj_para.metainfo.is_of_part           = "backmatter";
+              comp_obj_para.metainfo.is_of_section        = "blurb";
+              comp_obj_para.metainfo.is_of_type           = "para";
+              comp_obj_para.metainfo.is_a                 = "blurb";
+              comp_obj_para.text                          = links_and_images(line.to!string.strip).replaceFirst(rgx.para_attribs, "");
+              comp_obj_para.metainfo.ocn                  = 0;
+              comp_obj_para.metainfo.identifier           = "";
+              comp_obj_para.metainfo.object_number_off    = true;
+              comp_obj_para.metainfo.object_number_type   = 0;
+              comp_obj_para.attrib.indent_hang            = indent["hang_position"];
+              comp_obj_para.attrib.indent_base            = indent["base_position"];
+              comp_obj_para.has.inline_links              = true;
+              comp_obj_para.attrib.bullet                 = bullet;
+              the_document_blurb_section                  ~= comp_obj_para;
+            }
+            pith["ocn"] = eN.ocn.on;
+          }
+          continue;
+        } else if (pith["block_state"] == eN.blk_state.on) {
+          if (pith["block_is"]    == eN.blk_is.quote) {
+            line = line
+              ._doc_header_and_make_substitutions_(conf_make_meta)
+              ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
+            {
+              auto _get = line.txt_by_line_block_quote(an_object, pith);
+              {
+                an_object = _get.this_object;
+                pith      = _get.pith;
+              }
+            }
+            continue;
+          } else if (pith["block_is"]    == eN.blk_is.group) {
+            line = line
+              ._doc_header_and_make_substitutions_(conf_make_meta)
+              ._doc_header_and_make_substitutions_fontface_(conf_make_meta)
+              .replaceAll(rgx.para_delimiter, mkup.br_line_spaced ~ "$1");
+            {
+              auto _get = line.txt_by_line_block_group(an_object, pith);
+              {
+                an_object = _get.this_object;
+                pith      = _get.pith;
+              }
+            }
+            continue;
+          } else if (pith["block_is"]    == eN.blk_is.block) {
+            line = line
+              ._doc_header_and_make_substitutions_(conf_make_meta)
+              ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
+            if (auto m = line.match(rgx.spaces_keep)) {
+              line = line
+                .replaceAll(rgx.spaces_keep, (m.captures[1]).translate([ ' ' : mkup.nbsp ]));
+            }
+            {
+              auto _get = line.txt_by_line_block_block(an_object, pith);
+              {
+                an_object = _get.this_object;
+                pith      = _get.pith;
+              }
+            }
+            continue;
+          } else if (pith["block_is"]    == eN.blk_is.poem) {
+            {
+              auto _get = line.txt_by_line_block_poem(an_object, pith, cntr, object_number_poem, conf_make_meta, tag_in_seg);
+              {
+                an_object = _get.this_object;
+                pith      = _get.pith;
+                cntr      = _get.cntr;
+              }
+            }
+            continue;
+          } else if (pith["block_is"]    == eN.blk_is.table) {
+            {
+              auto _get = line.txt_by_line_block_table(an_object, pith, conf_make_meta);
+              {
+                an_object      = _get.this_object;
+                pith           = _get.pith;
+                conf_make_meta = _get.conf_make_meta;
+              }
+            }
+            continue;
+          }
+        } else {
+          /+ not within a block group +/
+          assert(
+            (pith["block_state"] == eN.blk_state.off)
+            || (pith["block_state"] == eN.blk_state.closing),
+            "block status: none or closed"
+          );
+          if (line.matchFirst(rgx.block_open)) {
+            if (line.matchFirst(rgx.block_poem_open)) {
+              /+ poem to verse exceptions! +/
+              object_reset(an_object);
+              processing.remove("verse");
+              object_number_poem["start"] = obj_cite_digits.object_number.to!string;
+            }
+            {
+              auto _get = line.txt_by_line_block_start(pith, dochas, object_number_poem);
+              {
+                pith               = _get.pith;
+                dochas             = _get.dochas;
+                object_number_poem = _get.object_number_poem;
+              }
+            }
+            continue;
+          } else if (!line.empty) {
+            /+ line not empty - non blocks (headings, paragraphs) & closed blocks +/
+            assert(
+              !line.empty,
+              "line tested, line not empty surely:\n  \"" ~ line ~ "\""
+            );
+            assert(
+              (pith["block_state"] == eN.blk_state.off)
+              || (pith["block_state"] == eN.blk_state.closing),
+              "code block status: none or closed"
+            );
+            if (pith["block_state"] == eN.blk_state.closing) {
+              debug(check) {
+                writeln(__LINE__);
+                writeln(line);
+              }
+              assert(
+                line.matchFirst(rgx.book_index_item)
+                || line.matchFirst(rgx.book_index_item_open)
+                || pith["section"] == eN.sect.book_index,
+                "\nblocks closed, unless followed by book index, non-matching line:\n  \""
+                ~ line ~ "\""
+              );
+            }
+            if (line.matchFirst(rgx.book_index_item)
+            || line.matchFirst(rgx.book_index_item_open)
+            || pith["section"] == eN.sect.book_index)  {
+              /+ book_index +/
+              {
+                auto _get = line.flow_book_index_(an_object, book_idx_tmp, pith, opt_action);
+                {
+                  an_object = _get.this_object;
+                  pith      = _get.pith;
+                  book_idx_tmp      = _get.book_idx_tmp;
+                }
+              }
+            } else {
+              /+ not book_index +/
+              an_object_key = "body_nugget";
+              if (auto m = line.matchFirst(rgx.comment)) {
+                /+ matched comment +/
+                debug(comment) {
+                  writeln(line);
+                }
+                an_object[an_object_key]                ~= line ~= "\n";
+                comp_obj_comment                        = comp_obj_comment.init;
+                comp_obj_comment.metainfo.is_of_part    = "comment"; // breaks flow
+                comp_obj_comment.metainfo.is_of_section = "comment"; // breaks flow
+                comp_obj_comment.metainfo.is_of_type    = "comment";
+                comp_obj_comment.metainfo.is_a          = "comment";
+                comp_obj_comment.text                   = an_object[an_object_key].strip;
+                the_document_body_section               ~= comp_obj_comment;
+                {
+                  auto _get = txt_by_line_common_reset_(line_occur, an_object, pith);
+                  {
+                    line_occur = _get.line_occur;
+                    an_object  = _get.this_object;
+                    pith       = _get.pith;
+                  }
+                }
+                processing.remove("verse");
+                ++cntr;
+              } else if ((line_occur["para"] == eN.bi.off
+                && line_occur["heading"] == eN.bi.off)
+                && pith["txt_is"] == eN.txt_is.off
+              ) {                             /+ heading or para but neither flag nor line exists +/
+                if ((conf_make_meta.make.headings.length > 2)
+                && (pith["make_headings"] == eN.bi.off)) {
+                  /+ heading found +/
+                  {
+                    auto _get = line.flow_heading_found_(heading_match_str, conf_make_meta.make.headings, heading_match_rgx, pith);
+                    {
+                      heading_match_str = _get.heading_match_str;
+                      heading_match_rgx = _get.heading_match_rgx;
+                      pith              = _get.pith;
+                    }
+                  }
+                }
+                if (pith["make_headings"] == eN.bi.on
+                  && (line_occur["para"] == eN.bi.off
+                  && line_occur["heading"] == eN.bi.off)
+                  && pith["txt_is"] == eN.txt_is.off
+                ) {
+                  /+ heading make set +/
+                  {
+                    auto _get = line.flow_heading_make_set_(line_occur, heading_match_rgx, pith);
+                    {
+                      line      = _get.line;
+                      an_object = _get.this_object;
+                      pith      = _get.pith;
+                    }
+                  }
+                }
+                /+ TODO node info: all headings identified at this point,
+                   - extract node info here??
+                   - how long can it wait?
+                   - should be incorporated in composite objects
+                   - should happen before endnote links set (they need to be moved down?)
+                +/
+                if (line.matchFirst(rgx.headings)) {
+                  /+ heading match +/
+                  line = line._doc_header_and_make_substitutions_(conf_make_meta);
+                  {
+                    auto _get = line.flow_heading_matched_(
+                      an_object,
+                      line_occur,
+                      an_object_key,
+                      lv,
+                      collapsed_lev,
+                      pith,
+                      conf_make_meta,
+                    );
+                    {
+                      an_object = _get.this_object;
+                      pith      = _get.pith;
+                    }
+                  }
+                } else if (line_occur["para"] == eN.bi.off) {
+                  /+ para match +/
+                  an_object_key = "body_nugget";
+                  line = line
+                    ._doc_header_and_make_substitutions_(conf_make_meta)
+                    ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
+                  {
+                    auto _get = line.flow_para_match_(an_object, an_object_key, indent, bullet, pith, line_occur);
+                    {
+                      an_object     = _get.this_object;
+                      an_object_key = _get.this_object_key;
+                      pith          = _get.pith;
+                      indent        = _get.indent;
+                      bullet        = _get.bullet;
+                      line_occur    = _get.line_occur;
+                    }
+                  }
+                }
+              } else if (line_occur["heading"] > eN.bi.off) {
+                /+ heading +/
+                debug(heading) {
+                  writeln(line);
+                }
+                an_object[an_object_key] ~= line ~= "\n";
+                ++line_occur["heading"];
+              } else if (line_occur["para"] > eN.bi.off) {
+                /+ paragraph +/
+                debug(para) {
+                  writeln(an_object_key, "-> ", line);
+                }
+                line = line
+                  ._doc_header_and_make_substitutions_(conf_make_meta)
+                  ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
+                an_object[an_object_key] ~= " " ~ line;
+                ++line_occur["para"];
+              }
+            }
+          } else if (pith["block_state"] == eN.blk_state.closing) {
+            /+ line empty, with blocks flag +/
+            {
+              auto _get = line.flow_block_flag_line_empty_(
+                an_object,
+                bookindex_extract_hash,
+                the_document_body_section,
+                bookindex_unordered_hashes,
+                obj_cite_digits,
+                comp_obj_heading,
+                cntr,
+                pith,
+                object_number_poem,
+                conf_make_meta,
+                tag_in_seg,
+              );
+              {
+                an_object                  = _get.this_object;
+                the_document_body_section  = _get.the_document_body_section;
+                bookindex_unordered_hashes = _get.bookindex_unordered_hashes;
+                obj_cite_digits            = _get.obj_cite_digits;
+                comp_obj_heading           = _get.comp_obj_heading;
+                cntr                       = _get.cntr;
+                pith                       = _get.pith;
+              }
+            }
+          } else {
+            /+ line.empty, post contents, empty variables: +/
+            assert(
+              line.empty,
+              "\nline should be empty:\n  \""
+              ~ line ~ "\""
+            );
+            assert(
+              (pith["block_state"] == eN.blk_state.off),
+              "code block status: none"
+            );
+            if (_new_doc) {
+              tag_assoc   = tag_assoc.init;
+              lv0to3_tags = lv0to3_tags.init;
+              tag_in_seg  = tag_in_seg.init;
+            }
+            if (pith["txt_is"] == eN.txt_is.heading
+              && line_occur["heading"] > eN.bi.off
+            ) {
+              /+ heading object (current line empty) +/
+              obj_cite_digits = (an_object["lev_markup_number"].to!int == 0)
+              ? ocn_emit(eN.ocn.reset)
+              : ocn_emit(pith["ocn"]);
+              an_object["is"] = "heading";
+              an_object_key = "body_nugget";
+              TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_object_and_anchor_tags_tuple
+                = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, ((_new_doc) ? Yes._new_doc : No._new_doc));
+              an_object["substantive"] = substantive_object_and_anchor_tags_tuple[sObj.content];
+              anchor_tag = substantive_object_and_anchor_tags_tuple[sObj.anchor_tag];
+              if (_new_doc) {
+                cnt1 = 1;
+                cnt2 = 1;
+                cnt3 = 1;
+                _new_doc = false;
+              }
+              if (
+                an_object["lev_markup_number"].to!int == 4
+                && (!(anchor_tag.empty)
+                || (lv0to3_tags.length > 0))
+              ) {
+                tag_in_seg["seg_lv4"]    = anchor_tag;
+                tag_in_seg["seg_lv1to4"] = anchor_tag;
+                lev_anchor_tag = anchor_tag;
+                tag_assoc[anchor_tag]["seg_lv4"]    = tag_in_seg["seg_lv4"];
+                tag_assoc[anchor_tag]["seg_lv1to4"] = tag_in_seg["seg_lv1to4"];
+                if (lv0to3_tags.length > 0) {
+                  /+ names used for html markup segments 1 to 4 (rather than epub which has separate segments for A to D) +/
+                  foreach (lv0_to_lv3_html_tag; lv0to3_tags) {
+                    tag_assoc[lv0_to_lv3_html_tag]["seg_lv4"] = anchor_tag;
+                  }
+                }
+                anchor_tag_ = anchor_tag;
+                lv0to3_tags = lv0to3_tags.init;
+              } else if (an_object["lev_markup_number"].to!int > 4) {
+                tag_in_seg["seg_lv4"]    = anchor_tag_;
+                tag_in_seg["seg_lv1to4"] = anchor_tag_;
+                lev_anchor_tag           = anchor_tag;
+                tag_assoc[anchor_tag]["seg_lv4"] = tag_in_seg["seg_lv4"];
+                tag_assoc[anchor_tag]["seg_lv1to4"] = tag_in_seg["seg_lv1to4"];
+              } else if (an_object["lev_markup_number"].to!int < 4) {
+                string segn;
+                switch (an_object["lev_markup_number"].to!int) {
+                /+ names used for epub markup segments A to D +/
+                case 0:
+                  segn = "_the_title";
+                  goto default;
+                case 1:
+                  segn = "_part_" ~ cnt1.to!string;
+                  ++cnt1;
+                  goto default;
+                case 2:
+                  segn = "_part_" ~ cnt1.to!string ~ "_" ~ cnt2.to!string;
+                  ++cnt2;
+                  goto default;
+                case 3:
+                  segn =  "_part_" ~ cnt1.to!string ~ "_" ~ cnt2.to!string ~ "_" ~ cnt3.to!string;
+                  ++cnt3;
+                  goto default;
+                default:
+                  lv0to3_tags ~= obj_cite_digits.object_number.to!string;
+                  lv0to3_tags ~= segn;
+                  tag_in_seg["seg_lv4"]    = segn; // for html segname need following lv4 not yet known
+                  tag_in_seg["seg_lv1to4"] = segn;
+                  break;
+                }
+              }
+              an_object["bookindex_nugget"]
+                = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
+              bookindex_unordered_hashes
+                = bookindex_extract_hash.bookindex_nugget_hash(an_object["bookindex_nugget"], obj_cite_digits, tag_in_seg);
+              /+ (incrementally build toc) table of contents here! +/
+              _anchor_tag                   = obj_cite_digits.identifier;
+              {
+                auto _get = obj_im.flow_table_of_contents_gather_headings(
+                  an_object,
+                  conf_make_meta,
+                  tag_in_seg,
+                  _anchor_tag,
+                  lev4_subtoc,
+                  the_document_toc_section,
+                );
+                {
+                  the_document_toc_section = _get.the_document_toc_section;
+                  lev4_subtoc              = _get.lev4_subtoc;
+                }
+              }
+              if (an_object["lev_markup_number"] == "4") {
+                segnames["html"] ~= tag_in_seg["seg_lv4"];
+                html_segnames_ptr = html_segnames_ptr_cntr;
+                html_segnames_ptr_cntr++;
+              }
+              if (an_object["lev_markup_number"].to!int <= 4) {
+                segnames["epub"] ~= tag_in_seg["seg_lv1to4"];
+              }
+              auto comp_obj_heading = node_construct.node_emitter_heading(
+                  an_object["substantive"],
+                  an_object["lev_markup_number"],
+                  an_object["lev_collapsed_number"],
+                  an_object["dummy_heading_status"],
+                  tag_in_seg,
+                  lev_anchor_tag,
+                  tag_assoc,
+                  obj_cite_digits,                              // OCNset
+                  cntr,                                         // int
+                  heading_ptr,                                  // int
+                  lv_ancestors_txt,                             // string[]
+                  an_object["is"],                              // string
+                  html_segnames_ptr,                            // int
+                  substantive_object_and_anchor_tags_tuple[sObj.notes_reg],
+                  substantive_object_and_anchor_tags_tuple[sObj.notes_star],
+                  substantive_object_and_anchor_tags_tuple[sObj.links],
+                );
+              ++heading_ptr;
+              debug(segments) {
+                writeln(an_object["lev_markup_number"]);
+                writeln(tag_in_seg["seg_lv4"]);
+                writeln(tag_in_seg["seg_lv1to4"]);
+              }
+              the_document_body_section ~= comp_obj_heading;
+              debug(objectrelated1) { // check
+                writeln(line);
+              }
+              {
+                auto _get = txt_by_line_common_reset_(line_occur, an_object, pith);
+                {
+                  line_occur = _get.line_occur;
+                  an_object  = _get.this_object;
+                  pith       = _get.pith;
+                }
+              }
+              an_object.remove("lev");
+              an_object.remove("lev_markup_number");
+              processing.remove("verse");
+              ++cntr;
+            } else if (pith["txt_is"] == eN.txt_is.para
+              && line_occur["para"] > eN.bi.off
+            ) { /+ paragraph object (current line empty) - repeated character paragraph separator +/
+              if ((an_object[an_object_key].to!string).matchFirst(rgx.repeated_character_line_separator)) {
+                pith["ocn"] = eN.ocn.off;
+              }
+              obj_cite_digits = ocn_emit(pith["ocn"]);
+              an_object["bookindex_nugget"] = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
+              bookindex_unordered_hashes = bookindex_extract_hash.bookindex_nugget_hash(an_object["bookindex_nugget"], obj_cite_digits, tag_in_seg);
+              an_object["is"] = "para";
+              auto comp_obj_heading = node_construct.node_location_emitter(
+                  content_non_header,
+                  tag_in_seg,
+                  lev_anchor_tag,
+                  tag_assoc,
+                  obj_cite_digits,
+                  cntr,
+                  heading_ptr-1,
+                  an_object["is"],
+                );
+              TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
+                = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
+              an_object["substantive"] = substantive_obj_misc_tuple[sObj.content];
+              anchor_tag = substantive_obj_misc_tuple[sObj.anchor_tag];
+              comp_obj_para                                       = comp_obj_para.init;
+              comp_obj_para.metainfo.is_of_part                   = "body";
+              comp_obj_para.metainfo.is_of_section                = "body";
+              comp_obj_para.metainfo.is_of_type                   = "para";
+              comp_obj_para.metainfo.is_a                         = "para";
+              comp_obj_para.text                                  = an_object["substantive"].to!string.strip;
+              comp_obj_para.tags.html_segment_anchor_tag_is       = tag_in_seg["seg_lv4"];
+              comp_obj_para.tags.epub_segment_anchor_tag_is       = tag_in_seg["seg_lv1to4"];
+              comp_obj_para.metainfo.ocn                          = obj_cite_digits.object_number;
+              comp_obj_para.metainfo.identifier                   = obj_cite_digits.identifier;
+              comp_obj_para.metainfo.object_number_off            = (obj_cite_digits.off == 0)   ? true : false; // TODO
+              comp_obj_para.metainfo.o_n_book_index               = obj_cite_digits.bkidx;
+              comp_obj_para.metainfo.object_number_type           = obj_cite_digits.type;
+              comp_obj_para.attrib.indent_hang                    = indent["hang_position"];
+              comp_obj_para.attrib.indent_base                    = indent["base_position"];
+              comp_obj_para.attrib.bullet                         = bullet;
+              comp_obj_para.tags.anchor_tags                      = [anchor_tag]; anchor_tag="";
+              comp_obj_para.has.inline_notes_reg                  = substantive_obj_misc_tuple[sObj.notes_reg];
+              comp_obj_para.has.inline_notes_star                 = substantive_obj_misc_tuple[sObj.notes_star];
+              comp_obj_para.has.inline_links                      = substantive_obj_misc_tuple[sObj.links];
+              comp_obj_para.has.image_without_dimensions          = substantive_obj_misc_tuple[sObj.image_no_dimensions];
+              the_document_body_section                           ~= comp_obj_para;
+              tag_assoc                                           = an_object.inline_para_link_anchor(tag_in_seg, tag_assoc);
+              {
+                auto _get = txt_by_line_common_reset_(line_occur, an_object, pith);
+                {
+                  line_occur = _get.line_occur;
+                  an_object  = _get.this_object;
+                  pith       = _get.pith;
+                }
+              }
+              indent = [
+                "hang_position" : 0,
+                "base_position" : 0,
+              ];
+              bullet = false;
+              processing.remove("verse");
+              ++cntr;
+            // } else { // could be useful to test line variable should be empty and never null
+            }
+          } // close else for line empty
+        } // close else for not the above
+      } // close after non code, other blocks or regular text
+      /+ unless (the_document_body_section.length == 0) ? +/
+      if (the_document_body_section.length > 0) {
+        if (((the_document_body_section[$-1].metainfo.is_a == "para")
+          || (the_document_body_section[$-1].metainfo.is_a == "heading")
+          || (the_document_body_section[$-1].metainfo.is_a == "quote")
+          || (the_document_body_section[$-1].metainfo.is_a == "group")
+          || (the_document_body_section[$-1].metainfo.is_a == "block")
+          || (the_document_body_section[$-1].metainfo.is_a == "verse"))
+        && (the_document_body_section.length > previous_length)) {
+          if ((the_document_body_section[$-1].metainfo.is_a == "heading")
+          && (the_document_body_section[$-1].metainfo.heading_lev_markup < 5)) {
+            pith["section"] = eN.sect.unset;
+          }
+          if (the_document_body_section[$-1].metainfo.is_a == "verse") {
+            /+ scan for endnotes for whole poem (each verse in poem) +/
+            foreach (i; previous_length .. the_document_body_section.length) {
+              if (the_document_body_section[i].metainfo.is_a == "verse") {
+                if ((the_document_body_section[i].text).match(
+                  rgx.inline_notes_al_all_note
+                )) {
+                  object_notes = note_section.gather_notes_for_endnote_section(
+                    the_document_body_section,
+                    tag_in_seg,
+                    (i).to!int,
+                  );
+                }
+              }
+            }
+          } else {
+            /+ scan object for endnotes +/
+            previous_length = the_document_body_section.length.to!int;
+            if ((the_document_body_section[$-1].text).match(
+              rgx.inline_notes_al_all_note
+            )) {
+              previous_count = (the_document_body_section.length -1).to!int;
+              object_notes = note_section.gather_notes_for_endnote_section(
+                the_document_body_section,
+                tag_in_seg,
+                (the_document_body_section.length-1).to!int,
+              );
+            }
+          }
+          previous_length = the_document_body_section.length.to!int;
+        }
+      }
     }
-    _ancestors_markup[obj.metainfo.heading_lev_markup] = obj.metainfo.ocn;
+    ret.toc          = the_document_toc_section;
+    ret.body         = the_document_body_section;
+    ret.glossary     = the_document_glossary_section;
+    ret.blurb        = the_document_blurb_section;
+    ret.object_notes = object_notes;
+    ret.segnames     = segnames;
+    return ret;
+  }
+  { // loopMarkupSrcByLine
+    auto _doc_by_line = loopMarkupSrcByLine(markup_sourcefile_content, an_object, pith);
+    the_document_toc_section      = _doc_by_line.toc;
+    the_document_body_section     = _doc_by_line.body;
+    the_document_glossary_section = _doc_by_line.glossary;
+    the_document_blurb_section    = _doc_by_line.blurb;
+    segnames                      = _doc_by_line.segnames;
+    object_notes                  = _doc_by_line.object_notes; // endnotes, compare, not sure is used
+    destroy(_doc_by_line);
+  }
+  { // EOF
+    comp_obj_heading_                                              = comp_obj_heading_.init;
+    comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
+    comp_obj_heading_.metainfo.is_of_section                       = "tail";
+    comp_obj_heading_.metainfo.is_of_type                          = "para";
+    comp_obj_heading_.metainfo.is_a                                = "heading";
+    comp_obj_heading_.text                                         = "";
+    comp_obj_heading_.metainfo.ocn                                 = 0;
+    comp_obj_heading_.metainfo.identifier                          = "";
+    comp_obj_heading_.metainfo.dummy_heading                       = false;
+    comp_obj_heading_.metainfo.object_number_off                   = false;
+    comp_obj_heading_.metainfo.object_number_type                  = 0;
+    comp_obj_heading_.tags.segment_anchor_tag_epub                 = "_part_eof";
+    comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
+    comp_obj_heading_.tags.in_segment_html                         = "tail";
+    comp_obj_heading_.tags.anchor_tags                             = ["section_eof"];
+    comp_obj_heading_.metainfo.heading_lev_markup                  = 1;
+    comp_obj_heading_.metainfo.heading_lev_collapsed               = 1;
+    comp_obj_heading_.metainfo.parent_ocn                          = 1;
+    comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
+    comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 0, 0, 0, 0, 0, 0, 0, 0];
+    comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 0, 0, 0, 0, 0, 0, 0, 0];
+    the_document_xml_dom_tail_section                              ~= comp_obj_heading_;
+    tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+    tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
   }
-  debug(ancestor_markup) {
-    writeln("marked up: ", _ancestors_markup);
+  auto en_tuple = note_section.endnote_objects(obj_cite_digits, opt_action); // endnotes, check
+  auto the_document_endnotes_section = en_tuple[0];
+  obj_cite_digits = en_tuple[1];
+  debug(endnotes) {
+    writefln("%s %s",
+      __LINE__,
+      the_document_endnotes_section.length
+    );
+    foreach (o; the_document_endnotes_section) {
+      writeln(o);
+    }
+  }
+  if (an_object["glossary_nugget"].length == 0) {
+    comp_obj_heading_                                   = comp_obj_heading_.init;
+    comp_obj_heading_.metainfo.is_of_part               = "empty";
+    comp_obj_heading_.metainfo.is_of_section            = "empty";
+    comp_obj_heading_.metainfo.is_of_type               = "para";
+    comp_obj_heading_.metainfo.is_a                     = "heading";
+    comp_obj_heading_.text                              = "(skip) there is no Glossary section";
+    comp_obj_heading_.metainfo.ocn                      = 0;
+    comp_obj_heading_.metainfo.identifier               = "";
+    comp_obj_heading_.metainfo.dummy_heading            = true;
+    comp_obj_heading_.metainfo.object_number_off        = true;
+    comp_obj_heading_.metainfo.object_number_type       = 0;
+    comp_obj_heading_.metainfo.heading_lev_markup       = 1;
+    comp_obj_heading_.metainfo.heading_lev_collapsed    = 1;
+    comp_obj_heading_.metainfo.parent_ocn               = 1;
+    comp_obj_heading_.metainfo.parent_lev_markup        = 0;
+    the_document_glossary_section                       ~= comp_obj_heading_;
   }
-  return _ancestors_markup;
-}
-#+END_SRC
-
-****** get ancestors collapsed
-
-#+NAME: abs_post_heading_ancestors_collapsed
-#+BEGIN_SRC d
-@safe int[] _get_ancestors_collapsed(O)(O obj, ref int[] _ancestors_collapsed) {
-  if (obj.metainfo.is_a == "heading") {
-    if (obj.metainfo.heading_lev_collapsed == 1) {
-      _ancestors_collapsed = [
-        _ancestors_collapsed[0],
-        0,0,0,0,0,0,0
-      ];
-    }
-    if (obj.metainfo.heading_lev_collapsed == 2) {
-      _ancestors_collapsed = [
-        _ancestors_collapsed[0],
-        _ancestors_collapsed[1],
-        0,0,0,0,0,0
-      ];
-    }
-    if (obj.metainfo.heading_lev_collapsed == 3) {
-      _ancestors_collapsed = [
-        _ancestors_collapsed[0],
-        _ancestors_collapsed[1],
-        _ancestors_collapsed[2],
-        0,0,0,0,0
-      ];
-    }
-    if (obj.metainfo.heading_lev_collapsed == 4) {
-      _ancestors_collapsed = [
-        _ancestors_collapsed[0],
-        _ancestors_collapsed[1],
-        _ancestors_collapsed[2],
-        _ancestors_collapsed[3],
-        0,0,0,0
-      ];
+  debug(glossary) {
+    foreach (gloss; the_document_glossary_section) {
+      writeln(gloss.text);
     }
-    if (obj.metainfo.heading_lev_collapsed == 5) {
-      _ancestors_collapsed = [
-        _ancestors_collapsed[0],
-        _ancestors_collapsed[1],
-        _ancestors_collapsed[2],
-        _ancestors_collapsed[3],
-        _ancestors_collapsed[4],
-        0,0,0
-      ];
+  }
+  auto biblio_unsorted_incomplete = biblio_arr_json.dup;
+  auto biblio = Bibliography();
+  JSONValue[] biblio_ordered;
+  {
+    auto _get = biblio.flow_bibliography_(biblio_unsorted_incomplete, bib_arr_json);
+    {
+      biblio_ordered             = _get.biblio_sorted;
+      bib_arr_json               = _get.bib_arr_json;
+      biblio_unsorted_incomplete = _get.biblio_unsorted_incomplete;
     }
-    if (obj.metainfo.heading_lev_collapsed == 6) {
-      _ancestors_collapsed = [
-        _ancestors_collapsed[0],
-        _ancestors_collapsed[1],
-        _ancestors_collapsed[2],
-        _ancestors_collapsed[3],
-        _ancestors_collapsed[4],
-        _ancestors_collapsed[5],
-        0,0
-      ];
+  }
+  if (biblio_ordered.length > 0) {
+    {
+      comp_obj_heading_                                 = comp_obj_heading_.init;
+      comp_obj_heading_.metainfo.is_of_part             = "backmatter";
+      comp_obj_heading_.metainfo.is_of_section          = "bibliography";
+      comp_obj_heading_.metainfo.is_of_type             = "para";
+      comp_obj_heading_.metainfo.is_a                   = "heading";
+      comp_obj_heading_.text                            = "Bibliography";
+      comp_obj_heading_.metainfo.ocn                    = 0;
+      comp_obj_heading_.metainfo.identifier             = "";
+      comp_obj_heading_.metainfo.dummy_heading          = false;
+      comp_obj_heading_.metainfo.object_number_off      = false;
+      comp_obj_heading_.metainfo.object_number_type     = 0;
+      comp_obj_heading_.tags.segment_anchor_tag_epub    = "_part_bibliography";
+      comp_obj_heading_.tags.anchor_tag_html            = comp_obj_heading_.tags.segment_anchor_tag_epub;
+      comp_obj_heading_.tags.in_segment_html            = "bibliography";
+      comp_obj_heading_.tags.anchor_tags                = ["section_bibliography"];
+      comp_obj_heading_.metainfo.heading_lev_markup     = 1;
+      comp_obj_heading_.metainfo.heading_lev_collapsed  = 1;
+      comp_obj_heading_.metainfo.parent_ocn             = 1;
+      comp_obj_heading_.metainfo.parent_lev_markup      = 0;
+      comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 0, 0, 0, 0];
+      comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 0, 0, 0, 0, 0, 0];
+      the_document_bibliography_section                 ~= comp_obj_heading_;
+      tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+      tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
     }
-    if (obj.metainfo.heading_lev_collapsed == 7) {
-      _ancestors_collapsed = [
-        _ancestors_collapsed[0],
-        _ancestors_collapsed[1],
-        _ancestors_collapsed[2],
-        _ancestors_collapsed[3],
-        _ancestors_collapsed[4],
-        _ancestors_collapsed[5],
-        _ancestors_collapsed[6],
-        0
-      ];
+    {
+      comp_obj_heading_                                 = comp_obj_heading_.init;
+      comp_obj_heading_.metainfo.is_of_part             = "backmatter";
+      comp_obj_heading_.metainfo.is_of_section          = "bibliography";
+      comp_obj_heading_.metainfo.is_of_type             = "para";
+      comp_obj_heading_.metainfo.is_a                   = "heading";
+      comp_obj_heading_.text                            = "Bibliography";
+      comp_obj_heading_.metainfo.ocn                    = 0;
+      comp_obj_heading_.metainfo.identifier             = "";
+      comp_obj_heading_.metainfo.dummy_heading          = true;
+      comp_obj_heading_.metainfo.object_number_off      = true;
+      comp_obj_heading_.metainfo.object_number_type     = 0;
+      comp_obj_heading_.tags.segment_anchor_tag_epub    = "bibliography";
+      comp_obj_heading_.tags.anchor_tag_html            = comp_obj_heading_.tags.segment_anchor_tag_epub;
+      comp_obj_heading_.tags.in_segment_html            = comp_obj_heading_.tags.anchor_tag_html;
+      comp_obj_heading_.metainfo.heading_lev_markup     = 4;
+      comp_obj_heading_.metainfo.heading_lev_collapsed  = 2;
+      comp_obj_heading_.metainfo.parent_ocn             = 1;
+      comp_obj_heading_.metainfo.parent_lev_markup      = 0;
+      comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 1, 0, 0, 0];
+      comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 1, 0, 0, 0, 0, 0];
+      comp_obj_heading_.tags.anchor_tags                = ["bibliography"];
+      the_document_bibliography_section                 ~= comp_obj_heading_;
+      tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+      tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
     }
-    if (obj.metainfo.heading_lev_collapsed == 8) {
-      _ancestors_collapsed = [
-        _ancestors_collapsed[0],
-        _ancestors_collapsed[1],
-        _ancestors_collapsed[2],
-        _ancestors_collapsed[3],
-        _ancestors_collapsed[4],
-        _ancestors_collapsed[5],
-        _ancestors_collapsed[6],
-        _ancestors_collapsed[7]
-      ];
+    {
+      string out_;
+      foreach (entry; biblio_ordered) {
+        out_ = format("%s \"%s\"%s%s%s%s%s%s%s%s%s.",
+          ((entry["author"].str.empty) ? entry["editor"].str : entry["author"].str),
+          entry["fulltitle"].str,
+          ((entry["journal"].str.empty) ? "" : ", " ~ mkup.ff_i ~ mkup.italic ~ mkup.ff_o ~ entry["journal"].str ~ mkup.ff_c ~ mkup.italic),
+          ((entry["volume"].str.empty) ? "" : ", " ~ entry["volume"].str),
+          ((entry["in"].str.empty) ? "" : ", " ~ entry["in"].str),
+          ((!(entry["author"].str.empty) && (!(entry["editor"].str.empty))) ? entry["editor"].str : ""),
+          ", " ~ entry["year"].str,
+          ((entry["pages"].str.empty) ? "" : ", " ~ entry["pages"].str),
+          ((entry["publisher"].str.empty) ? "" : ", " ~ entry["publisher"].str),
+          ((entry["place"].str.empty) ? "" : ", " ~ entry["place"].str),
+          ((entry["url"].str.empty) ? "" : ", [" ~ entry["url"].str ~ "]"),
+        );
+        comp_obj_para                                   = comp_obj_para.init;
+        comp_obj_para.metainfo.is_of_part               = "backmatter";
+        comp_obj_para.metainfo.is_of_section            = "bibliography";
+        comp_obj_para.metainfo.is_of_type               = "para";
+        comp_obj_para.metainfo.is_a                     = "bibliography";
+        comp_obj_para.text                              = out_.to!string.strip;
+        comp_obj_para.metainfo.ocn                      = 0;
+        comp_obj_para.metainfo.identifier               = "";
+        comp_obj_para.metainfo.object_number_off        = true;
+        comp_obj_para.metainfo.object_number_type       = 0;
+        comp_obj_para.attrib.indent_hang                = 0;
+        comp_obj_para.attrib.indent_base                = 1;
+        comp_obj_para.attrib.bullet                     = bullet;
+        comp_obj_para.tags.anchor_tags                  = [anchor_tag];
+        the_document_bibliography_section               ~= comp_obj_para;
+      }
     }
-    _ancestors_collapsed[obj.metainfo.heading_lev_collapsed] = obj.metainfo.ocn;
-  }
-  debug(ancestor_collapsed) {
-    writeln("collapsed: ", _ancestors_collapsed);
+  } else {
+    comp_obj_heading_                                   = comp_obj_heading_.init;
+    comp_obj_heading_.metainfo.is_of_part               = "empty";
+    comp_obj_heading_.metainfo.is_of_section            = "empty";
+    comp_obj_heading_.metainfo.is_of_type               = "para";
+    comp_obj_heading_.metainfo.is_a                     = "heading";
+    comp_obj_heading_.text                              = "(skip) there is no Bibliography";
+    comp_obj_heading_.metainfo.ocn                      = 0;
+    comp_obj_heading_.metainfo.identifier               = "";
+    comp_obj_heading_.metainfo.dummy_heading            = true;
+    comp_obj_heading_.metainfo.object_number_off        = true;
+    comp_obj_heading_.metainfo.object_number_type       = 0;
+    comp_obj_heading_.metainfo.heading_lev_markup       = 1;
+    comp_obj_heading_.metainfo.heading_lev_collapsed    = 1;
+    comp_obj_heading_.metainfo.parent_ocn               = 1;
+    comp_obj_heading_.metainfo.parent_lev_markup        = 0;
+    the_document_bibliography_section                   ~= comp_obj_heading_;
+  }
+  debug(bibliosection) {
+    foreach (o; the_document_bibliography_section) {
+      writeln(o.text);
+    }
+  }
+  auto bi = BookIndexReportSection();
+  auto bi_tuple
+    = bi.bookindex_build_abstraction_section(
+      bookindex_unordered_hashes,
+      obj_cite_digits,
+      opt_action,
+    );
+  destroy(bookindex_unordered_hashes);
+  auto the_document_bookindex_section = bi_tuple[0];
+  obj_cite_digits = bi_tuple[1];
+  debug(bookindex) {
+    foreach (bi_entry; the_document_bookindex_section) {
+      writeln(bi_entry);
+    }
+  }
+  if (an_object["blurb_nugget"].length == 0) {
+    comp_obj_heading_                                   = comp_obj_heading_.init;
+    comp_obj_heading_.metainfo.is_of_part               = "empty";
+    comp_obj_heading_.metainfo.is_of_section            = "empty";
+    comp_obj_heading_.metainfo.is_of_type               = "para";
+    comp_obj_heading_.metainfo.is_a                     = "heading";
+    comp_obj_heading_.text                              = "(skip) there is no Blurb section";
+    comp_obj_heading_.metainfo.ocn                      = 0;
+    comp_obj_heading_.metainfo.identifier               = "";
+    comp_obj_para.metainfo.object_number_off            = true;
+    comp_obj_para.metainfo.object_number_type           = 0;
+    comp_obj_heading_.tags.segment_anchor_tag_epub      = "";
+    comp_obj_heading_.tags.anchor_tag_html              = "";
+    comp_obj_heading_.tags.in_segment_html              = "";
+    comp_obj_heading_.metainfo.heading_lev_markup       = 1;
+    comp_obj_heading_.metainfo.heading_lev_collapsed    = 1;
+    comp_obj_heading_.metainfo.parent_ocn               = 1;
+    comp_obj_heading_.metainfo.parent_lev_markup        = 0;
+    the_document_blurb_section                          ~= comp_obj_heading_;
   }
-  return _ancestors_collapsed;
-}
-#+END_SRC
-
-***** ↻ Loop section: document body [bd] :loop:body:
-
-- substantive object numbers already exist
-- number un-numbered non-substantive text
-
-#+NAME: abs_post_loop_section_body_get_ancestors
-#+BEGIN_SRC d
-/+ multiple 1~ levels, loop through document body +/
-if (the_document_body_section.length > 1) {
-  int[] _ancestors_markup = [0,0,0,0,0,0,0,0];
-  int[][] _ancestors_markup_;
-  _ancestors_markup = [1,0,0,0,0,0,0,0];
-  _ancestors_markup_ ~= _ancestors_markup;
-  int[] _ancestors_collapsed = [0,0,0,0,0,0,0,0];
-  int[][] _ancestors_collapsed_;
-  _ancestors_collapsed = [1,0,0,0,0,0,0,0];
-  _ancestors_collapsed_ ~= _ancestors_collapsed;
-  foreach (ref obj; the_document_body_section) {
-    if (obj.metainfo.is_a == "heading") {
-      obj.metainfo.markedup_ancestors = _get_ancestors_markup(obj, _ancestors_markup);
-      obj.metainfo.collapsed_ancestors = _get_ancestors_collapsed(obj, _ancestors_collapsed);
-      obj.metainfo.parent_ocn = obj.metainfo.markedup_ancestors[obj.metainfo.parent_lev_markup];
+  debug(blurb) {
+    foreach (blurb; the_document_blurb_section) {
+      writeln(blurb.text);
     }
   }
-  debug(ancestors) {
-    writeln("ancestors markup o_n:    ", obj.metainfo.markedup_ancestors);
-    writeln("ancestors collapsed o_n: ", obj.metainfo.markedup_ancestors);
+  indent = [
+    "hang_position" : 1,
+    "base_position" : 1,
+  ];
+  comp_obj_toc                                          = comp_obj_toc.init;
+  comp_obj_toc.metainfo.is_of_part                      = "frontmatter";
+  comp_obj_toc.metainfo.is_of_section                   = "toc";
+  comp_obj_toc.metainfo.is_of_type                      = "para";
+  comp_obj_toc.metainfo.is_a                            = "toc";
+  comp_obj_toc.metainfo.ocn                             = 0;
+  comp_obj_toc.metainfo.identifier                      = "";
+  comp_obj_toc.metainfo.object_number_off               = true;
+  comp_obj_toc.metainfo.object_number_type              = 0;
+  comp_obj_toc.attrib.indent_hang                       = indent["hang_position"];
+  comp_obj_toc.attrib.indent_base                       = indent["base_position"];
+  comp_obj_toc.attrib.bullet                            = false;
+  if (the_document_endnotes_section.length > 1) {
+    toc_txt_ = format("%s%s%s%s#%s%s",
+      mkup.lnk_o,
+      "Endnotes",
+      mkup.lnk_c,
+      mkup.url_o,
+      "endnotes",
+      mkup.url_c,
+    );
+    toc_txt_= toc_txt_.links_and_images;
+    comp_obj_toc.text                                   = toc_txt_.to!string.strip;
+    comp_obj_toc.has.inline_links                       = true;
+    the_document_toc_section                            ~= comp_obj_toc;
   }
-}
-#+END_SRC
-
-***** ↻ Loop section: endnotes [en] :loop:endnotes:
-
-#+NAME: abs_post_loop_section_endnotes
-#+BEGIN_SRC d
-if (the_document_endnotes_section.length > 1) {
-  segnames["html"] ~= "endnotes";
-  segnames["epub"] ~= "endnotes";
-  html_segnames_ptr = html_segnames_ptr_cntr;
-  foreach (ref obj; the_document_endnotes_section) {
-    if (obj.metainfo.is_a == "heading") {
-      obj.metainfo.parent_ocn = obj.metainfo.markedup_ancestors[obj.metainfo.parent_lev_markup];
-    }
-    if (obj.metainfo.heading_lev_markup == 4) {
-      obj.ptr.html_segnames = html_segnames_ptr;
-      break;
-    }
+  if (the_document_glossary_section.length > 1) {
+    toc_txt_ = format("%s%s%s%s#%s%s",
+      mkup.lnk_o,
+      "Glossary",
+      mkup.lnk_c,
+      mkup.url_o,
+      "glossary",
+      mkup.url_c,
+    );
+    toc_txt_= toc_txt_.links_and_images;
+    comp_obj_toc.text                                   = toc_txt_.to!string.strip;
+    comp_obj_toc.has.inline_links                       = true;
+    the_document_toc_section                            ~= comp_obj_toc;
   }
-  html_segnames_ptr_cntr++;
-}
-#+END_SRC
-
-***** ↻ Loop section: glossary [gl] :loop:glossary:
-
-#+NAME: abs_post_loop_section_glossary
-#+BEGIN_SRC d
-if (the_document_glossary_section.length > 1) {
-  segnames["html"] ~= "glossary";
-  segnames["epub"] ~= "glossary";
-  html_segnames_ptr = html_segnames_ptr_cntr;
-  foreach (ref obj; the_document_glossary_section) {
-    if (obj.metainfo.is_a == "heading") {
-      obj.metainfo.parent_ocn = obj.metainfo.markedup_ancestors[obj.metainfo.parent_lev_markup];
-    }
-    if (obj.metainfo.heading_lev_markup == 4) {
-      obj.ptr.html_segnames = html_segnames_ptr;
-      break;
-    }
+  if (the_document_bibliography_section.length > 1){
+    toc_txt_ = format("%s%s%s%s#%s%s",
+      mkup.lnk_o,
+      "Bibliography",
+      mkup.lnk_c,
+      mkup.url_o,
+      "bibliography",
+      mkup.url_c,
+    );
+    toc_txt_= toc_txt_.links_and_images;
+    comp_obj_toc.text                                   = toc_txt_.to!string.strip;
+    comp_obj_toc.has.inline_links                       = true;
+    the_document_toc_section                            ~= comp_obj_toc;
   }
-  html_segnames_ptr_cntr++;
-}
-#+END_SRC
-
-***** ↻ Loop section: bibliography [bb] :loop:bibliography:
-
-#+NAME: abs_post_loop_section_biblio
-#+BEGIN_SRC d
-if (the_document_bibliography_section.length > 1) {
-  segnames["html"] ~= "bibliography";
-  segnames["epub"] ~= "bibliography";
-  html_segnames_ptr = html_segnames_ptr_cntr;
-  foreach (ref obj; the_document_bibliography_section) {
-    if (obj.metainfo.is_a == "heading") {
-      obj.metainfo.parent_ocn = obj.metainfo.markedup_ancestors[obj.metainfo.parent_lev_markup];
-    }
-    if (obj.metainfo.heading_lev_markup == 4) {
-      obj.ptr.html_segnames = html_segnames_ptr;
-      break;
-    }
+  if (the_document_bookindex_section.length > 1) {
+    toc_txt_ = format("%s%s%s%s#%s%s",
+      mkup.lnk_o,
+      "Book Index",
+      mkup.lnk_c,
+      mkup.url_o,
+      "bookindex",
+      mkup.url_c,
+    );
+    toc_txt_= toc_txt_.links_and_images;
+    comp_obj_toc.text                                   = toc_txt_.to!string.strip;
+    comp_obj_toc.has.inline_links                       = true;
+    the_document_toc_section                            ~= comp_obj_toc;
   }
-  html_segnames_ptr_cntr++;
-}
-#+END_SRC
-
-***** ↻ Loop section: book index [bi] :loop:bookindex:
-
-#+NAME: abs_post_loop_section_bookindex
-#+BEGIN_SRC d
-if (the_document_bookindex_section.length > 1) {
-  segnames["html"] ~= "bookindex";
-  segnames["epub"] ~= "bookindex";
-  html_segnames_ptr = html_segnames_ptr_cntr;
-  foreach (ref obj; the_document_bookindex_section) {
-    if (obj.metainfo.is_a == "heading") {
-      obj.metainfo.parent_ocn = obj.metainfo.markedup_ancestors[obj.metainfo.parent_lev_markup];
-    }
-    if (obj.metainfo.heading_lev_markup == 4) {
-      obj.ptr.html_segnames = html_segnames_ptr;
-      break;
-    }
+  if (the_document_blurb_section.length > 1) {
+    toc_txt_ = format("%s%s%s%s#%s%s",
+      mkup.lnk_o,
+      "Blurb",
+      mkup.lnk_c,
+      mkup.url_o,
+      "blurb",
+      mkup.url_c,
+    );
+    toc_txt_= toc_txt_.links_and_images;
+    comp_obj_toc.has.inline_links                       = true;
+    comp_obj_toc.text                                   = toc_txt_.to!string.strip;
+    the_document_toc_section                            ~= comp_obj_toc;
   }
-  html_segnames_ptr_cntr++;
-}
-#+END_SRC
-
-***** ↻ Loop section: blurb [bl] :loop:blurb:
-
-#+NAME: abs_post_loop_section_blurb
-#+BEGIN_SRC d
-if (the_document_blurb_section.length > 1) {
-  segnames["html"] ~= "blurb";
-  segnames["epub"] ~= "blurb";
-  html_segnames_ptr = html_segnames_ptr_cntr;
-  foreach (ref obj; the_document_blurb_section) {
-    if (obj.metainfo.is_a == "heading") {
-      obj.metainfo.parent_ocn = obj.metainfo.markedup_ancestors[obj.metainfo.parent_lev_markup];
-    }
-    if (obj.metainfo.heading_lev_markup == 4) {
-      obj.ptr.html_segnames = html_segnames_ptr;
-      break;
+  debug(toc) {
+    writefln(
+      "%s %s",
+      __LINE__,
+    );
+    foreach (toc_linked_heading; the_document_toc_section) {
+      writeln(mkup.indent_by_spaces_provided(toc_linked_heading.attrib.indent_hang), toc_linked_heading.text);
     }
   }
-  html_segnames_ptr_cntr++;
-}
-#+END_SRC
-
-**** 2. ↻ _Loop all objects:_ encode _structural relationships_ (sections, segments, objects)
-
-needed for DOM structure, segnames & subtoc, backmatter pointers & unique image
-list
-
-if used minimally only for DOM structure, segnames, subtoc, could optimise by
-- skipping second and third pass unless the output html seg or epub is being
-  made!
-
-- this loop could conveniently be used more extensively for ancestors as well
-  (though this information can be extracted earlier)
-
-Build here:
-- DOM structure
-  - ancestors & decendants
-    - ancestors could be determined earlier, but convenient to have here
-    - descendants could be in the form of:
-      - headings contained under current heading, and/or;
-      - the range of objects under the current heading
-- numbering
-  - already given
-    - substantive object numbers
-    - endnote
-  - provide
-    - glossary
-    - bibliography
-    - book index
-    - blurb
-    - other non-substantive objects (prefix & other stuff)
-  - you could also decide on a sequential object list, containing all objects
-    (both substantive and non-substantive objects), in addition to ocn, which
-    are for substantive/ citable objects within the document
-
-(as needed) up to document heading 1~, lev4 html:
-
-- during this (the third) pass all previous and next segment names are known
-- next are not yet known for backmatter during the second pas
-
-***** Methods
-****** decendants
-
-#+NAME: abs_post_loop_all_obj_get_heading_decendants
-#+BEGIN_SRC d
-@safe auto get_decendants()(ObjGenericComposite[] document_sections) {
-  int[string] _heading_ocn_decendants;
-  string[] _ocn_open_key = ["","","","","","","",""];
-  auto _doc_sect_length = document_sections.length - 1;
-  int _last_ocn;
-  foreach (_lg, ref obj; document_sections) {
+  the_document_head_section ~= the_document_body_section[0];
+  the_document_body_section = the_document_body_section[1..$];
+  @safe int[] _get_ancestors_markup(O)(O obj, ref int[] _ancestors_markup) {
     if (obj.metainfo.is_a == "heading") {
-      foreach (_dts_lv, dom_tag_status; obj.metainfo.dom_structure_markedup_tags_status) {
-        switch (dom_tag_status) with (DomTags) {
-        case none: break;
-        case open:
-            _ocn_open_key[_dts_lv] = (obj.metainfo.ocn).to!string;
-            _heading_ocn_decendants[_ocn_open_key[_dts_lv]] = obj.metainfo.ocn;
-          break;
-        case close:
-          if (_ocn_open_key[_dts_lv].empty) {
-            _ocn_open_key[_dts_lv] = "0";
-          }
-          _heading_ocn_decendants[_ocn_open_key[_dts_lv]] = obj.metainfo.ocn - 1;
-          _ocn_open_key[_dts_lv] = (0).to!string;
-          break;
-        case close_and_open:
-          if (_ocn_open_key[_dts_lv].empty) {
-            _ocn_open_key[_dts_lv] = "0";
-          }
-          _heading_ocn_decendants[_ocn_open_key[_dts_lv]] = obj.metainfo.ocn - 1;
-          _ocn_open_key[_dts_lv] = (obj.metainfo.ocn).to!string;
-          _heading_ocn_decendants[_ocn_open_key[_dts_lv]] = obj.metainfo.ocn;
-          break;
-        case open_still: break;
-        default: break;
-        }
+      debug(dom) {
+        writeln(obj.text);
       }
-    }
-    if (obj.metainfo.ocn > 0) {
-      _last_ocn = obj.metainfo.ocn;
-    }
-    if (_lg == _doc_sect_length) {
-      _heading_ocn_decendants["1"] = _last_ocn; // close existing o_n key
-    }
-  }
-  Tuple!(int, int)[] pairs;
-  foreach (pair; _heading_ocn_decendants.byPair) {
-    pairs ~= tuple(pair[0].to!int, pair[1]);
-  }
-  return pairs.sort;
-}
-#+END_SRC
-
-****** images: extract
-
-#+NAME: abs_post_loop_all_obj_get_image_names
-#+BEGIN_SRC d
-string[] _images;
-@safe string[] extract_images()(string content_block) {
-  string[] images_;
-  if (auto m = content_block.matchAll(rgx.image)) {
-    images_ ~= m.captures[1];
-  }
-  return images_;
-}
-string[] segnames_0_to_4;
-#+END_SRC
-
-****** images: dimensions
-
-#+NAME: abs_post_loop_all_obj_get_image_dimensions
-#+BEGIN_SRC d
-@system auto _image_dimensions(O,M)(O obj, M manifested) {
-  if (obj.has.image_without_dimensions) {
-    import std.math;
-    import imageformats;
-    int w, h, chans;
-    real _w, _h;
-    int max_width = 640;
-    foreach (img; obj.text.matchAll(rgx.inline_image_without_dimensions)) {
-      try {
-        read_image_info(manifested.src.image_dir_path ~ "/" ~ img["img"], w, h, chans); //
-      } catch (Exception ex) {
-        writeln("WARNING, image not found: ", img["img"], "\n  ", manifested.src.image_dir_path ~ "/" ~ img["img"]);
-      }
-      // calculate, decide max width and proportionally reduce to keep w & h within it
-      debug(images) {
-        writeln("width: ", w, ", height: ", h);
+      if (obj.metainfo.heading_lev_markup == 1) {
+        _ancestors_markup = [
+          _ancestors_markup[0],
+          0,0,0,0,0,0,0
+        ];
+      }
+      if (obj.metainfo.heading_lev_markup == 2) {
+        _ancestors_markup = [
+          _ancestors_markup[0],
+          _ancestors_markup[1],
+          0,0,0,0,0,0
+        ];
+      }
+      if (obj.metainfo.heading_lev_markup == 3) {
+        _ancestors_markup = [
+          _ancestors_markup[0],
+          _ancestors_markup[1],
+          _ancestors_markup[2],
+          0,0,0,0,0
+        ];
+      }
+      if (obj.metainfo.heading_lev_markup == 4) {
+        _ancestors_markup = [
+          _ancestors_markup[0],
+          _ancestors_markup[1],
+          _ancestors_markup[2],
+          _ancestors_markup[3],
+          0,0,0,0
+        ];
+      }
+      if (obj.metainfo.heading_lev_markup == 5) {
+        _ancestors_markup = [
+          _ancestors_markup[0],
+          _ancestors_markup[1],
+          _ancestors_markup[2],
+          _ancestors_markup[3],
+          _ancestors_markup[4],
+          0,0,0
+        ];
+      }
+      if (obj.metainfo.heading_lev_markup == 6) {
+        _ancestors_markup = [
+          _ancestors_markup[0],
+          _ancestors_markup[1],
+          _ancestors_markup[2],
+          _ancestors_markup[3],
+          _ancestors_markup[4],
+          _ancestors_markup[5],
+          0,0
+        ];
+      }
+      if (obj.metainfo.heading_lev_markup == 7) {
+        _ancestors_markup = [
+          _ancestors_markup[0],
+          _ancestors_markup[1],
+          _ancestors_markup[2],
+          _ancestors_markup[3],
+          _ancestors_markup[4],
+          _ancestors_markup[5],
+          _ancestors_markup[6],
+          0
+        ];
+      }
+      if (obj.metainfo.heading_lev_markup == 8) {
+        _ancestors_markup = [
+          _ancestors_markup[0],
+          _ancestors_markup[1],
+          _ancestors_markup[2],
+          _ancestors_markup[3],
+          _ancestors_markup[4],
+          _ancestors_markup[5],
+          _ancestors_markup[6],
+          _ancestors_markup[7]
+        ];
+      }
+      _ancestors_markup[obj.metainfo.heading_lev_markup] = obj.metainfo.ocn;
+    }
+    debug(ancestor_markup) {
+      writeln("marked up: ", _ancestors_markup);
+    }
+    return _ancestors_markup;
+  }
+  @safe int[] _get_ancestors_collapsed(O)(O obj, ref int[] _ancestors_collapsed) {
+    if (obj.metainfo.is_a == "heading") {
+      if (obj.metainfo.heading_lev_collapsed == 1) {
+        _ancestors_collapsed = [
+          _ancestors_collapsed[0],
+          0,0,0,0,0,0,0
+        ];
+      }
+      if (obj.metainfo.heading_lev_collapsed == 2) {
+        _ancestors_collapsed = [
+          _ancestors_collapsed[0],
+          _ancestors_collapsed[1],
+          0,0,0,0,0,0
+        ];
+      }
+      if (obj.metainfo.heading_lev_collapsed == 3) {
+        _ancestors_collapsed = [
+          _ancestors_collapsed[0],
+          _ancestors_collapsed[1],
+          _ancestors_collapsed[2],
+          0,0,0,0,0
+        ];
+      }
+      if (obj.metainfo.heading_lev_collapsed == 4) {
+        _ancestors_collapsed = [
+          _ancestors_collapsed[0],
+          _ancestors_collapsed[1],
+          _ancestors_collapsed[2],
+          _ancestors_collapsed[3],
+          0,0,0,0
+        ];
+      }
+      if (obj.metainfo.heading_lev_collapsed == 5) {
+        _ancestors_collapsed = [
+          _ancestors_collapsed[0],
+          _ancestors_collapsed[1],
+          _ancestors_collapsed[2],
+          _ancestors_collapsed[3],
+          _ancestors_collapsed[4],
+          0,0,0
+        ];
+      }
+      if (obj.metainfo.heading_lev_collapsed == 6) {
+        _ancestors_collapsed = [
+          _ancestors_collapsed[0],
+          _ancestors_collapsed[1],
+          _ancestors_collapsed[2],
+          _ancestors_collapsed[3],
+          _ancestors_collapsed[4],
+          _ancestors_collapsed[5],
+          0,0
+        ];
+      }
+      if (obj.metainfo.heading_lev_collapsed == 7) {
+        _ancestors_collapsed = [
+          _ancestors_collapsed[0],
+          _ancestors_collapsed[1],
+          _ancestors_collapsed[2],
+          _ancestors_collapsed[3],
+          _ancestors_collapsed[4],
+          _ancestors_collapsed[5],
+          _ancestors_collapsed[6],
+          0
+        ];
+      }
+      if (obj.metainfo.heading_lev_collapsed == 8) {
+        _ancestors_collapsed = [
+          _ancestors_collapsed[0],
+          _ancestors_collapsed[1],
+          _ancestors_collapsed[2],
+          _ancestors_collapsed[3],
+          _ancestors_collapsed[4],
+          _ancestors_collapsed[5],
+          _ancestors_collapsed[6],
+          _ancestors_collapsed[7]
+        ];
+      }
+      _ancestors_collapsed[obj.metainfo.heading_lev_collapsed] = obj.metainfo.ocn;
+    }
+    debug(ancestor_collapsed) {
+      writeln("collapsed: ", _ancestors_collapsed);
+    }
+    return _ancestors_collapsed;
+  }
+  /+ multiple 1~ levels, loop through document body +/
+  if (the_document_body_section.length > 1) {
+    int[] _ancestors_markup = [0,0,0,0,0,0,0,0];
+    int[][] _ancestors_markup_;
+    _ancestors_markup = [1,0,0,0,0,0,0,0];
+    _ancestors_markup_ ~= _ancestors_markup;
+    int[] _ancestors_collapsed = [0,0,0,0,0,0,0,0];
+    int[][] _ancestors_collapsed_;
+    _ancestors_collapsed = [1,0,0,0,0,0,0,0];
+    _ancestors_collapsed_ ~= _ancestors_collapsed;
+    foreach (ref obj; the_document_body_section) {
+      if (obj.metainfo.is_a == "heading") {
+        obj.metainfo.markedup_ancestors = _get_ancestors_markup(obj, _ancestors_markup);
+        obj.metainfo.collapsed_ancestors = _get_ancestors_collapsed(obj, _ancestors_collapsed);
+        obj.metainfo.parent_ocn = obj.metainfo.markedup_ancestors[obj.metainfo.parent_lev_markup];
       }
-      if (w > max_width) {
-        _w = max_width;
-        _h = round((max_width / w.to!real) * h.to!real);
-      } else {
-        _w = w;
-        _h = h;
-      }
-      obj.text = obj.text.replaceFirst(
-        rgx.inline_image_without_dimensions,
-        format(q"┃%s☼%s,w%sh%s %s┃",
-          "$1",
-          "$3",
-          _w.to!string,
-          _h.to!string,
-          "$6",
-        )
-      );
     }
-    debug(images) {
-      writeln("image without dimensions: ", obj.text);
+    debug(ancestors) {
+      writeln("ancestors markup o_n:    ", obj.metainfo.markedup_ancestors);
+      writeln("ancestors collapsed o_n: ", obj.metainfo.markedup_ancestors);
     }
   }
-  return obj;
-}
-#+END_SRC
-
-***** links: think about!!!
-- move actual links to an array in object struct so they cannot be regex munged within text block
-  - you may wish to exclude certain types of internal document link
-    - object number links
-      - toc
-      - book index
-    - footnotes and footnote numbers
-
-#+NAME: abs_post_loop_all_obj_get_links
-#+BEGIN_SRC d
-@safe auto _links(O)(O obj) {
-  if (auto m = obj.text.match(rgx.inline_link_stow_uri)) {
-    debug(links) {
-      writeln("number of link matches to stow: ", (obj.text.match(rgx.inline_link_stow_uri)).count);
-      writeln("links to stow: ", (obj.text.match(rgx.inline_link_stow_uri)));
-    }
-    int _n_matches = (obj.text.match(rgx.inline_link_stow_uri)).count.to!int;
-    for(int i = 0; i < _n_matches; ++i) {
-      if (obj.text.match(rgx.inline_link_stow_uri)) {
-        obj.stow.link ~= obj.text.matchFirst(rgx.inline_link_stow_uri)[2];
-        obj.text = obj.text.replaceFirst(
-          rgx.inline_link_stow_uri,
-          format(q"┃┥%s┝┤%s├┃", "$1", i)
-        );
+  if (the_document_endnotes_section.length > 1) {
+    segnames["html"] ~= "endnotes";
+    segnames["epub"] ~= "endnotes";
+    html_segnames_ptr = html_segnames_ptr_cntr;
+    foreach (ref obj; the_document_endnotes_section) {
+      if (obj.metainfo.is_a == "heading") {
+        obj.metainfo.parent_ocn = obj.metainfo.markedup_ancestors[obj.metainfo.parent_lev_markup];
+      }
+      if (obj.metainfo.heading_lev_markup == 4) {
+        obj.ptr.html_segnames = html_segnames_ptr;
+        break;
       }
     }
+    html_segnames_ptr_cntr++;
   }
-  return obj;
-}
-#+END_SRC
-
-***** ↻ Loop section: head :loop:head:
-
-#+NAME: abs_post_loop_section_head
-#+BEGIN_SRC d
-foreach (ref obj; the_document_head_section) {
-  if (obj.metainfo.is_a == "heading") {
-    debug(dom) {
-      writeln(obj.text);
-    }
-    if (obj.metainfo.heading_lev_markup <= 4) {
-      segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
-    }
-    if (obj.metainfo.heading_lev_markup == 0) {
-      /+ TODO second hit (of two) with same assertion failure, check, fix and reinstate
-      assert( obj.metainfo.ocn == 1,
-        "Title OCN should be 1 not: " ~ obj.metainfo.ocn.to!string); // bug introduced 0.18.1
-      +/
-      obj.metainfo.ocn = 1;
-      obj.metainfo.identifier = "1";
-      obj.metainfo.object_number_type = OCNtype.ocn;
-    }
-    /+ dom structure (marked up & collapsed) +/
-    if (opt_action.meta_processing_xml_dom) {
-      obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
-      obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
-    }
-    obj = obj.obj_heading_ancestors(lv_ancestors_txt);
-  }
-  obj = _links(obj);
-}
-#+END_SRC
-
-***** ↻ Loop section: toc :loop:table_of_contents:
-
-#+NAME: abs_post_loop_section_toc
-#+BEGIN_SRC d
-if (the_document_toc_section.length > 1) {
-  /+ scroll +/
-  dom_structure_markedup_tags_status_buffer = dom_structure_markedup_tags_status.dup;
-  dom_structure_collapsed_tags_status_buffer = dom_structure_collapsed_tags_status.dup;
-  foreach (ref obj; the_document_toc_section) {
-    if (obj.metainfo.is_a == "heading") {
-      if (obj.metainfo.heading_lev_markup <= 4) {
-        segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
-        if (obj.metainfo.heading_lev_markup == 4) {
-          obj.tags.segname_next = segnames["html"][obj.ptr.html_segnames + 1];
-          assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
-            obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
-        }
+  if (the_document_glossary_section.length > 1) {
+    segnames["html"] ~= "glossary";
+    segnames["epub"] ~= "glossary";
+    html_segnames_ptr = html_segnames_ptr_cntr;
+    foreach (ref obj; the_document_glossary_section) {
+      if (obj.metainfo.is_a == "heading") {
+        obj.metainfo.parent_ocn = obj.metainfo.markedup_ancestors[obj.metainfo.parent_lev_markup];
       }
-      /+ dom structure (marked up & collapsed) +/
-      if (opt_action.meta_processing_xml_dom) {
-        obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
-        obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
+      if (obj.metainfo.heading_lev_markup == 4) {
+        obj.ptr.html_segnames = html_segnames_ptr;
+        break;
       }
-      obj = obj.obj_heading_ancestors(lv_ancestors_txt);
     }
-    obj = _links(obj);
+    html_segnames_ptr_cntr++;
   }
-}
-#+END_SRC
-
-***** ↻ Loop section: document body [bd] :loop:body:
-
-#+NAME: abs_post_reloop_section_body
-#+BEGIN_SRC d
-/+ multiple 1~ levels, loop through document body +/
-if (the_document_body_section.length > 1) {
-  foreach (ref obj; the_document_body_section) {
-    if (!(obj.metainfo.identifier.empty)) {
-      if (!(((obj.metainfo.identifier) in tag_assoc)
-        && ("seg_lv4" in tag_assoc[(obj.metainfo.identifier)]))
-      ) {
-        tag_assoc[(obj.metainfo.identifier)]["seg_lv4"]
-        = obj.tags.html_segment_anchor_tag_is;
+  if (the_document_bibliography_section.length > 1) {
+    segnames["html"] ~= "bibliography";
+    segnames["epub"] ~= "bibliography";
+    html_segnames_ptr = html_segnames_ptr_cntr;
+    foreach (ref obj; the_document_bibliography_section) {
+      if (obj.metainfo.is_a == "heading") {
+        obj.metainfo.parent_ocn = obj.metainfo.markedup_ancestors[obj.metainfo.parent_lev_markup];
+      }
+      if (obj.metainfo.heading_lev_markup == 4) {
+        obj.ptr.html_segnames = html_segnames_ptr;
+        break;
       }
-      tag_assoc[(obj.metainfo.identifier)]["seg_lv1to4"]
-      = obj.tags.epub_segment_anchor_tag_is;
     }
-    if (obj.metainfo.is_a == "heading") {
-      debug(dom) {
-        writeln(obj.text);
+    html_segnames_ptr_cntr++;
+  }
+  if (the_document_bookindex_section.length > 1) {
+    segnames["html"] ~= "bookindex";
+    segnames["epub"] ~= "bookindex";
+    html_segnames_ptr = html_segnames_ptr_cntr;
+    foreach (ref obj; the_document_bookindex_section) {
+      if (obj.metainfo.is_a == "heading") {
+        obj.metainfo.parent_ocn = obj.metainfo.markedup_ancestors[obj.metainfo.parent_lev_markup];
       }
-      if (obj.metainfo.heading_lev_markup <= 4) {
-        segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
-        if (obj.metainfo.heading_lev_markup == 4) {
-          obj.tags.lev4_subtoc = lev4_subtoc[obj.tags.anchor_tag_html];
-          obj.tags.segname_prev = segnames["html"][obj.ptr.html_segnames - 1];
-          if (segnames["html"].length > obj.ptr.html_segnames + 1) {
-            obj.tags.segname_next = segnames["html"][obj.ptr.html_segnames + 1];
-          }
-          assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
-            obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
-        }
+      if (obj.metainfo.heading_lev_markup == 4) {
+        obj.ptr.html_segnames = html_segnames_ptr;
+        break;
       }
-      /+ dom structure (marked up & collapsed) +/
-      if (opt_action.meta_processing_xml_dom) {
-        obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
-        obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
-      }
-      obj = obj.obj_heading_ancestors(lv_ancestors_txt);
-    } else if (obj.metainfo.is_a == "para") {
-       _images ~= extract_images(obj.text);
-       obj = _image_dimensions(obj, manifested);
     }
-    obj = _links(obj);
+    html_segnames_ptr_cntr++;
   }
-}
-auto image_list = (_images.sort()).uniq;
-#+END_SRC
-
-***** ↻ Loop section: endnotes [en] :loop:endnotes:
-
-- endnotes have their own number, (also use in node) and they belong to calling object
-
-#+NAME: abs_post_reloop_section_endnotes
-#+BEGIN_SRC d
-/+ optional only one 1~ level +/
-if (the_document_endnotes_section.length > 1) {
-  dom_structure_markedup_tags_status_buffer           = dom_structure_markedup_tags_status.dup;
-  dom_structure_collapsed_tags_status_buffer          = dom_structure_collapsed_tags_status.dup;
-  dom_structure_markedup_tags_status                  = dom_structure_markedup_tags_status_buffer.dup;
-  dom_structure_collapsed_tags_status                 = dom_structure_collapsed_tags_status_buffer.dup;
-  foreach (ref obj; the_document_endnotes_section) {
-    if (obj.metainfo.is_a == "heading") {
-      debug(dom) {
-        writeln(obj.text);
+  if (the_document_blurb_section.length > 1) {
+    segnames["html"] ~= "blurb";
+    segnames["epub"] ~= "blurb";
+    html_segnames_ptr = html_segnames_ptr_cntr;
+    foreach (ref obj; the_document_blurb_section) {
+      if (obj.metainfo.is_a == "heading") {
+        obj.metainfo.parent_ocn = obj.metainfo.markedup_ancestors[obj.metainfo.parent_lev_markup];
       }
-      if (obj.metainfo.heading_lev_markup == 1) {
-        obj_cite_digits                               = ocn_emit(eN.ocn.on);
-        obj.metainfo.ocn                              = obj_cite_digits.object_number;
-        obj.metainfo.identifier                       = obj_cite_digits.identifier;
+      if (obj.metainfo.heading_lev_markup == 4) {
+        obj.ptr.html_segnames = html_segnames_ptr;
+        break;
       }
-      if (obj.metainfo.heading_lev_markup <= 4) {
-        segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
-        if (obj.metainfo.heading_lev_markup == 4) {
-          obj.tags.segname_prev = segnames["html"][obj.ptr.html_segnames - 1];
-          if (segnames["html"].length > obj.ptr.html_segnames + 1) {
-            obj.tags.segname_next = segnames["html"][obj.ptr.html_segnames + 1];
+    }
+    html_segnames_ptr_cntr++;
+  }
+  @safe auto get_decendants()(ObjGenericComposite[] document_sections) {
+    int[string] _heading_ocn_decendants;
+    string[] _ocn_open_key = ["","","","","","","",""];
+    auto _doc_sect_length = document_sections.length - 1;
+    int _last_ocn;
+    foreach (_lg, ref obj; document_sections) {
+      if (obj.metainfo.is_a == "heading") {
+        foreach (_dts_lv, dom_tag_status; obj.metainfo.dom_structure_markedup_tags_status) {
+          switch (dom_tag_status) with (DomTags) {
+          case none: break;
+          case open:
+              _ocn_open_key[_dts_lv] = (obj.metainfo.ocn).to!string;
+              _heading_ocn_decendants[_ocn_open_key[_dts_lv]] = obj.metainfo.ocn;
+            break;
+          case close:
+            if (_ocn_open_key[_dts_lv].empty) {
+              _ocn_open_key[_dts_lv] = "0";
+            }
+            _heading_ocn_decendants[_ocn_open_key[_dts_lv]] = obj.metainfo.ocn - 1;
+            _ocn_open_key[_dts_lv] = (0).to!string;
+            break;
+          case close_and_open:
+            if (_ocn_open_key[_dts_lv].empty) {
+              _ocn_open_key[_dts_lv] = "0";
+            }
+            _heading_ocn_decendants[_ocn_open_key[_dts_lv]] = obj.metainfo.ocn - 1;
+            _ocn_open_key[_dts_lv] = (obj.metainfo.ocn).to!string;
+            _heading_ocn_decendants[_ocn_open_key[_dts_lv]] = obj.metainfo.ocn;
+            break;
+          case open_still: break;
+          default: break;
           }
-          assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
-            obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
         }
       }
-      /+ dom structure (marked up & collapsed) +/
-      if (opt_action.meta_processing_xml_dom) {
-        obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
-        obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
+      if (obj.metainfo.ocn > 0) {
+        _last_ocn = obj.metainfo.ocn;
+      }
+      if (_lg == _doc_sect_length) {
+        _heading_ocn_decendants["1"] = _last_ocn; // close existing o_n key
       }
-      obj = obj.obj_heading_ancestors(lv_ancestors_txt);
     }
-    obj = _links(obj);
+    Tuple!(int, int)[] pairs;
+    foreach (pair; _heading_ocn_decendants.byPair) {
+      pairs ~= tuple(pair[0].to!int, pair[1]);
+    }
+    return pairs.sort;
   }
-}
-#+END_SRC
-
-***** ↻ reLoop section: glossary [gl] :loop:glossary:
-
-- add glossary numbering, (also use in node) no need to show in text
-
-#+NAME: abs_post_reloop_section_glossary_get_numbering
-#+BEGIN_SRC d
-/+ optional only one 1~ level +/
-if (the_document_glossary_section.length > 1) {
-  foreach (ref obj; the_document_glossary_section) {
-    if (obj.metainfo.is_a == "heading") {
-      debug(dom) {
-        writeln(obj.text);
-      }
-      if (obj.metainfo.heading_lev_markup == 1) {
-        obj_cite_digits                               = ocn_emit(eN.ocn.on);
-        obj.metainfo.ocn                              = obj_cite_digits.object_number;
-        obj.metainfo.identifier                       = obj_cite_digits.identifier;
-      }
-      if (obj.metainfo.heading_lev_markup <= 4) {
-        segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
-        if (obj.metainfo.heading_lev_markup == 4) {
-          obj.tags.segname_prev = segnames["html"][obj.ptr.html_segnames - 1];
-          if (segnames["html"].length > obj.ptr.html_segnames + 1) {
-            obj.tags.segname_next = segnames["html"][obj.ptr.html_segnames + 1];
-          }
-          assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
-            obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
+  string[] _images;
+  @safe string[] extract_images()(string content_block) {
+    string[] images_;
+    if (auto m = content_block.matchAll(rgx.image)) {
+      images_ ~= m.captures[1];
+    }
+    return images_;
+  }
+  string[] segnames_0_to_4;
+  @system auto _image_dimensions(O,M)(O obj, M manifested) {
+    if (obj.has.image_without_dimensions) {
+      import std.math;
+      import imageformats;
+      int w, h, chans;
+      real _w, _h;
+      int max_width = 640;
+      foreach (img; obj.text.matchAll(rgx.inline_image_without_dimensions)) {
+        try {
+          read_image_info(manifested.src.image_dir_path ~ "/" ~ img["img"], w, h, chans); //
+        } catch (Exception ex) {
+          writeln("WARNING, image not found: ", img["img"], "\n  ", manifested.src.image_dir_path ~ "/" ~ img["img"]);
         }
+        // calculate, decide max width and proportionally reduce to keep w & h within it
+        debug(images) {
+          writeln("width: ", w, ", height: ", h);
+        }
+        if (w > max_width) {
+          _w = max_width;
+          _h = round((max_width / w.to!real) * h.to!real);
+        } else {
+          _w = w;
+          _h = h;
+        }
+        obj.text = obj.text.replaceFirst(
+          rgx.inline_image_without_dimensions,
+          format(q"┃%s☼%s,w%sh%s %s┃",
+            "$1",
+            "$3",
+            _w.to!string,
+            _h.to!string,
+            "$6",
+          )
+        );
       }
-      /+ dom structure (marked up & collapsed) +/
-      if (opt_action.meta_processing_xml_dom) {
-        obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
-        obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
+      debug(images) {
+        writeln("image without dimensions: ", obj.text);
       }
-      obj = obj.obj_heading_ancestors(lv_ancestors_txt);
-    } else if (obj.metainfo.is_a == "glossary" && !(obj.text.empty)) {
-      obj_cite_digits         = ocn_emit(eN.ocn.on);
-      obj.metainfo.ocn        = obj_cite_digits.object_number;
-      obj.metainfo.identifier = obj_cite_digits.identifier;
     }
-    obj = _links(obj);
+    return obj;
   }
-}
-#+END_SRC
-
-***** ↻ reLoop section: bibliography [bb] :loop:bibliography:
-
-- add bibliography numbering, (also use in node) no need to show in text
-
-#+NAME: abs_post_reloop_section_biblio_get_numbering
-#+BEGIN_SRC d
-/+ optional only one 1~ level +/
-if (the_document_bibliography_section.length > 1) {
-  foreach (ref obj; the_document_bibliography_section) {
-    if (obj.metainfo.is_a == "heading") {
-      debug(dom) {
-        writeln(obj.text);
-      }
-      if (obj.metainfo.heading_lev_markup == 1) {
-        obj_cite_digits                               = ocn_emit(eN.ocn.on);
-        obj.metainfo.ocn                              = obj_cite_digits.object_number;
-        obj.metainfo.identifier                       = obj_cite_digits.identifier;
+  @safe auto _links(O)(O obj) {
+    if (auto m = obj.text.match(rgx.inline_link_stow_uri)) {
+      debug(links) {
+        writeln("number of link matches to stow: ", (obj.text.match(rgx.inline_link_stow_uri)).count);
+        writeln("links to stow: ", (obj.text.match(rgx.inline_link_stow_uri)));
       }
-      if (obj.metainfo.heading_lev_markup <= 4) {
-        segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
-        if (obj.metainfo.heading_lev_markup == 4) {
-          obj.tags.segname_prev = segnames["html"][obj.ptr.html_segnames - 1];
-          if (segnames["html"].length > obj.ptr.html_segnames + 1) {
-            obj.tags.segname_next = segnames["html"][obj.ptr.html_segnames + 1];
-          }
-          assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
-            obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
+      int _n_matches = (obj.text.match(rgx.inline_link_stow_uri)).count.to!int;
+      for(int i = 0; i < _n_matches; ++i) {
+        if (obj.text.match(rgx.inline_link_stow_uri)) {
+          obj.stow.link ~= obj.text.matchFirst(rgx.inline_link_stow_uri)[2];
+          obj.text = obj.text.replaceFirst(
+            rgx.inline_link_stow_uri,
+            format(q"┃┥%s┝┤%s├┃", "$1", i)
+          );
         }
       }
-      /+ dom structure (marked up & collapsed) +/
-      if (opt_action.meta_processing_xml_dom) {
-        obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
-        obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
-      }
-      obj = obj.obj_heading_ancestors(lv_ancestors_txt);
-    } else if (obj.metainfo.is_a == "bibliography") {
-      obj_cite_digits                                 = ocn_emit(eN.ocn.on);
-      obj.metainfo.ocn                                = obj_cite_digits.object_number;
-      obj.metainfo.identifier                         = obj_cite_digits.identifier;
     }
-    obj = _links(obj);
+    return obj;
   }
-}
-#+END_SRC
-
-***** ↻ Loop section: book index (scroll, seg) [bi] :loop:bookindex:
-
-- add book index numbering?, (also use in node) no need to show in text
-
-#+NAME: abs_post_reloop_section_bookindex_get_index
-#+BEGIN_SRC d
-/+ optional only one 1~ level +/
-int ocn_       = obj_cite_digits.object_number;
-int ocn_bkidx_ = 0;
-int ocn_bidx_;
-if (the_document_bookindex_section.length > 1) {                                        /+ scroll +/
-  dom_structure_markedup_tags_status_buffer = dom_structure_markedup_tags_status.dup;
-  dom_structure_collapsed_tags_status_buffer = dom_structure_collapsed_tags_status.dup;
-  foreach (ref obj; the_document_bookindex_section) {
+  foreach (ref obj; the_document_head_section) {
     if (obj.metainfo.is_a == "heading") {
       debug(dom) {
+        writeln(obj.text);
       }
       if (obj.metainfo.heading_lev_markup <= 4) {
         segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
       }
-      if (obj.metainfo.heading_lev_markup == 1) {
-        obj_cite_digits                               = ocn_emit(eN.ocn.on);
-        obj.metainfo.ocn                              = obj_cite_digits.object_number;
-        obj.metainfo.identifier                       = obj_cite_digits.identifier;
-      }
-      if (obj.metainfo.heading_lev_markup <= 4) {
-        if (obj.metainfo.heading_lev_markup == 4) {
-          obj.tags.segname_prev = segnames["html"][obj.ptr.html_segnames - 1];
-          if (segnames["html"].length > obj.ptr.html_segnames + 1) {
-            obj.tags.segname_next = segnames["html"][obj.ptr.html_segnames + 1];
-          }
-          assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
-            obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
-        }
+      if (obj.metainfo.heading_lev_markup == 0) {
+        /+ TODO second hit (of two) with same assertion failure, check, fix and reinstate
+        assert( obj.metainfo.ocn == 1,
+          "Title OCN should be 1 not: " ~ obj.metainfo.ocn.to!string); // bug introduced 0.18.1
+        +/
+        obj.metainfo.ocn = 1;
+        obj.metainfo.identifier = "1";
+        obj.metainfo.object_number_type = OCNtype.ocn;
       }
       /+ dom structure (marked up & collapsed) +/
       if (opt_action.meta_processing_xml_dom) {
@@ -2996,163 +2223,291 @@ if (the_document_bookindex_section.length > 1) {
         obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
       }
       obj = obj.obj_heading_ancestors(lv_ancestors_txt);
-    } else if (obj.metainfo.is_a == "bookindex") {
-      obj_cite_digits                                 = ocn_emit(eN.ocn.bkidx);
-      obj.metainfo.ocn                                = obj_cite_digits.object_number;
-      obj.metainfo.identifier                         = obj_cite_digits.identifier;
-      obj.metainfo.o_n_book_index                     = obj_cite_digits.bkidx;
-      obj.metainfo.object_number_type                 = OCNtype.bkidx;
     }
     obj = _links(obj);
   }
-  /+ TODO assert failure, reinstate
-  assert(obj_cite_digit_bkidx == ocn_bidx_
-    obj_cite_digit_bkidx ~ " == ocn_" ~ ocn_ ~ "?");
-  +/
-}
-#+END_SRC
-
-***** ↻ Loop section: blurb [bl] :loop:blurb:
-
-#+NAME: abs_post_reloop_section_blurb_get_numbering
-#+BEGIN_SRC d
-/+ optional only one 1~ level +/
-if (the_document_blurb_section.length > 1) {
-  foreach (ref obj; the_document_blurb_section) {
-    if (obj.metainfo.is_a == "heading") {
-      debug(dom) {
-        writeln(obj.text);
-      }
-      if (obj.metainfo.heading_lev_markup == 1) {
-        obj_cite_digits                               = ocn_emit(eN.ocn.on);
-        obj.metainfo.ocn                              = obj_cite_digits.object_number;
-        obj.metainfo.identifier                       = obj_cite_digits.identifier;
-      }
-      if (obj.metainfo.heading_lev_markup <= 4) {
-        segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
-        if (obj.metainfo.heading_lev_markup == 4) {
-          obj.tags.segname_prev = segnames["html"][obj.ptr.html_segnames - 1];
-          if (segnames["html"].length > obj.ptr.html_segnames + 1) {
+  if (the_document_toc_section.length > 1) {
+    /+ scroll +/
+    dom_structure_markedup_tags_status_buffer = dom_structure_markedup_tags_status.dup;
+    dom_structure_collapsed_tags_status_buffer = dom_structure_collapsed_tags_status.dup;
+    foreach (ref obj; the_document_toc_section) {
+      if (obj.metainfo.is_a == "heading") {
+        if (obj.metainfo.heading_lev_markup <= 4) {
+          segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
+          if (obj.metainfo.heading_lev_markup == 4) {
             obj.tags.segname_next = segnames["html"][obj.ptr.html_segnames + 1];
+            assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
+              obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
           }
-          assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
-            obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
         }
-      }
-      /+ dom structure (marked up & collapsed) +/
-      if (opt_action.meta_processing_xml_dom) {
-        obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
-        obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
-      }
-      obj = obj.obj_heading_ancestors(lv_ancestors_txt);
-    } else if (obj.metainfo.is_a == "blurb") {
-      obj_cite_digits                                 = ocn_emit(eN.ocn.off);
-      obj.metainfo.object_number_off                  = obj_cite_digits.off;
-      obj.metainfo.object_number_type                 = OCNtype.non;
-    }
-    obj = _links(obj);
-  }
-}
-#+END_SRC
-
-***** ↻ reLoop sections: get decendants :loop:document:
-
-#+NAME: abs_post_reloop_section_all_get_decendants
-#+BEGIN_SRC d
-if (the_document_body_section.length > 1) {
-  auto pairs = get_decendants(
-    the_document_head_section ~
-    the_document_body_section ~
-    the_document_endnotes_section ~
-    the_document_glossary_section ~
-    the_document_bibliography_section ~
-    the_document_bookindex_section ~
-    the_document_blurb_section ~
-    the_document_xml_dom_tail_section
-  );
-  debug(decendants_tuple) {
-    pairs = pairs.sort();
-    foreach (pair; pairs) {  // (pair; pairs.sort())
-      writeln(pair[0], "..", pair[1]);
-    }
-  }
-  foreach (ref obj; the_document_head_section) {
-    if (obj.metainfo.is_a == "heading") {
-      foreach (pair; pairs) {
-        if (obj.metainfo.ocn == pair[0]) {
-          obj.metainfo.last_decendant_ocn = pair[1];
+        /+ dom structure (marked up & collapsed) +/
+        if (opt_action.meta_processing_xml_dom) {
+          obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
+          obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
         }
+        obj = obj.obj_heading_ancestors(lv_ancestors_txt);
       }
+      obj = _links(obj);
     }
   }
+  /+ multiple 1~ levels, loop through document body +/
   if (the_document_body_section.length > 1) {
     foreach (ref obj; the_document_body_section) {
+      if (!(obj.metainfo.identifier.empty)) {
+        if (!(((obj.metainfo.identifier) in tag_assoc)
+          && ("seg_lv4" in tag_assoc[(obj.metainfo.identifier)]))
+        ) {
+          tag_assoc[(obj.metainfo.identifier)]["seg_lv4"]
+          = obj.tags.html_segment_anchor_tag_is;
+        }
+        tag_assoc[(obj.metainfo.identifier)]["seg_lv1to4"]
+        = obj.tags.epub_segment_anchor_tag_is;
+      }
       if (obj.metainfo.is_a == "heading") {
-        foreach (pair; pairs) {
-          if (obj.metainfo.ocn == pair[0]) {
-            obj.metainfo.last_decendant_ocn = pair[1];
+        debug(dom) {
+          writeln(obj.text);
+        }
+        if (obj.metainfo.heading_lev_markup <= 4) {
+          segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
+          if (obj.metainfo.heading_lev_markup == 4) {
+            obj.tags.lev4_subtoc = lev4_subtoc[obj.tags.anchor_tag_html];
+            obj.tags.segname_prev = segnames["html"][obj.ptr.html_segnames - 1];
+            if (segnames["html"].length > obj.ptr.html_segnames + 1) {
+              obj.tags.segname_next = segnames["html"][obj.ptr.html_segnames + 1];
+            }
+            assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
+              obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
           }
         }
+        /+ dom structure (marked up & collapsed) +/
+        if (opt_action.meta_processing_xml_dom) {
+          obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
+          obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
+        }
+        obj = obj.obj_heading_ancestors(lv_ancestors_txt);
+      } else if (obj.metainfo.is_a == "para") {
+         _images ~= extract_images(obj.text);
+         obj = _image_dimensions(obj, manifested);
       }
+      obj = _links(obj);
     }
   }
+  auto image_list = (_images.sort()).uniq;
+  /+ optional only one 1~ level +/
   if (the_document_endnotes_section.length > 1) {
+    dom_structure_markedup_tags_status_buffer           = dom_structure_markedup_tags_status.dup;
+    dom_structure_collapsed_tags_status_buffer          = dom_structure_collapsed_tags_status.dup;
+    dom_structure_markedup_tags_status                  = dom_structure_markedup_tags_status_buffer.dup;
+    dom_structure_collapsed_tags_status                 = dom_structure_collapsed_tags_status_buffer.dup;
     foreach (ref obj; the_document_endnotes_section) {
       if (obj.metainfo.is_a == "heading") {
-        foreach (pair; pairs) {
-          if (obj.metainfo.ocn == pair[0]) {
-            obj.metainfo.last_decendant_ocn = pair[1];
+        debug(dom) {
+          writeln(obj.text);
+        }
+        if (obj.metainfo.heading_lev_markup == 1) {
+          obj_cite_digits                               = ocn_emit(eN.ocn.on);
+          obj.metainfo.ocn                              = obj_cite_digits.object_number;
+          obj.metainfo.identifier                       = obj_cite_digits.identifier;
+        }
+        if (obj.metainfo.heading_lev_markup <= 4) {
+          segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
+          if (obj.metainfo.heading_lev_markup == 4) {
+            obj.tags.segname_prev = segnames["html"][obj.ptr.html_segnames - 1];
+            if (segnames["html"].length > obj.ptr.html_segnames + 1) {
+              obj.tags.segname_next = segnames["html"][obj.ptr.html_segnames + 1];
+            }
+            assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
+              obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
           }
         }
+        /+ dom structure (marked up & collapsed) +/
+        if (opt_action.meta_processing_xml_dom) {
+          obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
+          obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
+        }
+        obj = obj.obj_heading_ancestors(lv_ancestors_txt);
       }
+      obj = _links(obj);
     }
   }
+  /+ optional only one 1~ level +/
   if (the_document_glossary_section.length > 1) {
     foreach (ref obj; the_document_glossary_section) {
       if (obj.metainfo.is_a == "heading") {
-        foreach (pair; pairs) {
-          if (obj.metainfo.ocn == pair[0]) {
-            obj.metainfo.last_decendant_ocn = pair[1];
+        debug(dom) {
+          writeln(obj.text);
+        }
+        if (obj.metainfo.heading_lev_markup == 1) {
+          obj_cite_digits                               = ocn_emit(eN.ocn.on);
+          obj.metainfo.ocn                              = obj_cite_digits.object_number;
+          obj.metainfo.identifier                       = obj_cite_digits.identifier;
+        }
+        if (obj.metainfo.heading_lev_markup <= 4) {
+          segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
+          if (obj.metainfo.heading_lev_markup == 4) {
+            obj.tags.segname_prev = segnames["html"][obj.ptr.html_segnames - 1];
+            if (segnames["html"].length > obj.ptr.html_segnames + 1) {
+              obj.tags.segname_next = segnames["html"][obj.ptr.html_segnames + 1];
+            }
+            assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
+              obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
           }
         }
+        /+ dom structure (marked up & collapsed) +/
+        if (opt_action.meta_processing_xml_dom) {
+          obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
+          obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
+        }
+        obj = obj.obj_heading_ancestors(lv_ancestors_txt);
+      } else if (obj.metainfo.is_a == "glossary" && !(obj.text.empty)) {
+        obj_cite_digits         = ocn_emit(eN.ocn.on);
+        obj.metainfo.ocn        = obj_cite_digits.object_number;
+        obj.metainfo.identifier = obj_cite_digits.identifier;
       }
+      obj = _links(obj);
     }
   }
+  /+ optional only one 1~ level +/
   if (the_document_bibliography_section.length > 1) {
     foreach (ref obj; the_document_bibliography_section) {
       if (obj.metainfo.is_a == "heading") {
-        foreach (pair; pairs) {
-          if (obj.metainfo.ocn == pair[0]) {
-            obj.metainfo.last_decendant_ocn = pair[1];
+        debug(dom) {
+          writeln(obj.text);
+        }
+        if (obj.metainfo.heading_lev_markup == 1) {
+          obj_cite_digits                               = ocn_emit(eN.ocn.on);
+          obj.metainfo.ocn                              = obj_cite_digits.object_number;
+          obj.metainfo.identifier                       = obj_cite_digits.identifier;
+        }
+        if (obj.metainfo.heading_lev_markup <= 4) {
+          segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
+          if (obj.metainfo.heading_lev_markup == 4) {
+            obj.tags.segname_prev = segnames["html"][obj.ptr.html_segnames - 1];
+            if (segnames["html"].length > obj.ptr.html_segnames + 1) {
+              obj.tags.segname_next = segnames["html"][obj.ptr.html_segnames + 1];
+            }
+            assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
+              obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
           }
         }
-      }
-    }
-  }
-  if (the_document_bookindex_section.length > 1) {
+        /+ dom structure (marked up & collapsed) +/
+        if (opt_action.meta_processing_xml_dom) {
+          obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
+          obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
+        }
+        obj = obj.obj_heading_ancestors(lv_ancestors_txt);
+      } else if (obj.metainfo.is_a == "bibliography") {
+        obj_cite_digits                                 = ocn_emit(eN.ocn.on);
+        obj.metainfo.ocn                                = obj_cite_digits.object_number;
+        obj.metainfo.identifier                         = obj_cite_digits.identifier;
+      }
+      obj = _links(obj);
+    }
+  }
+  /+ optional only one 1~ level +/
+  int ocn_       = obj_cite_digits.object_number;
+  int ocn_bkidx_ = 0;
+  int ocn_bidx_;
+  if (the_document_bookindex_section.length > 1) {                                        /+ scroll +/
+    dom_structure_markedup_tags_status_buffer = dom_structure_markedup_tags_status.dup;
+    dom_structure_collapsed_tags_status_buffer = dom_structure_collapsed_tags_status.dup;
     foreach (ref obj; the_document_bookindex_section) {
       if (obj.metainfo.is_a == "heading") {
-        foreach (pair; pairs) {
-          if (obj.metainfo.ocn == pair[0]) {
-            obj.metainfo.last_decendant_ocn = pair[1];
+        debug(dom) {
+        }
+        if (obj.metainfo.heading_lev_markup <= 4) {
+          segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
+        }
+        if (obj.metainfo.heading_lev_markup == 1) {
+          obj_cite_digits                               = ocn_emit(eN.ocn.on);
+          obj.metainfo.ocn                              = obj_cite_digits.object_number;
+          obj.metainfo.identifier                       = obj_cite_digits.identifier;
+        }
+        if (obj.metainfo.heading_lev_markup <= 4) {
+          if (obj.metainfo.heading_lev_markup == 4) {
+            obj.tags.segname_prev = segnames["html"][obj.ptr.html_segnames - 1];
+            if (segnames["html"].length > obj.ptr.html_segnames + 1) {
+              obj.tags.segname_next = segnames["html"][obj.ptr.html_segnames + 1];
+            }
+            assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
+              obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
           }
         }
-      }
-    }
+        /+ dom structure (marked up & collapsed) +/
+        if (opt_action.meta_processing_xml_dom) {
+          obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
+          obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
+        }
+        obj = obj.obj_heading_ancestors(lv_ancestors_txt);
+      } else if (obj.metainfo.is_a == "bookindex") {
+        obj_cite_digits                                 = ocn_emit(eN.ocn.bkidx);
+        obj.metainfo.ocn                                = obj_cite_digits.object_number;
+        obj.metainfo.identifier                         = obj_cite_digits.identifier;
+        obj.metainfo.o_n_book_index                     = obj_cite_digits.bkidx;
+        obj.metainfo.object_number_type                 = OCNtype.bkidx;
+      }
+      obj = _links(obj);
+    }
+    /+ TODO assert failure, reinstate
+    assert(obj_cite_digit_bkidx == ocn_bidx_
+      obj_cite_digit_bkidx ~ " == ocn_" ~ ocn_ ~ "?");
+    +/
   }
+  /+ optional only one 1~ level +/
   if (the_document_blurb_section.length > 1) {
     foreach (ref obj; the_document_blurb_section) {
       if (obj.metainfo.is_a == "heading") {
-        foreach (pair; pairs) {
-          if (obj.metainfo.ocn == pair[0]) {
-            obj.metainfo.last_decendant_ocn = pair[1];
+        debug(dom) {
+          writeln(obj.text);
+        }
+        if (obj.metainfo.heading_lev_markup == 1) {
+          obj_cite_digits                               = ocn_emit(eN.ocn.on);
+          obj.metainfo.ocn                              = obj_cite_digits.object_number;
+          obj.metainfo.identifier                       = obj_cite_digits.identifier;
+        }
+        if (obj.metainfo.heading_lev_markup <= 4) {
+          segnames_0_to_4 ~= obj.tags.segment_anchor_tag_epub;
+          if (obj.metainfo.heading_lev_markup == 4) {
+            obj.tags.segname_prev = segnames["html"][obj.ptr.html_segnames - 1];
+            if (segnames["html"].length > obj.ptr.html_segnames + 1) {
+              obj.tags.segname_next = segnames["html"][obj.ptr.html_segnames + 1];
+            }
+            assert(obj.tags.anchor_tag_html == segnames["html"][obj.ptr.html_segnames],
+              obj.tags.anchor_tag_html ~ "!=" ~ segnames["html"][obj.ptr.html_segnames]);
           }
         }
+        /+ dom structure (marked up & collapsed) +/
+        if (opt_action.meta_processing_xml_dom) {
+          obj = obj.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, obj.metainfo.heading_lev_markup);
+          obj = obj.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, obj.metainfo.heading_lev_collapsed);
+        }
+        obj = obj.obj_heading_ancestors(lv_ancestors_txt);
+      } else if (obj.metainfo.is_a == "blurb") {
+        obj_cite_digits                                 = ocn_emit(eN.ocn.off);
+        obj.metainfo.object_number_off                  = obj_cite_digits.off;
+        obj.metainfo.object_number_type                 = OCNtype.non;
       }
+      obj = _links(obj);
     }
   }
-  if (the_document_xml_dom_tail_section.length > 1) {
-    foreach (ref obj; the_document_xml_dom_tail_section) {
+  if (the_document_body_section.length > 1) {
+    auto pairs = get_decendants(
+      the_document_head_section ~
+      the_document_body_section ~
+      the_document_endnotes_section ~
+      the_document_glossary_section ~
+      the_document_bibliography_section ~
+      the_document_bookindex_section ~
+      the_document_blurb_section ~
+      the_document_xml_dom_tail_section
+    );
+    debug(decendants_tuple) {
+      pairs = pairs.sort();
+      foreach (pair; pairs) {  // (pair; pairs.sort())
+        writeln(pair[0], "..", pair[1]);
+      }
+    }
+    foreach (ref obj; the_document_head_section) {
       if (obj.metainfo.is_a == "heading") {
         foreach (pair; pairs) {
           if (obj.metainfo.ocn == pair[0]) {
@@ -3161,163 +2516,201 @@ if (the_document_body_section.length > 1) {
         }
       }
     }
+    if (the_document_body_section.length > 1) {
+      foreach (ref obj; the_document_body_section) {
+        if (obj.metainfo.is_a == "heading") {
+          foreach (pair; pairs) {
+            if (obj.metainfo.ocn == pair[0]) {
+              obj.metainfo.last_decendant_ocn = pair[1];
+            }
+          }
+        }
+      }
+    }
+    if (the_document_endnotes_section.length > 1) {
+      foreach (ref obj; the_document_endnotes_section) {
+        if (obj.metainfo.is_a == "heading") {
+          foreach (pair; pairs) {
+            if (obj.metainfo.ocn == pair[0]) {
+              obj.metainfo.last_decendant_ocn = pair[1];
+            }
+          }
+        }
+      }
+    }
+    if (the_document_glossary_section.length > 1) {
+      foreach (ref obj; the_document_glossary_section) {
+        if (obj.metainfo.is_a == "heading") {
+          foreach (pair; pairs) {
+            if (obj.metainfo.ocn == pair[0]) {
+              obj.metainfo.last_decendant_ocn = pair[1];
+            }
+          }
+        }
+      }
+    }
+    if (the_document_bibliography_section.length > 1) {
+      foreach (ref obj; the_document_bibliography_section) {
+        if (obj.metainfo.is_a == "heading") {
+          foreach (pair; pairs) {
+            if (obj.metainfo.ocn == pair[0]) {
+              obj.metainfo.last_decendant_ocn = pair[1];
+            }
+          }
+        }
+      }
+    }
+    if (the_document_bookindex_section.length > 1) {
+      foreach (ref obj; the_document_bookindex_section) {
+        if (obj.metainfo.is_a == "heading") {
+          foreach (pair; pairs) {
+            if (obj.metainfo.ocn == pair[0]) {
+              obj.metainfo.last_decendant_ocn = pair[1];
+            }
+          }
+        }
+      }
+    }
+    if (the_document_blurb_section.length > 1) {
+      foreach (ref obj; the_document_blurb_section) {
+        if (obj.metainfo.is_a == "heading") {
+          foreach (pair; pairs) {
+            if (obj.metainfo.ocn == pair[0]) {
+              obj.metainfo.last_decendant_ocn = pair[1];
+            }
+          }
+        }
+      }
+    }
+    if (the_document_xml_dom_tail_section.length > 1) {
+      foreach (ref obj; the_document_xml_dom_tail_section) {
+        if (obj.metainfo.is_a == "heading") {
+          foreach (pair; pairs) {
+            if (obj.metainfo.ocn == pair[0]) {
+              obj.metainfo.last_decendant_ocn = pair[1];
+            }
+          }
+        }
+      }
+    }
   }
-}
-#+END_SRC
-
-**** update TODO BUG?
-
-#+NAME: abs_post_heading_obj_reinitialize
-#+BEGIN_SRC d
   /+ TODO
     - note create/insert heading object sole purpose eof close all open tags
       sort out:
       - obj.metainfo.dom_structure_markedup_tags_status = dom_structure_markedup_tags_status;
       - obj.metainfo.dom_structure_collapsed_tags_status = dom_structure_collapsed_tags_status;
   +/
-comp_obj_heading_                                               = comp_obj_heading_.init;
-comp_obj_heading_.metainfo.is_of_part                           = "empty";
-comp_obj_heading_.metainfo.is_of_section                        = "empty";
-comp_obj_heading_.metainfo.is_of_type                           = "para";
-comp_obj_heading_.metainfo.is_a                                 = "heading";
-comp_obj_heading_.metainfo.ocn                                  = 0;
-comp_obj_heading_.metainfo.identifier                           = "";
-comp_obj_heading_.metainfo.dummy_heading                        = true;
-comp_obj_heading_.metainfo.object_number_off                    = true;
-comp_obj_heading_.metainfo.object_number_type                   = 0;
-comp_obj_heading_.tags.segment_anchor_tag_epub                  = "";
-comp_obj_heading_.tags.anchor_tag_html                          = "";
-comp_obj_heading_.tags.in_segment_html                          = "";
-comp_obj_heading_.tags.html_segment_anchor_tag_is               = "";
-comp_obj_heading_.tags.epub_segment_anchor_tag_is               = "";
-comp_obj_heading_.metainfo.heading_lev_markup                   = 9;
-comp_obj_heading_.metainfo.heading_lev_collapsed                = 9;
-comp_obj_heading_.metainfo.parent_ocn                           = 0;
-comp_obj_heading_.metainfo.parent_lev_markup                    = 0;
-comp_obj_heading_.metainfo.dom_structure_markedup_tags_status   = dom_structure_markedup_tags_status.dup;
-comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status  = dom_structure_collapsed_tags_status.dup;
-comp_obj_heading_ = comp_obj_heading_.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, 0);
-comp_obj_heading_ = comp_obj_heading_.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, 0);
-comp_obj_heading_ = comp_obj_heading_.obj_heading_ancestors(lv_ancestors_txt);
-// the_dom_tail_section                      ~= comp_obj_heading_; // remove tail for now, decide on later
-#+END_SRC
-
-** 4. _return document tuple_ :post:
-*** _the document_ :document:
-
-#+NAME: abs_post_the_document
-#+BEGIN_SRC d
-ObjGenericComposite[][string] document_the = [
-  "head":             the_document_head_section,
-  "toc":              the_document_toc_section,
-  /+ substantive/body: +/
-  "body":             the_document_body_section,
-  /+ backmatter: +/
-  "endnotes":         the_document_endnotes_section,
-  "glossary":         the_document_glossary_section,
-  "bibliography":     the_document_bibliography_section,
-  "bookindex":        the_document_bookindex_section,
-  "blurb":            the_document_blurb_section,
-  /+ dom tail only +/
-  "tail":             the_document_xml_dom_tail_section,
-];
-#+END_SRC
-
-*** document _section keys_ sequence
-
-#+NAME: abs_post_document_parts_keys
-#+BEGIN_SRC d
-string[][string] document_section_keys_sequenced = [
-  "scroll": ["head", "toc", "body",],
-  "seg":    ["head", "toc", "body",],
-  "sql":    ["head", "body",],
-  "latex":  ["head", "toc", "body",]
-];
-if (document_the["endnotes"].length > 1) {
-  document_section_keys_sequenced["scroll"] ~= "endnotes";
-  document_section_keys_sequenced["seg"]    ~= "endnotes";
-  document_section_keys_sequenced["latex"]  ~= "endnotes";
-}
-if (document_the["glossary"].length > 1) {
-  document_section_keys_sequenced["scroll"] ~= "glossary";
-  document_section_keys_sequenced["seg"]    ~= "glossary";
-  document_section_keys_sequenced["sql"]    ~= "glossary";
-  document_section_keys_sequenced["latex"]  ~= "glossary";
-}
-if (document_the["bibliography"].length > 1) {
-  document_section_keys_sequenced["scroll"] ~= "bibliography";
-  document_section_keys_sequenced["seg"]    ~= "bibliography";
-  document_section_keys_sequenced["sql"]    ~= "bibliography";
-  document_section_keys_sequenced["latex"]  ~= "bibliography";
-}
-if (document_the["bookindex"].length > 1) {
-  document_section_keys_sequenced["scroll"] ~= "bookindex";
-  document_section_keys_sequenced["seg"]    ~= "bookindex";
-  document_section_keys_sequenced["sql"]    ~= "bookindex";
-  document_section_keys_sequenced["latex"]  ~= "bookindex";
-}
-if (document_the["blurb"].length > 1) {
-  document_section_keys_sequenced["scroll"] ~= "blurb";
-  document_section_keys_sequenced["seg"]    ~= "blurb";
-  document_section_keys_sequenced["sql"]    ~= "blurb";
-  document_section_keys_sequenced["latex"]  ~= "blurb";
-}
-if ((opt_action.html)
-|| (opt_action.html_scroll)
-|| (opt_action.html_seg)
-|| (opt_action.epub)) {
-  document_section_keys_sequenced["scroll"] ~= "tail";
-  document_section_keys_sequenced["seg"]    ~= "tail";
-}
-#+END_SRC
-
-*** dup
-
-#+NAME: abs_post_document_segnames
-#+BEGIN_SRC d
-string[] segnames_4                 = segnames["html"].dup;
-string[] segnames_lv1to4            = segnames["epub"].dup;
-debug(segnames) {
-  writeln("segnames_lv4:    ", segnames_4);
-  writeln("segnames_lv1to4: ", segnames_lv1to4);
-}
-#+END_SRC
-
-*** clean out structure
-
-#+NAME: abs_post_document_reinitialize
-#+BEGIN_SRC d
-destroy(the_document_head_section);
-destroy(the_document_toc_section);
-destroy(the_document_body_section);
-destroy(the_document_endnotes_section);
-destroy(the_document_glossary_section);
-destroy(the_document_bibliography_section);
-destroy(the_document_bookindex_section);
-destroy(the_document_blurb_section);
-destroy(the_document_xml_dom_tail_section);
-destroy(segnames);
-destroy(bookindex_unordered_hashes);
-destroy(an_object);
-obj_cite_digits                             = ocn_emit(eN.ocn.reset);
-biblio_arr_json                             = [];
-obj_cite_digit_                             = 0;
-html_segnames_ptr                           = 0;
-html_segnames_ptr_cntr                      = 0;
-content_non_header                          = "8";
-dom_structure_markedup_tags_status          = [ 0, 0, 0, 0, 0, 0, 0, 0,];
-dom_structure_markedup_tags_status_buffer   = [ 0, 0, 0, 0, 0, 0, 0, 0,];
-dom_structure_collapsed_tags_status         = [ 0, 0, 0, 0, 0, 0, 0, 0,];
-dom_structure_collapsed_tags_status_buffer  = [ 0, 0, 0, 0, 0, 0, 0, 0,];
-lev_anchor_tag = "";
-anchor_tag = "";
-#+END_SRC
-
-*** doc has struct
-
-#+NAME: abs_struct_doc_has
-#+BEGIN_SRC d
-@safe auto doc_has() {
+  comp_obj_heading_                                               = comp_obj_heading_.init;
+  comp_obj_heading_.metainfo.is_of_part                           = "empty";
+  comp_obj_heading_.metainfo.is_of_section                        = "empty";
+  comp_obj_heading_.metainfo.is_of_type                           = "para";
+  comp_obj_heading_.metainfo.is_a                                 = "heading";
+  comp_obj_heading_.metainfo.ocn                                  = 0;
+  comp_obj_heading_.metainfo.identifier                           = "";
+  comp_obj_heading_.metainfo.dummy_heading                        = true;
+  comp_obj_heading_.metainfo.object_number_off                    = true;
+  comp_obj_heading_.metainfo.object_number_type                   = 0;
+  comp_obj_heading_.tags.segment_anchor_tag_epub                  = "";
+  comp_obj_heading_.tags.anchor_tag_html                          = "";
+  comp_obj_heading_.tags.in_segment_html                          = "";
+  comp_obj_heading_.tags.html_segment_anchor_tag_is               = "";
+  comp_obj_heading_.tags.epub_segment_anchor_tag_is               = "";
+  comp_obj_heading_.metainfo.heading_lev_markup                   = 9;
+  comp_obj_heading_.metainfo.heading_lev_collapsed                = 9;
+  comp_obj_heading_.metainfo.parent_ocn                           = 0;
+  comp_obj_heading_.metainfo.parent_lev_markup                    = 0;
+  comp_obj_heading_.metainfo.dom_structure_markedup_tags_status   = dom_structure_markedup_tags_status.dup;
+  comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status  = dom_structure_collapsed_tags_status.dup;
+  comp_obj_heading_ = comp_obj_heading_.obj_dom_structure_set_markup_tags(dom_structure_markedup_tags_status, 0);
+  comp_obj_heading_ = comp_obj_heading_.obj_dom_set_collapsed_tags(dom_structure_collapsed_tags_status, 0);
+  comp_obj_heading_ = comp_obj_heading_.obj_heading_ancestors(lv_ancestors_txt);
+  // the_dom_tail_section                      ~= comp_obj_heading_; // remove tail for now, decide on later
+  ObjGenericComposite[][string] document_the = [
+    "head":             the_document_head_section,
+    "toc":              the_document_toc_section,
+    /+ substantive/body: +/
+    "body":             the_document_body_section,
+    /+ backmatter: +/
+    "endnotes":         the_document_endnotes_section,
+    "glossary":         the_document_glossary_section,
+    "bibliography":     the_document_bibliography_section,
+    "bookindex":        the_document_bookindex_section,
+    "blurb":            the_document_blurb_section,
+    /+ dom tail only +/
+    "tail":             the_document_xml_dom_tail_section,
+  ];
+  string[][string] document_section_keys_sequenced = [
+    "scroll": ["head", "toc", "body",],
+    "seg":    ["head", "toc", "body",],
+    "sql":    ["head", "body",],
+    "latex":  ["head", "toc", "body",]
+  ];
+  if (document_the["endnotes"].length > 1) {
+    document_section_keys_sequenced["scroll"] ~= "endnotes";
+    document_section_keys_sequenced["seg"]    ~= "endnotes";
+    document_section_keys_sequenced["latex"]  ~= "endnotes";
+  }
+  if (document_the["glossary"].length > 1) {
+    document_section_keys_sequenced["scroll"] ~= "glossary";
+    document_section_keys_sequenced["seg"]    ~= "glossary";
+    document_section_keys_sequenced["sql"]    ~= "glossary";
+    document_section_keys_sequenced["latex"]  ~= "glossary";
+  }
+  if (document_the["bibliography"].length > 1) {
+    document_section_keys_sequenced["scroll"] ~= "bibliography";
+    document_section_keys_sequenced["seg"]    ~= "bibliography";
+    document_section_keys_sequenced["sql"]    ~= "bibliography";
+    document_section_keys_sequenced["latex"]  ~= "bibliography";
+  }
+  if (document_the["bookindex"].length > 1) {
+    document_section_keys_sequenced["scroll"] ~= "bookindex";
+    document_section_keys_sequenced["seg"]    ~= "bookindex";
+    document_section_keys_sequenced["sql"]    ~= "bookindex";
+    document_section_keys_sequenced["latex"]  ~= "bookindex";
+  }
+  if (document_the["blurb"].length > 1) {
+    document_section_keys_sequenced["scroll"] ~= "blurb";
+    document_section_keys_sequenced["seg"]    ~= "blurb";
+    document_section_keys_sequenced["sql"]    ~= "blurb";
+    document_section_keys_sequenced["latex"]  ~= "blurb";
+  }
+  if ((opt_action.html)
+  || (opt_action.html_scroll)
+  || (opt_action.html_seg)
+  || (opt_action.epub)) {
+    document_section_keys_sequenced["scroll"] ~= "tail";
+    document_section_keys_sequenced["seg"]    ~= "tail";
+  }
+  string[] segnames_4                 = segnames["html"].dup;
+  string[] segnames_lv1to4            = segnames["epub"].dup;
+  debug(segnames) {
+    writeln("segnames_lv4:    ", segnames_4);
+    writeln("segnames_lv1to4: ", segnames_lv1to4);
+  }
+  destroy(the_document_head_section);
+  destroy(the_document_toc_section);
+  destroy(the_document_body_section);
+  destroy(the_document_endnotes_section);
+  destroy(the_document_glossary_section);
+  destroy(the_document_bibliography_section);
+  destroy(the_document_bookindex_section);
+  destroy(the_document_blurb_section);
+  destroy(the_document_xml_dom_tail_section);
+  destroy(segnames);
+  destroy(bookindex_unordered_hashes);
+  destroy(an_object);
+  obj_cite_digits                             = ocn_emit(eN.ocn.reset);
+  biblio_arr_json                             = [];
+  obj_cite_digit_                             = 0;
+  html_segnames_ptr                           = 0;
+  html_segnames_ptr_cntr                      = 0;
+  content_non_header                          = "8";
+  dom_structure_markedup_tags_status          = [ 0, 0, 0, 0, 0, 0, 0, 0,];
+  dom_structure_markedup_tags_status_buffer   = [ 0, 0, 0, 0, 0, 0, 0, 0,];
+  dom_structure_collapsed_tags_status         = [ 0, 0, 0, 0, 0, 0, 0, 0,];
+  dom_structure_collapsed_tags_status_buffer  = [ 0, 0, 0, 0, 0, 0, 0, 0,];
+  lev_anchor_tag = "";
+  anchor_tag = "";
   struct DocHas_ {
     uint inline_links() {
       return dochas["inline_links"];
@@ -3365,692 +2758,251 @@ anchor_tag = "";
       return tag_assoc;
     }
   }
-  return DocHas_();
-}
-#+END_SRC
-
-*** _return the document tuple_ [#A] :return:tuple:
-
-#+NAME: abs_return_tuple
-#+BEGIN_SRC d
-auto t = tuple(
-  document_the,
-  doc_has,
-);
-return t;
-#+END_SRC
-
-** 5. Functions :abstract:function:
-
-functions used in document abstraction
-
-*** set & resets :reset:
-**** object reset: remove (clean) :object:remove:
-
-#+NAME: abs_functions_object_reset
-#+BEGIN_SRC d
-@safe static string[string] object_reset()(string[string] an_object) {
-  an_object.remove("body_nugget");
-  an_object.remove("substantive");
-  an_object.remove("is");
-  an_object.remove("attrib");
-  an_object.remove("bookindex_nugget");
-  return an_object;
-}
+  @safe auto doc_has() {
+    return DocHas_();
+  }
+  struct retStruct {
+    ObjGenericComposite[][string] document_the;
+    DocHas_                       doc_has;
+  }
+  retStruct ret;
+  {
+    ret.document_the = document_the;
+    ret.doc_has      = doc_has;
+  }
+  return ret;
+}                                                                             /+ ← closed: abstract doc source +/
 #+END_SRC
 
-**** set, initialize or re-initialize :set:
+** sort
 
-#+NAME: abs_functions_header_set_common
+#+NAME: docSortOut
+#+HEADER: :noweb yes
 #+BEGIN_SRC d
-@system void flow_common_reset_()(
-  return ref int[string]     line_occur,
-  return ref string[string]  an_object,
-  return ref uint[string]    pith,
+@system auto txt_by_line_common_reset_()(
+  int[string]     line_occur,
+  string[string]  an_object,
+  uint[string]    pith,
 ) {
   line_occur["heading"]                               = eN.bi.off;
   line_occur["para"]                                  = eN.bi.off;
   pith["txt_is"]                                      = eN.txt_is.off;
   an_object                                           = an_object.object_reset;
+  struct retStruct {
+    int[string]     line_occur;
+    string[string]  this_object;
+    uint[string]    pith;
+  }
+  retStruct ret;
+  {
+    ret.line_occur  = line_occur;
+    ret.this_object = an_object;
+    ret.pith        = pith;
+  }
+  return ret;
 }
-#+END_SRC
-
-*** check object_number status in document :ocn:
-
-#+NAME: abs_functions_ocn_status
-#+BEGIN_SRC d
-@safe static uint[string] _check_ocn_status_()(
-  char[]       line,
-  uint[string] pith,
+@safe auto txt_by_line_block_start()(
+  char[]         line,
+  uint[string]   pith,
+  uint[string]   dochas,
+  string[string] object_number_poem
 ) {
   static auto rgx = RgxI();
-  if (!(line.empty)) {
-    if (pith["no_ocn_multiple_objects"] == eN.bi.off) {
-      /+ not multi-line object, check whether object_number is on or turned off +/
-      if (line.matchFirst(rgx.object_number_block_marks)) {                      /+ switch off object_number +/
-        if (line.matchFirst(rgx.object_number_off_block)) {
-          pith["no_ocn_multiple_objects"]             = eN.bi.on;
-          pith["ocn"]                                 = eN.ocn.off;
-          debug(ocnoff) {
-            writeln(line);
-          }
-        }
-        if (line.matchFirst(rgx.object_number_off_block_dummy_heading)) {
-          pith["no_ocn_multiple_objects"]             = eN.bi.on;
-          pith["dummy_heading_multiple_objects"]      = eN.bi.on;
-          pith["ocn"]                                 = eN.ocn.off;
-          debug(ocnoff) {
-            writeln(line);
-          }
-        }
-      } else if (pith["no_ocn_multiple_objects"] == eN.bi.off) {
-          pith["dummy_heading_status"]                = eN.bi.off;
-          if (pith["dummy_heading_multiple_objects"]) {
-            pith["dummy_heading_status"]              = eN.bi.on;
-          }
-          if (line.matchFirst(rgx.object_number_off)) {
-            pith["ocn"]                               = eN.ocn.off;
-          } else if (line.matchFirst(rgx.object_number_off_dummy_heading)) {
-            pith["ocn"]                               = eN.ocn.off;
-            pith["dummy_heading_status"]              = eN.bi.on;
-          } else {
-            pith["ocn"]                               = eN.ocn.on;
-            pith["dummy_heading_status"]              = eN.bi.off;
-          }
-        } else {
-          pith["ocn"] = pith["no_ocn_multiple_objects"];
-        }
-    } else if (pith["no_ocn_multiple_objects"] == eN.bi.on) {
-      if (line.matchFirst(rgx.object_number_off_block_close)) {
-        pith["no_ocn_multiple_objects"]               = eN.bi.off;
-        pith["ocn"]                                   = eN.ocn.on;
-        pith["dummy_heading_status"]                  = eN.bi.off;
-        debug(ocnoff) {
-          writeln(line);
-        }
-      }
+  if (auto m = line.matchFirst(rgx.block_curly_code_open)) {
+    dochas["codeblock"]++;
+    an_object["lang"]               = "";
+    an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
+    an_object["syntax"]             = (m["syntax"]) ? m["syntax"].to!string : "";
+    debug(codecurly) {                              // code (curly) open
+      writefln(
+        "* [code curly] %s",
+        line
+      );
     }
-  }
-  return pith;
-}
-#+END_SRC
-
-*** make substitutions
-**** project
-
-#+NAME: abs_functions_substitutions_user_requested
-#+BEGIN_SRC d
-@safe char[] _doc_header_and_make_substitutions_(CMM)(
-  char[]  line,
-  CMM     conf_make_meta,
-) {
-  enum Substitute { match, markup, }
-  if (conf_make_meta.make.substitute) {
-    foreach(substitution_pair; conf_make_meta.make.substitute) {
-      line = line.replaceAll(
-        regex("\b" ~ substitution_pair[Substitute.match]),
-        substitution_pair[Substitute.markup]
+    pith["block_is"]                = eN.blk_is.code;
+    pith["block_state"]             = eN.blk_state.on;
+    pith["block_delim"]             = eN.blk_delim.curly;
+  } else if (auto m = line.matchFirst(rgx.block_curly_poem_open)) {
+    dochas["poem"]++;
+    an_object["syntax"]             = "";
+    an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
+    an_object["lang"]               = (m["lang"]) ? m["lang"].to!string : "";
+    debug(poem) {                              // poem (curly) open
+      writefln(
+        "* [poem curly] %s",
+        line
       );
     }
-  }
-  return line;
-}
-#+END_SRC
-
-**** fontface
-
-#+NAME: abs_functions_substitutions_fontface
-#+BEGIN_SRC d
-@safe char[] _doc_header_and_make_substitutions_fontface_(CMM)(
-  char[]  line,
-  CMM     conf_make_meta,
-) {
-  enum Substitute { match, markup, }
-  if ( conf_make_meta.make.bold) {
-    line = line.replaceAll(
-      regex("\b" ~ conf_make_meta.make.bold[Substitute.match]),
-      conf_make_meta.make.bold[Substitute.markup]
-    );
-  }
-  if (conf_make_meta.make.emphasis) {
-    line = line.replaceAll(
-      regex("\b" ~ conf_make_meta.make.emphasis[Substitute.match]),
-      conf_make_meta.make.emphasis[Substitute.markup]
-    );
-  }
-  if (conf_make_meta.make.italics) {
-    line = line.replaceAll(
-      regex("\b" ~ conf_make_meta.make.italics[Substitute.match]),
-      conf_make_meta.make.italics[Substitute.markup]
-    );
-  }
-  return line;
-}
-#+END_SRC
-
-*** block :block:
-**** block start (open) block :start:
-***** { block starts function
-
-#+NAME: abs_functions_block_open
-#+BEGIN_SRC d
-@safe void flow_txt_block_start()(
-             char[]         line,
-  return ref uint[string]   pith,
-  return ref uint[string]   dochas,
-  return ref string[string] object_number_poem
-) {
-#+END_SRC
-
-****** block (various) curly open :curly:
-
-#+NAME: abs_functions_block_regex
-#+BEGIN_SRC d
-static auto rgx = RgxI();
-#+END_SRC
-
-******* code
-
-#+NAME: abs_functions_block_curly_open_code
-#+BEGIN_SRC d
-if (auto m = line.matchFirst(rgx.block_curly_code_open)) {
-  dochas["codeblock"]++;
-  an_object["lang"]               = "";
-  an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
-  an_object["syntax"]             = (m["syntax"]) ? m["syntax"].to!string : "";
-  debug(codecurly) {                              // code (curly) open
-    writefln(
-      "* [code curly] %s",
-      line
-    );
-  }
-  pith["block_is"]                = eN.blk_is.code;
-  pith["block_state"]             = eN.blk_state.on;
-  pith["block_delim"]             = eN.blk_delim.curly;
-#+END_SRC
-
-******* poem
-
-#+NAME: abs_functions_block_curly_open_poem
-#+BEGIN_SRC d
-} else if (auto m = line.matchFirst(rgx.block_curly_poem_open)) {
-  dochas["poem"]++;
-  an_object["syntax"]             = "";
-  an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
-  an_object["lang"]               = (m["lang"]) ? m["lang"].to!string : "";
-  debug(poem) {                              // poem (curly) open
-    writefln(
-      "* [poem curly] %s",
-      line
-    );
-  }
-  object_number_poem["start"]     = obj_cite_digits.object_number.to!string;
-  pith["block_is"]                = eN.blk_is.poem;
-  pith["block_state"]             = eN.blk_state.on;
-  pith["block_delim"]             = eN.blk_delim.curly;
-  pith["verse_new"]               = eN.bi.on;
-#+END_SRC
-
-******* group
-
-#+NAME: abs_functions_block_curly_open_group
-#+BEGIN_SRC d
-} else if (auto m = line.matchFirst(rgx.block_curly_group_open)) {
-  dochas["group"]++;
-  an_object["syntax"]             = "";
-  an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
-  an_object["lang"]               = (m["lang"]) ? m["lang"].to!string : "";
-  debug(group) {                             // group (curly) open
-    writefln(
-      "* [group curly] %s",
-      line
-    );
-  }
-  pith["block_is"]                = eN.blk_is.group;
-  pith["block_state"]             = eN.blk_state.on;
-  pith["block_delim"]             = eN.blk_delim.curly;
-#+END_SRC
-
-******* block
-
-#+NAME: abs_functions_block_curly_open_block
-#+BEGIN_SRC d
-} else if (auto m = line.matchFirst(rgx.block_curly_block_open)) {
-  dochas["block"]++;
-  an_object["syntax"]             = "";
-  an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
-  an_object["lang"]               = (m["lang"]) ? m["lang"].to!string : "";
-  debug(block) {
-    writefln(
-      "* [block curly] %s",
-      line
-    );
-  }
-  pith["block_is"]                = eN.blk_is.block;
-  pith["block_state"]             = eN.blk_state.on;
-  pith["block_delim"]             = eN.blk_delim.curly;
-#+END_SRC
-
-******* quote
-
-#+NAME: abs_functions_block_curly_open_quote
-#+BEGIN_SRC d
-} else if (auto m = line.matchFirst(rgx.block_curly_quote_open)) {
-  dochas["quote"]++;
-  an_object["syntax"]             = "";
-  an_object["attrib"]             = m["attrib"].to!string;
-  an_object["lang"]               = m["lang"].to!string;
-  debug(quote) {
-    writefln(
-      "* [quote curly] %s",
-      line
-    );
-  }
-  pith["block_is"]                = eN.blk_is.quote;
-  pith["block_state"]             = eN.blk_state.on;
-  pith["block_delim"]             = eN.blk_delim.curly;
-#+END_SRC
-
-******* table
-
-#+NAME: abs_functions_block_curly_open_table
-#+BEGIN_SRC d
-} else if (auto m = line.matchFirst(rgx.block_curly_table_open)) {           /+ curly table open +/
-  debug(table) {                             // table (curly) open
-    writefln(
-      "* [table curly] %s",
-      line
-    );
-  }
-  dochas["table"] ++;
-  an_object["table_head"]         = m["attrib"].to!string;
-  an_object["block_type"]         = "curly";
-  pith["block_is"]                = eN.blk_is.table;
-  pith["block_state"]             = eN.blk_state.on;
-  pith["block_delim"]             = eN.blk_delim.curly;
-#+END_SRC
-
-******* table special
-
-#+NAME: abs_functions_block_curly_open_table_special
-#+BEGIN_SRC d
-} else if (auto m = line.matchFirst(rgx.block_curly_table_special_markup)) { /+ table: special table block markup syntax! +/
-  dochas["table"]++;
-  an_object["table_head"]         = m["attrib"].to!string;
-  an_object["block_type"]         = "special";
-  pith["block_is"]                = eN.blk_is.table;
-  pith["block_state"]             = eN.blk_state.on;
-  pith["block_delim"]             = eN.blk_delim.curly_special;
-#+END_SRC
-
-****** block (various) tic open :tic:
-******* code
-
-#+NAME: abs_functions_block_tic_open_code
-#+BEGIN_SRC d
-} else if (auto m = line.matchFirst(rgx.block_tic_code_open)) {
-  dochas["codeblock"]++;
-  an_object["lang"]               = "";
-  an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
-  an_object["syntax"]             = (m["syntax"]) ? m["syntax"].to!string : "";
-  debug(codetic) {
-    writefln(
-      "* [code tic] %s",
-      line
-    );
-  }
-  pith["block_is"]                = eN.blk_is.code;
-  pith["block_state"]             = eN.blk_state.on;
-  pith["block_delim"]             = eN.blk_delim.tic;
-#+END_SRC
-
-******* poem
-
-#+NAME: abs_functions_block_tic_open_poem
-#+BEGIN_SRC d
-} else if (auto m = line.matchFirst(rgx.block_tic_poem_open)) {
-  dochas["poem"]++;
-  an_object["syntax"]             = "";
-  an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
-  an_object["lang"]               = (m["lang"]) ? m["lang"].to!string : "";
-  debug(poem) {
-    writefln(
-      "* [poem tic] %s",
-      line
-    );
-  }
-  object_number_poem["start"]     = obj_cite_digits.object_number.to!string;
-  pith["block_is"]                = eN.blk_is.poem;
-  pith["block_state"]             = eN.blk_state.on;
-  pith["block_delim"]             = eN.blk_delim.tic;
-  pith["verse_new"]               = eN.bi.on;
-#+END_SRC
-
-******* group
-
-#+NAME: abs_functions_block_tic_open_group
-#+BEGIN_SRC d
-} else if (auto m = line.matchFirst(rgx.block_tic_group_open)) {
-  dochas["group"]++;
-  an_object["syntax"]             = "";
-  an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
-  an_object["lang"]               = (m["lang"]) ? m["lang"].to!string : "";
-  debug(group) {
-    writefln(
-      "* [group tic] %s",
-      line
-    );
-  }
-  pith["block_is"]                = eN.blk_is.group;
-  pith["block_state"]             = eN.blk_state.on;
-  pith["block_delim"]             = eN.blk_delim.tic;
-#+END_SRC
-
-******* block
-
-#+NAME: abs_functions_block_tic_open_block
-#+BEGIN_SRC d
-} else if (auto m = line.matchFirst(rgx.block_tic_block_open)) {
-  dochas["block"]++;
-  an_object["syntax"]             = "";
-  an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
-  an_object["lang"]               = (m["lang"]) ? m["lang"].to!string : "";
-  debug(block) {
-    writefln(
-      "* [block tic] %s",
-      line
-    );
-  }
-  pith["block_is"]                = eN.blk_is.block;
-  pith["block_state"]             = eN.blk_state.on;
-  pith["block_delim"]             = eN.blk_delim.tic;
-#+END_SRC
-
-******* quote
-
-#+NAME: abs_functions_block_tic_open_quote
-#+BEGIN_SRC d
-} else if (auto m = line.matchFirst(rgx.block_tic_quote_open)) {
-  dochas["quote"]++;
-  an_object["syntax"]             = "";
-  an_object["attrib"]             = m["attrib"].to!string;
-  an_object["lang"]               = m["lang"].to!string;
-  debug(quote) {                             // quote (tic) open
-    writefln(
-      "* [quote tic] %s",
-      line
-    );
-  }
-  pith["block_is"]                = eN.blk_is.quote;
-  pith["block_state"]             = eN.blk_state.on;
-  pith["block_delim"]             = eN.blk_delim.tic;
-#+END_SRC
-
-******* table
-
-#+NAME: abs_functions_block_tic_open_table
-#+BEGIN_SRC d
-} else if (auto m = line.matchFirst(rgx.block_tic_table_open)) {             /+ tic table open +/
-  debug(table) {                             // table (tic) open
-    writefln(
-      "* [table tic] %s",
-      line
-    );
-  }
-  dochas["table"] ++;
-  an_object["table_head"]         = m["attrib"].to!string;
-  an_object["block_type"]         = "tic";
-  pith["block_is"]                = eN.blk_is.table;
-  pith["block_state"]             = eN.blk_state.on;
-  pith["block_delim"]             = eN.blk_delim.tic;
-}
-#+END_SRC
-
-***** }
-
-#+NAME: abs_functions_block_close
-#+BEGIN_SRC d
-}
-#+END_SRC
-
-**** block continue (an open block) :continue:
-***** _code block_ (special status, deal with first) :code:
-
-#+NAME: abs_functions_block_code
-#+BEGIN_SRC d
-@safe void flow_txt_block_code()(
-             char[]          line,
-  return ref string[string]  an_object,
-  return ref uint[string]    pith,
-) {
-  static auto rgx = RgxI();
-  if ( pith["block_is"] == eN.blk_is.code) {
-    if (pith["block_delim"] == eN.blk_delim.curly) {
-      if (line.matchFirst(rgx.block_curly_code_close)) {
-        debug(codecurly) {
-          writeln(line);
-        }
-        an_object[an_object_key] = an_object[an_object_key]
-          .replaceFirst(rgx.newline_eol_delimiter_only, "")
-          .stripRight;
-        pith["block_is"]            = eN.blk_is.code;
-        pith["block_state"]         = eN.blk_state.closing;
-        pith["block_delim"]         = eN.blk_delim.off;
-      } else {
-        debug(codecurly) {
-          writeln(line);
-        }
-        an_object[an_object_key] ~= line ~= "\n";
-      }
-    } else if (pith["block_delim"] == eN.blk_delim.tic) {
-      if (line.matchFirst(rgx.block_tic_close)) {
-        debug(codetic) {
-          writeln(line);
-        }
-        an_object[an_object_key] = an_object[an_object_key]
-          .replaceFirst(rgx.newline_eol_delimiter_only, "")
-          .stripRight;
-        pith["block_is"]            = eN.blk_is.code;
-        pith["block_state"]         = eN.blk_state.closing;
-        pith["block_delim"]         = eN.blk_delim.off;
-      } else {
-        debug(codetic) {
-          writeln(line);
-        }
-        an_object[an_object_key] ~= line ~= "\n";
-      }
+    object_number_poem["start"]     = obj_cite_digits.object_number.to!string;
+    pith["block_is"]                = eN.blk_is.poem;
+    pith["block_state"]             = eN.blk_state.on;
+    pith["block_delim"]             = eN.blk_delim.curly;
+    pith["verse_new"]               = eN.bi.on;
+  } else if (auto m = line.matchFirst(rgx.block_curly_group_open)) {
+    dochas["group"]++;
+    an_object["syntax"]             = "";
+    an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
+    an_object["lang"]               = (m["lang"]) ? m["lang"].to!string : "";
+    debug(group) {                             // group (curly) open
+      writefln(
+        "* [group curly] %s",
+        line
+      );
     }
-  }
-}
-#+END_SRC
-
-***** biblio block :biblio:
-****** biblio map tags
-
-#+NAME: abs_functions_block_biblio_map_tags
-#+BEGIN_SRC d
-@safe final string biblio_tag_map()(string abr) {
-  auto btm = [
-    "au"        : "author_raw",
-    "ed"        : "editor_raw",
-    "ti"        : "fulltitle",
-    "lng"       : "language",
-    "jo"        : "journal",
-    "vol"       : "volume",
-    "edn"       : "edition",
-    "yr"        : "year",
-    "pl"        : "place",
-    "pb"        : "publisher",
-    "pub"       : "publisher",
-    "pg"        : "pages",
-    "pgs"       : "pages",
-    "sn"        : "short_name"
-  ];
-  return btm[abr];
-}
-#+END_SRC
-
-******* +consider+
-
-#+NAME: none
-#+BEGIN_SRC d
-final string biblio_tag_map_()(string abr) {
-  string name;
-  switch (abr) {
-  case "au"     : name = "author_raw"; break;
-  case "ed"     : name = "editor_raw"; break;
-  case "ti"     : name = "fulltitle";  break;
-  case "lng"    : name = "language";   break;
-  case "jo"     : name = "journal";    break;
-  case "vol"    : name = "volume";     break;
-  case "edn"    : name = "edition";    break;
-  case "yr"     : name = "year";       break;
-  case "pl"     : name = "place";      break;
-  case "pb"     : name = "publisher";  break;
-  case "pub"    : name = "publisher";  break;
-  case "pg"     : name = "pages";      break;
-  case "pgs"    : name = "pages";      break;
-  case "sn"     : name = "short_name"; break;
-  default       : name = abr;          break;
-  }
-  return name;
-}
-#+END_SRC
-
-****** biblio block
-
-#+NAME: abs_functions_block_biblio_text_block
-#+BEGIN_SRC d
-@system void flow_txt_block_biblio(
-  char[]                  line,
-  return ref uint[string] pith,
-  return ref int          bib_entry,
-  return ref string       biblio_entry_str_json,
-  return ref string[]     biblio_arr_json,
-) {
-  mixin spineBiblio;
-  auto jsn = BibJsnStr();
-  static auto rgx = RgxI();
-  if (line.matchFirst(rgx.heading_biblio)) {
-    pith["section"] = eN.sect.bibliography;
-  }
-  if (line.empty) {
-    debug {
-      debug(biblioblock) {
-        writeln("---");
-      }
-      debug(biblioblockinclude) {
-        writeln(biblio_entry_str_json.length);
-      }
+    pith["block_is"]                = eN.blk_is.group;
+    pith["block_state"]             = eN.blk_state.on;
+    pith["block_delim"]             = eN.blk_delim.curly;
+  } else if (auto m = line.matchFirst(rgx.block_curly_block_open)) {
+    dochas["block"]++;
+    an_object["syntax"]             = "";
+    an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
+    an_object["lang"]               = (m["lang"]) ? m["lang"].to!string : "";
+    debug(block) {
+      writefln(
+        "* [block curly] %s",
+        line
+      );
     }
-    if ((bib_entry == eN.bi.off)
-    && (biblio_entry_str_json.empty)) {
-      bib_entry = eN.bi.on;
-      biblio_entry_str_json = jsn.biblio_entry_tags_jsonstr;
-    } else if (!(biblio_entry_str_json.empty)) {
-      bib_entry = eN.bi.off;
-      if (!(biblio_entry_str_json == jsn.biblio_entry_tags_jsonstr)) {
-        auto biblio_entry = parseJSON(biblio_entry_str_json);
-        if (biblio_entry["fulltitle"].str.empty) {
-          writeln("check problem entry (Title missing): ", biblio_entry_str_json);
-        } else if ((biblio_entry["author_raw"].str.empty) && (biblio_entry["editor_raw"].str.empty)) {
-          writeln("check problem entry (No author and no editor): ", biblio_entry_str_json);
-        } else {
-          biblio_arr_json ~= biblio_entry_str_json;
-        }
-        biblio_entry_str_json = jsn.biblio_entry_tags_jsonstr;
-      }
-    } else {
-      writeln("?? 2. ERROR ", biblio_entry_str_json, "??");
-      biblio_entry_str_json = "";
+    pith["block_is"]                = eN.blk_is.block;
+    pith["block_state"]             = eN.blk_state.on;
+    pith["block_delim"]             = eN.blk_delim.curly;
+  } else if (auto m = line.matchFirst(rgx.block_curly_quote_open)) {
+    dochas["quote"]++;
+    an_object["syntax"]             = "";
+    an_object["attrib"]             = m["attrib"].to!string;
+    an_object["lang"]               = m["lang"].to!string;
+    debug(quote) {
+      writefln(
+        "* [quote curly] %s",
+        line
+      );
     }
-  } else if (line.matchFirst(rgx.biblio_tags)) {
-    debug(biblioblock) {
-      writeln(line);
+    pith["block_is"]                = eN.blk_is.quote;
+    pith["block_state"]             = eN.blk_state.on;
+    pith["block_delim"]             = eN.blk_delim.curly;
+  } else if (auto m = line.matchFirst(rgx.block_curly_table_open)) {           /+ curly table open +/
+    debug(table) {                             // table (curly) open
+      writefln(
+        "* [table curly] %s",
+        line
+      );
     }
-    auto bt = line.match(rgx.biblio_tags);
-    bib_entry = eN.bi.off;
-    st = bt.captures[1].to!string;
-    auto header_tag_value = (bt.captures[2]).to!string;
-    JSONValue j = parseJSON(biblio_entry_str_json);
-    biblio_tag_name = (st.match(rgx.biblio_abbreviations))
-      ? (biblio_tag_map(st))
-      : st;
-    j.object[biblio_tag_name] = header_tag_value;
-    debug(bibliounsortedcheckduplicates) {
-      writeln(biblio_tag_name, ": ", header_tag_value);
-      writeln("--");
+    dochas["table"] ++;
+    an_object["table_head"]         = m["attrib"].to!string;
+    an_object["block_type"]         = "curly";
+    pith["block_is"]                = eN.blk_is.table;
+    pith["block_state"]             = eN.blk_state.on;
+    pith["block_delim"]             = eN.blk_delim.curly;
+  } else if (auto m = line.matchFirst(rgx.block_curly_table_special_markup)) { /+ table: special table block markup syntax! +/
+    dochas["table"]++;
+    an_object["table_head"]         = m["attrib"].to!string;
+    an_object["block_type"]         = "special";
+    pith["block_is"]                = eN.blk_is.table;
+    pith["block_state"]             = eN.blk_state.on;
+    pith["block_delim"]             = eN.blk_delim.curly_special;
+  } else if (auto m = line.matchFirst(rgx.block_tic_code_open)) {
+    dochas["codeblock"]++;
+    an_object["lang"]               = "";
+    an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
+    an_object["syntax"]             = (m["syntax"]) ? m["syntax"].to!string : "";
+    debug(codetic) {
+      writefln(
+        "* [code tic] %s",
+        line
+      );
     }
-    switch (biblio_tag_name) {
-    case "author_raw": // author_arr author (fn sn)
-      j["author_arr"]
-       = header_tag_value.split(rgx.arr_delimiter);
-      string tmp;
-      biblioAuthorLoop:
-      foreach (au; j["author_arr"].array) {
-        if (auto x = au.str.match(rgx.name_delimiter)) {
-          tmp ~= x.captures[2] ~ " " ~ x.captures[1] ~ ", ";
-        } else {
-          tmp ~= au.str;
-        }
-      }
-      tmp = tmp.replace(rgx.trailing_comma, "");
-      j["author"].str = tmp;
-      goto default;
-    case "editor_raw": // editor_arr editor (fn sn)
-      j["editor_arr"]
-        = header_tag_value.split(rgx.arr_delimiter);
-      string tmp;
-      biblioEditorLoop:
-      foreach (ed; j["editor_arr"].array) {
-        if (auto x = ed.str.match(rgx.name_delimiter)) {
-          tmp ~= x.captures[2] ~ " " ~ x.captures[1] ~ ", ";
-        } else {
-          tmp ~= ed.str;
-        }
-      }
-      tmp = tmp.replace(rgx.trailing_comma, "");
-      j["editor"].str = tmp;
-      goto default;
-    case "fulltitle": // title & subtitle
-      goto default;
-    default:
-      break;
+    pith["block_is"]                = eN.blk_is.code;
+    pith["block_state"]             = eN.blk_state.on;
+    pith["block_delim"]             = eN.blk_delim.tic;
+  } else if (auto m = line.matchFirst(rgx.block_tic_poem_open)) {
+    dochas["poem"]++;
+    an_object["syntax"]             = "";
+    an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
+    an_object["lang"]               = (m["lang"]) ? m["lang"].to!string : "";
+    debug(poem) {
+      writefln(
+        "* [poem tic] %s",
+        line
+      );
     }
-    auto s = j.toString();
-    debug(biblio1) {
+    object_number_poem["start"]     = obj_cite_digits.object_number.to!string;
+    pith["block_is"]                = eN.blk_is.poem;
+    pith["block_state"]             = eN.blk_state.on;
+    pith["block_delim"]             = eN.blk_delim.tic;
+    pith["verse_new"]               = eN.bi.on;
+  } else if (auto m = line.matchFirst(rgx.block_tic_group_open)) {
+    dochas["group"]++;
+    an_object["syntax"]             = "";
+    an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
+    an_object["lang"]               = (m["lang"]) ? m["lang"].to!string : "";
+    debug(group) {
       writefln(
-        "* %s: %s\n%s",
-        biblio_tag_name,
-        biblio_tag_entry,
-        j[biblio_tag_name]
+        "* [group tic] %s",
+        line
       );
     }
-    if (line.match(rgx.comment)) {
-      writeln("ERROR", line, "COMMENT");
-      writeln("ERROR", s, "%%");
+    pith["block_is"]                = eN.blk_is.group;
+    pith["block_state"]             = eN.blk_state.on;
+    pith["block_delim"]             = eN.blk_delim.tic;
+  } else if (auto m = line.matchFirst(rgx.block_tic_block_open)) {
+    dochas["block"]++;
+    an_object["syntax"]             = "";
+    an_object["attrib"]             = (m["attrib"]) ? m["attrib"].to!string : "";
+    an_object["lang"]               = (m["lang"]) ? m["lang"].to!string : "";
+    debug(block) {
+      writefln(
+        "* [block tic] %s",
+        line
+      );
     }
-    if (!(match(line, rgx.comment))) {
-      debug(biblioblockinclude) {
-        writeln(line);
-      }
-      biblio_entry_str_json = s;
-    } else {
-      biblio_entry_str_json = "";
+    pith["block_is"]                = eN.blk_is.block;
+    pith["block_state"]             = eN.blk_state.on;
+    pith["block_delim"]             = eN.blk_delim.tic;
+  } else if (auto m = line.matchFirst(rgx.block_tic_quote_open)) {
+    dochas["quote"]++;
+    an_object["syntax"]             = "";
+    an_object["attrib"]             = m["attrib"].to!string;
+    an_object["lang"]               = m["lang"].to!string;
+    debug(quote) {                             // quote (tic) open
+      writefln(
+        "* [quote tic] %s",
+        line
+      );
     }
-    header_tag_value        = "";
+    pith["block_is"]                = eN.blk_is.quote;
+    pith["block_state"]             = eN.blk_state.on;
+    pith["block_delim"]             = eN.blk_delim.tic;
+  } else if (auto m = line.matchFirst(rgx.block_tic_table_open)) {             /+ tic table open +/
+    debug(table) {                             // table (tic) open
+      writefln(
+        "* [table tic] %s",
+        line
+      );
+    }
+    dochas["table"] ++;
+    an_object["table_head"]         = m["attrib"].to!string;
+    an_object["block_type"]         = "tic";
+    pith["block_is"]                = eN.blk_is.table;
+    pith["block_state"]             = eN.blk_state.on;
+    pith["block_delim"]             = eN.blk_delim.tic;
+  }
+  struct retStruct {
+    uint[string]    pith;
+    uint[string]    dochas;
+    string[string]  object_number_poem;
   }
+  retStruct ret;
+  {
+    ret.pith               = pith;
+    ret.dochas             = dochas;
+    ret.object_number_poem = object_number_poem;
+  }
+  return ret;
 }
-#+END_SRC
-
-***** quote block :quote:
-
-#+NAME: abs_functions_block_quote
-#+BEGIN_SRC d
-@safe string[string] flow_txt_block_quote()(
-             char[]          line,
-             string[string]  an_object,
-  return ref uint[string]    pith,
+@safe auto txt_by_line_block_quote()(
+  char[]          line,
+  string[string]  an_object,
+  uint[string]    pith,
 ) {
   static auto rgx = RgxI();
   if (pith["block_is"] == eN.blk_is.quote){
@@ -4086,21 +3038,21 @@ final string biblio_tag_map_()(string abr) {
       }
     }
   }
-  return an_object;
+  struct retStruct {
+    uint[string]    pith;
+    string[string]  this_object;
+  }
+  retStruct ret;
+  {
+    ret.pith        = pith;
+    ret.this_object = an_object;
+  }
+  return ret;
 }
-#+END_SRC
-
-***** group block :group:
-
-- apply inline markup
-- discard leading and newline whitespace
-
-#+NAME: abs_functions_block_group
-#+BEGIN_SRC d
-@safe string[string] flow_txt_block_group()(
-             char[]          line,
-             string[string]  an_object,
-  return ref uint[string]    pith,
+@safe auto txt_by_line_block_group()(
+  char[]          line,
+  string[string]  an_object,
+  uint[string]    pith,
 ) {
   static auto rgx = RgxI();
   if (pith["block_is"] == eN.blk_is.group) {
@@ -4136,22 +3088,21 @@ final string biblio_tag_map_()(string abr) {
       }
     }
   }
-  return an_object;
+  struct retStruct {
+    uint[string]    pith;
+    string[string]  this_object;
+  }
+  retStruct ret;
+  {
+    ret.pith        = pith;
+    ret.this_object = an_object;
+  }
+  return ret;
 }
-#+END_SRC
-
-***** block block :block:
-
-- apply inline markup
-- keep whitespace indentation
-- keep newlines
-
-#+NAME: abs_functions_block_block
-#+BEGIN_SRC d
-@safe string[string] flow_txt_block_block()(
-             char[]          line,
-             string[string]  an_object,
-  return ref uint[string]    pith,
+@safe auto txt_by_line_block_block()(
+  char[]          line,
+  string[string]  an_object,
+  uint[string]    pith,
 ) {
   static auto rgx = RgxI();
   if (pith["block_is"] == eN.blk_is.block) {
@@ -4187,24 +3138,25 @@ final string biblio_tag_map_()(string abr) {
       }
     }
   }
-  return an_object;
+  struct retStruct {
+    uint[string]    pith;
+    string[string]  this_object;
+  }
+  retStruct ret;
+  {
+    ret.pith        = pith;
+    ret.this_object = an_object;
+  }
+  return ret;
 }
-#+END_SRC
-
-***** poem block, verse objects :poem:verse:
-
-why extra object stuff only in poem/verse?
-
-#+NAME: abs_functions_block_poem
-#+BEGIN_SRC d
-@safe string[string]  flow_txt_block_poem(CMM)(
-             char[]          line,
-             string[string]  an_object,
-  return ref uint[string]    pith,
-  return ref int             cntr,
-             string[string]  object_number_poem,
-             CMM             conf_make_meta,
-             string[string]  tag_in_seg,
+@safe auto txt_by_line_block_poem(CMM)(
+  char[]          line,
+  string[string]  an_object,
+  uint[string]    pith,
+  int             cntr,
+  string[string]  object_number_poem,
+  CMM             conf_make_meta,
+  string[string]  tag_in_seg,
 ) {
   static auto rgx = RgxI();
   if (pith["block_is"] == eN.blk_is.poem) {
@@ -4439,35 +3391,78 @@ why extra object stuff only in poem/verse?
       }
     }
   }
-  return an_object;
+  struct retStruct {
+    int             cntr;
+    uint[string]    pith;
+    string[string]  this_object;
+  }
+  retStruct ret;
+  {
+    ret.cntr        = cntr;
+    ret.pith        = pith;
+    ret.this_object = an_object;
+  }
+  return ret;
 }
-#+END_SRC
-
-***** table block :table:
-
-there are 3 types of table markup that need to be nomalized (given a single representation) here
-
-- curly brace block
-- tic block
-- special notation block
-
-you need:
-- identify the type for the munging to create uniform presentation
-  - curly, tick, special
-  - table heading row, bool
-- present table header info in uniform way
-  - table_number_of_columns, int (count)
-  - table_column_widths, int[] column widths (as given or calculate average)
-  - show table walls, bool
-- table content marked up in uniform way
-
-#+NAME: abs_functions_block_table
-#+BEGIN_SRC d
-@system string[string] flow_txt_block_table(CMM)(
-             char[]          line,
-             string[string]  an_object,
-  return ref uint[string]    pith,
-  return ref CMM             conf_make_meta,
+@safe auto txt_by_line_block_code()(
+  char[]          line,
+  string[string]  an_object,
+  uint[string]    pith,
+) {
+  static auto rgx = RgxI();
+  if ( pith["block_is"] == eN.blk_is.code) {
+    if (pith["block_delim"] == eN.blk_delim.curly) {
+      if (line.matchFirst(rgx.block_curly_code_close)) {
+        debug(codecurly) {
+          writeln(line);
+        }
+        an_object[an_object_key] = an_object[an_object_key]
+          .replaceFirst(rgx.newline_eol_delimiter_only, "")
+          .stripRight;
+        pith["block_is"]            = eN.blk_is.code;
+        pith["block_state"]         = eN.blk_state.closing;
+        pith["block_delim"]         = eN.blk_delim.off;
+      } else {
+        debug(codecurly) {
+          writeln(line);
+        }
+        an_object[an_object_key] ~= line ~= "\n";
+      }
+    } else if (pith["block_delim"] == eN.blk_delim.tic) {
+      if (line.matchFirst(rgx.block_tic_close)) {
+        debug(codetic) {
+          writeln(line);
+        }
+        an_object[an_object_key] = an_object[an_object_key]
+          .replaceFirst(rgx.newline_eol_delimiter_only, "")
+          .stripRight;
+        pith["block_is"]            = eN.blk_is.code;
+        pith["block_state"]         = eN.blk_state.closing;
+        pith["block_delim"]         = eN.blk_delim.off;
+      } else {
+        debug(codetic) {
+          writeln(line);
+        }
+        an_object[an_object_key] ~= line ~= "\n";
+      }
+    }
+  }
+  struct retStruct {
+    uint[string]    pith;
+    string[string]  this_object;
+  }
+  retStruct ret;
+  {
+    ret.pith        = pith;
+    ret.this_object = an_object;
+  }
+  return ret;
+}
+@system auto txt_by_line_block_table(CMM)(
+  char[]          line,
+  string[string]  an_object,
+  uint[string]    pith,
+  CMM             conf_make_meta,
 ) {
   static auto rgx = RgxI();
   if (pith["block_is"] == eN.blk_is.table) {
@@ -4490,15 +3485,25 @@ you need:
         pith["block_is"]            = eN.blk_is.table;
         pith["block_state"]         = eN.blk_state.off;
         pith["block_delim"]         = eN.blk_delim.off;
-        line.flow_table_closed_make_special_notation_table_(
-          an_object,
-          the_document_body_section,
-          obj_cite_digits,
-          comp_obj_heading,
-          cntr,
-          pith,
-          conf_make_meta,
-        );
+        {
+          auto _get = line.flow_table_closed_make_special_notation_table_(
+            an_object,
+            the_document_body_section,
+            obj_cite_digits,
+            comp_obj_heading,
+            cntr,
+            pith,
+            conf_make_meta,
+          );
+          {
+            an_object                 = _get.this_object;
+            the_document_body_section = _get.the_document_body_section;
+            obj_cite_digits           = _get.obj_cite_digits;
+            comp_obj_heading          = _get._comp_obj_heading;
+            cntr                      = _get.cntr;
+            pith                      = _get.pith;
+          }
+        }
       } else {
         debug(table) {
           writeln(line);
@@ -4521,34 +3526,288 @@ you need:
       }
     }
   }
+  struct retStruct {
+    CMM             conf_make_meta;
+    uint[string]    pith;
+    string[string]  this_object;
+  }
+  retStruct ret;
+  {
+    ret.conf_make_meta = conf_make_meta,
+    ret.pith           = pith;
+    ret.this_object    = an_object;
+  }
+  return ret;
+}
+@system auto txt_by_line_block_biblio(
+  char[]                  line,
+  uint[string] pith,
+  int          bib_entry,
+  string       biblio_entry_str_json,
+  string[]     biblio_arr_json,
+) {
+  mixin spineBiblio;
+  auto jsn = BibJsnStr();
+  static auto rgx = RgxI();
+  string biblio_tag_map()(string abr) {
+    auto btm = [
+      "au"        : "author_raw",
+      "ed"        : "editor_raw",
+      "ti"        : "fulltitle",
+      "lng"       : "language",
+      "jo"        : "journal",
+      "vol"       : "volume",
+      "edn"       : "edition",
+      "yr"        : "year",
+      "pl"        : "place",
+      "pb"        : "publisher",
+      "pub"       : "publisher",
+      "pg"        : "pages",
+      "pgs"       : "pages",
+      "sn"        : "short_name"
+    ];
+    return btm[abr];
+  }
+  if (line.matchFirst(rgx.heading_biblio)) {
+    pith["section"] = eN.sect.bibliography;
+  }
+  if (line.empty) {
+    debug {
+      debug(biblioblock) {
+        writeln("---");
+      }
+      debug(biblioblockinclude) {
+        writeln(biblio_entry_str_json.length);
+      }
+    }
+    if ((bib_entry == eN.bi.off)
+    && (biblio_entry_str_json.empty)) {
+      bib_entry = eN.bi.on;
+      biblio_entry_str_json = jsn.biblio_entry_tags_jsonstr;
+    } else if (!(biblio_entry_str_json.empty)) {
+      bib_entry = eN.bi.off;
+      if (!(biblio_entry_str_json == jsn.biblio_entry_tags_jsonstr)) {
+        auto biblio_entry = parseJSON(biblio_entry_str_json);
+        if (biblio_entry["fulltitle"].str.empty) {
+          writeln("check problem entry (Title missing): ", biblio_entry_str_json);
+        } else if ((biblio_entry["author_raw"].str.empty) && (biblio_entry["editor_raw"].str.empty)) {
+          writeln("check problem entry (No author and no editor): ", biblio_entry_str_json);
+        } else {
+          biblio_arr_json ~= biblio_entry_str_json;
+        }
+        biblio_entry_str_json = jsn.biblio_entry_tags_jsonstr;
+      }
+    } else {
+      writeln("?? 2. ERROR ", biblio_entry_str_json, "??");
+      biblio_entry_str_json = "";
+    }
+  } else if (line.matchFirst(rgx.biblio_tags)) {
+    debug(biblioblock) {
+      writeln(line);
+    }
+    auto bt = line.match(rgx.biblio_tags);
+    bib_entry = eN.bi.off;
+    st = bt.captures[1].to!string;
+    auto header_tag_value = (bt.captures[2]).to!string;
+    JSONValue j = parseJSON(biblio_entry_str_json);
+    biblio_tag_name = (st.match(rgx.biblio_abbreviations))
+      ? (biblio_tag_map(st))
+      : st;
+    j.object[biblio_tag_name] = header_tag_value;
+    debug(bibliounsortedcheckduplicates) {
+      writeln(biblio_tag_name, ": ", header_tag_value);
+      writeln("--");
+    }
+    switch (biblio_tag_name) {
+    case "author_raw": // author_arr author (fn sn)
+      j["author_arr"]
+       = header_tag_value.split(rgx.arr_delimiter);
+      string tmp;
+      biblioAuthorLoop:
+      foreach (au; j["author_arr"].array) {
+        if (auto x = au.str.match(rgx.name_delimiter)) {
+          tmp ~= x.captures[2] ~ " " ~ x.captures[1] ~ ", ";
+        } else {
+          tmp ~= au.str;
+        }
+      }
+      tmp = tmp.replace(rgx.trailing_comma, "");
+      j["author"].str = tmp;
+      goto default;
+    case "editor_raw": // editor_arr editor (fn sn)
+      j["editor_arr"]
+        = header_tag_value.split(rgx.arr_delimiter);
+      string tmp;
+      biblioEditorLoop:
+      foreach (ed; j["editor_arr"].array) {
+        if (auto x = ed.str.match(rgx.name_delimiter)) {
+          tmp ~= x.captures[2] ~ " " ~ x.captures[1] ~ ", ";
+        } else {
+          tmp ~= ed.str;
+        }
+      }
+      tmp = tmp.replace(rgx.trailing_comma, "");
+      j["editor"].str = tmp;
+      goto default;
+    case "fulltitle": // title & subtitle
+      goto default;
+    default:
+      break;
+    }
+    auto s = j.toString();
+    debug(biblio1) {
+      writefln(
+        "* %s: %s\n%s",
+        biblio_tag_name,
+        biblio_tag_entry,
+        j[biblio_tag_name]
+      );
+    }
+    if (line.match(rgx.comment)) {
+      writeln("ERROR", line, "COMMENT");
+      writeln("ERROR", s, "%%");
+    }
+    if (!(match(line, rgx.comment))) {
+      debug(biblioblockinclude) {
+        writeln(line);
+      }
+      biblio_entry_str_json = s;
+    } else {
+      biblio_entry_str_json = "";
+    }
+    header_tag_value        = "";
+  }
+  struct retStruct {
+    uint[string]    pith;
+    int             bib_entry;
+    string          biblio_entry_str_json;
+    string[]        biblio_arr_json;
+  }
+  retStruct ret;
+  {
+    ret.pith                  = pith;
+    ret.bib_entry             = bib_entry;
+    ret.biblio_entry_str_json = biblio_entry_str_json;
+    ret.biblio_arr_json       = biblio_arr_json;
+  }
+  return ret;
+}
+                                                                              /+ ↓ abstraction functions +/
+@safe static string[string] object_reset()(string[string] an_object) {
+  an_object.remove("body_nugget");
+  an_object.remove("substantive");
+  an_object.remove("is");
+  an_object.remove("attrib");
+  an_object.remove("bookindex_nugget");
   return an_object;
 }
-#+END_SRC
-
-**** special table notation, make: table
-
-process and use an_object["table_head"] (then empty it)
-- present table header info in uniform way
-  - table_number_of_columns, int (count)
-  - table_column_widths, int[] column widths (as given or calculate average)
-  - show table walls, bool
-
-#+NAME: abs_functions_block_line_status_empty_table_closed
-#+BEGIN_SRC d
-@system void flow_table_closed_make_special_notation_table_(N,CMM)(
-             char[]                line,
-  return ref string[string]        an_object,
-  return ref ObjGenericComposite[] the_document_body_section,
-  return ref N                     obj_cite_digits,
-  return ref ObjGenericComposite   _comp_obj_heading,
-  return ref int                   cntr,
-  return ref uint[string]          pith,
-  CMM                              conf_make_meta
+@safe static uint[string] _check_ocn_status_()(
+  char[]       line,
+  uint[string] pith,
+) {
+  static auto rgx = RgxI();
+  if (!(line.empty)) {
+    if (pith["no_ocn_multiple_objects"] == eN.bi.off) {
+      /+ not multi-line object, check whether object_number is on or turned off +/
+      if (line.matchFirst(rgx.object_number_block_marks)) {                      /+ switch off object_number +/
+        if (line.matchFirst(rgx.object_number_off_block)) {
+          pith["no_ocn_multiple_objects"]             = eN.bi.on;
+          pith["ocn"]                                 = eN.ocn.off;
+          debug(ocnoff) {
+            writeln(line);
+          }
+        }
+        if (line.matchFirst(rgx.object_number_off_block_dummy_heading)) {
+          pith["no_ocn_multiple_objects"]             = eN.bi.on;
+          pith["dummy_heading_multiple_objects"]      = eN.bi.on;
+          pith["ocn"]                                 = eN.ocn.off;
+          debug(ocnoff) {
+            writeln(line);
+          }
+        }
+      } else if (pith["no_ocn_multiple_objects"] == eN.bi.off) {
+          pith["dummy_heading_status"]                = eN.bi.off;
+          if (pith["dummy_heading_multiple_objects"]) {
+            pith["dummy_heading_status"]              = eN.bi.on;
+          }
+          if (line.matchFirst(rgx.object_number_off)) {
+            pith["ocn"]                               = eN.ocn.off;
+          } else if (line.matchFirst(rgx.object_number_off_dummy_heading)) {
+            pith["ocn"]                               = eN.ocn.off;
+            pith["dummy_heading_status"]              = eN.bi.on;
+          } else {
+            pith["ocn"]                               = eN.ocn.on;
+            pith["dummy_heading_status"]              = eN.bi.off;
+          }
+        } else {
+          pith["ocn"] = pith["no_ocn_multiple_objects"];
+        }
+    } else if (pith["no_ocn_multiple_objects"] == eN.bi.on) {
+      if (line.matchFirst(rgx.object_number_off_block_close)) {
+        pith["no_ocn_multiple_objects"]               = eN.bi.off;
+        pith["ocn"]                                   = eN.ocn.on;
+        pith["dummy_heading_status"]                  = eN.bi.off;
+        debug(ocnoff) {
+          writeln(line);
+        }
+      }
+    }
+  }
+  return pith;
+}
+@safe char[] _doc_header_and_make_substitutions_(CMM)(
+  char[]  line,
+  CMM     conf_make_meta,
+) {
+  enum Substitute { match, markup, }
+  if (conf_make_meta.make.substitute) {
+    foreach(substitution_pair; conf_make_meta.make.substitute) {
+      line = line.replaceAll(
+        regex("\b" ~ substitution_pair[Substitute.match]),
+        substitution_pair[Substitute.markup]
+      );
+    }
+  }
+  return line;
+}
+@safe char[] _doc_header_and_make_substitutions_fontface_(CMM)(
+  char[]  line,
+  CMM     conf_make_meta,
+) {
+  enum Substitute { match, markup, }
+  if ( conf_make_meta.make.bold) {
+    line = line.replaceAll(
+      regex("\b" ~ conf_make_meta.make.bold[Substitute.match]),
+      conf_make_meta.make.bold[Substitute.markup]
+    );
+  }
+  if (conf_make_meta.make.emphasis) {
+    line = line.replaceAll(
+      regex("\b" ~ conf_make_meta.make.emphasis[Substitute.match]),
+      conf_make_meta.make.emphasis[Substitute.markup]
+    );
+  }
+  if (conf_make_meta.make.italics) {
+    line = line.replaceAll(
+      regex("\b" ~ conf_make_meta.make.italics[Substitute.match]),
+      conf_make_meta.make.italics[Substitute.markup]
+    );
+  }
+  return line;
+}
+@system auto flow_table_closed_make_special_notation_table_(CMM)(
+  char[]                line,
+  string[string]        an_object,
+  ObjGenericComposite[] the_document_body_section,
+  OCNset                obj_cite_digits,
+  ObjGenericComposite   _comp_obj_heading,
+  int                   cntr,
+  uint[string]          pith,
+  CMM                   conf_make_meta
 ) {
   comp_obj_block = comp_obj_block.init;
   obj_cite_digits = ocn_emit(pith["ocn"]);
-  auto comp_obj_location
-    = node_construct.node_location_emitter(
+  auto comp_obj_location = node_construct.node_location_emitter(
       content_non_header,
       tag_in_seg,
       lev_anchor_tag,
@@ -4570,33 +3829,49 @@ process and use an_object["table_head"] (then empty it)
   comp_obj_block.metainfo.o_n_book_index                      = obj_cite_digits.bkidx;
   comp_obj_block.metainfo.object_number_type                  = obj_cite_digits.type;
   comp_obj_block                                              = comp_obj_block.flow_table_instructions(an_object["table_head"]);
-  comp_obj_block                                              = comp_obj_block.flow_table_substantive_munge_special(an_object["substantive"]);
+  {
+    auto _get = comp_obj_block.flow_table_substantive_munge_special(an_object["substantive"]);
+    {
+      comp_obj_block           = _get.table_object;
+      an_object["substantive"] = _get.table_substantive;
+    }
+  }
   the_document_body_section                                   ~= comp_obj_block;
   object_reset(an_object);
   processing.remove("verse");
   ++cntr;
-}
-#+END_SRC
-
-**** block end (close an open block): line empty, block flag _makes_ :close:
-
-***** { line empty, _make block_
-
-#+NAME: abs_functions_block_line_status_empty_block_close_function_open
-#+BEGIN_SRC d
-@system string[string] flow_block_flag_line_empty_(B,N,CMM,Ts)(
-             char[]                   line,
-             string[string]           an_object,
-             B                        bookindex_extract_hash,
-  return ref ObjGenericComposite[]    the_document_body_section,
-  return ref string[][string][string] bookindex_unordered_hashes,
-  return ref N                        obj_cite_digits,
-  return ref ObjGenericComposite      _comp_obj_heading,
-  return ref int                      cntr,
-  return ref uint[string]             pith,
-  string[string]                      object_number_poem,
-  CMM                                 conf_make_meta,
-  Ts                                  tag_in_seg,
+  struct retStruct {
+    string[string]        this_object;
+    ObjGenericComposite[] the_document_body_section;
+    OCNset                obj_cite_digits;
+    ObjGenericComposite   _comp_obj_heading;
+    int                   cntr;
+    uint[string]          pith;
+  }
+  retStruct ret;
+  {
+    ret.this_object               = an_object;
+    ret.the_document_body_section = the_document_body_section;
+    ret.obj_cite_digits           = obj_cite_digits;
+    ret._comp_obj_heading         = _comp_obj_heading;
+    ret.cntr                      = cntr;
+    ret.pith                      = pith;
+  }
+  return ret;
+}
+@system auto flow_block_flag_line_empty_(B,CMM,Ts)(
+  char[]                   line,
+  string[string]           an_object,
+  B                        bookindex_extract_hash,
+  ObjGenericComposite[]    the_document_body_section,
+  string[][string][string] bookindex_unordered_hashes,
+  OCNset                   obj_cite_digits,
+  ObjGenericComposite      _comp_obj_heading,
+  int                      cntr,
+  uint[string]             pith,
+  string[string]           object_number_poem,
+  CMM                      conf_make_meta,
+  Ts                       tag_in_seg,
 ) {
   assert(
     line.empty,
@@ -4609,352 +3884,329 @@ process and use an_object["table_head"] (then empty it)
   );
   static auto rgx = RgxI();
   if (pith["block_state"] == eN.blk_state.closing) {
-#+END_SRC
-
-****** make: quote block
-
-#+NAME: abs_functions_block_line_status_empty_block_quote
-#+BEGIN_SRC d
-if (pith["block_is"] == eN.blk_is.quote) {
-  obj_cite_digits = ocn_emit(pith["ocn"]);
-  an_object["bookindex_nugget"]
-    = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
-  bookindex_unordered_hashes
-    = bookindex_extract_hash.bookindex_nugget_hash(
-      an_object["bookindex_nugget"],
-      obj_cite_digits,
-      tag_in_seg
-    );
-  an_object["is"]                                         = "quote";
-  auto comp_obj_location
-    = node_construct.node_location_emitter(
-      content_non_header,
-      tag_in_seg,
-      lev_anchor_tag,
-      tag_assoc,
-      obj_cite_digits,
-      cntr,
-      heading_ptr-1,
-      an_object["is"]
-    );
-  TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
-    = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
-  an_object["substantive"]                                = substantive_obj_misc_tuple[sObj.content];
-  anchor_tag                                              = substantive_obj_misc_tuple[sObj.anchor_tag];
-  comp_obj_block                                          = comp_obj_block.init;
-  comp_obj_block.metainfo.is_of_part                      = "body";
-  comp_obj_block.metainfo.is_of_section                   = "body";
-  comp_obj_block.metainfo.is_of_type                      = "block";
-  comp_obj_block.metainfo.is_a                            = "quote";
-  comp_obj_block.metainfo.ocn                             = obj_cite_digits.object_number;
-  comp_obj_block.metainfo.identifier                      = obj_cite_digits.identifier;
-  comp_obj_block.metainfo.object_number_off               = obj_cite_digits.off;
-  comp_obj_block.metainfo.o_n_book_index                  = obj_cite_digits.bkidx;
-  comp_obj_block.metainfo.object_number_type              = obj_cite_digit_type;
-  comp_obj_block.metainfo.lang                            = an_object["lang"];
-  comp_obj_block.metainfo.attrib                          = an_object["attrib"];
-  comp_obj_block.tags.html_segment_anchor_tag_is          = tag_in_seg["seg_lv4"];
-  comp_obj_block.tags.epub_segment_anchor_tag_is          = tag_in_seg["seg_lv1to4"];
-  comp_obj_block.text                                     = an_object["substantive"];
-  comp_obj_block.has.inline_notes_reg                     = substantive_obj_misc_tuple[sObj.notes_reg];
-  comp_obj_block.has.inline_notes_star                    = substantive_obj_misc_tuple[sObj.notes_star];
-  comp_obj_block.has.inline_links                         = substantive_obj_misc_tuple[sObj.links];
-  the_document_body_section                               ~= comp_obj_block;
-  tag_assoc                                               = an_object.inline_para_link_anchor(tag_in_seg, tag_assoc);
-  pith["block_is"]                                        = eN.blk_is.quote;
-  pith["block_state"]                                     = eN.blk_state.off;
-  pith["block_delim"]                                     = eN.blk_delim.off;
-  object_reset(an_object);
-  processing.remove("verse");
-  ++cntr;
-#+END_SRC
-
-****** make: group block
-
-#+NAME: abs_functions_block_line_status_empty_block_group
-#+BEGIN_SRC d
-} else if (pith["block_is"] == eN.blk_is.group) {
-  obj_cite_digits = ocn_emit(pith["ocn"]);
-  an_object["bookindex_nugget"]
-    = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
-  bookindex_unordered_hashes
-    = bookindex_extract_hash.bookindex_nugget_hash(
-      an_object["bookindex_nugget"],
-      obj_cite_digits,
-      tag_in_seg
-    );
-  an_object["is"]                                         = "group";
-  auto comp_obj_location
-    = node_construct.node_location_emitter(
-      content_non_header,
-      tag_in_seg,
-      lev_anchor_tag,
-      tag_assoc,
-      obj_cite_digits,
-      cntr,
-      heading_ptr-1,
-      an_object["is"]
-    );
-  TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
-    = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
-  an_object["substantive"]                                = substantive_obj_misc_tuple[sObj.content];
-  anchor_tag                                              = substantive_obj_misc_tuple[sObj.anchor_tag];
-  comp_obj_block                                          = comp_obj_block.init;
-  comp_obj_block.metainfo.is_of_part                      = "body";
-  comp_obj_block.metainfo.is_of_section                   = "body";
-  comp_obj_block.metainfo.is_of_type                      = "block";
-  comp_obj_block.metainfo.is_a                            = "group";
-  comp_obj_block.metainfo.ocn                             = obj_cite_digits.object_number;
-  comp_obj_block.metainfo.identifier                      = obj_cite_digits.identifier;
-  comp_obj_block.metainfo.object_number_off               = obj_cite_digits.off;
-  comp_obj_block.metainfo.o_n_book_index                  = obj_cite_digits.bkidx;
-  comp_obj_block.metainfo.object_number_type              = obj_cite_digits.type;
-  comp_obj_block.metainfo.lang                            = an_object["lang"];
-  comp_obj_block.metainfo.attrib                          = an_object["attrib"];
-  comp_obj_block.tags.html_segment_anchor_tag_is          = tag_in_seg["seg_lv4"];
-  comp_obj_block.tags.epub_segment_anchor_tag_is          = tag_in_seg["seg_lv1to4"];
-  comp_obj_block.text                                     = an_object["substantive"];
-  comp_obj_block.has.inline_notes_reg                     = substantive_obj_misc_tuple[sObj.notes_reg];
-  comp_obj_block.has.inline_notes_star                    = substantive_obj_misc_tuple[sObj.notes_star];
-  comp_obj_block.has.inline_links                         = substantive_obj_misc_tuple[sObj.links];
-  the_document_body_section                               ~= comp_obj_block;
-  tag_assoc                                               = an_object.inline_para_link_anchor(tag_in_seg, tag_assoc);
-  pith["block_is"]                                        = eN.blk_is.poem;
-  pith["block_state"]                                     = eN.blk_state.off;
-  pith["block_delim"]                                     = eN.blk_delim.off;
-  object_reset(an_object);
-  processing.remove("verse");
-  ++cntr;
-#+END_SRC
-
-****** make: block
-
-#+NAME: abs_functions_block_line_status_empty_block_block
-#+BEGIN_SRC d
-} else if (pith["block_is"] == eN.blk_is.block) {
-  obj_cite_digits = ocn_emit(pith["ocn"]);
-  an_object["bookindex_nugget"]
-    = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
-  bookindex_unordered_hashes
-    = bookindex_extract_hash.bookindex_nugget_hash(
-      an_object["bookindex_nugget"],
-      obj_cite_digits,
-      tag_in_seg
-    );
-  an_object["is"]                                         = "block";
-  auto comp_obj_location
-    = node_construct.node_location_emitter(
-      content_non_header,
-      tag_in_seg,
-      lev_anchor_tag,
-      tag_assoc,
-      obj_cite_digits,
-      cntr,
-      heading_ptr-1,
-      an_object["is"]
-    );
-  TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
-    = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
-  an_object["substantive"]                                = substantive_obj_misc_tuple[sObj.content];
-  // anchor_tag                                           = substantive_obj_misc_tuple[sObj.anchor_tag];
-  comp_obj_block                                          = comp_obj_block.init;
-  comp_obj_block.metainfo.is_of_part                      = "body";
-  comp_obj_block.metainfo.is_of_section                   = "body";
-  comp_obj_block.metainfo.is_of_type                      = "block";
-  comp_obj_block.metainfo.is_a                            = "block";
-  comp_obj_block.metainfo.ocn                             = obj_cite_digits.object_number;
-  comp_obj_block.metainfo.identifier                      = obj_cite_digits.identifier;
-  comp_obj_block.metainfo.object_number_off               = obj_cite_digits.off;
-  comp_obj_block.metainfo.o_n_book_index                  = obj_cite_digits.bkidx;
-  comp_obj_block.metainfo.object_number_type              = obj_cite_digit_type;
-  comp_obj_block.metainfo.lang                            = an_object["lang"];
-  comp_obj_block.metainfo.attrib                          = an_object["attrib"];
-  comp_obj_block.tags.html_segment_anchor_tag_is          = tag_in_seg["seg_lv4"];
-  comp_obj_block.tags.epub_segment_anchor_tag_is          = tag_in_seg["seg_lv1to4"];
-  comp_obj_block.text                                     = an_object["substantive"];
-  comp_obj_block.has.inline_notes_reg                     = substantive_obj_misc_tuple[sObj.notes_reg];
-  comp_obj_block.has.inline_notes_star                    = substantive_obj_misc_tuple[sObj.notes_star];
-  comp_obj_block.has.inline_links                         = substantive_obj_misc_tuple[sObj.links];
-  the_document_body_section                               ~= comp_obj_block;
-  pith["block_is"]                                        = eN.blk_is.block;
-  pith["block_state"]                                     = eN.blk_state.off;
-  pith["block_delim"]                                     = eN.blk_delim.off;
-  object_reset(an_object);
-  processing.remove("verse");
-  ++cntr;
-#+END_SRC
-
-****** make: poem
-
-#+NAME: abs_functions_block_line_status_empty_block_poem
-#+BEGIN_SRC d
-} else if (pith["block_is"] == eN.blk_is.poem) {
-  an_object["bookindex_nugget"]
-    = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
-  bookindex_unordered_hashes
-    = bookindex_extract_hash.bookindex_nugget_hash(
-      an_object["bookindex_nugget"],
-      obj_cite_digits,
-      tag_in_seg
-    );
-  an_object["is"]                                         = "verse";
-  auto comp_obj_location
-    = node_construct.node_location_emitter(
-      content_non_header,
-      tag_in_seg,
-      lev_anchor_tag,
-      tag_assoc,
-      obj_cite_digits,
-      cntr,
-      heading_ptr-1,
-      an_object["is"]
-    );
-  comp_obj_poem_ocn                                       = comp_obj_poem_ocn.init;
-  comp_obj_poem_ocn.metainfo.is_of_part                   = "body";
-  comp_obj_poem_ocn.metainfo.is_of_section                = "body";
-  comp_obj_poem_ocn.metainfo.is_of_type                   = "block";
-  comp_obj_poem_ocn.metainfo.is_a                         = "poem";
-  comp_obj_poem_ocn.metainfo.ocn                          = obj_cite_digits.object_number;
-  comp_obj_poem_ocn.metainfo.identifier                   = obj_cite_digits.identifier;
-  comp_obj_poem_ocn.metainfo.object_number_off            = obj_cite_digits.off;
-  comp_obj_poem_ocn.metainfo.o_n_book_index               = obj_cite_digits.bkidx;
-  comp_obj_poem_ocn.metainfo.object_number_type           = obj_cite_digits.type;
-  comp_obj_poem_ocn.text                                  = "";
-  the_document_body_section                               ~= comp_obj_poem_ocn;
-  pith["block_is"]                                        = eN.blk_is.poem;
-  pith["block_state"]                                     = eN.blk_state.off;
-  pith["block_delim"]                                     = eN.blk_delim.off;
-  object_reset(an_object);
-  processing.remove("verse");
-#+END_SRC
-
-****** make: code block
-
-#+NAME: abs_functions_block_line_status_empty_block_code
-#+BEGIN_SRC d
-} else if (pith["block_is"] == eN.blk_is.code) {
-  obj_cite_digits = ocn_emit(pith["ocn"]);
-  an_object["bookindex_nugget"]
-    = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
-  bookindex_unordered_hashes
-    = bookindex_extract_hash.bookindex_nugget_hash(
-      an_object["bookindex_nugget"],
-      obj_cite_digits,
-      tag_in_seg
-    );
-  an_object["is"]                                         = "code";
-  auto comp_obj_location
-    = node_construct.node_location_emitter(
-      content_non_header,
-      tag_in_seg,
-      lev_anchor_tag,
-      tag_assoc,
-      obj_cite_digits,
-      cntr,
-      heading_ptr-1,
-      an_object["is"]
-    );
-  TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
-    = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
-  an_object["substantive"]                                = substantive_obj_misc_tuple[sObj.content];
-  anchor_tag                                              = substantive_obj_misc_tuple[sObj.anchor_tag];
-  comp_obj_code                                           = comp_obj_code.init;
-  comp_obj_code.metainfo.is_of_part                       = "body";
-  comp_obj_code.metainfo.is_of_section                    = "body";
-  comp_obj_code.metainfo.is_of_type                       = "block";
-  comp_obj_code.metainfo.is_a                             = "code";
-  comp_obj_code.metainfo.ocn                              = obj_cite_digits.object_number;
-  comp_obj_code.metainfo.identifier                       = obj_cite_digits.identifier;
-  comp_obj_code.metainfo.object_number_off                = obj_cite_digits.off;
-  comp_obj_code.metainfo.o_n_book_index                   = obj_cite_digits.bkidx;
-  comp_obj_code.metainfo.object_number_type               = obj_cite_digits.type;
-  comp_obj_code.metainfo.syntax                           = an_object["syntax"];
-  comp_obj_code.metainfo.attrib                           = an_object["attrib"];
-  comp_obj_code.code_block.linenumbers                    = (an_object["attrib"].match(rgx.code_numbering)) ? true : false;
-  comp_obj_code.tags.html_segment_anchor_tag_is           = tag_in_seg["seg_lv4"];
-  comp_obj_code.tags.epub_segment_anchor_tag_is           = tag_in_seg["seg_lv1to4"];
-  comp_obj_code.text                                      = an_object["substantive"];
-  comp_obj_code.has.inline_notes_reg                      = substantive_obj_misc_tuple[sObj.notes_reg];
-  comp_obj_code.has.inline_notes_star                     = substantive_obj_misc_tuple[sObj.notes_star];
-  comp_obj_code.has.inline_links                          = substantive_obj_misc_tuple[sObj.links];
-  the_document_body_section                               ~= comp_obj_code;
-  pith["block_is"]                                        = eN.blk_is.code;
-  pith["block_state"]                                     = eN.blk_state.off;
-  pith["block_delim"]                                     = eN.blk_delim.off;
-  object_reset(an_object);
-  processing.remove("verse");
-  ++cntr;
-#+END_SRC
-
-****** make: table
-
-#+NAME: abs_functions_block_line_status_empty_block_table
-#+BEGIN_SRC d
-} else if (pith["block_is"]    == eN.blk_is.table) {
-  comp_obj_block = comp_obj_block.init;
-  obj_cite_digits = ocn_emit(pith["ocn"]);
-  an_object["bookindex_nugget"]
-    = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
-  bookindex_unordered_hashes
-    = bookindex_extract_hash.bookindex_nugget_hash(
-      an_object["bookindex_nugget"],
-      obj_cite_digits,
-      tag_in_seg
-    );
-  an_object["is"]                                         = "table";
-  auto comp_obj_location
-    = node_construct.node_location_emitter(
-      content_non_header,
-      tag_in_seg,
-      lev_anchor_tag,
-      tag_assoc,
-      obj_cite_digits,
-      cntr,
-      heading_ptr-1,
-      an_object["is"]
-    );
-  TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
-    = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
-  an_object["substantive"]                                = substantive_obj_misc_tuple[sObj.content];
-  comp_obj_block                                          = comp_obj_block.init;
-  comp_obj_block.metainfo.ocn                             = obj_cite_digits.object_number;
-  comp_obj_block.metainfo.identifier                      = obj_cite_digits.identifier;
-  comp_obj_block.metainfo.object_number_off               = obj_cite_digits.off;
-  comp_obj_block.tags.html_segment_anchor_tag_is          = tag_in_seg["seg_lv4"];
-  comp_obj_block.tags.epub_segment_anchor_tag_is          = tag_in_seg["seg_lv1to4"];
-  comp_obj_block.metainfo.o_n_book_index                  = obj_cite_digits.bkidx;
-  comp_obj_block.metainfo.object_number_type              = obj_cite_digits.type;
-  comp_obj_block                                          = comp_obj_block.flow_table_instructions(an_object["table_head"]);
-  comp_obj_block                                          = comp_obj_block.flow_table_substantive_munge(an_object["substantive"]);
-  the_document_body_section                               ~= comp_obj_block;
-  pith["block_is"]                                        = eN.blk_is.table;
-  pith["block_state"]                                     = eN.blk_state.off;
-  pith["block_delim"]                                     = eN.blk_delim.off;
-  object_reset(an_object);
-  processing.remove("verse");
-  ++cntr;
-}
-#+END_SRC
-
-***** }
-
-#+NAME: abs_functions_block_line_status_empty_block_close_function_close
-#+BEGIN_SRC d
-  }
-  return an_object;
-}
-#+END_SRC
-
-*** book index :bookindex:
-
-#+NAME: abs_functions_book_index
-#+BEGIN_SRC d
-@system string[string] flow_book_index_(B)(
-             char[]          line,
-             string[string]  an_object,
-  return ref string          book_idx_tmp,
-  return ref uint[string]    pith,
-             B               opt_action,
+    if (pith["block_is"] == eN.blk_is.quote) {
+      obj_cite_digits = ocn_emit(pith["ocn"]);
+      an_object["bookindex_nugget"]
+        = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
+      bookindex_unordered_hashes
+        = bookindex_extract_hash.bookindex_nugget_hash(
+          an_object["bookindex_nugget"],
+          obj_cite_digits,
+          tag_in_seg
+        );
+      an_object["is"]                                         = "quote";
+      auto comp_obj_location
+        = node_construct.node_location_emitter(
+          content_non_header,
+          tag_in_seg,
+          lev_anchor_tag,
+          tag_assoc,
+          obj_cite_digits,
+          cntr,
+          heading_ptr-1,
+          an_object["is"]
+        );
+      TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
+        = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
+      an_object["substantive"]                                = substantive_obj_misc_tuple[sObj.content];
+      anchor_tag                                              = substantive_obj_misc_tuple[sObj.anchor_tag];
+      comp_obj_block                                          = comp_obj_block.init;
+      comp_obj_block.metainfo.is_of_part                      = "body";
+      comp_obj_block.metainfo.is_of_section                   = "body";
+      comp_obj_block.metainfo.is_of_type                      = "block";
+      comp_obj_block.metainfo.is_a                            = "quote";
+      comp_obj_block.metainfo.ocn                             = obj_cite_digits.object_number;
+      comp_obj_block.metainfo.identifier                      = obj_cite_digits.identifier;
+      comp_obj_block.metainfo.object_number_off               = obj_cite_digits.off;
+      comp_obj_block.metainfo.o_n_book_index                  = obj_cite_digits.bkidx;
+      comp_obj_block.metainfo.object_number_type              = obj_cite_digit_type;
+      comp_obj_block.metainfo.lang                            = an_object["lang"];
+      comp_obj_block.metainfo.attrib                          = an_object["attrib"];
+      comp_obj_block.tags.html_segment_anchor_tag_is          = tag_in_seg["seg_lv4"];
+      comp_obj_block.tags.epub_segment_anchor_tag_is          = tag_in_seg["seg_lv1to4"];
+      comp_obj_block.text                                     = an_object["substantive"];
+      comp_obj_block.has.inline_notes_reg                     = substantive_obj_misc_tuple[sObj.notes_reg];
+      comp_obj_block.has.inline_notes_star                    = substantive_obj_misc_tuple[sObj.notes_star];
+      comp_obj_block.has.inline_links                         = substantive_obj_misc_tuple[sObj.links];
+      the_document_body_section                               ~= comp_obj_block;
+      tag_assoc                                               = an_object.inline_para_link_anchor(tag_in_seg, tag_assoc);
+      pith["block_is"]                                        = eN.blk_is.quote;
+      pith["block_state"]                                     = eN.blk_state.off;
+      pith["block_delim"]                                     = eN.blk_delim.off;
+      object_reset(an_object);
+      processing.remove("verse");
+      ++cntr;
+    } else if (pith["block_is"] == eN.blk_is.group) {
+      obj_cite_digits = ocn_emit(pith["ocn"]);
+      an_object["bookindex_nugget"]
+        = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
+      bookindex_unordered_hashes
+        = bookindex_extract_hash.bookindex_nugget_hash(
+          an_object["bookindex_nugget"],
+          obj_cite_digits,
+          tag_in_seg
+        );
+      an_object["is"]                                         = "group";
+      auto comp_obj_location
+        = node_construct.node_location_emitter(
+          content_non_header,
+          tag_in_seg,
+          lev_anchor_tag,
+          tag_assoc,
+          obj_cite_digits,
+          cntr,
+          heading_ptr-1,
+          an_object["is"]
+        );
+      TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
+        = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
+      an_object["substantive"]                                = substantive_obj_misc_tuple[sObj.content];
+      anchor_tag                                              = substantive_obj_misc_tuple[sObj.anchor_tag];
+      comp_obj_block                                          = comp_obj_block.init;
+      comp_obj_block.metainfo.is_of_part                      = "body";
+      comp_obj_block.metainfo.is_of_section                   = "body";
+      comp_obj_block.metainfo.is_of_type                      = "block";
+      comp_obj_block.metainfo.is_a                            = "group";
+      comp_obj_block.metainfo.ocn                             = obj_cite_digits.object_number;
+      comp_obj_block.metainfo.identifier                      = obj_cite_digits.identifier;
+      comp_obj_block.metainfo.object_number_off               = obj_cite_digits.off;
+      comp_obj_block.metainfo.o_n_book_index                  = obj_cite_digits.bkidx;
+      comp_obj_block.metainfo.object_number_type              = obj_cite_digits.type;
+      comp_obj_block.metainfo.lang                            = an_object["lang"];
+      comp_obj_block.metainfo.attrib                          = an_object["attrib"];
+      comp_obj_block.tags.html_segment_anchor_tag_is          = tag_in_seg["seg_lv4"];
+      comp_obj_block.tags.epub_segment_anchor_tag_is          = tag_in_seg["seg_lv1to4"];
+      comp_obj_block.text                                     = an_object["substantive"];
+      comp_obj_block.has.inline_notes_reg                     = substantive_obj_misc_tuple[sObj.notes_reg];
+      comp_obj_block.has.inline_notes_star                    = substantive_obj_misc_tuple[sObj.notes_star];
+      comp_obj_block.has.inline_links                         = substantive_obj_misc_tuple[sObj.links];
+      the_document_body_section                               ~= comp_obj_block;
+      tag_assoc                                               = an_object.inline_para_link_anchor(tag_in_seg, tag_assoc);
+      pith["block_is"]                                        = eN.blk_is.poem;
+      pith["block_state"]                                     = eN.blk_state.off;
+      pith["block_delim"]                                     = eN.blk_delim.off;
+      object_reset(an_object);
+      processing.remove("verse");
+      ++cntr;
+    } else if (pith["block_is"] == eN.blk_is.block) {
+      obj_cite_digits = ocn_emit(pith["ocn"]);
+      an_object["bookindex_nugget"]
+        = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
+      bookindex_unordered_hashes
+        = bookindex_extract_hash.bookindex_nugget_hash(
+          an_object["bookindex_nugget"],
+          obj_cite_digits,
+          tag_in_seg
+        );
+      an_object["is"]                                         = "block";
+      auto comp_obj_location
+        = node_construct.node_location_emitter(
+          content_non_header,
+          tag_in_seg,
+          lev_anchor_tag,
+          tag_assoc,
+          obj_cite_digits,
+          cntr,
+          heading_ptr-1,
+          an_object["is"]
+        );
+      TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
+        = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
+      an_object["substantive"]                                = substantive_obj_misc_tuple[sObj.content];
+      // anchor_tag                                           = substantive_obj_misc_tuple[sObj.anchor_tag];
+      comp_obj_block                                          = comp_obj_block.init;
+      comp_obj_block.metainfo.is_of_part                      = "body";
+      comp_obj_block.metainfo.is_of_section                   = "body";
+      comp_obj_block.metainfo.is_of_type                      = "block";
+      comp_obj_block.metainfo.is_a                            = "block";
+      comp_obj_block.metainfo.ocn                             = obj_cite_digits.object_number;
+      comp_obj_block.metainfo.identifier                      = obj_cite_digits.identifier;
+      comp_obj_block.metainfo.object_number_off               = obj_cite_digits.off;
+      comp_obj_block.metainfo.o_n_book_index                  = obj_cite_digits.bkidx;
+      comp_obj_block.metainfo.object_number_type              = obj_cite_digit_type;
+      comp_obj_block.metainfo.lang                            = an_object["lang"];
+      comp_obj_block.metainfo.attrib                          = an_object["attrib"];
+      comp_obj_block.tags.html_segment_anchor_tag_is          = tag_in_seg["seg_lv4"];
+      comp_obj_block.tags.epub_segment_anchor_tag_is          = tag_in_seg["seg_lv1to4"];
+      comp_obj_block.text                                     = an_object["substantive"];
+      comp_obj_block.has.inline_notes_reg                     = substantive_obj_misc_tuple[sObj.notes_reg];
+      comp_obj_block.has.inline_notes_star                    = substantive_obj_misc_tuple[sObj.notes_star];
+      comp_obj_block.has.inline_links                         = substantive_obj_misc_tuple[sObj.links];
+      the_document_body_section                               ~= comp_obj_block;
+      pith["block_is"]                                        = eN.blk_is.block;
+      pith["block_state"]                                     = eN.blk_state.off;
+      pith["block_delim"]                                     = eN.blk_delim.off;
+      object_reset(an_object);
+      processing.remove("verse");
+      ++cntr;
+    } else if (pith["block_is"] == eN.blk_is.poem) {
+      an_object["bookindex_nugget"]
+        = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
+      bookindex_unordered_hashes
+        = bookindex_extract_hash.bookindex_nugget_hash(
+          an_object["bookindex_nugget"],
+          obj_cite_digits,
+          tag_in_seg
+        );
+      an_object["is"]                                         = "verse";
+      auto comp_obj_location
+        = node_construct.node_location_emitter(
+          content_non_header,
+          tag_in_seg,
+          lev_anchor_tag,
+          tag_assoc,
+          obj_cite_digits,
+          cntr,
+          heading_ptr-1,
+          an_object["is"]
+        );
+      comp_obj_poem_ocn                                       = comp_obj_poem_ocn.init;
+      comp_obj_poem_ocn.metainfo.is_of_part                   = "body";
+      comp_obj_poem_ocn.metainfo.is_of_section                = "body";
+      comp_obj_poem_ocn.metainfo.is_of_type                   = "block";
+      comp_obj_poem_ocn.metainfo.is_a                         = "poem";
+      comp_obj_poem_ocn.metainfo.ocn                          = obj_cite_digits.object_number;
+      comp_obj_poem_ocn.metainfo.identifier                   = obj_cite_digits.identifier;
+      comp_obj_poem_ocn.metainfo.object_number_off            = obj_cite_digits.off;
+      comp_obj_poem_ocn.metainfo.o_n_book_index               = obj_cite_digits.bkidx;
+      comp_obj_poem_ocn.metainfo.object_number_type           = obj_cite_digits.type;
+      comp_obj_poem_ocn.text                                  = "";
+      the_document_body_section                               ~= comp_obj_poem_ocn;
+      pith["block_is"]                                        = eN.blk_is.poem;
+      pith["block_state"]                                     = eN.blk_state.off;
+      pith["block_delim"]                                     = eN.blk_delim.off;
+      object_reset(an_object);
+      processing.remove("verse");
+    } else if (pith["block_is"] == eN.blk_is.code) {
+      obj_cite_digits = ocn_emit(pith["ocn"]);
+      an_object["bookindex_nugget"]
+        = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
+      bookindex_unordered_hashes
+        = bookindex_extract_hash.bookindex_nugget_hash(
+          an_object["bookindex_nugget"],
+          obj_cite_digits,
+          tag_in_seg
+        );
+      an_object["is"]                                         = "code";
+      auto comp_obj_location
+        = node_construct.node_location_emitter(
+          content_non_header,
+          tag_in_seg,
+          lev_anchor_tag,
+          tag_assoc,
+          obj_cite_digits,
+          cntr,
+          heading_ptr-1,
+          an_object["is"]
+        );
+      TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
+        = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
+      an_object["substantive"]                                = substantive_obj_misc_tuple[sObj.content];
+      anchor_tag                                              = substantive_obj_misc_tuple[sObj.anchor_tag];
+      comp_obj_code                                           = comp_obj_code.init;
+      comp_obj_code.metainfo.is_of_part                       = "body";
+      comp_obj_code.metainfo.is_of_section                    = "body";
+      comp_obj_code.metainfo.is_of_type                       = "block";
+      comp_obj_code.metainfo.is_a                             = "code";
+      comp_obj_code.metainfo.ocn                              = obj_cite_digits.object_number;
+      comp_obj_code.metainfo.identifier                       = obj_cite_digits.identifier;
+      comp_obj_code.metainfo.object_number_off                = obj_cite_digits.off;
+      comp_obj_code.metainfo.o_n_book_index                   = obj_cite_digits.bkidx;
+      comp_obj_code.metainfo.object_number_type               = obj_cite_digits.type;
+      comp_obj_code.metainfo.syntax                           = an_object["syntax"];
+      comp_obj_code.metainfo.attrib                           = an_object["attrib"];
+      comp_obj_code.code_block.linenumbers                    = (an_object["attrib"].match(rgx.code_numbering)) ? true : false;
+      comp_obj_code.tags.html_segment_anchor_tag_is           = tag_in_seg["seg_lv4"];
+      comp_obj_code.tags.epub_segment_anchor_tag_is           = tag_in_seg["seg_lv1to4"];
+      comp_obj_code.text                                      = an_object["substantive"];
+      comp_obj_code.has.inline_notes_reg                      = substantive_obj_misc_tuple[sObj.notes_reg];
+      comp_obj_code.has.inline_notes_star                     = substantive_obj_misc_tuple[sObj.notes_star];
+      comp_obj_code.has.inline_links                          = substantive_obj_misc_tuple[sObj.links];
+      the_document_body_section                               ~= comp_obj_code;
+      pith["block_is"]                                        = eN.blk_is.code;
+      pith["block_state"]                                     = eN.blk_state.off;
+      pith["block_delim"]                                     = eN.blk_delim.off;
+      object_reset(an_object);
+      processing.remove("verse");
+      ++cntr;
+    } else if (pith["block_is"]    == eN.blk_is.table) {
+      comp_obj_block = comp_obj_block.init;
+      obj_cite_digits = ocn_emit(pith["ocn"]);
+      an_object["bookindex_nugget"]
+        = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
+      bookindex_unordered_hashes
+        = bookindex_extract_hash.bookindex_nugget_hash(
+          an_object["bookindex_nugget"],
+          obj_cite_digits,
+          tag_in_seg
+        );
+      an_object["is"]                                         = "table";
+      auto comp_obj_location
+        = node_construct.node_location_emitter(
+          content_non_header,
+          tag_in_seg,
+          lev_anchor_tag,
+          tag_assoc,
+          obj_cite_digits,
+          cntr,
+          heading_ptr-1,
+          an_object["is"]
+        );
+      TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
+        = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
+      an_object["substantive"]                                = substantive_obj_misc_tuple[sObj.content];
+      comp_obj_block                                          = comp_obj_block.init;
+      comp_obj_block.metainfo.ocn                             = obj_cite_digits.object_number;
+      comp_obj_block.metainfo.identifier                      = obj_cite_digits.identifier;
+      comp_obj_block.metainfo.object_number_off               = obj_cite_digits.off;
+      comp_obj_block.tags.html_segment_anchor_tag_is          = tag_in_seg["seg_lv4"];
+      comp_obj_block.tags.epub_segment_anchor_tag_is          = tag_in_seg["seg_lv1to4"];
+      comp_obj_block.metainfo.o_n_book_index                  = obj_cite_digits.bkidx;
+      comp_obj_block.metainfo.object_number_type              = obj_cite_digits.type;
+      comp_obj_block                                          = comp_obj_block.flow_table_instructions(an_object["table_head"]);
+      {
+        auto _get = comp_obj_block.flow_table_substantive_munge(an_object["substantive"]);
+        {
+          comp_obj_block           = _get.table_object;
+          an_object["substantive"] = _get.table_substantive;
+        }
+      }
+      the_document_body_section                               ~= comp_obj_block;
+      pith["block_is"]                                        = eN.blk_is.table;
+      pith["block_state"]                                     = eN.blk_state.off;
+      pith["block_delim"]                                     = eN.blk_delim.off;
+      object_reset(an_object);
+      processing.remove("verse");
+      ++cntr;
+    }
+  }
+  struct retStruct {
+    string[string]           this_object;
+    ObjGenericComposite[]    the_document_body_section;
+    string[][string][string] bookindex_unordered_hashes;
+    OCNset                   obj_cite_digits;
+    ObjGenericComposite      comp_obj_heading;
+    int                      cntr;
+    uint[string]             pith;
+  }
+  retStruct ret;
+  {
+    ret.this_object                = an_object;
+    ret.the_document_body_section  = the_document_body_section;
+    ret.bookindex_unordered_hashes = bookindex_unordered_hashes;
+    ret.obj_cite_digits            = obj_cite_digits;
+    ret.comp_obj_heading           = _comp_obj_heading; //
+    ret.cntr                       = cntr;
+    ret.pith                       = pith;
+  }
+  return ret;
+}
+@system auto flow_book_index_(B)(
+  char[]          line,
+  string[string]  an_object,
+  string          book_idx_tmp,
+  uint[string]    pith,
+  B               opt_action,
 ) {
   static auto rgx = RgxI();
   if (auto m = line.match(rgx.book_index_item)) {                                   /+ match book_index +/
@@ -4997,21 +4249,25 @@ if (pith["block_is"] == eN.blk_is.quote) {
       }
     }
   }
-  return an_object;
-}
-#+END_SRC
-
-*** heading or paragraph :heading:paragraph:
-**** heading found :heading:
-
-#+NAME: abs_functions_heading_found
-#+BEGIN_SRC d
-@safe string[string] flow_heading_found_()(
-             char[]                line,
-             string[string]        heading_match_str,
-             string[]              _make_unmarked_headings,
-  return ref Regex!(char)[string]  heading_match_rgx,
-  return ref uint[string]          pith,
+  struct retStruct {
+    string[string]  this_object;
+    uint[string]    pith;
+    string          book_idx_tmp;
+  }
+  retStruct ret;
+  {
+    ret.this_object    = an_object;
+    ret.pith           = pith;
+    ret.book_idx_tmp   = book_idx_tmp;
+  }
+  return ret;
+}
+@safe auto flow_heading_found_()(
+  char[]                line,
+  string[string]        heading_match_str,
+  string[]              _make_unmarked_headings,
+  Regex!(char)[string]  heading_match_rgx,
+  uint[string]          pith,
 ) {
   static auto rgx = RgxI();
   if ((_make_unmarked_headings.length > 2)
@@ -5085,15 +4341,20 @@ if (pith["block_is"] == eN.blk_is.quote) {
     }
     pith["make_headings"] = eN.bi.on;
   }
-  return heading_match_str;
+  struct retStruct {
+    string[string]       heading_match_str;
+    Regex!(char)[string] heading_match_rgx;
+    uint[string]         pith;
+  }
+  retStruct ret;
+  {
+    ret.heading_match_str = heading_match_str;
+    ret.heading_match_rgx = heading_match_rgx;
+    ret.pith              = pith;
+  }
+  return ret;
 }
-#+END_SRC
-
-**** heading make set :heading:
-
-#+NAME: abs_functions_heading_make_set
-#+BEGIN_SRC d
-@safe char[] flow_heading_make_set_()(
+@safe auto flow_heading_make_set_()(
              char[]                line,
              int[string]           line_occur,
   return ref Regex!(char)[string]  heading_match_rgx,
@@ -5147,23 +4408,28 @@ if (pith["block_is"] == eN.blk_is.quote) {
       }
     }
   }
-  return line;
+  struct retStruct {
+    char[]          line;
+    uint[string]    pith;
+    string[string]  this_object;
+  }
+  retStruct ret;
+  {
+    ret.line           = line;
+    ret.pith           = pith;
+    ret.this_object    = an_object;
+  }
+  return ret;
 }
-#+END_SRC
-
-**** heading match :heading:
-
-#+NAME: abs_functions_heading_matched
-#+BEGIN_SRC d
-@safe string[string] flow_heading_matched_(CMM)(
-             char[]          line,
-             string[string]  an_object,
-  return ref int[string]     line_occur,
-  return ref string          an_object_key,
-  return ref int[string]     lv,
-  return ref int[string]     collapsed_lev,
-  return ref uint[string]    pith,
-  return ref CMM             conf_make_meta,
+@safe auto flow_heading_matched_(CMM)(
+  char[]          line,
+  string[string]  an_object,
+  int[string]     line_occur,
+  string          an_object_key,
+  int[string]     lv,
+  int[string]     collapsed_lev,
+  uint[string]    pith,
+  CMM             conf_make_meta,
 ) {
   static auto rgx = RgxI();
   static auto mkup = InlineMarkup();
@@ -5325,22 +4591,35 @@ if (pith["block_is"] == eN.blk_is.quote) {
       writeln(line.strip);
     }
   }
-  return an_object;
-}
-#+END_SRC
-
-**** para match :para:
-
-#+NAME: abs_functions_para_matched
-#+BEGIN_SRC d
-@safe string[string] flow_para_match_()(
-             char[]         line,
-             string[string]  an_object,
-  return ref string          an_object_key,
-  return ref int[string]     indent,
-  return ref bool            bullet,
-  return ref uint[string]    pith,
-  return ref int[string]     line_occur,
+  struct retStruct {
+    string[string]  this_object;
+    int[string]     line_occur;
+    string          an_object_key;
+    int[string]     lv;
+    int[string]     collapsed_lev;
+    uint[string]    pith;
+    CMM             conf_make_meta;
+  }
+  retStruct ret;
+  {
+    ret.this_object    = an_object;
+    ret.line_occur     = line_occur;
+    ret.an_object_key  = an_object_key;
+    ret.lv             = lv;
+    ret.collapsed_lev  = collapsed_lev;
+    ret.pith           = pith;
+    ret.conf_make_meta = conf_make_meta;
+  }
+  return ret;
+}
+@safe auto flow_para_match_()(
+  char[]         line,
+  string[string]  an_object,
+  string          an_object_key,
+  int[string]     indent,
+  bool            bullet,
+  uint[string]    pith,
+  int[string]     line_occur,
 ) {
   static auto rgx = RgxI();
   if (line_occur["para"] == eN.bi.off) {
@@ -5384,14 +4663,25 @@ if (pith["block_is"] == eN.blk_is.quote) {
     }
     ++line_occur["para"];
   }
-  return an_object;
+  struct retStruct {
+    uint[string]    pith;
+    string[string]  this_object;
+    string          this_object_key;
+    int[string]     indent;
+    bool            bullet;
+    int[string]     line_occur;
+  }
+  retStruct ret;
+  {
+    ret.pith            = pith;
+    ret.this_object     = an_object;
+    ret.this_object_key = an_object_key;
+    ret.indent          = indent;
+    ret.bullet          = bullet;
+    ret.line_occur      = line_occur;
+  }
+  return ret;
 }
-#+END_SRC
-
-**** text font face
-
-#+NAME: abs_functions_para_font_faces_line
-#+BEGIN_SRC d
 @safe char[] font_faces_line()(
   char[]  textline,
 ) {
@@ -5414,24 +4704,9 @@ if (pith["block_is"] == eN.blk_is.quote) {
   }
   return textline;
 }
-#+END_SRC
-
-**** tables
-
-- number of columns
-- column widths (either as given or uniform, first often different from rest)
-- column aligns (as given else default left for text, check whether can default right for digits)
-- table heading (auto align left)
-- table walls
-- TODO need to be able to align columns left or right (digits)
-
-***** table instructions
-
-#+NAME: abs_functions_table_instructions
-#+BEGIN_SRC d
 @safe ObjGenericComposite flow_table_instructions(H)(
-  return ref ObjGenericComposite  table_object,
-             H                    table_head,
+  ObjGenericComposite  table_object,
+  H                    table_head,
 ) {
   static auto rgx = RgxI();
   table_object.metainfo.is_of_part        = "body";
@@ -5454,15 +4729,9 @@ if (pith["block_is"] == eN.blk_is.quote) {
   }
   return table_object;
 }
-#+END_SRC
-
-***** table array munge
-
-#+NAME: abs_functions_table_munge_array
-#+BEGIN_SRC d
-@safe ObjGenericComposite flow_table_array_munge(T)(
-  return ref ObjGenericComposite  table_object,
-  return ref T                    table_array,
+@safe auto flow_table_array_munge()(
+  ObjGenericComposite  table_object,
+  string[][]           table_array,
 ) {
   static auto rgx = RgxI();
   static auto mng = InlineMarkup();
@@ -5497,26 +4766,24 @@ if (pith["block_is"] == eN.blk_is.quote) {
       }
       col_num_ = idx_c;
       _table_substantive ~= col ~ mng.tc_s;
-      if (idx_r == 0 && comp_obj_block.table.heading) {
+      if (idx_r == 0 && table_object.table.heading) {
       } else if (col.match(rgx.numeric_col) && idx_r == 1) { // conditions reversed to avoid: gdc compiled program run segfault
-        if ((comp_obj_block.table.column_aligns.length > idx_c)
-        && (comp_obj_block.table.column_aligns[idx_c].matchFirst(rgx.table_col_align_match))) {
-          comp_obj_block.table.column_aligns[idx_c]
-            = comp_obj_block.table.column_aligns[idx_c];
-        } else if (comp_obj_block.table.column_aligns.length > idx_c) {
-          comp_obj_block.table.column_aligns[idx_c] = "r";
+        if ((table_object.table.column_aligns.length > idx_c)
+        && (table_object.table.column_aligns[idx_c].matchFirst(rgx.table_col_align_match))) {
+          table_object.table.column_aligns[idx_c] = table_object.table.column_aligns[idx_c];
+        } else if (table_object.table.column_aligns.length > idx_c) {
+          table_object.table.column_aligns[idx_c] = "r";
         } else {
-          comp_obj_block.table.column_aligns ~= "r";
+          table_object.table.column_aligns ~= "r";
         }
       } else if (idx_r == 1) {
-        if ((comp_obj_block.table.column_aligns.length > idx_c)
-        && (comp_obj_block.table.column_aligns[idx_c].matchFirst(rgx.table_col_align_match))) {
-          comp_obj_block.table.column_aligns[idx_c]
-            = comp_obj_block.table.column_aligns[idx_c];
-        } else if (comp_obj_block.table.column_aligns.length > idx_c) {
-          comp_obj_block.table.column_aligns[idx_c] = "l";
+        if ((table_object.table.column_aligns.length > idx_c)
+        && (table_object.table.column_aligns[idx_c].matchFirst(rgx.table_col_align_match))) {
+          table_object.table.column_aligns[idx_c] = table_object.table.column_aligns[idx_c];
+        } else if (table_object.table.column_aligns.length > idx_c) {
+          table_object.table.column_aligns[idx_c] = "l";
         } else {
-          comp_obj_block.table.column_aligns ~= "l";
+          table_object.table.column_aligns ~= "l";
         }
       }
     }
@@ -5530,12 +4797,12 @@ if (pith["block_is"] == eN.blk_is.quote) {
     }
     _table_substantive = _table_substantive.replaceFirst(rgx.table_col_separator_nl, "\n");
   }
-  if (comp_obj_block.table.number_of_columns != col_num) {
-    if (comp_obj_block.table.number_of_columns == 0) {
-      comp_obj_block.table.number_of_columns = (col_num).to!int;
+  if (table_object.table.number_of_columns != col_num) {
+    if (table_object.table.number_of_columns == 0) {
+      table_object.table.number_of_columns = (col_num).to!int;
     } else {
       debug(table_dev) {
-        writeln(comp_obj_block.table.number_of_columns, " != ", col_num);
+        writeln(table_object.table.number_of_columns, " != ", col_num);
       }
     }
   }
@@ -5575,67 +4842,88 @@ if (pith["block_is"] == eN.blk_is.quote) {
     writeln(_table_substantive);
   }
   debug(table_res) {
-    writeln("aligns: ", comp_obj_block.table.column_aligns, "\n",
-      "no. of columns: ", comp_obj_block.table.number_of_columns, "\n",
-      "col widths: ", comp_obj_block.table.column_widths,
-        " sum: ", comp_obj_block.table.column_widths.sum, "\n",
+    writeln("aligns: ", table_object.table.column_aligns, "\n",
+      "no. of columns: ", table_object.table.number_of_columns, "\n",
+      "col widths: ", table_object.table.column_widths,
+        " sum: ", table_object.table.column_widths.sum, "\n",
       _table_substantive);
   }
-  comp_obj_block.text = _table_substantive;
-  return table_object;
+  table_object.text = _table_substantive;
+  struct retStruct {
+    ObjGenericComposite table_object;
+    string[][]          table_array;
+  }
+  retStruct ret;
+  {
+    ret.table_object      = table_object;
+    ret.table_array       = table_array;
+  }
+  return ret;
 }
-#+END_SRC
-
-***** table substantive munge
-
-#+NAME: abs_functions_table_munge_substantive
-#+BEGIN_SRC d
-@system ObjGenericComposite flow_table_substantive_munge(T)(
-  return ref ObjGenericComposite  table_object,
-  return ref T                    table_substantive,
+@system auto flow_table_substantive_munge()(
+  ObjGenericComposite  table_object,
+  string               table_substantive,
 ) {
   static auto rgx = RgxI();
   static auto munge = ObjInlineMarkupMunge();
   string[] _table_rows = (table_substantive).split(rgx.table_row_delimiter);
   string[] _table_cols;
-  string[][] _table;
+  string[][] _table_array;
   foreach(col; _table_rows) {
     _table_cols = col.split(rgx.table_col_delimiter);
-    _table ~= _table_cols;
+    _table_array ~= _table_cols;
   }
-  table_object = table_object.flow_table_array_munge(_table);
-  return table_object;
+  {
+    auto _get = table_object.flow_table_array_munge(_table_array);
+    {
+      table_object = _get.table_object;
+      _table_array = _get.table_array; // what do you do with this? how is this passed down?
+    }
+  }
+  struct retStruct {
+    ObjGenericComposite  table_object;
+    string               table_substantive;
+  }
+  retStruct ret;
+  {
+    ret.table_object      = table_object;
+    ret.table_substantive = table_substantive; // has anything been changed here?
+  }
+  return ret;
 }
-#+END_SRC
-
-***** table substantive munge special
-
-#+NAME: abs_functions_table_munge_substantive_special
-#+BEGIN_SRC d
-@system ObjGenericComposite flow_table_substantive_munge_special(T)(
-  return ref ObjGenericComposite  table_object,
-  return ref T                    table_substantive,
+@system auto flow_table_substantive_munge_special()(
+  ObjGenericComposite  table_object,
+  string               table_substantive,
 ) {
   static auto rgx = RgxI();
   static auto munge = ObjInlineMarkupMunge();
   string[] _table_rows = (table_substantive).split(rgx.table_row_delimiter_special);
   string[] _table_cols;
-  string[][] _table;
+  string[][] _table_array;
   foreach(col; _table_rows) {
     _table_cols = col.split(rgx.table_col_delimiter_special);
-    _table ~= _table_cols;
+    _table_array ~= _table_cols;
   }
-  table_object = table_object.flow_table_array_munge(_table);
-  return table_object;
+  {
+    auto _get = table_object.flow_table_array_munge(_table_array);
+    {
+      table_object = _get.table_object;
+      _table_array = _get.table_array;
+    }
+  }
+  struct retStruct {
+    ObjGenericComposite  table_object;
+    string               table_substantive;
+  }
+  retStruct ret;
+  {
+    ret.table_object      = table_object;
+    ret.table_substantive = table_substantive;
+  }
+  return ret;
 }
-#+END_SRC
-
-*** function emitters :emitters:
-**** object :object:
-***** ocn :ocn:
-
-#+NAME: meta_emitters_ocn
-#+BEGIN_SRC d
+/+ abstraction functions ↑ +/
+/+ ↓ abstraction function emitters +/
 @safe pure struct OCNemitter {
   int ocn_digit, ocn_object_number, ocn_on_, ocn_off_, ocn_bkidx, ocn_bkidx_;
   string object_identifier;
@@ -5684,13 +4972,7 @@ if (pith["block_is"] == eN.blk_is.quote) {
   invariant() {
   }
 }
-#+END_SRC
-
-***** object inline markup munge :markup:inline:
-****** { struct, inline markup munge
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_open
-#+BEGIN_SRC d
+                                                                              /+ +/
 @safe static struct ObjInlineMarkupMunge {
   string[string] obj_txt;
   int n_foot, n_foot_reg, n_foot_sp_asterisk, n_foot_sp_plus;
@@ -5705,1108 +4987,827 @@ if (pith["block_is"] == eN.blk_is.quote) {
     n_foot_sp_asterisk              = 0;
     n_foot_sp_plus                  = 0;
   }
-#+END_SRC
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_markup_images
-#+BEGIN_SRC d
-@safe static auto images()(string obj_txt_in) {
-  static auto mng = InlineMarkup();
-  /+ url matched +/
-  obj_txt_in = obj_txt_in.replaceAll(rgx.inline_notes_al_special, ""); // TODO reinstate when special footnotes are implemented
-  if (obj_txt_in.match(rgx.smid_image_generic)) {                            /+ images with and without links +/
-    debug(images) {
-      writeln("Image: ", obj_txt_in);
-    }
-    if (obj_txt_in.match(rgx.smid_image_with_dimensions)) {
-      obj_txt_in = obj_txt_in
-        .replaceAll(rgx.smid_image_with_dimensions, ("$1" ~ mkup.img ~ "$2,w$3h$4 " ~ "$5"))
-        .replaceAll(rgx.smid_image_delimit, ("$1"
-          ~ mkup.lnk_o ~ "$2".strip ~ mkup.lnk_c
-          ~ mkup.url_o ~ mkup.url_c));
+  @safe static auto images()(string obj_txt_in) {
+    static auto mng = InlineMarkup();
+    /+ url matched +/
+    obj_txt_in = obj_txt_in.replaceAll(rgx.inline_notes_al_special, ""); // TODO reinstate when special footnotes are implemented
+    if (obj_txt_in.match(rgx.smid_image_generic)) {                            /+ images with and without links +/
       debug(images) {
-        writeln("IMAGE with size: ", obj_txt_in);
-      }
-    } else if (obj_txt_in.match(rgx.smid_image)) {
-      obj_txt_in = obj_txt_in
-        .replaceAll(rgx.smid_image, ("$1" ~ mkup.img ~ "$2,w0h0" ~ "$3"))
-        .replaceAll(rgx.smid_image_delimit, ("$1"
-          ~ mkup.lnk_o ~ "$2".strip ~ mkup.lnk_c
-          ~ mkup.url_o ~ mkup.url_c));
-      debug(images) {
-        writeln("IMAGE: ", obj_txt_in); // decide on representation
+        writeln("Image: ", obj_txt_in);
+      }
+      if (obj_txt_in.match(rgx.smid_image_with_dimensions)) {
+        obj_txt_in = obj_txt_in
+          .replaceAll(rgx.smid_image_with_dimensions, ("$1" ~ mkup.img ~ "$2,w$3h$4 " ~ "$5"))
+          .replaceAll(rgx.smid_image_delimit, ("$1"
+            ~ mkup.lnk_o ~ "$2".strip ~ mkup.lnk_c
+            ~ mkup.url_o ~ mkup.url_c));
+        debug(images) {
+          writeln("IMAGE with size: ", obj_txt_in);
+        }
+      } else if (obj_txt_in.match(rgx.smid_image)) {
+        obj_txt_in = obj_txt_in
+          .replaceAll(rgx.smid_image, ("$1" ~ mkup.img ~ "$2,w0h0" ~ "$3"))
+          .replaceAll(rgx.smid_image_delimit, ("$1"
+            ~ mkup.lnk_o ~ "$2".strip ~ mkup.lnk_c
+            ~ mkup.url_o ~ mkup.url_c));
+        debug(images) {
+          writeln("IMAGE: ", obj_txt_in); // decide on representation
+        }
       }
     }
+    return obj_txt_in;
   }
-  return obj_txt_in;
-}
-#+END_SRC
-
-******* footnotes endnotes markup
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_markup_footnotes_endnotes
-#+BEGIN_SRC d
-@safe TxtPlusHasFootnotes footnotes_endnotes_markup_and_number_or_stars()(string obj_txt_in, bool reset_note_numbers) {
-  /+ endnotes (regular) +/
-  bool flg_notes_reg  = false;
-  bool flg_notes_star = false;
-  bool flg_notes_plus = false;
-  obj_txt_in = obj_txt_in.replaceAll(
-    rgx.inline_notes_curly,
-    (mkup.en_a_o ~ " $1" ~ mkup.en_a_c)
-  );
-  if (!(stage_reset_note_numbers) && reset_note_numbers) {
-    stage_reset_note_numbers = true;
-  }
-  obj_txt_out = "";
-  if (obj_txt_in.match(rgx.inline_notes_al_gen)) {
-    string[] _tmp_txt;
-    foreach (x; obj_txt_in.split("\n")) {
-      if (auto m = x.matchAll(rgx.inline_text_and_note_al_)) {
-        if (stage_reset_note_numbers) {
-          n_foot                  = 0;
-          n_foot_reg              = 0;
-          n_foot_sp_asterisk      = 0;
-          n_foot_sp_plus          = 0;
-        }
-        stage_reset_note_numbers = false;
-        foreach(n; m) {
-          if (n.hit.to!string.match(rgx.inline_al_delimiter_open_symbol_star)) {
-            flg_notes_star =  true;
-            ++n_foot_sp_asterisk;
-            asterisks_ = "*";
-            n_foot = n_foot_sp_asterisk;
-            _tmp_txt ~= n.hit.to!string.replaceFirst(
-              rgx.inline_al_delimiter_open_symbol_star,
-              (mkup.en_a_o ~ replicate(asterisks_, n_foot_sp_asterisk) ~ " ")
-            );
-          } else if (n.hit.to!string.match(rgx.inline_al_delimiter_open_symbol_plus)) {
-            flg_notes_plus =  true;
-            ++n_foot_sp_plus;
-            plus_ = "*";
-            n_foot = n_foot_sp_plus;
-            _tmp_txt ~= n.hit.to!string.replaceFirst(
-              rgx.inline_al_delimiter_open_symbol_plus,
-              (mkup.en_a_o ~ replicate(plus_, n_foot_sp_plus) ~ " ")
-            );
-          } else if (n.hit.to!string.matchFirst(rgx.inline_al_delimiter_open_regular)) {
-            string _tmp_str = n.hit.to!string;
-            flg_notes_reg =  true;
-            foreach (q; n.hit.to!string.matchAll(rgx.inline_al_delimiter_open_regular)) {
-              ++n_foot_reg;
-              n_foot = n_foot_reg;
-              _tmp_str = replaceFirst!(m => mkup.en_a_o ~ n_foot.to!string ~ " ")
-                (_tmp_str, rgx.inline_al_delimiter_open_regular);
+  @safe TxtPlusHasFootnotes footnotes_endnotes_markup_and_number_or_stars()(string obj_txt_in, bool reset_note_numbers) {
+    /+ endnotes (regular) +/
+    bool flg_notes_reg  = false;
+    bool flg_notes_star = false;
+    bool flg_notes_plus = false;
+    obj_txt_in = obj_txt_in.replaceAll(
+      rgx.inline_notes_curly,
+      (mkup.en_a_o ~ " $1" ~ mkup.en_a_c)
+    );
+    if (!(stage_reset_note_numbers) && reset_note_numbers) {
+      stage_reset_note_numbers = true;
+    }
+    obj_txt_out = "";
+    if (obj_txt_in.match(rgx.inline_notes_al_gen)) {
+      string[] _tmp_txt;
+      foreach (x; obj_txt_in.split("\n")) {
+        if (auto m = x.matchAll(rgx.inline_text_and_note_al_)) {
+          if (stage_reset_note_numbers) {
+            n_foot                  = 0;
+            n_foot_reg              = 0;
+            n_foot_sp_asterisk      = 0;
+            n_foot_sp_plus          = 0;
+          }
+          stage_reset_note_numbers = false;
+          foreach(n; m) {
+            if (n.hit.to!string.match(rgx.inline_al_delimiter_open_symbol_star)) {
+              flg_notes_star =  true;
+              ++n_foot_sp_asterisk;
+              asterisks_ = "*";
+              n_foot = n_foot_sp_asterisk;
+              _tmp_txt ~= n.hit.to!string.replaceFirst(
+                rgx.inline_al_delimiter_open_symbol_star,
+                (mkup.en_a_o ~ replicate(asterisks_, n_foot_sp_asterisk) ~ " ")
+              );
+            } else if (n.hit.to!string.match(rgx.inline_al_delimiter_open_symbol_plus)) {
+              flg_notes_plus =  true;
+              ++n_foot_sp_plus;
+              plus_ = "*";
+              n_foot = n_foot_sp_plus;
+              _tmp_txt ~= n.hit.to!string.replaceFirst(
+                rgx.inline_al_delimiter_open_symbol_plus,
+                (mkup.en_a_o ~ replicate(plus_, n_foot_sp_plus) ~ " ")
+              );
+            } else if (n.hit.to!string.matchFirst(rgx.inline_al_delimiter_open_regular)) {
+              string _tmp_str = n.hit.to!string;
+              flg_notes_reg =  true;
+              foreach (q; n.hit.to!string.matchAll(rgx.inline_al_delimiter_open_regular)) {
+                ++n_foot_reg;
+                n_foot = n_foot_reg;
+                _tmp_str = replaceFirst!(m => mkup.en_a_o ~ n_foot.to!string ~ " ")
+                  (_tmp_str, rgx.inline_al_delimiter_open_regular);
+              }
+              _tmp_txt ~= _tmp_str;
+            } else {
+              _tmp_txt ~= n.hit.to!string;
             }
-            _tmp_txt ~= _tmp_str;
-          } else {
-            _tmp_txt ~= n.hit.to!string;
           }
+          obj_txt_out = _tmp_txt.join("\n");
         }
-        obj_txt_out = _tmp_txt.join("\n");
       }
+    } else {
+      obj_txt_out = obj_txt_in;
     }
-  } else {
-    obj_txt_out = obj_txt_in;
+    TxtPlusHasFootnotes t = tuple(
+      obj_txt_out,
+      flg_notes_reg,
+      flg_notes_star,
+      flg_notes_plus,
+    );
+    return t;
   }
-  TxtPlusHasFootnotes t = tuple(
-    obj_txt_out,
-    flg_notes_reg,
-    flg_notes_star,
-    flg_notes_plus,
-  );
-  return t;
-}
-#+END_SRC
-
-******* object notes and links
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_object_notes_and_links
-#+BEGIN_SRC d
-@safe private TxtPlusHasFootnotesUrlsImages object_notes_and_links_()(
-  string obj_txt_in,
-  bool reset_note_numbers = false
-) {
-  obj_txt_out = "";
-  bool urls = false;
-  bool images_without_dimensions = false;
-  tail = "";
-  /+ special endnotes +/
-  obj_txt_in = obj_txt_in.replaceAll(
-    rgx.inline_notes_curly_sp_asterisk,
-    (mkup.en_a_o ~ "*" ~ " $1" ~ mkup.en_a_c)
-  );
-  obj_txt_in
-    = obj_txt_in.replaceAll(
-      rgx.inline_notes_curly_sp_plus,
-      (mkup.en_a_o ~ "+" ~ " $1" ~ mkup.en_a_c)
+  @safe private TxtPlusHasFootnotesUrlsImages object_notes_and_links_()(
+    string obj_txt_in,
+    bool reset_note_numbers = false
+  ) {
+    obj_txt_out = "";
+    bool urls = false;
+    bool images_without_dimensions = false;
+    tail = "";
+    /+ special endnotes +/
+    obj_txt_in = obj_txt_in.replaceAll(
+      rgx.inline_notes_curly_sp_asterisk,
+      (mkup.en_a_o ~ "*" ~ " $1" ~ mkup.en_a_c)
     );
-  /+ image matched +/
-  if (obj_txt_in.match(rgx.smid_image_generic)) {
-    obj_txt_in = images(obj_txt_in);
-    if (obj_txt_in.match(rgx.smid_mod_image_without_dimensions)) {
-      images_without_dimensions = true;
-    }
-  }
-  /+ url matched +/
-  if (obj_txt_in.match(rgx.smid_inline_url)) {
-    urls = true;
-    obj_txt_in = obj_txt_in.links_and_images;
-  }
-  if (auto m = obj_txt_in.match(rgx.para_inline_link_anchor)) {
-    obj_txt_in = obj_txt_in
-      .replaceAll(rgx.para_inline_link_anchor, "┃$1┃");
-  }
-  TxtPlusHasFootnotes ftn = footnotes_endnotes_markup_and_number_or_stars(obj_txt_in, reset_note_numbers);
-  obj_txt_out = ftn.obj_txt;
-  debug(footnotes) {
-    writeln(obj_txt_out, tail);
-  }
-  obj_txt_out = obj_txt_out ~ tail;
-  debug(footnotesdone) {
-    foreach(m; matchAll(obj_txt_out,
-    (mkup.en_a_o ~ `\s*(.+?)` ~ mkup.en_a_c))) {
-      writeln(m[1]);
-      writeln(m.hit);
-    }
-  }
-  TxtPlusHasFootnotesUrlsImages t = tuple(
-    obj_txt_out,
-    ftn.has_notes_reg,
-    ftn.has_notes_star,
-    ftn.has_notes_plus,
-    urls,
-    images_without_dimensions,
-  );
-  return t;
-}
-auto init() {
-  TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_("");
-  return t;
-}
-invariant() {
-}
-#+END_SRC
-
-******* heading
-
-- identified text by heading level marker followed by text until two new lines
-- general markup subset
-  - attributes (heading)
-    - heading level
-  - inline markup
-    - font faces (bold, italics, underscore etc.)
-    - footnotes/endnotes
-    - links?
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_heading
-#+BEGIN_SRC d
-@safe auto munge_heading()(
-  string obj_txt_in,
-  bool reset_note_numbers = false
-) {
-  obj_txt["munge"] = obj_txt_in
-   .replaceFirst(rgx.headings, "")
-   .replaceFirst(rgx.object_number_off_all, "")
-   .replaceFirst(rgx.markup_inline_linebreak, mkup.br_line_inline)
-   .strip;
-  TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt["munge"], reset_note_numbers);
-  debug(munge) {
-    writeln(__LINE__);
-    writeln(obj_txt_in);
-    writeln(__LINE__);
-    writeln(obj_txt["munge"].to!string);
-  }
-  return t;
-}
-invariant() {
-}
-#+END_SRC
-
-******* para
-
-- paragraph the default form of text, text without other identification until two new lines
-- general markup
-  - attributes (para)
-    - paragraph attributes (indent markup, bullet indent, etc.)
-  - inline markup
-    - font faces (bold, italics, underscore etc.)
-    - footnotes/endnotes
-    - links
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_para
-#+BEGIN_SRC d
-@safe auto munge_para()(string obj_txt_in) {
-  obj_txt["munge"] = (obj_txt_in)
-    .replaceFirst(rgx.para_attribs, "")
-    .replaceFirst(rgx.object_number_off_all, "")
-    .replaceFirst(rgx.markup_inline_linebreak, mkup.br_line_inline);
-  TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt["munge"]);
-  debug(munge) {
-    writeln(__LINE__);
-    writeln(obj_txt_in);
-    writeln(__LINE__);
-    writeln(obj_txt["munge"].to!string);
-  }
-  return t;
-}
-#+END_SRC
-
-******* quote WORKON
-
-- quote block identified by open an close tags
-- general markup subset
-  - NO standard (para) attributes
-  - inline markup
-    - font faces (bold, italics, underscore etc.)
-    - footnotes/endnotes
-    - links
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_quote
-#+BEGIN_SRC d
-@safe auto munge_quote()(string obj_txt_in) {
-  TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt_in.split("\n\n").join(" \\\\\n \\\\\n"));
-  // TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt_in);
-  return t;
-}
-invariant() {
-}
-#+END_SRC
-
-******* group
-
-- group block identified by open an close tags
-- general markup
-  - NO standard (para) attributes
-  - inline markup
-    - (indent markup, bullet indent [usually para attributes]) kept as inline markup [not available as paragraph attributes, requires bespoke processing (for group text) downstream]
-    - font faces (bold, italics, underscore etc.)
-    - footnotes/endnotes
-    - links
-- drop spaces
-- keep newlines?
-  - drop linebreaks (single newlines),
-  - keep parabreaks (double newlines) apply paragraph attributes
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_group
-#+BEGIN_SRC d
-@safe auto munge_group(string obj_txt_in) {
-  TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt_in.split("\n\n").join("\n" ~ mkup.br_line_spaced ~ "\n")); // br_line br_line_inline br_line_spaced
-  return t;
-}
-invariant() {
-}
-#+END_SRC
-
-******* block
-
-- group block identified by open an close tags
-- general markup subset
-  - NO standard (para) attributes
-  - inline markup
-    - font faces (bold, italics, underscore etc.)
-    - footnotes/endnotes
-    - links
-- keep newlines & spaces
-  - spaces
-  - newlines?
-    - newlines detected and kept?
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_block
-#+BEGIN_SRC d
-@safe auto munge_block()(string obj_txt_in) {
-  TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt_in);
-  return t;
-}
-invariant() {
-}
-#+END_SRC
-
-******* verse (poem)
-
-- sub part of poem block which is identified by open an close tags, separated from other verse by double newline
-- keep newlines & spaces
-  - newlines
-  - indentation
-- what part of general markup?
-  - NO standard (para) attributes
-  - inline markup
-    - font faces (bold, italics, underscore etc.)
-    - footnotes/endnotes
-    - links?
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_verse
-#+BEGIN_SRC d
-@safe auto munge_verse()(string obj_txt_in) {
-  TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt_in);
-  return t;
-}
-invariant() {
-}
-#+END_SRC
-
-******* code
-
-- NO general markup
-  - NO standard (para) attributes
-  - special attributes?
-    - possibly identify language object attribute for syntax for coloring
-    - numbered code blocks (markup/obj attribute?)
-- keep newlines & spaces
-  - newlines
-  - indentation
-- one special character represented by mkup.nbsp ░
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_code
-#+BEGIN_SRC d
-@safe string munge_code()(string obj_txt_in) {
-  obj_txt_in = obj_txt_in.replaceAll(rgx.space, mkup.nbsp);
-  obj_txt["munge"] = obj_txt_in;
-  return obj_txt["munge"];
-}
-invariant() {
-}
-#+END_SRC
-
-******* table
-
-- table block identified by open an close tags
-- table markup
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_table
-#+BEGIN_SRC d
-@safe string munge_table()(string obj_txt_in) {
-  obj_txt["munge"] = obj_txt_in;
-  return obj_txt["munge"];
-}
-invariant() {
-}
-#+END_SRC
-
-******* comment
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_comment
-#+BEGIN_SRC d
-@safe string munge_comment()(string obj_txt_in) {
-  obj_txt["munge"] = obj_txt_in;
-  return obj_txt["munge"];
-}
-invariant() {
-}
-#+END_SRC
-
-****** }
-
-#+NAME: meta_emitters_obj_inline_markup_munge_function_close
-#+BEGIN_SRC d
+    obj_txt_in
+      = obj_txt_in.replaceAll(
+        rgx.inline_notes_curly_sp_plus,
+        (mkup.en_a_o ~ "+" ~ " $1" ~ mkup.en_a_c)
+      );
+    /+ image matched +/
+    if (obj_txt_in.match(rgx.smid_image_generic)) {
+      obj_txt_in = images(obj_txt_in);
+      if (obj_txt_in.match(rgx.smid_mod_image_without_dimensions)) {
+        images_without_dimensions = true;
+      }
+    }
+    /+ url matched +/
+    if (obj_txt_in.match(rgx.smid_inline_url)) {
+      urls = true;
+      obj_txt_in = obj_txt_in.links_and_images;
+    }
+    if (auto m = obj_txt_in.match(rgx.para_inline_link_anchor)) {
+      obj_txt_in = obj_txt_in
+        .replaceAll(rgx.para_inline_link_anchor, "┃$1┃");
+    }
+    TxtPlusHasFootnotes ftn = footnotes_endnotes_markup_and_number_or_stars(obj_txt_in, reset_note_numbers);
+    obj_txt_out = ftn.obj_txt;
+    debug(footnotes) {
+      writeln(obj_txt_out, tail);
+    }
+    obj_txt_out = obj_txt_out ~ tail;
+    debug(footnotesdone) {
+      foreach(m; matchAll(obj_txt_out,
+      (mkup.en_a_o ~ `\s*(.+?)` ~ mkup.en_a_c))) {
+        writeln(m[1]);
+        writeln(m.hit);
+      }
+    }
+    TxtPlusHasFootnotesUrlsImages t = tuple(
+      obj_txt_out,
+      ftn.has_notes_reg,
+      ftn.has_notes_star,
+      ftn.has_notes_plus,
+      urls,
+      images_without_dimensions,
+    );
+    return t;
+  }
+  auto init() {
+    TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_("");
+    return t;
+  }
+  invariant() {
+  }
+  @safe auto munge_heading()(
+    string obj_txt_in,
+    bool reset_note_numbers = false
+  ) {
+    obj_txt["munge"] = obj_txt_in
+     .replaceFirst(rgx.headings, "")
+     .replaceFirst(rgx.object_number_off_all, "")
+     .replaceFirst(rgx.markup_inline_linebreak, mkup.br_line_inline)
+     .strip;
+    TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt["munge"], reset_note_numbers);
+    debug(munge) {
+      writeln(__LINE__);
+      writeln(obj_txt_in);
+      writeln(__LINE__);
+      writeln(obj_txt["munge"].to!string);
+    }
+    return t;
+  }
+  invariant() {
+  }
+  @safe auto munge_para()(string obj_txt_in) {
+    obj_txt["munge"] = (obj_txt_in)
+      .replaceFirst(rgx.para_attribs, "")
+      .replaceFirst(rgx.object_number_off_all, "")
+      .replaceFirst(rgx.markup_inline_linebreak, mkup.br_line_inline);
+    TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt["munge"]);
+    debug(munge) {
+      writeln(__LINE__);
+      writeln(obj_txt_in);
+      writeln(__LINE__);
+      writeln(obj_txt["munge"].to!string);
+    }
+    return t;
+  }
+  @safe auto munge_quote()(string obj_txt_in) {
+    TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt_in.split("\n\n").join(" \\\\\n \\\\\n"));
+    // TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt_in);
+    return t;
+  }
+  invariant() {
+  }
+  @safe auto munge_group(string obj_txt_in) {
+    TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt_in.split("\n\n").join("\n" ~ mkup.br_line_spaced ~ "\n")); // br_line br_line_inline br_line_spaced
+    return t;
+  }
+  invariant() {
+  }
+  @safe auto munge_block()(string obj_txt_in) {
+    TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt_in);
+    return t;
+  }
+  invariant() {
+  }
+  @safe auto munge_verse()(string obj_txt_in) {
+    TxtPlusHasFootnotesUrlsImages t = object_notes_and_links_(obj_txt_in);
+    return t;
+  }
+  invariant() {
+  }
+  @safe string munge_code()(string obj_txt_in) {
+    obj_txt_in = obj_txt_in.replaceAll(rgx.space, mkup.nbsp);
+    obj_txt["munge"] = obj_txt_in;
+    return obj_txt["munge"];
+  }
+  invariant() {
+  }
+  @safe string munge_table()(string obj_txt_in) {
+    obj_txt["munge"] = obj_txt_in;
+    return obj_txt["munge"];
+  }
+  invariant() {
+  }
+  @safe string munge_comment()(string obj_txt_in) {
+    obj_txt["munge"] = obj_txt_in;
+    return obj_txt["munge"];
+  }
+  invariant() {
+  }
 }
-#+END_SRC
-
-***** toc, tags, object inline markup :markup:inline:
-****** {
-
-#+NAME: meta_emitters_obj_inline_markup_function_open
-#+BEGIN_SRC d
 static struct ObjInlineMarkup {
   static auto rgx = RgxI();
   static auto munge = ObjInlineMarkupMunge();
   string[string] obj_txt;
   string anchor_tag = "";
-#+END_SRC
-
-******* object inline markup and anchor tags :markup:inline:
-
-#+NAME: meta_emitters_obj_inline_markup_and_anchor_tags_and_misc
-#+BEGIN_SRC d
-@safe TxtAndAnchorTagPlusHasFootnotesUrlsImages obj_inline_markup_and_anchor_tags_and_misc(CMM)(
-  string[string]   obj_,
-  string           obj_key_,
-  CMM              conf_make_meta,
-  Flag!"_new_doc"  _new_doc
-) {
-  obj_txt["munge"]                                = obj_[obj_key_].dup;
-  obj_txt["munge"]                                = (obj_["is"].match(ctRegex!(`verse|code`)))
-  ? obj_txt["munge"]
-  : obj_txt["munge"].strip;
-  if (_new_doc) {
+  @safe TxtAndAnchorTagPlusHasFootnotesUrlsImages obj_inline_markup_and_anchor_tags_and_misc(CMM)(
+    string[string]   obj_,
+    string           obj_key_,
+    CMM              conf_make_meta,
+    Flag!"_new_doc"  _new_doc
+  ) {
+    obj_txt["munge"]                                = obj_[obj_key_].dup;
+    obj_txt["munge"]                                = (obj_["is"].match(ctRegex!(`verse|code`)))
+    ? obj_txt["munge"]
+    : obj_txt["munge"].strip;
+    if (_new_doc) {
+      anchor_tag = "";
+    }
+    auto x = munge.init;
+    bool[string] obj_notes_and_links;
+    obj_notes_and_links["notes_reg"]                = false;
+    obj_notes_and_links["notes_star"]               = false;
+    obj_notes_and_links["links"]                    = false;
+    obj_notes_and_links["image_no_dimensions"]      = false;
+    if ((obj_["is"] == "para")
+      || (obj_["is"] == "heading")
+      || (obj_["is"] == "quote")
+      || (obj_["is"] == "group")
+      || (obj_["is"] == "block")
+      || (obj_["is"] == "verse")) {
+      obj_txt["munge"]                              = (obj_txt["munge"]).inline_markup_faces;
+      obj_txt["munge"]                              = (obj_txt["munge"]).links_and_images;
+    }
+    switch (obj_["is"]) {
+    case "heading":
+      if (_new_doc) {
+        anchor_tag                                  = "";
+      }
+      obj_txt["munge"] = _configured_auto_heading_numbering_and_segment_anchor_tags(obj_txt["munge"], obj_, conf_make_meta, _new_doc);
+      obj_txt["munge"] = _make_segment_anchor_tags_if_none_provided(obj_txt["munge"], obj_["lev"], _new_doc);
+      if (auto m = obj_txt["munge"].match(rgx.heading_anchor_tag)) {
+        anchor_tag                                  = m.captures[1];
+      } else if (obj_["lev"] == "1") {
+        writeln("heading anchor tag missing: ", obj_txt["munge"]);
+      }
+      x                                             = munge.munge_heading(obj_txt["munge"], reset_note_numbers);
+      reset_note_numbers = false;
+      goto default;
+    case "para":
+      x                                             = munge.munge_para(obj_txt["munge"]);
+      goto default;
+    case "group":
+      x                                             = munge.munge_group(obj_txt["munge"]);
+      goto default;
+    case "block":
+      x                                             = munge.munge_block(obj_txt["munge"]);
+      goto default;
+    case "quote":
+      x                                             = munge.munge_quote(obj_txt["munge"]);
+      goto default;
+    case "verse":
+      x                                             = munge.munge_verse(obj_txt["munge"]);
+      goto default;
+    case "code":
+      obj_txt["munge"]                              = munge.munge_code(obj_txt["munge"]);
+      break;
+    case "table":
+      obj_txt["munge"]                              = munge.munge_table(obj_txt["munge"]);
+      break;
+    case "comment":
+      obj_txt["munge"]                              = munge.munge_comment(obj_txt["munge"]);
+      break;
+    case "doc_end_reset":
+      munge.initialize_note_numbers();
+      break;
+    default:
+      /+ para, heading, group, block, verse +/
+      obj_txt["munge"]                              = x[0];
+      obj_notes_and_links["notes_reg"]              = x[1];
+      obj_notes_and_links["notes_star"]             = x[2];
+      obj_notes_and_links["notes_plus"]             = x[3];
+      obj_notes_and_links["links"]                  = x[4];
+      obj_notes_and_links["image_no_dimensions"]    = x[5];
+      break;
+    }
+    TxtAndAnchorTagPlusHasFootnotesUrlsImages t = tuple(
+      obj_txt["munge"],
+      anchor_tag,
+      obj_notes_and_links["notes_reg"],
+      obj_notes_and_links["notes_star"],
+      obj_notes_and_links["links"],
+      obj_notes_and_links["image_no_dimensions"],
+    );
     anchor_tag = "";
+    return t;
   }
-  auto x = munge.init;
-  bool[string] obj_notes_and_links;
-  obj_notes_and_links["notes_reg"]                = false;
-  obj_notes_and_links["notes_star"]               = false;
-  obj_notes_and_links["links"]                    = false;
-  obj_notes_and_links["image_no_dimensions"]      = false;
-  if ((obj_["is"] == "para")
-    || (obj_["is"] == "heading")
-    || (obj_["is"] == "quote")
-    || (obj_["is"] == "group")
-    || (obj_["is"] == "block")
-    || (obj_["is"] == "verse")) {
-    obj_txt["munge"]                              = (obj_txt["munge"]).inline_markup_faces;
-    obj_txt["munge"]                              = (obj_txt["munge"]).links_and_images;
-  }
-  switch (obj_["is"]) {
-  case "heading":
-    if (_new_doc) {
-      anchor_tag                                  = "";
+  invariant() {
+  }
+  @safe auto _clean_heading_toc_()(
+    char[] heading_toc_,
+  ) {
+   auto m = (cast(char[]) heading_toc_).matchFirst(rgx.heading);
+   heading_toc_ = (m.post).replaceAll(rgx.inline_notes_curly_gen, "");
+   return heading_toc_;
+  };
+  @safe auto flow_table_of_contents_gather_headings(CMM)( //
+    string[string]         obj_,
+    CMM                    conf_make_meta,
+    string[string]         tag_in_seg,
+    string                 _anchor_tag,
+    string[][string]       lev4_subtoc,
+    ObjGenericComposite[]  the_document_toc_section,
+  ) {
+    ObjGenericComposite comp_obj_toc;
+    mixin InternalMarkup;
+    static auto mkup = InlineMarkup();
+    char[] heading_toc_                             = (obj_["substantive"].dup.strip.to!(char[]))
+      .replaceAll(rgx.inline_notes_al, "");
+    heading_toc_                                    = _clean_heading_toc_(heading_toc_);
+    auto attrib = "";
+    string toc_txt_, subtoc_txt_;
+    int[string] indent;
+    if (obj_["lev_markup_number"].to!int > 0) {
+      indent = [
+        "hang_position" : obj_["lev_markup_number"].to!int,
+        "base_position" : obj_["lev_markup_number"].to!int,
+      ];
+      toc_txt_ = format("%s%s%s%s#%s%s",
+        mkup.lnk_o,
+        heading_toc_.strip,
+        mkup.lnk_c,
+        mkup.url_o,
+        _anchor_tag,
+        mkup.url_c,
+      );
+      toc_txt_= toc_txt_.links_and_images;
+      comp_obj_toc                                  = comp_obj_toc.init;
+      comp_obj_toc.metainfo.is_of_part              = "frontmatter";
+      comp_obj_toc.metainfo.is_of_section           = "toc";
+      comp_obj_toc.metainfo.is_of_type              = "para";
+      comp_obj_toc.metainfo.is_a                    = "toc";
+      comp_obj_toc.metainfo.ocn                     = 0;
+      comp_obj_toc.metainfo.identifier              = "";
+      comp_obj_toc.metainfo.object_number_off       = true;
+      comp_obj_toc.metainfo.object_number_type      = 0;
+      comp_obj_toc.metainfo.dummy_heading           = (an_object["dummy_heading_status"] == "t") ? true: false;
+      comp_obj_toc.attrib.indent_hang               = indent["hang_position"];
+      comp_obj_toc.attrib.indent_base               = indent["base_position"];
+      comp_obj_toc.attrib.bullet                    = false;
+      comp_obj_toc.text                             = toc_txt_.to!string.strip;
+      comp_obj_toc.has.inline_links                 = true;
+      the_document_toc_section                      ~= comp_obj_toc;
+    }
+    comp_obj_toc                                    = comp_obj_toc.init;
+    comp_obj_toc.metainfo.is_of_part                = "frontmatter";
+    comp_obj_toc.metainfo.is_of_section             = "toc";
+    comp_obj_toc.metainfo.is_of_type                = "para";
+    comp_obj_toc.metainfo.is_a                      = "toc";
+    comp_obj_toc.metainfo.ocn                       = 0;
+    comp_obj_toc.metainfo.identifier                = "";
+    comp_obj_toc.metainfo.object_number_off         = true;
+    comp_obj_toc.metainfo.object_number_type        = 0;
+    comp_obj_toc.metainfo.dummy_heading             = (an_object["dummy_heading_status"] == "t") ? true: false;
+    comp_obj_toc.attrib.bullet                      = false;
+    comp_obj_toc.has.inline_links                   = true;
+    switch (obj_["lev_markup_number"].to!int) {
+    case 0: .. case 3:
+      break;
+    case 4:
+      lev4_subtoc[tag_in_seg["seg_lv4"]] = [];
+      break;
+    case 5: .. case 7:
+      subtoc_txt_ = format("%s%s%s%s#%s%s",
+        mkup.lnk_o,
+        heading_toc_.strip,
+        mkup.lnk_c,
+        mkup.url_o,
+        _anchor_tag,
+        mkup.url_c,
+      );
+      lev4_subtoc[tag_in_seg["seg_lv4"]]
+      ~= links_and_images(obj_["lev_markup_number"]
+           ~ "~ " ~ subtoc_txt_.to!string.strip
+         );
+      break;
+    default:
+      break;
     }
-    obj_txt["munge"] = _configured_auto_heading_numbering_and_segment_anchor_tags(obj_txt["munge"], obj_, conf_make_meta, _new_doc);
-    obj_txt["munge"] = _make_segment_anchor_tags_if_none_provided(obj_txt["munge"], obj_["lev"], _new_doc);
-    if (auto m = obj_txt["munge"].match(rgx.heading_anchor_tag)) {
-      anchor_tag                                  = m.captures[1];
-    } else if (obj_["lev"] == "1") {
-      writeln("heading anchor tag missing: ", obj_txt["munge"]);
+    struct retStruct {
+      ObjGenericComposite[] the_document_toc_section;
+      string[][string]      lev4_subtoc;
     }
-    x                                             = munge.munge_heading(obj_txt["munge"], reset_note_numbers);
-    reset_note_numbers = false;
-    goto default;
-  case "para":
-    x                                             = munge.munge_para(obj_txt["munge"]);
-    goto default;
-  case "group":
-    x                                             = munge.munge_group(obj_txt["munge"]);
-    goto default;
-  case "block":
-    x                                             = munge.munge_block(obj_txt["munge"]);
-    goto default;
-  case "quote":
-    x                                             = munge.munge_quote(obj_txt["munge"]);
-    goto default;
-  case "verse":
-    x                                             = munge.munge_verse(obj_txt["munge"]);
-    goto default;
-  case "code":
-    obj_txt["munge"]                              = munge.munge_code(obj_txt["munge"]);
-    break;
-  case "table":
-    obj_txt["munge"]                              = munge.munge_table(obj_txt["munge"]);
-    break;
-  case "comment":
-    obj_txt["munge"]                              = munge.munge_comment(obj_txt["munge"]);
-    break;
-  case "doc_end_reset":
-    munge.initialize_note_numbers();
-    break;
-  default:
-    /+ para, heading, group, block, verse +/
-    obj_txt["munge"]                              = x[0];
-    obj_notes_and_links["notes_reg"]              = x[1];
-    obj_notes_and_links["notes_star"]             = x[2];
-    obj_notes_and_links["notes_plus"]             = x[3];
-    obj_notes_and_links["links"]                  = x[4];
-    obj_notes_and_links["image_no_dimensions"]    = x[5];
-    break;
+    retStruct ret;
+    {
+      ret.the_document_toc_section = the_document_toc_section;
+      ret.lev4_subtoc              = lev4_subtoc;
+    }
+    return ret;
   }
-  TxtAndAnchorTagPlusHasFootnotesUrlsImages t = tuple(
-    obj_txt["munge"],
-    anchor_tag,
-    obj_notes_and_links["notes_reg"],
-    obj_notes_and_links["notes_star"],
-    obj_notes_and_links["links"],
-    obj_notes_and_links["image_no_dimensions"],
-  );
-  anchor_tag = "";
-  return t;
-}
-invariant() {
-}
-#+END_SRC
-
-******* toc (table of contents), build, gather headings :markup:inline:
-
-#+NAME: meta_emitters_obj_inline_markup_table_of_contents
-#+BEGIN_SRC d
-@safe auto _clean_heading_toc_()(
-  char[] heading_toc_,
-) {
- auto m = (cast(char[]) heading_toc_).matchFirst(rgx.heading);
- heading_toc_ = (m.post).replaceAll(rgx.inline_notes_curly_gen, "");
- return heading_toc_;
-};
-@safe ObjGenericComposite[] flow_table_of_contents_gather_headings(CMM)(
-             string[string]         obj_,
-             CMM                    conf_make_meta,
-             string[string]         tag_in_seg,
-             string                 _anchor_tag,
-  return ref string[][string]       lev4_subtoc,
-             ObjGenericComposite[]  the_document_toc_section,
-) {
-  ObjGenericComposite comp_obj_toc;
-  mixin InternalMarkup;
-  static auto mkup = InlineMarkup();
-  char[] heading_toc_                             = (obj_["substantive"].dup.strip.to!(char[]))
-    .replaceAll(rgx.inline_notes_al, "");
-  heading_toc_                                    = _clean_heading_toc_(heading_toc_);
-  auto attrib = "";
-  string toc_txt_, subtoc_txt_;
-  int[string] indent;
-  if (obj_["lev_markup_number"].to!int > 0) {
-    indent = [
-      "hang_position" : obj_["lev_markup_number"].to!int,
-      "base_position" : obj_["lev_markup_number"].to!int,
-    ];
-    toc_txt_ = format("%s%s%s%s#%s%s",
-      mkup.lnk_o,
-      heading_toc_.strip,
-      mkup.lnk_c,
-      mkup.url_o,
-      _anchor_tag,
-      mkup.url_c,
-    );
-    toc_txt_= toc_txt_.links_and_images;
-    comp_obj_toc                                  = comp_obj_toc.init;
-    comp_obj_toc.metainfo.is_of_part              = "frontmatter";
-    comp_obj_toc.metainfo.is_of_section           = "toc";
-    comp_obj_toc.metainfo.is_of_type              = "para";
-    comp_obj_toc.metainfo.is_a                    = "toc";
-    comp_obj_toc.metainfo.ocn                     = 0;
-    comp_obj_toc.metainfo.identifier              = "";
-    comp_obj_toc.metainfo.object_number_off       = true;
-    comp_obj_toc.metainfo.object_number_type      = 0;
-    comp_obj_toc.metainfo.dummy_heading           = (an_object["dummy_heading_status"] == "t") ? true: false;
-    comp_obj_toc.attrib.indent_hang               = indent["hang_position"];
-    comp_obj_toc.attrib.indent_base               = indent["base_position"];
-    comp_obj_toc.attrib.bullet                    = false;
-    comp_obj_toc.text                             = toc_txt_.to!string.strip;
-    comp_obj_toc.has.inline_links                 = true;
-    the_document_toc_section                      ~= comp_obj_toc;
-  }
-  comp_obj_toc                                    = comp_obj_toc.init;
-  comp_obj_toc.metainfo.is_of_part                = "frontmatter";
-  comp_obj_toc.metainfo.is_of_section             = "toc";
-  comp_obj_toc.metainfo.is_of_type                = "para";
-  comp_obj_toc.metainfo.is_a                      = "toc";
-  comp_obj_toc.metainfo.ocn                       = 0;
-  comp_obj_toc.metainfo.identifier                = "";
-  comp_obj_toc.metainfo.object_number_off         = true;
-  comp_obj_toc.metainfo.object_number_type        = 0;
-  comp_obj_toc.metainfo.dummy_heading             = (an_object["dummy_heading_status"] == "t") ? true: false;
-  comp_obj_toc.attrib.bullet                      = false;
-  comp_obj_toc.has.inline_links                   = true;
-  switch (obj_["lev_markup_number"].to!int) {
-  case 0: .. case 3:
-    break;
-  case 4:
-    lev4_subtoc[tag_in_seg["seg_lv4"]] = [];
-    break;
-  case 5: .. case 7:
-    subtoc_txt_ = format("%s%s%s%s#%s%s",
-      mkup.lnk_o,
-      heading_toc_.strip,
-      mkup.lnk_c,
-      mkup.url_o,
-      _anchor_tag,
-      mkup.url_c,
-    );
-    lev4_subtoc[tag_in_seg["seg_lv4"]]
-    ~= links_and_images(obj_["lev_markup_number"]
-         ~ "~ " ~ subtoc_txt_.to!string.strip
-       );
-    break;
-  default:
-    break;
+  invariant() {
   }
-  return the_document_toc_section;
-}
-invariant() {
-}
-#+END_SRC
-
-******* private:
-
-#+NAME: meta_emitters_obj_inline_markup_private_function_open
-#+BEGIN_SRC d
 private:
-#+END_SRC
-
-******** make heading number & segment anchor tags if instructed :markup:inline:segment:anchor:tags:
-
-#+NAME: meta_emitters_obj_inline_markup_heading_numbering_and_segment_anchor_tags
-#+BEGIN_SRC d
-static int[] heading_num = [ 0, 0, 0, 0 ];
-static string heading_number_auto_composite = "";
-static string heading_number_auto_composite_segname = "";
-static bool[] auto_heading_numbering = [ true, true, true, true];
-@safe static string _configured_auto_heading_numbering_and_segment_anchor_tags(CMM)(
-  string           munge_,
-  string[string]   obj_,
-  CMM              conf_make_meta,
-  bool             _new_doc,
-) {
-  if (_new_doc) {
-    heading_num                         = [ 0, 0, 0, 0 ];
-    heading_number_auto_composite       = "";
-    auto_heading_numbering              = [ true, true, true, true];
-  }
-  if (conf_make_meta.make.auto_num_top_lv) {
-    if (obj_["lev_markup_number"].to!int == 0) {
-      heading_num[0]                    = 0;
-      heading_num[1]                    = 0;
-      heading_num[2]                    = 0;
-      heading_num[3]                    = 0;
-      heading_number_auto_composite     = "";
-    }
-    /+ auto_num_depth minimum 0
-       (1.) default 2 (1.1.1) max 3 (1.1.1.1) implement +/
-    if (
-      conf_make_meta.make.auto_num_top_lv
-      > obj_["lev_markup_number"].to!uint
-    ) {
-      heading_num[1]                    = 0;
-      heading_num[2]                    = 0;
-      heading_num[3]                    = 0;
-    } else if (
-      conf_make_meta.make.auto_num_top_lv
-        == obj_["lev_markup_number"].to!uint
-    ) {
-      auto_heading_numbering[0] =
-        (munge_.match(rgx.auto_heading_numbering_off_lv1)) ? false : true;
-      if (auto_heading_numbering[0]) {
-        heading_num[0] ++;
-      }
-      heading_num[1]                    = 0;
-      heading_num[2]                    = 0;
-      heading_num[3]                    = 0;
-    } else if (
-      conf_make_meta.make.auto_num_top_lv
-        == (obj_["lev_markup_number"].to!uint - 1)
-    ) {
-      auto_heading_numbering[1] =
-        (munge_.match(rgx.auto_heading_numbering_off_lv2)) ? false : true;
-      if (auto_heading_numbering[0]
-      && auto_heading_numbering[1]) {
-        heading_num[1] ++;
-      }
-      heading_num[2]                    = 0;
-      heading_num[3]                    = 0;
-    } else if (
-      conf_make_meta.make.auto_num_top_lv
-        == (obj_["lev_markup_number"].to!uint - 2)
-    ) {
-      auto_heading_numbering[2] =
-        (munge_.match(rgx.auto_heading_numbering_off_lv3)) ? false : true;
-      if (auto_heading_numbering[0]
-      && auto_heading_numbering[1]
-      && auto_heading_numbering[2]) {
-        heading_num[2] ++;
-      }
-      heading_num[3]                    = 0;
-    } else if (
-      conf_make_meta.make.auto_num_top_lv
-        == (obj_["lev_markup_number"].to!uint - 3)
-    ) {
-      auto_heading_numbering[3] =
-        (munge_.match(rgx.auto_heading_numbering_off_lv4)) ? false : true;
-      if (auto_heading_numbering[0]
-      && auto_heading_numbering[1]
-      && auto_heading_numbering[2]
-      && auto_heading_numbering[3]) {
-        heading_num[3] ++;
-      }
-    }
-    if (auto_heading_numbering[0]) {
-      if (heading_num[3] > 0) {
-        heading_number_auto_composite
-          = (conf_make_meta.make.auto_num_depth.to!uint == 3
-            && auto_heading_numbering[3])
-          ? (format(q"┃%s.%s.%s.%s┃",
-              heading_num[0].to!string,
-              heading_num[1].to!string,
-              heading_num[2].to!string,
-              heading_num[3].to!string
-            ))
-          : "";
-      } else if (heading_num[2] > 0) {
-        heading_number_auto_composite
-          = ((conf_make_meta.make.auto_num_depth.to!uint >= 2)
-            && (conf_make_meta.make.auto_num_depth.to!uint <= 3)
-            && auto_heading_numbering[2])
-          ? (format(q"┃%s.%s.%s┃",
-              heading_num[0].to!string,
-              heading_num[1].to!string,
-              heading_num[2].to!string
-            ))
-          : "";
-      } else if (heading_num[1] > 0) {
-        heading_number_auto_composite
-          = ((conf_make_meta.make.auto_num_depth.to!uint >= 1)
-            && (conf_make_meta.make.auto_num_depth.to!uint <= 3)
-            && auto_heading_numbering[1])
-          ? (format(q"┃%s.%s┃",
-              heading_num[0].to!string,
-              heading_num[1].to!string
-            ))
-          : "";
-      } else if (heading_num[0] > 0
-        && munge_.match(rgx.auto_heading_numbering_lv1)
+  static int[] heading_num = [ 0, 0, 0, 0 ];
+  static string heading_number_auto_composite = "";
+  static string heading_number_auto_composite_segname = "";
+  static bool[] auto_heading_numbering = [ true, true, true, true];
+  @safe static string _configured_auto_heading_numbering_and_segment_anchor_tags(CMM)(
+    string           munge_,
+    string[string]   obj_,
+    CMM              conf_make_meta,
+    bool             _new_doc,
+  ) {
+    if (_new_doc) {
+      heading_num                         = [ 0, 0, 0, 0 ];
+      heading_number_auto_composite       = "";
+      auto_heading_numbering              = [ true, true, true, true];
+    }
+    if (conf_make_meta.make.auto_num_top_lv) {
+      if (obj_["lev_markup_number"].to!int == 0) {
+        heading_num[0]                    = 0;
+        heading_num[1]                    = 0;
+        heading_num[2]                    = 0;
+        heading_num[3]                    = 0;
+        heading_number_auto_composite     = "";
+      }
+      /+ auto_num_depth minimum 0
+         (1.) default 2 (1.1.1) max 3 (1.1.1.1) implement +/
+      if (
+        conf_make_meta.make.auto_num_top_lv
+        > obj_["lev_markup_number"].to!uint
       ) {
-        heading_number_auto_composite
-          = ((conf_make_meta.make.auto_num_depth.to!uint >= 0)
-            && (conf_make_meta.make.auto_num_depth.to!uint <= 3)
-            && auto_heading_numbering[0])
-          ? (format(q"┃%s┃",
-              heading_num[0].to!string
-            ))
-          : "";
-      } else {
-        heading_number_auto_composite = "";
+        heading_num[1]                    = 0;
+        heading_num[2]                    = 0;
+        heading_num[3]                    = 0;
+      } else if (
+        conf_make_meta.make.auto_num_top_lv
+          == obj_["lev_markup_number"].to!uint
+      ) {
+        auto_heading_numbering[0] =
+          (munge_.match(rgx.auto_heading_numbering_off_lv1)) ? false : true;
+        if (auto_heading_numbering[0]) {
+          heading_num[0] ++;
+        }
+        heading_num[1]                    = 0;
+        heading_num[2]                    = 0;
+        heading_num[3]                    = 0;
+      } else if (
+        conf_make_meta.make.auto_num_top_lv
+          == (obj_["lev_markup_number"].to!uint - 1)
+      ) {
+        auto_heading_numbering[1] =
+          (munge_.match(rgx.auto_heading_numbering_off_lv2)) ? false : true;
+        if (auto_heading_numbering[0]
+        && auto_heading_numbering[1]) {
+          heading_num[1] ++;
+        }
+        heading_num[2]                    = 0;
+        heading_num[3]                    = 0;
+      } else if (
+        conf_make_meta.make.auto_num_top_lv
+          == (obj_["lev_markup_number"].to!uint - 2)
+      ) {
+        auto_heading_numbering[2] =
+          (munge_.match(rgx.auto_heading_numbering_off_lv3)) ? false : true;
+        if (auto_heading_numbering[0]
+        && auto_heading_numbering[1]
+        && auto_heading_numbering[2]) {
+          heading_num[2] ++;
+        }
+        heading_num[3]                    = 0;
+      } else if (
+        conf_make_meta.make.auto_num_top_lv
+          == (obj_["lev_markup_number"].to!uint - 3)
+      ) {
+        auto_heading_numbering[3] =
+          (munge_.match(rgx.auto_heading_numbering_off_lv4)) ? false : true;
+        if (auto_heading_numbering[0]
+        && auto_heading_numbering[1]
+        && auto_heading_numbering[2]
+        && auto_heading_numbering[3]) {
+          heading_num[3] ++;
+        }
       }
-    }
-    heading_number_auto_composite_segname =
-      (heading_number_auto_composite.empty)
-        ? ""
-        : "seg_" ~ heading_number_auto_composite;
-    debug(heading_number_auto) {
-      writeln(heading_number_auto_composite);
-    }
-    if ((!empty(heading_number_auto_composite))
-    && (obj_["lev_markup_number"].to!uint >= conf_make_meta.make.auto_num_top_lv)) {
-      munge_ = munge_
-      .replaceFirst(rgx.heading,
-        "$1~$2 " ~ heading_number_auto_composite ~ ". ")
-      .replaceFirst(rgx.heading_marker_missing_tag,
-        "$1~" ~ heading_number_auto_composite_segname ~ " ");
-    }
-  }
-  return munge_;
-}
-#+END_SRC
-
-******** make segment anchor tags if not provided :markup:inline:segment:anchor:tags:
-
-#+NAME: meta_emitters_obj_inline_segment_anchor_tags_manufacture
-#+BEGIN_SRC d
-static int heading_num_lev1 = 0;
-@safe static string _make_segment_anchor_tags_if_none_provided()(
-  string munge_,
-  string lev_,
-  bool   _new_doc
-) {
-  if (!(munge_.match(rgx.heading_anchor_tag))) {
-    if (lev_ == "A") { // (_new_doc)
-      heading_num_lev1 = 0;
-    }
-    if (munge_.match(rgx.heading_identify_anchor_tag)) {
-      if (auto m = munge_.match(rgx.heading_extract_named_anchor_tag)) {
-        munge_ = munge_.replaceFirst(
-          rgx.heading_marker_missing_tag,
-          "$1~" ~ m.captures[1].toLower ~ "_"  ~ m.captures[2] ~ " ");
-        if (auto n = munge_.match(rgx.heading_anchor_tag_plus_colon)) {
-          auto tag_remunge_ = n.captures[2]
-            .replaceAll(rgx.heading_marker_tag_has_colon, "..");
-          munge_ = munge_.replaceFirst(rgx.heading_anchor_tag_plus_colon, n.captures[1] ~ tag_remunge_ ~ " ");
+      if (auto_heading_numbering[0]) {
+        if (heading_num[3] > 0) {
+          heading_number_auto_composite
+            = (conf_make_meta.make.auto_num_depth.to!uint == 3
+              && auto_heading_numbering[3])
+            ? (format(q"┃%s.%s.%s.%s┃",
+                heading_num[0].to!string,
+                heading_num[1].to!string,
+                heading_num[2].to!string,
+                heading_num[3].to!string
+              ))
+            : "";
+        } else if (heading_num[2] > 0) {
+          heading_number_auto_composite
+            = ((conf_make_meta.make.auto_num_depth.to!uint >= 2)
+              && (conf_make_meta.make.auto_num_depth.to!uint <= 3)
+              && auto_heading_numbering[2])
+            ? (format(q"┃%s.%s.%s┃",
+                heading_num[0].to!string,
+                heading_num[1].to!string,
+                heading_num[2].to!string
+              ))
+            : "";
+        } else if (heading_num[1] > 0) {
+          heading_number_auto_composite
+            = ((conf_make_meta.make.auto_num_depth.to!uint >= 1)
+              && (conf_make_meta.make.auto_num_depth.to!uint <= 3)
+              && auto_heading_numbering[1])
+            ? (format(q"┃%s.%s┃",
+                heading_num[0].to!string,
+                heading_num[1].to!string
+              ))
+            : "";
+        } else if (heading_num[0] > 0
+          && munge_.match(rgx.auto_heading_numbering_lv1)
+        ) {
+          heading_number_auto_composite
+            = ((conf_make_meta.make.auto_num_depth.to!uint >= 0)
+              && (conf_make_meta.make.auto_num_depth.to!uint <= 3)
+              && auto_heading_numbering[0])
+            ? (format(q"┃%s┃",
+                heading_num[0].to!string
+              ))
+            : "";
+        } else {
+          heading_number_auto_composite = "";
         }
-      } else if (auto m = munge_.match(rgx.heading_extract_unnamed_anchor_tag)) {
+      }
+      heading_number_auto_composite_segname =
+        (heading_number_auto_composite.empty)
+          ? ""
+          : "seg_" ~ heading_number_auto_composite;
+      debug(heading_number_auto) {
+        writeln(heading_number_auto_composite);
+      }
+      if ((!empty(heading_number_auto_composite))
+      && (obj_["lev_markup_number"].to!uint >= conf_make_meta.make.auto_num_top_lv)) {
+        munge_ = munge_
+        .replaceFirst(rgx.heading,
+          "$1~$2 " ~ heading_number_auto_composite ~ ". ")
+        .replaceFirst(rgx.heading_marker_missing_tag,
+          "$1~" ~ heading_number_auto_composite_segname ~ " ");
+      }
+    }
+    return munge_;
+  }
+  static int heading_num_lev1 = 0;
+  @safe static string _make_segment_anchor_tags_if_none_provided()(
+    string munge_,
+    string lev_,
+    bool   _new_doc
+  ) {
+    if (!(munge_.match(rgx.heading_anchor_tag))) {
+      if (lev_ == "A") { // (_new_doc)
+        heading_num_lev1 = 0;
+      }
+      if (munge_.match(rgx.heading_identify_anchor_tag)) {
+        if (auto m = munge_.match(rgx.heading_extract_named_anchor_tag)) {
+          munge_ = munge_.replaceFirst(
+            rgx.heading_marker_missing_tag,
+            "$1~" ~ m.captures[1].toLower ~ "_"  ~ m.captures[2] ~ " ");
+          if (auto n = munge_.match(rgx.heading_anchor_tag_plus_colon)) {
+            auto tag_remunge_ = n.captures[2]
+              .replaceAll(rgx.heading_marker_tag_has_colon, "..");
+            munge_ = munge_.replaceFirst(rgx.heading_anchor_tag_plus_colon, n.captures[1] ~ tag_remunge_ ~ " ");
+          }
+        } else if (auto m = munge_.match(rgx.heading_extract_unnamed_anchor_tag)) {
+          munge_ = munge_.replaceFirst(
+            rgx.heading_marker_missing_tag,
+            "$1~" ~ "s" ~ m.captures[1] ~ " ");
+        }
+      } else if (lev_ == "1") { // (if not successful) manufacture a unique anchor tag for lev == "1"
+        heading_num_lev1 ++;
         munge_ = munge_.replaceFirst(
           rgx.heading_marker_missing_tag,
-          "$1~" ~ "s" ~ m.captures[1] ~ " ");
+          "$1~" ~ "x" ~ heading_num_lev1.to!string ~ " ");
       }
-    } else if (lev_ == "1") { // (if not successful) manufacture a unique anchor tag for lev == "1"
-      heading_num_lev1 ++;
-      munge_ = munge_.replaceFirst(
-        rgx.heading_marker_missing_tag,
-        "$1~" ~ "x" ~ heading_num_lev1.to!string ~ " ");
     }
+    return munge_;
   }
-  return munge_;
 }
-#+END_SRC
-
-****** }
-
-#+NAME: meta_emitters_obj_inline_markup_private_function_close
-#+BEGIN_SRC d
-}
-#+END_SRC
-
-***** object attrib :attributes:
-****** { attributes structure open, public
-
-#+NAME: meta_emitters_obj_attributes
-#+BEGIN_SRC d
+                                                                              /+ +/
 struct ObjAttributes {
   string[string] _obj_attrib;
-#+END_SRC
-
-******* emitter obj attributes, public
-
-#+NAME: meta_emitters_obj_attributes_public
-#+BEGIN_SRC d
-@safe string obj_attributes()(
-  string              obj_is_,
-  string              obj_raw,
-  ObjGenericComposite _comp_obj_heading,
-) {
-  scope(exit) {
-    destroy(obj_is_);
-    destroy(obj_raw);
-    destroy(_comp_obj_heading);
-  }
-  _obj_attrib["json"] ="{";
-  switch (obj_is_) {
-  case "heading":
-    _obj_attrib["json"] ~= txt_heading(obj_raw);
-    break;
-  case "para":
-    _obj_attrib["json"] ~= txt_para_and_blocks(obj_raw)
-    ~ txt_para(obj_raw);
-    break;
-  case "code":
-    _obj_attrib["json"] ~= txt_code(obj_raw);
-    break;
-  case "group":
-    _obj_attrib["json"] ~= txt_para_and_blocks(obj_raw)
-    ~ txt_group(obj_raw);
-    break;
-  case "block":
-    _obj_attrib["json"] ~= txt_para_and_blocks(obj_raw)
-    ~ txt_block(obj_raw);
-    break;
-  case "verse":
-    _obj_attrib["json"] ~= txt_verse(obj_raw);
-    break;
-  case "quote":
-    _obj_attrib["json"] ~= txt_quote(obj_raw);
-    break;
-  case "table":
-    _obj_attrib["json"] ~= txt_table(obj_raw);
-    break;
-  case "comment":
-    _obj_attrib["json"] ~= txt_comment(obj_raw);
-    break;
-  default:
-    _obj_attrib["json"] ~= txt_para(obj_raw);
-    break;
+  @safe string obj_attributes()(
+    string              obj_is_,
+    string              obj_raw,
+    ObjGenericComposite _comp_obj_heading,
+  ) {
+    scope(exit) {
+      destroy(obj_is_);
+      destroy(obj_raw);
+      destroy(_comp_obj_heading);
+    }
+    _obj_attrib["json"] ="{";
+    switch (obj_is_) {
+    case "heading":
+      _obj_attrib["json"] ~= txt_heading(obj_raw);
+      break;
+    case "para":
+      _obj_attrib["json"] ~= txt_para_and_blocks(obj_raw)
+      ~ txt_para(obj_raw);
+      break;
+    case "code":
+      _obj_attrib["json"] ~= txt_code(obj_raw);
+      break;
+    case "group":
+      _obj_attrib["json"] ~= txt_para_and_blocks(obj_raw)
+      ~ txt_group(obj_raw);
+      break;
+    case "block":
+      _obj_attrib["json"] ~= txt_para_and_blocks(obj_raw)
+      ~ txt_block(obj_raw);
+      break;
+    case "verse":
+      _obj_attrib["json"] ~= txt_verse(obj_raw);
+      break;
+    case "quote":
+      _obj_attrib["json"] ~= txt_quote(obj_raw);
+      break;
+    case "table":
+      _obj_attrib["json"] ~= txt_table(obj_raw);
+      break;
+    case "comment":
+      _obj_attrib["json"] ~= txt_comment(obj_raw);
+      break;
+    default:
+      _obj_attrib["json"] ~= txt_para(obj_raw);
+      break;
+    }
+    _obj_attrib["json"] ~= " }";
+    _obj_attrib["json"] = _set_additional_values_parse_as_json(_obj_attrib["json"], obj_is_, _comp_obj_heading);
+    debug(structattrib) {
+      if (oa_j["is"].str() == "heading") {
+        writeln(_obj_attrib["json"]);
+        writeln(
+          "is: ", oa_j["is"].str(),
+          "; object_number: ", oa_j["object_number"].integer()
+        );
+      }
+    }
+    return _obj_attrib["json"];
   }
-  _obj_attrib["json"] ~= " }";
-  _obj_attrib["json"] = _set_additional_values_parse_as_json(_obj_attrib["json"], obj_is_, _comp_obj_heading);
-  debug(structattrib) {
-    if (oa_j["is"].str() == "heading") {
-      writeln(_obj_attrib["json"]);
-      writeln(
-        "is: ", oa_j["is"].str(),
-        "; object_number: ", oa_j["object_number"].integer()
-      );
+  invariant() {
+  }
+  private:
+  string _obj_attributes;
+  @safe string txt_para_and_blocks()(string obj_txt_in) {
+    if (obj_txt_in.matchFirst(rgx.para_bullet)) {
+      _obj_attributes =" \"bullet\": \"true\","
+      ~ " \"indent_hang\": 0,"
+      ~ " \"indent_base\": 0,";
+    } else if (auto m = obj_txt_in.matchFirst(rgx.para_bullet_indent)) {
+      _obj_attributes =" \"bullet\": \"true\","
+      ~ " \"indent_hang\": " ~ m["indent"].to!string ~ ","
+      ~ " \"indent_base\": " ~ m["indent"].to!string ~ ",";
+    } else if (auto m = obj_txt_in.matchFirst(rgx.para_indent_hang)) {
+      _obj_attributes =" \"bullet\": \"false\","
+      ~ " \"indent_hang\": " ~ m["hang"].to!string ~ ","
+      ~ " \"indent_base\": " ~ m["indent"].to!string ~ ",";
+    } else if (auto m = obj_txt_in.matchFirst(rgx.para_indent)) {
+      _obj_attributes =" \"bullet\": \"false\","
+      ~ " \"indent_hang\": " ~ m["indent"].to!string ~ ","
+      ~ " \"indent_base\": " ~ m["indent"].to!string ~ ",";
+    } else {
+      _obj_attributes =" \"bullet\": \"false\","
+      ~ " \"indent_hang\": 0,"
+      ~ " \"indent_base\": 0,";
     }
+    return _obj_attributes;
   }
-  return _obj_attrib["json"];
-}
-invariant() {
-}
-#+END_SRC
-
-******* private
-
-#+NAME: meta_emitters_obj_attributes_private
-#+BEGIN_SRC d
-private:
-string _obj_attributes;
-#+END_SRC
-
-******** para & blocks
-
-#+NAME: meta_emitters_obj_attributes_private_an_attribute_txt_para_and_blocks
-#+BEGIN_SRC d
-@safe string txt_para_and_blocks()(string obj_txt_in) {
-  if (obj_txt_in.matchFirst(rgx.para_bullet)) {
-    _obj_attributes =" \"bullet\": \"true\","
-    ~ " \"indent_hang\": 0,"
-    ~ " \"indent_base\": 0,";
-  } else if (auto m = obj_txt_in.matchFirst(rgx.para_bullet_indent)) {
-    _obj_attributes =" \"bullet\": \"true\","
-    ~ " \"indent_hang\": " ~ m["indent"].to!string ~ ","
-    ~ " \"indent_base\": " ~ m["indent"].to!string ~ ",";
-  } else if (auto m = obj_txt_in.matchFirst(rgx.para_indent_hang)) {
-    _obj_attributes =" \"bullet\": \"false\","
-    ~ " \"indent_hang\": " ~ m["hang"].to!string ~ ","
-    ~ " \"indent_base\": " ~ m["indent"].to!string ~ ",";
-  } else if (auto m = obj_txt_in.matchFirst(rgx.para_indent)) {
-    _obj_attributes =" \"bullet\": \"false\","
-    ~ " \"indent_hang\": " ~ m["indent"].to!string ~ ","
-    ~ " \"indent_base\": " ~ m["indent"].to!string ~ ",";
-  } else {
-    _obj_attributes =" \"bullet\": \"false\","
-    ~ " \"indent_hang\": 0,"
-    ~ " \"indent_base\": 0,";
+  @safe string txt_heading()(string obj_txt_in) {
+    _obj_attributes = " \"use\": \"content\","
+    ~ " \"of\": \"para\","
+    ~ " \"is\": \"heading\"";
+    return _obj_attributes;
+  }
+  invariant() {
+  }
+  @safe string txt_para()(string obj_txt_in) {
+    _obj_attributes = " \"use\": \"content\","
+    ~ " \"of\": \"para\","
+    ~ " \"is\": \"para\"";
+    return _obj_attributes;
+  }
+  invariant() {
+  }
+  @safe string txt_quote()(string obj_txt_in) {
+    _obj_attributes = " \"use\": \"content\","
+    ~ " \"of\": \"block\","
+    ~ " \"is\": \"quote\"";
+    return _obj_attributes;
+  }
+  invariant() {
+  }
+  @safe string txt_group()(string obj_txt_in) {
+    _obj_attributes = " \"use\": \"content\","
+    ~ " \"of\": \"block\","
+    ~ " \"is\": \"group\"";
+    return _obj_attributes;
+  }
+  invariant() {
+  }
+  @safe string txt_block()(string obj_txt_in) {
+    _obj_attributes = " \"use\": \"content\","
+    ~ " \"of\": \"block\","
+    ~ " \"is\": \"block\"";
+    return _obj_attributes;
+  }
+  invariant() {
+  }
+  @safe string txt_verse()(string obj_txt_in) {
+    _obj_attributes = " \"use\": \"content\","
+    ~ " \"of\": \"block\","
+    ~ " \"is\": \"verse\"";
+    return _obj_attributes;
+  }
+  invariant() {
+  }
+  @safe string txt_code()(string obj_txt_in) {
+    _obj_attributes = " \"use\": \"content\","
+    ~ " \"of\": \"block\","
+    ~ " \"is\": \"code\"";
+    return _obj_attributes;
+  }
+  invariant() {
+  }
+  @safe string txt_table()(string obj_txt_in) {
+    _obj_attributes = " \"use\": \"content\","
+    ~ " \"of\": \"block\","
+    ~ " \"is\": \"table\"";
+    return _obj_attributes;
+  }
+  invariant() {
+  }
+  @safe string txt_comment()(string obj_txt_in) {
+    _obj_attributes = " \"use\": \"comment\","
+    ~ " \"of\": \"comment\","
+    ~ " \"is\": \"comment\"";
+    return _obj_attributes;
+  }
+  invariant() {
+  }
+  @safe string _set_additional_values_parse_as_json()(
+    string              _obj_attrib,
+    string              obj_is_,
+    ObjGenericComposite _comp_obj_heading,
+  ) {
+    JSONValue oa_j = parseJSON(_obj_attrib);
+    assert(
+      (oa_j.type == JSON_TYPE.OBJECT)
+    );
+    if (obj_is_ == "heading") {
+      oa_j.object["object_number"]              = _comp_obj_heading.metainfo.ocn;
+      oa_j.object["lev_markup_number"]          = _comp_obj_heading.metainfo.heading_lev_markup;
+      oa_j.object["lev_collapsed_number"]       = _comp_obj_heading.metainfo.heading_lev_collapsed;
+      oa_j.object["heading_ptr"]                = _comp_obj_heading.ptr.heading;
+      oa_j.object["doc_object_ptr"]             = _comp_obj_heading.ptr.doc_object;
+    }
+    oa_j.object["parent_object_number"]         = _comp_obj_heading.metainfo.parent_ocn;
+    oa_j.object["parent_lev_markup_number"]     = _comp_obj_heading.metainfo.parent_lev_markup;
+    _obj_attrib                                 = oa_j.toString();
+    return _obj_attrib;
   }
-  return _obj_attributes;
-}
-#+END_SRC
-
-******** heading
-
-#+NAME: meta_emitters_obj_attributes_private_an_attribute_txt_heading
-#+BEGIN_SRC d
-@safe string txt_heading()(string obj_txt_in) {
-  _obj_attributes = " \"use\": \"content\","
-  ~ " \"of\": \"para\","
-  ~ " \"is\": \"heading\"";
-  return _obj_attributes;
-}
-invariant() {
-}
-#+END_SRC
-
-******** para
-
-#+NAME: meta_emitters_obj_attributes_private_an_attribute_txt_para
-#+BEGIN_SRC d
-@safe string txt_para()(string obj_txt_in) {
-  _obj_attributes = " \"use\": \"content\","
-  ~ " \"of\": \"para\","
-  ~ " \"is\": \"para\"";
-  return _obj_attributes;
-}
-invariant() {
-}
-#+END_SRC
-
-******** quote
-
-#+NAME: meta_emitters_obj_attributes_private_an_attribute_txt_quote
-#+BEGIN_SRC d
-@safe string txt_quote()(string obj_txt_in) {
-  _obj_attributes = " \"use\": \"content\","
-  ~ " \"of\": \"block\","
-  ~ " \"is\": \"quote\"";
-  return _obj_attributes;
-}
-invariant() {
-}
-#+END_SRC
-
-******** group
-
-#+NAME: meta_emitters_obj_attributes_private_an_attribute_txt_group
-#+BEGIN_SRC d
-@safe string txt_group()(string obj_txt_in) {
-  _obj_attributes = " \"use\": \"content\","
-  ~ " \"of\": \"block\","
-  ~ " \"is\": \"group\"";
-  return _obj_attributes;
-}
-invariant() {
-}
-#+END_SRC
-
-******** block
-
-#+NAME: meta_emitters_obj_attributes_private_an_attribute_txt_block
-#+BEGIN_SRC d
-@safe string txt_block()(string obj_txt_in) {
-  _obj_attributes = " \"use\": \"content\","
-  ~ " \"of\": \"block\","
-  ~ " \"is\": \"block\"";
-  return _obj_attributes;
-}
-invariant() {
-}
-#+END_SRC
-
-******** verse
-
-#+NAME: meta_emitters_obj_attributes_private_an_attribute_txt_verse
-#+BEGIN_SRC d
-@safe string txt_verse()(string obj_txt_in) {
-  _obj_attributes = " \"use\": \"content\","
-  ~ " \"of\": \"block\","
-  ~ " \"is\": \"verse\"";
-  return _obj_attributes;
-}
-invariant() {
-}
-#+END_SRC
-
-******** code
-
-#+NAME: meta_emitters_obj_attributes_private_an_attribute_txt_code
-#+BEGIN_SRC d
-@safe string txt_code()(string obj_txt_in) {
-  _obj_attributes = " \"use\": \"content\","
-  ~ " \"of\": \"block\","
-  ~ " \"is\": \"code\"";
-  return _obj_attributes;
-}
-invariant() {
-}
-#+END_SRC
-
-******** table
-
-#+NAME: meta_emitters_obj_attributes_private_an_attribute_txt_table
-#+BEGIN_SRC d
-@safe string txt_table()(string obj_txt_in) {
-  _obj_attributes = " \"use\": \"content\","
-  ~ " \"of\": \"block\","
-  ~ " \"is\": \"table\"";
-  return _obj_attributes;
-}
-invariant() {
-}
-#+END_SRC
-
-******** comment
-
-#+NAME: meta_emitters_obj_attributes_private_an_attribute_txt_comment
-#+BEGIN_SRC d
-@safe string txt_comment()(string obj_txt_in) {
-  _obj_attributes = " \"use\": \"comment\","
-  ~ " \"of\": \"comment\","
-  ~ " \"is\": \"comment\"";
-  return _obj_attributes;
-}
-invariant() {
-}
-#+END_SRC
-
-******** set additional attribute values, parse as json
-
-#+NAME: meta_emitters_obj_attributes_private_json
-#+BEGIN_SRC d
-@safe string _set_additional_values_parse_as_json()(
-  string              _obj_attrib,
-  string              obj_is_,
-  ObjGenericComposite _comp_obj_heading,
-) {
-  JSONValue oa_j = parseJSON(_obj_attrib);
-  assert(
-    (oa_j.type == JSON_TYPE.OBJECT)
-  );
-  if (obj_is_ == "heading") {
-    oa_j.object["object_number"]              = _comp_obj_heading.metainfo.ocn;
-    oa_j.object["lev_markup_number"]          = _comp_obj_heading.metainfo.heading_lev_markup;
-    oa_j.object["lev_collapsed_number"]       = _comp_obj_heading.metainfo.heading_lev_collapsed;
-    oa_j.object["heading_ptr"]                = _comp_obj_heading.ptr.heading;
-    oa_j.object["doc_object_ptr"]             = _comp_obj_heading.ptr.doc_object;
-  }
-  oa_j.object["parent_object_number"]         = _comp_obj_heading.metainfo.parent_ocn;
-  oa_j.object["parent_lev_markup_number"]     = _comp_obj_heading.metainfo.parent_lev_markup;
-  _obj_attrib                                 = oa_j.toString();
-  return _obj_attrib;
-}
-#+END_SRC
-
-****** }
-
-#+NAME: meta_emitters_obj_attributes_private_close
-#+BEGIN_SRC d
 }
-#+END_SRC
-
-**** book index :book:index:
-***** book index nugget hash :hash:nugget:
-
-#+NAME: meta_emitters_bookindex_nugget
-#+BEGIN_SRC d
+                                                                              /+ +/
 struct BookIndexNuggetHash {
   string main_term, sub_term, sub_term_bits;
   int object_number_offset, object_number_endpoint;
   string[] object_numbers;
   string[][string][string] bi_hash_nugget;
   string[] bi_main_terms_split_arr;
-  @safe string[][string][string] bookindex_nugget_hash(N,S)(
+  @safe string[][string][string] bookindex_nugget_hash(S)(
     string bookindex_section,
-    N      obj_cite_digits,
+    OCNset obj_cite_digits,
     S      tag_in_seg,
   ) {
     debug(asserts) {
@@ -6872,12 +5873,6 @@ struct BookIndexNuggetHash {
   invariant() {
   }
 }
-#+END_SRC
-
-***** book index (sort &) report indented :report:indented:
-
-#+NAME: meta_emitters_bookindex_report_indented
-#+BEGIN_SRC d
 struct BookIndexReportIndent {
   int mkn, skn;
   @safe void bookindex_report_indented()(
@@ -6904,863 +5899,755 @@ struct BookIndexReportIndent {
     }
   }
 }
-#+END_SRC
-
-***** book index (sort &) report section :report:section:
-****** { book index struct open
-
-#+NAME: meta_emitters_bookindex_report_section_function_open
-#+BEGIN_SRC d
 struct BookIndexReportSection {
   int  mkn, skn;
   static auto rgx = RgxI();
   static auto munge = ObjInlineMarkupMunge();
-#+END_SRC
-
-******* bookindex write section
-
-#+NAME: meta_emitters_bookindex_report_section_function_write_section
-#+BEGIN_SRC d
-@safe void bookindex_write_section()(
-  string[][string][string] bookindex_unordered_hashes
-) {
-  auto mainkeys =
-    bookindex_unordered_hashes.byKey.array
-    .sort!("toUpper(a) < toUpper(b)", SwapStrategy.stable).release;
-  foreach (mainkey; mainkeys) {
-    write("_0_1 ⑆!┨", mainkey, "┣! ");
-    foreach (ref_; bookindex_unordered_hashes[mainkey]["_a"]) {
-      auto go = ref_.replaceAll(rgx.book_index_go, "$1");
-      write(" {", ref_, "}#", go, ", ");
-    }
-    writeln(" \\\\");
-    bookindex_unordered_hashes[mainkey].remove("_a");
-    auto subkeys =
-      bookindex_unordered_hashes[mainkey].byKey.array
+  @safe void bookindex_write_section()(
+    string[][string][string] bookindex_unordered_hashes
+  ) {
+    auto mainkeys =
+      bookindex_unordered_hashes.byKey.array
       .sort!("toUpper(a) < toUpper(b)", SwapStrategy.stable).release;
-    foreach (subkey; subkeys) {
-      write("  ", subkey, ", ");
-      foreach (ref_; bookindex_unordered_hashes[mainkey][subkey]) {
+    foreach (mainkey; mainkeys) {
+      write("_0_1 ⑆!┨", mainkey, "┣! ");
+      foreach (ref_; bookindex_unordered_hashes[mainkey]["_a"]) {
         auto go = ref_.replaceAll(rgx.book_index_go, "$1");
         write(" {", ref_, "}#", go, ", ");
       }
       writeln(" \\\\");
-      ++skn;
-    }
-    ++mkn;
-  }
-}
-#+END_SRC
-
-******* book index (sort &) build section :report:section:
-
-#+NAME: meta_emitters_bookindex_report_section_function_build_abstraction
-#+BEGIN_SRC d
-@system auto bookindex_build_abstraction_section(N,B)(
-  string[][string][string] bookindex_unordered_hashes,
-  N                        obj_cite_digits,
-  B                        opt_action,
-) {
-  debug(asserts) {
-    static assert(is(typeof(obj_cite_digits.object_number)             == int));
-  }
-  mixin spineNode;
-  mixin InternalMarkup;
-  static auto mkup = InlineMarkup();
-  string type_is;
-  string lev;
-  int heading_lev_markup, heading_lev_collapsed;
-  string attrib;
-  int[string] indent;
-  auto mainkeys =
-    bookindex_unordered_hashes.byKey.array
-    .sort!("toUpper(a) < toUpper(b)", SwapStrategy.stable).release;
-  ObjGenericComposite[] bookindex_section;
-  ObjGenericComposite comp_obj_heading_, comp_obj_para;
-  auto node_para_int_ = node_metadata_para_int;
-  auto node_para_str_ = node_metadata_para_str;
-  if ((mainkeys.length > 0)
-  && (opt_action.backmatter
-  && opt_action.section_bookindex)) {
-    string bi_tmp;
-    string[] bi_tmp_tags;
-    {
-      comp_obj_heading_                                     = comp_obj_heading_.init;
-      comp_obj_heading_.metainfo.is_of_part                 = "backmatter";
-      comp_obj_heading_.metainfo.is_of_section              = "bookindex";
-      comp_obj_heading_.metainfo.is_of_type                 = "para";
-      comp_obj_heading_.metainfo.is_a                       = "heading";
-      comp_obj_heading_.text                                = "Book Index";
-      comp_obj_heading_.metainfo.ocn                        = 0;
-      comp_obj_heading_.metainfo.identifier                 = "";
-      comp_obj_heading_.metainfo.dummy_heading              = false;
-      comp_obj_heading_.metainfo.object_number_off          = false;
-      comp_obj_heading_.metainfo.object_number_type         = 0;
-      comp_obj_heading_.tags.segment_anchor_tag_epub        = "_part_book_index";
-      comp_obj_heading_.tags.anchor_tag_html                = comp_obj_heading_.tags.segment_anchor_tag_epub;
-      comp_obj_heading_.tags.in_segment_html                = "bookindex";
-      comp_obj_heading_.tags.anchor_tags                    = ["section_bookindex"];
-      comp_obj_heading_.metainfo.heading_lev_markup         = 1;
-      comp_obj_heading_.metainfo.heading_lev_collapsed      = 1;
-      comp_obj_heading_.metainfo.parent_ocn                 = 1;
-      comp_obj_heading_.metainfo.parent_lev_markup          = 0;
-      comp_obj_heading.has.inline_links                     = true;
-      bookindex_section                                     ~= comp_obj_heading_;
-      tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-      tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-      ++mkn;
-    }
-    {
-      comp_obj_heading_                                     = comp_obj_heading_.init;
-      comp_obj_heading_.metainfo.is_of_part                 = "backmatter";
-      comp_obj_heading_.metainfo.is_of_section              = "bookindex";
-      comp_obj_heading_.metainfo.is_of_type                 = "para";
-      comp_obj_heading_.metainfo.is_a                       = "heading";
-      comp_obj_heading_.text                                = "Index";
-      comp_obj_heading_.metainfo.ocn                        = 0;
-      comp_obj_heading_.metainfo.identifier                 = "";
-      comp_obj_heading_.metainfo.dummy_heading              = true;
-      comp_obj_heading_.metainfo.object_number_off          = true;
-      comp_obj_heading_.metainfo.object_number_type         = 0;
-      comp_obj_heading_.tags.segment_anchor_tag_epub        = "bookindex";
-      comp_obj_heading_.tags.anchor_tag_html                = comp_obj_heading_.tags.segment_anchor_tag_epub;
-      comp_obj_heading_.tags.in_segment_html                = comp_obj_heading_.tags.anchor_tag_html;
-      comp_obj_heading_.metainfo.heading_lev_markup         = 4;
-      comp_obj_heading_.metainfo.heading_lev_collapsed      = 2;
-      comp_obj_heading_.metainfo.parent_ocn                 = 1;
-      comp_obj_heading_.metainfo.parent_lev_markup          = 0;
-      comp_obj_heading.has.inline_links                     = false;
-      comp_obj_heading_.tags.anchor_tags                    = ["bookindex"];
-      bookindex_section                                     ~= comp_obj_heading_;
-      tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-      tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-      ++mkn;
-    }
-    import std.array : appender;
-    auto buffer = appender!(char[])();
-    string[dchar] transTable = [' ' : "_"];
-    foreach (mainkey; mainkeys) {
-      bi_tmp_tags = [""];
-      bi_tmp = mkup.ff_i ~ mkup.bold ~ mkup.ff_o ~ mainkey ~ mkup.ff_c ~ mkup.bold ~ " ";
-      buffer.clear();
-      bi_tmp_tags ~= translate(mainkey, transTable);
-      auto bkidx_lnk(string locs) {
-        string markup = "";
-        if (auto m = locs.matchFirst(rgx.book_index_go)) {
-          markup
-            = links_and_images("{ " ~ m["link"] ~ " }"
-            ~ "#" ~ m["ocn"] ~ ", ");
-        } else {
-          writeln(__LINE__, ": ", locs);
-        }
-        return markup;
-      }
-      foreach (ref_; bookindex_unordered_hashes[mainkey]["_a"]) {
-        bi_tmp ~= bkidx_lnk(ref_);
-      }
-      bi_tmp ~= " \\\\\n    ";
       bookindex_unordered_hashes[mainkey].remove("_a");
       auto subkeys =
         bookindex_unordered_hashes[mainkey].byKey.array
         .sort!("toUpper(a) < toUpper(b)", SwapStrategy.stable).release;
       foreach (subkey; subkeys) {
-        bi_tmp ~= subkey ~ ", ";
-        buffer.clear();
-        bi_tmp_tags ~= translate(subkey, transTable);
+        write("  ", subkey, ", ");
         foreach (ref_; bookindex_unordered_hashes[mainkey][subkey]) {
-          bi_tmp ~= bkidx_lnk(ref_);
+          auto go = ref_.replaceAll(rgx.book_index_go, "$1");
+          write(" {", ref_, "}#", go, ", ");
         }
-        bi_tmp ~= " \\\\\n    ";
+        writeln(" \\\\");
         ++skn;
       }
-      bi_tmp                                                 = bi_tmp.replaceFirst(rgx.trailing_linebreak, "");
-      comp_obj_para                                          = comp_obj_para.init;
-      comp_obj_para.metainfo.is_of_part                      = "backmatter";
-      comp_obj_para.metainfo.is_of_section                   = "bookindex";
-      comp_obj_para.metainfo.is_of_type                      = "para";
-      comp_obj_para.metainfo.is_a                            = "bookindex";
-      comp_obj_para.text                                     = bi_tmp.to!string.strip;
-      comp_obj_para.metainfo.ocn                             = 0;
-      comp_obj_para.metainfo.identifier                      = "";
-      comp_obj_para.metainfo.object_number_off               = true;
-      comp_obj_para.metainfo.object_number_type              = 0;
-      comp_obj_para.tags.anchor_tags                         = bi_tmp_tags;
-      comp_obj_para.attrib.indent_hang                       = 0;
-      comp_obj_para.attrib.indent_base                       = 1;
-      comp_obj_para.attrib.bullet                            = false;
-      comp_obj_para.has.inline_links                         = true;
-      comp_obj_para.text                                     = bi_tmp.to!string.strip;
-      bookindex_section                                      ~= comp_obj_para;
       ++mkn;
     }
-  } else {                              // no book index, (figure out what to do here)
-    comp_obj_heading_                                       = comp_obj_heading_.init;
-    comp_obj_heading_.text                                  = "(skip) there is no Book Index";
-    comp_obj_heading_.metainfo.ocn                          = 0;
-    comp_obj_heading_.metainfo.identifier                   = "";
-    comp_obj_heading_.metainfo.dummy_heading                = true;
-    comp_obj_heading_.metainfo.object_number_off            = true;
-    comp_obj_heading_.metainfo.object_number_type           = 0;
-    comp_obj_heading_.metainfo.heading_lev_markup           = 1;
-    comp_obj_heading_.metainfo.heading_lev_collapsed        = 1;
-    comp_obj_heading_.metainfo.parent_ocn                   = 1;
-    comp_obj_heading_.metainfo.parent_lev_markup            = 0;
-    bookindex_section                                       ~= comp_obj_heading_;
-  }
-  auto t = tuple(
-    bookindex_section,
-    obj_cite_digits
-  );
-  return t;
-}
-#+END_SRC
-
-****** }
-
-#+NAME: meta_emitters_bookindex_report_section_function_close
-#+BEGIN_SRC d
+  }
+  @system auto bookindex_build_abstraction_section(B)(
+    string[][string][string] bookindex_unordered_hashes,
+    OCNset                   obj_cite_digits,
+    B                        opt_action,
+  ) {
+    debug(asserts) {
+      static assert(is(typeof(obj_cite_digits.object_number)             == int));
+    }
+    mixin spineNode;
+    mixin InternalMarkup;
+    static auto mkup = InlineMarkup();
+    string type_is;
+    string lev;
+    int heading_lev_markup, heading_lev_collapsed;
+    string attrib;
+    int[string] indent;
+    auto mainkeys =
+      bookindex_unordered_hashes.byKey.array
+      .sort!("toUpper(a) < toUpper(b)", SwapStrategy.stable).release;
+    ObjGenericComposite[] bookindex_section;
+    ObjGenericComposite comp_obj_heading_, comp_obj_para;
+    auto node_para_int_ = node_metadata_para_int;
+    auto node_para_str_ = node_metadata_para_str;
+    if ((mainkeys.length > 0)
+    && (opt_action.backmatter
+    && opt_action.section_bookindex)) {
+      string bi_tmp;
+      string[] bi_tmp_tags;
+      {
+        comp_obj_heading_                                     = comp_obj_heading_.init;
+        comp_obj_heading_.metainfo.is_of_part                 = "backmatter";
+        comp_obj_heading_.metainfo.is_of_section              = "bookindex";
+        comp_obj_heading_.metainfo.is_of_type                 = "para";
+        comp_obj_heading_.metainfo.is_a                       = "heading";
+        comp_obj_heading_.text                                = "Book Index";
+        comp_obj_heading_.metainfo.ocn                        = 0;
+        comp_obj_heading_.metainfo.identifier                 = "";
+        comp_obj_heading_.metainfo.dummy_heading              = false;
+        comp_obj_heading_.metainfo.object_number_off          = false;
+        comp_obj_heading_.metainfo.object_number_type         = 0;
+        comp_obj_heading_.tags.segment_anchor_tag_epub        = "_part_book_index";
+        comp_obj_heading_.tags.anchor_tag_html                = comp_obj_heading_.tags.segment_anchor_tag_epub;
+        comp_obj_heading_.tags.in_segment_html                = "bookindex";
+        comp_obj_heading_.tags.anchor_tags                    = ["section_bookindex"];
+        comp_obj_heading_.metainfo.heading_lev_markup         = 1;
+        comp_obj_heading_.metainfo.heading_lev_collapsed      = 1;
+        comp_obj_heading_.metainfo.parent_ocn                 = 1;
+        comp_obj_heading_.metainfo.parent_lev_markup          = 0;
+        comp_obj_heading.has.inline_links                     = true;
+        bookindex_section                                     ~= comp_obj_heading_;
+        tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+        tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+        ++mkn;
+      }
+      {
+        comp_obj_heading_                                     = comp_obj_heading_.init;
+        comp_obj_heading_.metainfo.is_of_part                 = "backmatter";
+        comp_obj_heading_.metainfo.is_of_section              = "bookindex";
+        comp_obj_heading_.metainfo.is_of_type                 = "para";
+        comp_obj_heading_.metainfo.is_a                       = "heading";
+        comp_obj_heading_.text                                = "Index";
+        comp_obj_heading_.metainfo.ocn                        = 0;
+        comp_obj_heading_.metainfo.identifier                 = "";
+        comp_obj_heading_.metainfo.dummy_heading              = true;
+        comp_obj_heading_.metainfo.object_number_off          = true;
+        comp_obj_heading_.metainfo.object_number_type         = 0;
+        comp_obj_heading_.tags.segment_anchor_tag_epub        = "bookindex";
+        comp_obj_heading_.tags.anchor_tag_html                = comp_obj_heading_.tags.segment_anchor_tag_epub;
+        comp_obj_heading_.tags.in_segment_html                = comp_obj_heading_.tags.anchor_tag_html;
+        comp_obj_heading_.metainfo.heading_lev_markup         = 4;
+        comp_obj_heading_.metainfo.heading_lev_collapsed      = 2;
+        comp_obj_heading_.metainfo.parent_ocn                 = 1;
+        comp_obj_heading_.metainfo.parent_lev_markup          = 0;
+        comp_obj_heading.has.inline_links                     = false;
+        comp_obj_heading_.tags.anchor_tags                    = ["bookindex"];
+        bookindex_section                                     ~= comp_obj_heading_;
+        tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+        tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+        ++mkn;
+      }
+      import std.array : appender;
+      auto buffer = appender!(char[])();
+      string[dchar] transTable = [' ' : "_"];
+      foreach (mainkey; mainkeys) {
+        bi_tmp_tags = [""];
+        bi_tmp = mkup.ff_i ~ mkup.bold ~ mkup.ff_o ~ mainkey ~ mkup.ff_c ~ mkup.bold ~ " ";
+        buffer.clear();
+        bi_tmp_tags ~= translate(mainkey, transTable);
+        auto bkidx_lnk(string locs) {
+          string markup = "";
+          if (auto m = locs.matchFirst(rgx.book_index_go)) {
+            markup
+              = links_and_images("{ " ~ m["link"] ~ " }"
+              ~ "#" ~ m["ocn"] ~ ", ");
+          } else {
+            writeln(__LINE__, ": ", locs);
+          }
+          return markup;
+        }
+        foreach (ref_; bookindex_unordered_hashes[mainkey]["_a"]) {
+          bi_tmp ~= bkidx_lnk(ref_);
+        }
+        bi_tmp ~= " \\\\\n    ";
+        bookindex_unordered_hashes[mainkey].remove("_a");
+        auto subkeys =
+          bookindex_unordered_hashes[mainkey].byKey.array
+          .sort!("toUpper(a) < toUpper(b)", SwapStrategy.stable).release;
+        foreach (subkey; subkeys) {
+          bi_tmp ~= subkey ~ ", ";
+          buffer.clear();
+          bi_tmp_tags ~= translate(subkey, transTable);
+          foreach (ref_; bookindex_unordered_hashes[mainkey][subkey]) {
+            bi_tmp ~= bkidx_lnk(ref_);
+          }
+          bi_tmp ~= " \\\\\n    ";
+          ++skn;
+        }
+        bi_tmp                                                 = bi_tmp.replaceFirst(rgx.trailing_linebreak, "");
+        comp_obj_para                                          = comp_obj_para.init;
+        comp_obj_para.metainfo.is_of_part                      = "backmatter";
+        comp_obj_para.metainfo.is_of_section                   = "bookindex";
+        comp_obj_para.metainfo.is_of_type                      = "para";
+        comp_obj_para.metainfo.is_a                            = "bookindex";
+        comp_obj_para.text                                     = bi_tmp.to!string.strip;
+        comp_obj_para.metainfo.ocn                             = 0;
+        comp_obj_para.metainfo.identifier                      = "";
+        comp_obj_para.metainfo.object_number_off               = true;
+        comp_obj_para.metainfo.object_number_type              = 0;
+        comp_obj_para.tags.anchor_tags                         = bi_tmp_tags;
+        comp_obj_para.attrib.indent_hang                       = 0;
+        comp_obj_para.attrib.indent_base                       = 1;
+        comp_obj_para.attrib.bullet                            = false;
+        comp_obj_para.has.inline_links                         = true;
+        comp_obj_para.text                                     = bi_tmp.to!string.strip;
+        bookindex_section                                      ~= comp_obj_para;
+        ++mkn;
+      }
+    } else {                              // no book index, (figure out what to do here)
+      comp_obj_heading_                                       = comp_obj_heading_.init;
+      comp_obj_heading_.text                                  = "(skip) there is no Book Index";
+      comp_obj_heading_.metainfo.ocn                          = 0;
+      comp_obj_heading_.metainfo.identifier                   = "";
+      comp_obj_heading_.metainfo.dummy_heading                = true;
+      comp_obj_heading_.metainfo.object_number_off            = true;
+      comp_obj_heading_.metainfo.object_number_type           = 0;
+      comp_obj_heading_.metainfo.heading_lev_markup           = 1;
+      comp_obj_heading_.metainfo.heading_lev_collapsed        = 1;
+      comp_obj_heading_.metainfo.parent_ocn                   = 1;
+      comp_obj_heading_.metainfo.parent_lev_markup            = 0;
+      bookindex_section                                       ~= comp_obj_heading_;
+    }
+    auto t = tuple(
+      bookindex_section,
+      obj_cite_digits
+    );
+    return t;
+  }
 }
-#+END_SRC
-
-**** (end)notes section :endnotes:section:
-
-#+NAME: meta_emitters_endnotes_function_open
-#+BEGIN_SRC d
+                                                                              /+ +/
 struct NotesSection {
   string[string] object_notes;
   int previous_count;
   int mkn;
   static auto rgx = RgxI();
-#+END_SRC
-
-***** { gather notes for endnote section struct open
-
-#+NAME: meta_emitters_endnotes_function_gather_notes
-#+BEGIN_SRC d
-@safe private auto gather_notes_for_endnote_section(
-  ObjGenericComposite[] contents_am,
-  string[string]        tag_in_seg,
-  int                   cntr,
-) {
-  assert((contents_am[cntr].metainfo.is_a == "para")
-  || (contents_am[cntr].metainfo.is_a     == "heading")
-  || (contents_am[cntr].metainfo.is_a     == "quote")
-  || (contents_am[cntr].metainfo.is_a     == "group")
-  || (contents_am[cntr].metainfo.is_a     == "block")
-  || (contents_am[cntr].metainfo.is_a     == "verse"));
-  assert(cntr >= previous_count);
-  assert(
-    (contents_am[cntr].text).match(
-    rgx.inline_notes_al_all_note)
-  );
-  mixin InternalMarkup;
-  previous_count = cntr;
-  static auto mkup = InlineMarkup();
-  static auto munge = ObjInlineMarkupMunge();
-  foreach(m;
-    (contents_am[cntr].text).matchAll(
-      rgx.inline_notes_al_special_char_note)
-  ) {
-    debug(endnotes_build) {
-      writeln(
-        "{", mkup.ff_i, mkup.superscript, mkup.ff_o, m["char"], ".", mkup.ff_c, mkup.superscript, "}"
-        ~ mkup.mark_internal_site_lnk,
-        tag_in_seg["seg_lv4"],
-          ".fnSuffix#noteref_\n  ", m["char"], " ",
-        m["note"]); // sometimes need segment name (segmented html & epub)
-    }
-    // you need anchor for segments at this point ->
-    object_notes["anchor"] ~= "note_" ~ m["char"] ~ "』";
-    object_notes["notes"]  ~= (tag_in_seg["seg_lv4"].empty)
-    ? (links_and_images(
-        "{" ~ mkup.ff_i ~ mkup.superscript  ~ mkup.ff_o ~ m["char"] ~ "." ~ mkup.ff_c  ~ mkup.superscript  ~ "}#noteref_"
-        ~ m["char"]) ~ " "
-        ~ m["note"] ~ "』"
-      )
-    : (links_and_images(
-        "{" ~ mkup.ff_i ~ mkup.superscript ~ mkup.ff_o ~ m["char"] ~ "." ~ mkup.ff_c  ~ mkup.superscript ~ "}"
-         ~ mkup.mark_internal_site_lnk
-         ~ tag_in_seg["seg_lv4"]
-         ~ ".fnSuffix#noteref_"
-         ~ m["char"]) ~ " "
-         ~ m["note"] ~ "』"
-      );
-  }
-  foreach(m;
-    (contents_am[cntr].text).matchAll(
-      rgx.inline_notes_al_regular_number_note)
+  @safe private auto gather_notes_for_endnote_section(
+    ObjGenericComposite[] contents_am,
+    string[string]        tag_in_seg,
+    int                   cntr,
   ) {
-    debug(endnotes_build) {
-      writeln(
-        "{", mkup.ff_i, mkup.superscipt, mkup.ff_o, m["num"], ".", mkup.ff_c, mkup.superscipt, "}"
-        ~ mkup.mark_internal_site_lnk,
-        tag_in_seg["seg_lv4"],
-          ".fnSuffix#noteref_\n  ", m["num"], " ",
-        m["note"]); // sometimes need segment name (segmented html & epub)
-    }
-    // you need anchor for segments at this point ->
-    object_notes["anchor"] ~= "note_" ~ m["num"] ~ "』";
-    object_notes["notes"]  ~= (tag_in_seg["seg_lv4"].empty)
-    ? (links_and_images(
-        "{" ~ mkup.ff_i ~ mkup.superscript  ~ mkup.ff_o ~ m["num"] ~ "." ~ mkup.ff_c  ~ mkup.superscript  ~ "}#noteref_"
-        ~ m["num"]) ~ " "
-        ~ m["note"] ~ "』"
-      )
-    : (links_and_images(
-        "{" ~ mkup.ff_i ~ mkup.superscript ~ mkup.ff_o ~ m["num"] ~ "." ~ mkup.ff_c  ~ mkup.superscript ~ "}"
-         ~ mkup.mark_internal_site_lnk
-         ~ tag_in_seg["seg_lv4"]
-         ~ ".fnSuffix#noteref_"
-         ~ m["num"]) ~ " "
-         ~ m["note"] ~ "』"
-      );
-  }
-  return object_notes;
-}
-#+END_SRC
-
-****** gathered notes
-
-#+NAME: meta_emitters_endnotes_function_gathered_notes
-#+BEGIN_SRC d
-@safe private auto gathered_notes() {
-  string[][string] endnotes_;
-  if (object_notes.length > 1) {
-    endnotes_["notes"] = (object_notes["notes"].split(rgx.break_string))[0..$-1];
-    endnotes_["anchor"] = (object_notes["anchor"].split(rgx.break_string))[0..$-1];
-  } else {
-    endnotes_["notes"] = [];
-    endnotes_["anchor"] = [];
-  }
-  return endnotes_;
-}
-#+END_SRC
-
-****** endnote objects
-
-#+NAME: meta_emitters_endnotes_function_endnote_objects
-#+BEGIN_SRC d
-@safe private auto endnote_objects(N,O)(
-  N              obj_cite_digits,
-  O              opt_action,
-) {
-  mixin spineNode;
-  ObjGenericComposite[] the_document_endnotes_section;
-  auto endnotes_ = gathered_notes();
-  string type_is;
-  string lev, lev_markup_number, lev_collapsed_number;
-  string attrib;
-  int[string] indent;
-  ObjGenericComposite comp_obj_heading_;
-  if ((endnotes_["notes"].length > 0)
-  && (opt_action.backmatter && opt_action.section_endnotes)) {
-    {
-      comp_obj_heading_                                     = comp_obj_heading_.init;
-      comp_obj_heading_.metainfo.is_of_part                 = "backmatter";
-      comp_obj_heading_.metainfo.is_of_section              = "endnotes";
-      comp_obj_heading_.metainfo.is_of_type                 = "para";
-      comp_obj_heading_.metainfo.is_a                       = "heading";
-      comp_obj_heading_.text                                = "Endnotes";
-      comp_obj_heading_.metainfo.ocn                        = 0;
-      comp_obj_heading_.metainfo.identifier                 = "";
-      comp_obj_heading_.metainfo.dummy_heading              = false;
-      comp_obj_heading_.metainfo.object_number_off          = false;
-      comp_obj_heading_.metainfo.object_number_type         = 0;
-      comp_obj_heading_.tags.segment_anchor_tag_epub        = "_part_endnotes";
-      comp_obj_heading_.tags.anchor_tag_html                = comp_obj_heading_.tags.segment_anchor_tag_epub;
-      comp_obj_heading_.tags.in_segment_html                = "endnotes";
-      comp_obj_heading_.tags.anchor_tags                    = ["section_endnotes"];
-      comp_obj_heading_.metainfo.heading_lev_markup         = 1;
-      comp_obj_heading_.metainfo.heading_lev_collapsed      = 1;
-      comp_obj_heading_.metainfo.parent_ocn                 = 1;
-      comp_obj_heading_.metainfo.parent_lev_markup          = 0;
-      the_document_endnotes_section                         ~= comp_obj_heading_;
-      tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-      tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-      ++mkn;
+    assert((contents_am[cntr].metainfo.is_a == "para")
+    || (contents_am[cntr].metainfo.is_a     == "heading")
+    || (contents_am[cntr].metainfo.is_a     == "quote")
+    || (contents_am[cntr].metainfo.is_a     == "group")
+    || (contents_am[cntr].metainfo.is_a     == "block")
+    || (contents_am[cntr].metainfo.is_a     == "verse"));
+    assert(cntr >= previous_count);
+    assert(
+      (contents_am[cntr].text).match(
+      rgx.inline_notes_al_all_note)
+    );
+    mixin InternalMarkup;
+    previous_count = cntr;
+    static auto mkup = InlineMarkup();
+    static auto munge = ObjInlineMarkupMunge();
+    foreach(m;
+      (contents_am[cntr].text).matchAll(
+        rgx.inline_notes_al_special_char_note)
+    ) {
+      debug(endnotes_build) {
+        writeln(
+          "{", mkup.ff_i, mkup.superscript, mkup.ff_o, m["char"], ".", mkup.ff_c, mkup.superscript, "}"
+          ~ mkup.mark_internal_site_lnk,
+          tag_in_seg["seg_lv4"],
+            ".fnSuffix#noteref_\n  ", m["char"], " ",
+          m["note"]); // sometimes need segment name (segmented html & epub)
+      }
+      // you need anchor for segments at this point ->
+      object_notes["anchor"] ~= "note_" ~ m["char"] ~ "』";
+      object_notes["notes"]  ~= (tag_in_seg["seg_lv4"].empty)
+      ? (links_and_images(
+          "{" ~ mkup.ff_i ~ mkup.superscript  ~ mkup.ff_o ~ m["char"] ~ "." ~ mkup.ff_c  ~ mkup.superscript  ~ "}#noteref_"
+          ~ m["char"]) ~ " "
+          ~ m["note"] ~ "』"
+        )
+      : (links_and_images(
+          "{" ~ mkup.ff_i ~ mkup.superscript ~ mkup.ff_o ~ m["char"] ~ "." ~ mkup.ff_c  ~ mkup.superscript ~ "}"
+           ~ mkup.mark_internal_site_lnk
+           ~ tag_in_seg["seg_lv4"]
+           ~ ".fnSuffix#noteref_"
+           ~ m["char"]) ~ " "
+           ~ m["note"] ~ "』"
+        );
     }
-    {
-      comp_obj_heading_                                     = comp_obj_heading_.init;
-      comp_obj_heading_.metainfo.is_of_part                 = "backmatter";
-      comp_obj_heading_.metainfo.is_of_section              = "endnotes";
-      comp_obj_heading_.metainfo.is_of_type                 = "para";
-      comp_obj_heading_.metainfo.is_a                       = "heading";
-      comp_obj_heading_.text                                = "Endnotes";
-      comp_obj_heading_.metainfo.ocn                        = 0;
-      comp_obj_heading_.metainfo.identifier                 = "";
-      comp_obj_heading_.metainfo.dummy_heading              = true;
-      comp_obj_heading_.metainfo.object_number_off          = true;
-      comp_obj_heading_.metainfo.object_number_type         = 0;
-      comp_obj_heading_.tags.segment_anchor_tag_epub        = "endnotes";
-      comp_obj_heading_.tags.anchor_tag_html                = comp_obj_heading_.tags.segment_anchor_tag_epub;
-      comp_obj_heading_.tags.in_segment_html                = comp_obj_heading_.tags.anchor_tag_html;
-      comp_obj_heading_.metainfo.heading_lev_markup         = 4;
-      comp_obj_heading_.metainfo.heading_lev_collapsed      = 2;
-      comp_obj_heading_.metainfo.parent_ocn                 = 1;
-      comp_obj_heading_.metainfo.parent_lev_markup          = 0;
-      comp_obj_heading_.tags.anchor_tags                    = ["endnotes"];
-      the_document_endnotes_section                         ~= comp_obj_heading_;
-      tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-      tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-      ++mkn;
+    foreach(m;
+      (contents_am[cntr].text).matchAll(
+        rgx.inline_notes_al_regular_number_note)
+    ) {
+      debug(endnotes_build) {
+        writeln(
+          "{", mkup.ff_i, mkup.superscipt, mkup.ff_o, m["num"], ".", mkup.ff_c, mkup.superscipt, "}"
+          ~ mkup.mark_internal_site_lnk,
+          tag_in_seg["seg_lv4"],
+            ".fnSuffix#noteref_\n  ", m["num"], " ",
+          m["note"]); // sometimes need segment name (segmented html & epub)
+      }
+      // you need anchor for segments at this point ->
+      object_notes["anchor"] ~= "note_" ~ m["num"] ~ "』";
+      object_notes["notes"]  ~= (tag_in_seg["seg_lv4"].empty)
+      ? (links_and_images(
+          "{" ~ mkup.ff_i ~ mkup.superscript  ~ mkup.ff_o ~ m["num"] ~ "." ~ mkup.ff_c  ~ mkup.superscript  ~ "}#noteref_"
+          ~ m["num"]) ~ " "
+          ~ m["note"] ~ "』"
+        )
+      : (links_and_images(
+          "{" ~ mkup.ff_i ~ mkup.superscript ~ mkup.ff_o ~ m["num"] ~ "." ~ mkup.ff_c  ~ mkup.superscript ~ "}"
+           ~ mkup.mark_internal_site_lnk
+           ~ tag_in_seg["seg_lv4"]
+           ~ ".fnSuffix#noteref_"
+           ~ m["num"]) ~ " "
+           ~ m["note"] ~ "』"
+        );
     }
-  } else {
-    comp_obj_heading_                                       = comp_obj_heading_.init;
-    comp_obj_heading_.metainfo.is_of_part                   = "empty";
-    comp_obj_heading_.metainfo.is_of_section                = "empty";
-    comp_obj_heading_.metainfo.is_of_type                   = "para";
-    comp_obj_heading_.metainfo.is_a                         = "heading";
-    comp_obj_heading_.text                                  = "(skip) there are no Endnotes";
-    comp_obj_heading_.metainfo.ocn                          = 0;
-    comp_obj_heading_.metainfo.identifier                   = "";
-    comp_obj_heading_.metainfo.dummy_heading                = true;
-    comp_obj_heading_.metainfo.object_number_off            = true;
-    comp_obj_heading_.metainfo.object_number_type           = 0;
-    comp_obj_heading_.metainfo.heading_lev_markup           = 1;
-    comp_obj_heading_.metainfo.heading_lev_collapsed        = 1;
-    comp_obj_heading_.metainfo.parent_ocn                   = 1;
-    comp_obj_heading_.metainfo.parent_lev_markup            = 0;
-    the_document_endnotes_section                           ~= comp_obj_heading_;
-  }
-  if (opt_action.backmatter && opt_action.section_endnotes) {
-    ObjGenericComposite comp_obj_endnote_;
-    comp_obj_endnote_                                       = comp_obj_endnote_.init;
-    comp_obj_endnote_.metainfo.is_of_part                   = "backmatter";
-    comp_obj_endnote_.metainfo.is_of_section                = "endnotes";
-    comp_obj_endnote_.metainfo.is_of_type                   = "para";
-    comp_obj_endnote_.metainfo.is_a                         = "endnote";
-    comp_obj_endnote_.metainfo.ocn                          = 0;
-    comp_obj_endnote_.metainfo.identifier                   = "";
-    // comp_obj_heading_.metainfo.dummy_heading                = false;
-    comp_obj_heading_.metainfo.object_number_off            = true;
-    comp_obj_heading_.metainfo.object_number_type           = 0;
-    comp_obj_endnote_.attrib.indent_hang                    = 0;
-    comp_obj_endnote_.attrib.indent_base                    = 0;
-    comp_obj_endnote_.attrib.bullet                         = false;
-    foreach (i, endnote; endnotes_["notes"]) {
-      auto     m                                            = endnote.matchFirst(rgx.note_ref);
-      string   notenumber                                   = m["ref"].to!string;
-      string   anchor_tag                                   = "note_" ~ notenumber;
-      comp_obj_endnote_.tags.anchor_tags                    = [ endnotes_["anchor"][i] ];
-      comp_obj_endnote_.has.inline_links                    = true;
-      comp_obj_endnote_.text                                = endnote.inline_markup_faces.strip;
-      the_document_endnotes_section                         ~= comp_obj_endnote_;
-    }
-  }
-  auto t = tuple(the_document_endnotes_section, obj_cite_digits);
-  return t;
-}
-#+END_SRC
-
-***** }
-
-#+NAME: meta_emitters_endnotes_function_close
-#+BEGIN_SRC d
-}
-#+END_SRC
-
-**** bibliography :bibliography:
-***** { biblio struct
-
-#+NAME: meta_emitters_bibliography_function_open
-#+BEGIN_SRC d
+    return object_notes;
+  }
+  @safe private auto gathered_notes() {
+    string[][string] endnotes_;
+    if (object_notes.length > 1) {
+      endnotes_["notes"] = (object_notes["notes"].split(rgx.break_string))[0..$-1];
+      endnotes_["anchor"] = (object_notes["anchor"].split(rgx.break_string))[0..$-1];
+    } else {
+      endnotes_["notes"] = [];
+      endnotes_["anchor"] = [];
+    }
+    return endnotes_;
+  }
+  @safe private auto endnote_objects(O)(
+    OCNset         obj_cite_digits,
+    O              opt_action,
+  ) {
+    mixin spineNode;
+    ObjGenericComposite[] the_document_endnotes_section;
+    auto endnotes_ = gathered_notes();
+    string type_is;
+    string lev, lev_markup_number, lev_collapsed_number;
+    string attrib;
+    int[string] indent;
+    ObjGenericComposite comp_obj_heading_;
+    if ((endnotes_["notes"].length > 0)
+    && (opt_action.backmatter && opt_action.section_endnotes)) {
+      {
+        comp_obj_heading_                                     = comp_obj_heading_.init;
+        comp_obj_heading_.metainfo.is_of_part                 = "backmatter";
+        comp_obj_heading_.metainfo.is_of_section              = "endnotes";
+        comp_obj_heading_.metainfo.is_of_type                 = "para";
+        comp_obj_heading_.metainfo.is_a                       = "heading";
+        comp_obj_heading_.text                                = "Endnotes";
+        comp_obj_heading_.metainfo.ocn                        = 0;
+        comp_obj_heading_.metainfo.identifier                 = "";
+        comp_obj_heading_.metainfo.dummy_heading              = false;
+        comp_obj_heading_.metainfo.object_number_off          = false;
+        comp_obj_heading_.metainfo.object_number_type         = 0;
+        comp_obj_heading_.tags.segment_anchor_tag_epub        = "_part_endnotes";
+        comp_obj_heading_.tags.anchor_tag_html                = comp_obj_heading_.tags.segment_anchor_tag_epub;
+        comp_obj_heading_.tags.in_segment_html                = "endnotes";
+        comp_obj_heading_.tags.anchor_tags                    = ["section_endnotes"];
+        comp_obj_heading_.metainfo.heading_lev_markup         = 1;
+        comp_obj_heading_.metainfo.heading_lev_collapsed      = 1;
+        comp_obj_heading_.metainfo.parent_ocn                 = 1;
+        comp_obj_heading_.metainfo.parent_lev_markup          = 0;
+        the_document_endnotes_section                         ~= comp_obj_heading_;
+        tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+        tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+        ++mkn;
+      }
+      {
+        comp_obj_heading_                                     = comp_obj_heading_.init;
+        comp_obj_heading_.metainfo.is_of_part                 = "backmatter";
+        comp_obj_heading_.metainfo.is_of_section              = "endnotes";
+        comp_obj_heading_.metainfo.is_of_type                 = "para";
+        comp_obj_heading_.metainfo.is_a                       = "heading";
+        comp_obj_heading_.text                                = "Endnotes";
+        comp_obj_heading_.metainfo.ocn                        = 0;
+        comp_obj_heading_.metainfo.identifier                 = "";
+        comp_obj_heading_.metainfo.dummy_heading              = true;
+        comp_obj_heading_.metainfo.object_number_off          = true;
+        comp_obj_heading_.metainfo.object_number_type         = 0;
+        comp_obj_heading_.tags.segment_anchor_tag_epub        = "endnotes";
+        comp_obj_heading_.tags.anchor_tag_html                = comp_obj_heading_.tags.segment_anchor_tag_epub;
+        comp_obj_heading_.tags.in_segment_html                = comp_obj_heading_.tags.anchor_tag_html;
+        comp_obj_heading_.metainfo.heading_lev_markup         = 4;
+        comp_obj_heading_.metainfo.heading_lev_collapsed      = 2;
+        comp_obj_heading_.metainfo.parent_ocn                 = 1;
+        comp_obj_heading_.metainfo.parent_lev_markup          = 0;
+        comp_obj_heading_.tags.anchor_tags                    = ["endnotes"];
+        the_document_endnotes_section                         ~= comp_obj_heading_;
+        tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+        tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+        ++mkn;
+      }
+    } else {
+      comp_obj_heading_                                       = comp_obj_heading_.init;
+      comp_obj_heading_.metainfo.is_of_part                   = "empty";
+      comp_obj_heading_.metainfo.is_of_section                = "empty";
+      comp_obj_heading_.metainfo.is_of_type                   = "para";
+      comp_obj_heading_.metainfo.is_a                         = "heading";
+      comp_obj_heading_.text                                  = "(skip) there are no Endnotes";
+      comp_obj_heading_.metainfo.ocn                          = 0;
+      comp_obj_heading_.metainfo.identifier                   = "";
+      comp_obj_heading_.metainfo.dummy_heading                = true;
+      comp_obj_heading_.metainfo.object_number_off            = true;
+      comp_obj_heading_.metainfo.object_number_type           = 0;
+      comp_obj_heading_.metainfo.heading_lev_markup           = 1;
+      comp_obj_heading_.metainfo.heading_lev_collapsed        = 1;
+      comp_obj_heading_.metainfo.parent_ocn                   = 1;
+      comp_obj_heading_.metainfo.parent_lev_markup            = 0;
+      the_document_endnotes_section                           ~= comp_obj_heading_;
+    }
+    if (opt_action.backmatter && opt_action.section_endnotes) {
+      ObjGenericComposite comp_obj_endnote_;
+      comp_obj_endnote_                                       = comp_obj_endnote_.init;
+      comp_obj_endnote_.metainfo.is_of_part                   = "backmatter";
+      comp_obj_endnote_.metainfo.is_of_section                = "endnotes";
+      comp_obj_endnote_.metainfo.is_of_type                   = "para";
+      comp_obj_endnote_.metainfo.is_a                         = "endnote";
+      comp_obj_endnote_.metainfo.ocn                          = 0;
+      comp_obj_endnote_.metainfo.identifier                   = "";
+      // comp_obj_heading_.metainfo.dummy_heading                = false;
+      comp_obj_heading_.metainfo.object_number_off            = true;
+      comp_obj_heading_.metainfo.object_number_type           = 0;
+      comp_obj_endnote_.attrib.indent_hang                    = 0;
+      comp_obj_endnote_.attrib.indent_base                    = 0;
+      comp_obj_endnote_.attrib.bullet                         = false;
+      foreach (i, endnote; endnotes_["notes"]) {
+        auto     m                                            = endnote.matchFirst(rgx.note_ref);
+        string   notenumber                                   = m["ref"].to!string;
+        string   anchor_tag                                   = "note_" ~ notenumber;
+        comp_obj_endnote_.tags.anchor_tags                    = [ endnotes_["anchor"][i] ];
+        comp_obj_endnote_.has.inline_links                    = true;
+        comp_obj_endnote_.text                                = endnote.inline_markup_faces.strip;
+        the_document_endnotes_section                         ~= comp_obj_endnote_;
+      }
+    }
+    auto t = tuple(the_document_endnotes_section, obj_cite_digits);
+    return t;
+  }
+}
+                                                                              /+ +/
 struct Bibliography {
-#+END_SRC
-
-****** biblio
-
-#+NAME: meta_emitters_bibliography_function_biblio_sorted
-#+BEGIN_SRC d
-@system public JSONValue[] flow_bibliography_()(
-  return ref string[]    biblio_unsorted_incomplete,
-  return ref JSONValue[] bib_arr_json
-) {
-  JSONValue[] biblio_unsorted
-    = biblio_make_unsorted_array_of_json_objects(biblio_unsorted_incomplete, bib_arr_json); // TODO lookat returns
-  biblio_arr_json = [];
-  biblio_unsorted_incomplete = [];
-  JSONValue[] biblio_sorted__ = biblio_sort(biblio_unsorted);
-  debug(biblio0) {
-    biblio_debug(biblio_sorted__);
-    writeln("---");
-    writeln("unsorted incomplete: ", biblio_unsorted_incomplete.length);
-    writeln("json:                ", bib_arr_json.length);
-    writeln("unsorted:            ", biblio_unsorted.length);
-    writeln("sorted:              ", biblio_sorted__.length);
-    int cntr;
-    int[7] x;
-    while (cntr < x.length) {
-      writeln(cntr, ": ", biblio_sorted__[cntr]["fulltitle"]);
-      cntr++;
-    }
-  }
-  return biblio_sorted__;
-}
-#+END_SRC
-
-****** biblio unsorted complete
-
-#+NAME: meta_emitters_bibliography_function_biblio_unsorted_json_object_array
-#+BEGIN_SRC d
-@system final private JSONValue[] biblio_make_unsorted_array_of_json_objects()(
-  string[]      biblio_unordered,
-  JSONValue[]   bib_arr_json
-) {
-  foreach (bibent; biblio_unordered) {
-    /+ update bib to include deemed_author, needed for:
-      sort_bibliography_array_by_deemed_author_year_title
-      either: sort on multiple fields, or; create such sort field
-    +/
-    JSONValue j = parseJSON(bibent);
-    if (!empty(j["fulltitle"].str)) {
-      if (!empty(j["author_raw"].str)) {
-        j["deemed_author"] = j["author_arr"][0];
-      } else if (!empty(j["editor_raw"].str)) {
-        j["deemed_author"] = j["editor_arr"][0];
-      }
-      j["sortby_deemed_author_year_title"] = (
-        j["deemed_author"].str ~
-         "; " ~
-         j["year"].str ~
-         "; "  ~
-         j["fulltitle"].str
-      );
+  @system public auto flow_bibliography_()(
+    string[]    biblio_unsorted_incomplete,
+    JSONValue[] bib_arr_json
+  ) {
+    JSONValue[] biblio_unsorted
+      = biblio_make_unsorted_array_of_json_objects(biblio_unsorted_incomplete, bib_arr_json); // TODO lookat returns
+    biblio_arr_json = [];
+    biblio_unsorted_incomplete = [];
+    JSONValue[] biblio_sorted__ = biblio_sort(biblio_unsorted);
+    debug(biblio0) {
+      biblio_debug(biblio_sorted__);
+      writeln("---");
+      writeln("unsorted incomplete: ", biblio_unsorted_incomplete.length);
+      writeln("json:                ", bib_arr_json.length);
+      writeln("unsorted:            ", biblio_unsorted.length);
+      writeln("sorted:              ", biblio_sorted__.length);
+      int cntr;
+      int[7] x;
+      while (cntr < x.length) {
+        writeln(cntr, ": ", biblio_sorted__[cntr]["fulltitle"]);
+        cntr++;
+      }
+    }
+    struct retStruct {
+      JSONValue[] biblio_sorted;
+      JSONValue[] bib_arr_json;
+      string[]    biblio_unsorted_incomplete;
+    }
+    retStruct ret;
+    {
+      ret.biblio_sorted  = biblio_sorted__;
+      ret.bib_arr_json  = bib_arr_json;
+      ret.biblio_unsorted_incomplete  = biblio_unsorted_incomplete;
     }
-    bib_arr_json ~= j;
+    return ret;
   }
-  return bib_arr_json.dup;
-}
-#+END_SRC
-
-****** biblio sort
-
-#+NAME: meta_emitters_bibliography_function_biblio_sort_json
-#+BEGIN_SRC d
-@system final private JSONValue[] biblio_sort()(JSONValue[] biblio_unordered) {
-  JSONValue[] biblio_sorted_;
-  biblio_sorted_
-    = sort!((a, b){
-      return ((a["sortby_deemed_author_year_title"].str) < (b["sortby_deemed_author_year_title"].str));
-    })(biblio_unordered).array;
-  debug(bibliosorted) {
-    foreach (j; biblio_sorted_) {
+  @system final private JSONValue[] biblio_make_unsorted_array_of_json_objects()(
+    string[]      biblio_unordered,
+    JSONValue[]   bib_arr_json
+  ) {
+    foreach (bibent; biblio_unordered) {
+      /+ update bib to include deemed_author, needed for:
+        sort_bibliography_array_by_deemed_author_year_title
+        either: sort on multiple fields, or; create such sort field
+      +/
+      JSONValue j = parseJSON(bibent);
       if (!empty(j["fulltitle"].str)) {
-        writeln(j["sortby_deemed_author_year_title"]);
+        if (!empty(j["author_raw"].str)) {
+          j["deemed_author"] = j["author_arr"][0];
+        } else if (!empty(j["editor_raw"].str)) {
+          j["deemed_author"] = j["editor_arr"][0];
+        }
+        j["sortby_deemed_author_year_title"] = (
+          j["deemed_author"].str ~
+           "; " ~
+           j["year"].str ~
+           "; "  ~
+           j["fulltitle"].str
+        );
       }
+      bib_arr_json ~= j;
     }
+    return bib_arr_json.dup;
   }
-  return biblio_sorted_;
-}
-#+END_SRC
-
-****** biblio debug
-
-#+NAME: meta_emitters_bibliography_function_biblio_sorted_json
-#+BEGIN_SRC d
-@system void biblio_debug()(JSONValue[] biblio_sorted) {
-  debug(biblio0) {
-    foreach (j; biblio_sorted) {
-      if (!empty(j["fulltitle"].str)) {
-        writeln(j["sortby_deemed_author_year_title"]);
+  @system final private JSONValue[] biblio_sort()(JSONValue[] biblio_unordered) {
+    JSONValue[] biblio_sorted_;
+    biblio_sorted_
+      = sort!((a, b){
+        return ((a["sortby_deemed_author_year_title"].str) < (b["sortby_deemed_author_year_title"].str));
+      })(biblio_unordered).array;
+    debug(bibliosorted) {
+      foreach (j; biblio_sorted_) {
+        if (!empty(j["fulltitle"].str)) {
+          writeln(j["sortby_deemed_author_year_title"]);
+        }
+      }
+    }
+    return biblio_sorted_;
+  }
+  @system void biblio_debug()(JSONValue[] biblio_sorted) {
+    debug(biblio0) {
+      foreach (j; biblio_sorted) {
+        if (!empty(j["fulltitle"].str)) {
+          writeln(j["sortby_deemed_author_year_title"]);
+        }
       }
     }
   }
 }
-#+END_SRC
-
-***** }
-
-#+NAME: meta_emitters_bibliography_function_close
-#+BEGIN_SRC d
-}
-#+END_SRC
-
-**** node structure metadata :structure:metadata:node:
-***** { metadata node struct
-
-#+NAME: meta_emitters_metadata_function_open
-#+BEGIN_SRC d
+                                                                              /+ +/
 struct NodeStructureMetadata {
   int lv, lv0, lv1, lv2, lv3, lv4, lv5, lv6, lv7;
   int obj_cite_digit;
   int[string] p_; // p_ parent_
   static auto rgx = RgxI();
-#+END_SRC
-
-****** node metadata emitter
-
-#+NAME: meta_emitters_metadata_function_node_location
-#+BEGIN_SRC d
-@safe ObjGenericComposite node_location_emitter(La,Ta,N)(
-  string         lev_markup_number,
-  string[string] tag_in_seg,
-  La             lev_anchor_tag,
-  Ta             tag_assoc,
-  N              obj_cite_digits,
-  int            cntr_,
-  int            ptr_,
-  string         is_
-) {
-  debug(asserts) {
-    static assert(is(typeof(obj_cite_digits.object_number) == int));
-  }
-  assert(is_ != "heading");
-  assert(obj_cite_digits.object_number.to!int >= 0);
-  assert(is_ != "heading");                          // should not be necessary
-  assert(obj_cite_digits.object_number.to!int >= 0); // should not be necessary
-  if (lv7 > eN.bi.off) {
-    p_["lev_markup_number"]                       = DocStructMarkupHeading.h_text_4;
-    p_["object_number"]                           = lv7;
-  } else if (lv6 > eN.bi.off) {
-    p_["lev_markup_number"]                       = DocStructMarkupHeading.h_text_3;
-    p_["object_number"]                           = lv6;
-  } else if (lv5 > eN.bi.off) {
-    p_["lev_markup_number"]                       = DocStructMarkupHeading.h_text_2;
-    p_["object_number"]                           = lv5;
-  } else {
-    p_["lev_markup_number"]                       = DocStructMarkupHeading.h_text_1;
-    p_["object_number"]                           = lv4;
-  }
-  ObjGenericComposite comp_obj_location;
-  comp_obj_location                               = comp_obj_location.init;
-  comp_obj_location.metainfo.is_a                 = is_;
-  comp_obj_location.metainfo.ocn                  = obj_cite_digits.object_number;
-  comp_obj_location.metainfo.identifier           = obj_cite_digits.identifier;
-  comp_obj_location.tags.anchor_tag_html          = tag_in_seg["seg_lv4"];
-  comp_obj_location.tags.segment_anchor_tag_epub  = tag_in_seg["seg_lv1to4"];
-  comp_obj_location.tags.heading_lev_anchor_tag   = lev_anchor_tag;
-  comp_obj_location.metainfo.parent_ocn           = p_["object_number"];
-  comp_obj_location.metainfo.parent_lev_markup    = p_["lev_markup_number"];
-  debug(_node) {
-    if (lev_markup_number.match(rgx.levels_numbered_headings)) {
-      writeln("x ", _node.to!string);
+  @safe ObjGenericComposite node_location_emitter(La,Ta)(
+    string         lev_markup_number,
+    string[string] tag_in_seg,
+    La             lev_anchor_tag,
+    Ta             tag_assoc,
+    OCNset         obj_cite_digits,
+    int            cntr_,
+    int            ptr_,
+    string         is_
+  ) {
+    debug(asserts) {
+      static assert(is(typeof(obj_cite_digits.object_number) == int));
+    }
+    assert(is_ != "heading");
+    assert(obj_cite_digits.object_number.to!int >= 0);
+    assert(is_ != "heading");                          // should not be necessary
+    assert(obj_cite_digits.object_number.to!int >= 0); // should not be necessary
+    if (lv7 > eN.bi.off) {
+      p_["lev_markup_number"]                       = DocStructMarkupHeading.h_text_4;
+      p_["object_number"]                           = lv7;
+    } else if (lv6 > eN.bi.off) {
+      p_["lev_markup_number"]                       = DocStructMarkupHeading.h_text_3;
+      p_["object_number"]                           = lv6;
+    } else if (lv5 > eN.bi.off) {
+      p_["lev_markup_number"]                       = DocStructMarkupHeading.h_text_2;
+      p_["object_number"]                           = lv5;
     } else {
-      writeln("- ", _node.to!string);
+      p_["lev_markup_number"]                       = DocStructMarkupHeading.h_text_1;
+      p_["object_number"]                           = lv4;
+    }
+    ObjGenericComposite comp_obj_location;
+    comp_obj_location                               = comp_obj_location.init;
+    comp_obj_location.metainfo.is_a                 = is_;
+    comp_obj_location.metainfo.ocn                  = obj_cite_digits.object_number;
+    comp_obj_location.metainfo.identifier           = obj_cite_digits.identifier;
+    comp_obj_location.tags.anchor_tag_html          = tag_in_seg["seg_lv4"];
+    comp_obj_location.tags.segment_anchor_tag_epub  = tag_in_seg["seg_lv1to4"];
+    comp_obj_location.tags.heading_lev_anchor_tag   = lev_anchor_tag;
+    comp_obj_location.metainfo.parent_ocn           = p_["object_number"];
+    comp_obj_location.metainfo.parent_lev_markup    = p_["lev_markup_number"];
+    debug(_node) {
+      if (lev_markup_number.match(rgx.levels_numbered_headings)) {
+        writeln("x ", _node.to!string);
+      } else {
+        writeln("- ", _node.to!string);
+      }
     }
+    assert(comp_obj_location.metainfo.parent_lev_markup >= 4);
+    assert(comp_obj_location.metainfo.parent_lev_markup <= 7);
+    assert(comp_obj_location.metainfo.parent_ocn >= 0);
+    return comp_obj_location;
   }
-  assert(comp_obj_location.metainfo.parent_lev_markup >= 4);
-  assert(comp_obj_location.metainfo.parent_lev_markup <= 7);
-  assert(comp_obj_location.metainfo.parent_ocn >= 0);
-  return comp_obj_location;
-}
-invariant() {
-}
-#+END_SRC
-
-****** node metadata emitter heading, (including most segnames & their pointers)
-
-#+NAME: meta_emitters_metadata_function_heading
-#+BEGIN_SRC d
-@safe ObjGenericComposite node_emitter_heading(Hd,TaL,TA,N,fNr,fNs,fL)(
-  string         _text,
-  string         lev_markup_number,
-  string         lev_collapsed_number,
-  Hd             dummy_heading_status,
-  string[string] tag_in_seg,
-  TaL            lev_anchor_tag,
-  TA             tag_assoc,
-  N              obj_cite_digits,
-  int            cntr_,
-  int            ptr_,
-  string[]       lv_ancestors_txt,
-  string         is_,
-  int            html_segnames_ptr,
-  fNr            flag_notes_reg,
-  fNs            flag_notes_star,
-  fL             flag_links,
-) {
-  debug(asserts) {
-    static assert(is(typeof(lev)                                       == string));
-    static assert(is(typeof(obj_cite_digits.object_number)             == int));
-  }
-  assert(is_ == "heading");
-  assert((obj_cite_digits.object_number).to!int >= 0);
-  assert(
-    lev_markup_number.match(rgx.levels_numbered),
-    ("not a valid heading level: " ~ lev_markup_number ~ " at " ~ obj_cite_digits.object_number.to!string)
-  );
-  if (lev_markup_number.match(rgx.levels_numbered)) {
-    if (lev_markup_number.to!int == 0) {
-      /+ TODO first hit (of two) with this assertion failure, check, fix & reinstate
-      assert(obj_cite_digits.object_number.to!int == 1,
-        "ERROR header lev markup number is: " ~
-        lev_markup_number.to!string ~
-        " obj_cite_digits.object_number.to!int should == 1 but is: " ~
-         obj_cite_digits.object_number.to!string ~
-        "\n" ~ _text);
-      +/
-    }
+  invariant() {
   }
-  switch (lev_markup_number.to!int) {
-  case 0:
-    lv = DocStructMarkupHeading.h_sect_A;
-    lv0 = obj_cite_digit;
-    lv1 = 0; lv2 = 0; lv3 = 0; lv4 = 0; lv5 = 0; lv6 = 0; lv7 = 0;
-    p_["lev_markup_number"] = 0;
-    p_["object_number"] = 0;
-    break;
-  case 1:
-    lv = DocStructMarkupHeading.h_sect_B;
-    lv1 = obj_cite_digit;
-    lv2 = 0; lv3 = 0; lv4 = 0; lv5 = 0; lv6 = 0; lv7 = 0;
-    p_["lev_markup_number"]
-      = DocStructMarkupHeading.h_sect_A;
-    p_["object_number"] = lv0;
-    break;
-  case 2:
-    lv = DocStructMarkupHeading.h_sect_C;
-    lv2 = obj_cite_digit;
-    lv3 = 0; lv4 = 0; lv5 = 0; lv6 = 0; lv7 = 0;
-    p_["lev_markup_number"]
-      = DocStructMarkupHeading.h_sect_B;
-    p_["object_number"] = lv1;
-    break;
-  case 3:
-    lv = DocStructMarkupHeading.h_sect_D;
-    lv3 = obj_cite_digit;
-    lv4 = 0; lv5 = 0; lv6 = 0; lv7 = 0;
-    p_["lev_markup_number"]
-      = DocStructMarkupHeading.h_sect_C;
-    p_["object_number"] = lv2;
-    break;
-  case 4:
-    lv = DocStructMarkupHeading.h_text_1;
-    lv4 = obj_cite_digit;
-    lv5 = 0; lv6 = 0; lv7 = 0;
-    if (lv3 > eN.bi.off) {
+  @safe ObjGenericComposite node_emitter_heading(Hd,TaL,TA,fNr,fNs,fL)(
+    string         _text,
+    string         lev_markup_number,
+    string         lev_collapsed_number,
+    Hd             dummy_heading_status,
+    string[string] tag_in_seg,
+    TaL            lev_anchor_tag,
+    TA             tag_assoc,
+    OCNset         obj_cite_digits,
+    int            cntr_,
+    int            ptr_,
+    string[]       lv_ancestors_txt,
+    string         is_,
+    int            html_segnames_ptr,
+    fNr            flag_notes_reg,
+    fNs            flag_notes_star,
+    fL             flag_links,
+  ) {
+    debug(asserts) {
+      static assert(is(typeof(lev)                                       == string));
+      static assert(is(typeof(obj_cite_digits.object_number)             == int));
+    }
+    assert(is_ == "heading");
+    assert((obj_cite_digits.object_number).to!int >= 0);
+    assert(
+      lev_markup_number.match(rgx.levels_numbered),
+      ("not a valid heading level: " ~ lev_markup_number ~ " at " ~ obj_cite_digits.object_number.to!string)
+    );
+    if (lev_markup_number.match(rgx.levels_numbered)) {
+      if (lev_markup_number.to!int == 0) {
+        /+ TODO first hit (of two) with this assertion failure, check, fix & reinstate
+        assert(obj_cite_digits.object_number.to!int == 1,
+          "ERROR header lev markup number is: " ~
+          lev_markup_number.to!string ~
+          " obj_cite_digits.object_number.to!int should == 1 but is: " ~
+           obj_cite_digits.object_number.to!string ~
+          "\n" ~ _text);
+        +/
+      }
+    }
+    switch (lev_markup_number.to!int) {
+    case 0:
+      lv = DocStructMarkupHeading.h_sect_A;
+      lv0 = obj_cite_digit;
+      lv1 = 0; lv2 = 0; lv3 = 0; lv4 = 0; lv5 = 0; lv6 = 0; lv7 = 0;
+      p_["lev_markup_number"] = 0;
+      p_["object_number"] = 0;
+      break;
+    case 1:
+      lv = DocStructMarkupHeading.h_sect_B;
+      lv1 = obj_cite_digit;
+      lv2 = 0; lv3 = 0; lv4 = 0; lv5 = 0; lv6 = 0; lv7 = 0;
       p_["lev_markup_number"]
-        = DocStructMarkupHeading.h_sect_D;
-      p_["object_number"] = lv3;
-    } else if (lv2 > eN.bi.off) {
+        = DocStructMarkupHeading.h_sect_A;
+      p_["object_number"] = lv0;
+      break;
+    case 2:
+      lv = DocStructMarkupHeading.h_sect_C;
+      lv2 = obj_cite_digit;
+      lv3 = 0; lv4 = 0; lv5 = 0; lv6 = 0; lv7 = 0;
+      p_["lev_markup_number"]
+        = DocStructMarkupHeading.h_sect_B;
+      p_["object_number"] = lv1;
+      break;
+    case 3:
+      lv = DocStructMarkupHeading.h_sect_D;
+      lv3 = obj_cite_digit;
+      lv4 = 0; lv5 = 0; lv6 = 0; lv7 = 0;
       p_["lev_markup_number"]
         = DocStructMarkupHeading.h_sect_C;
       p_["object_number"] = lv2;
-    } else if (lv1 > eN.bi.off) {
+      break;
+    case 4:
+      lv = DocStructMarkupHeading.h_text_1;
+      lv4 = obj_cite_digit;
+      lv5 = 0; lv6 = 0; lv7 = 0;
+      if (lv3 > eN.bi.off) {
+        p_["lev_markup_number"]
+          = DocStructMarkupHeading.h_sect_D;
+        p_["object_number"] = lv3;
+      } else if (lv2 > eN.bi.off) {
+        p_["lev_markup_number"]
+          = DocStructMarkupHeading.h_sect_C;
+        p_["object_number"] = lv2;
+      } else if (lv1 > eN.bi.off) {
+        p_["lev_markup_number"]
+          = DocStructMarkupHeading.h_sect_B;
+        p_["object_number"] = lv1;
+      } else {
+        p_["lev_markup_number"]
+          = DocStructMarkupHeading.h_sect_A;
+        p_["object_number"] = lv0;
+      }
+      break;
+    case 5:
+      lv = DocStructMarkupHeading.h_text_2;
+      lv5 = obj_cite_digit;
+      lv6 = 0; lv7 = 0;
       p_["lev_markup_number"]
-        = DocStructMarkupHeading.h_sect_B;
-      p_["object_number"] = lv1;
-    } else {
+        = DocStructMarkupHeading.h_text_1;
+      p_["object_number"] = lv4;
+      break;
+    case 6:
+      lv = DocStructMarkupHeading.h_text_3;
+      lv6 = obj_cite_digit;
+      lv7 = 0;
       p_["lev_markup_number"]
-        = DocStructMarkupHeading.h_sect_A;
-      p_["object_number"] = lv0;
+        = DocStructMarkupHeading.h_text_2;
+      p_["object_number"] = lv5;
+      break;
+    case 7:
+      lv = DocStructMarkupHeading.h_text_4;
+      lv7 = obj_cite_digit;
+      p_["lev_markup_number"]
+        = DocStructMarkupHeading.h_text_3;
+      p_["object_number"] = lv6;
+      break;
+    default:
+      break;
     }
-    break;
-  case 5:
-    lv = DocStructMarkupHeading.h_text_2;
-    lv5 = obj_cite_digit;
-    lv6 = 0; lv7 = 0;
-    p_["lev_markup_number"]
-      = DocStructMarkupHeading.h_text_1;
-    p_["object_number"] = lv4;
-    break;
-  case 6:
-    lv = DocStructMarkupHeading.h_text_3;
-    lv6 = obj_cite_digit;
-    lv7 = 0;
-    p_["lev_markup_number"]
-      = DocStructMarkupHeading.h_text_2;
-    p_["object_number"] = lv5;
-    break;
-  case 7:
-    lv = DocStructMarkupHeading.h_text_4;
-    lv7 = obj_cite_digit;
-    p_["lev_markup_number"]
-      = DocStructMarkupHeading.h_text_3;
-    p_["object_number"] = lv6;
-    break;
-  default:
-    break;
-  }
-  ObjGenericComposite _comp_obj_heading_;
-  _comp_obj_heading_                                        = _comp_obj_heading_.init;
-  _comp_obj_heading_.metainfo.is_of_part                    = "body";
-  _comp_obj_heading_.metainfo.is_of_section                 = "body";
-  _comp_obj_heading_.metainfo.is_of_type                    = "para";
-  _comp_obj_heading_.metainfo.is_a                          = "heading";
-  _comp_obj_heading_.text                                   = _text.to!string.strip;
-  _comp_obj_heading_.metainfo.ocn                           = obj_cite_digits.object_number;
-  _comp_obj_heading_.metainfo.identifier                    = obj_cite_digits.identifier;
-  _comp_obj_heading_.metainfo.dummy_heading                 = (dummy_heading_status == "t") ? true: false;
-  _comp_obj_heading_.metainfo.object_number_off             = obj_cite_digits.off;
-  // _comp_obj_heading_.metainfo.o_n_book_index             = obj_cite_digits.bkidx;
-  _comp_obj_heading_.metainfo.object_number_type            = obj_cite_digits.type;
-  _comp_obj_heading_.tags.segment_anchor_tag_epub           = tag_in_seg["seg_lv1to4"];
-  _comp_obj_heading_.tags.anchor_tag_html                   = tag_in_seg["seg_lv4"];
-  _comp_obj_heading_.tags.in_segment_html                   = _comp_obj_heading_.tags.anchor_tag_html;
-  _comp_obj_heading_.tags.heading_lev_anchor_tag            = lev_anchor_tag;
-  _comp_obj_heading_.tags.html_segment_anchor_tag_is        = tag_in_seg["seg_lv4"];
-  _comp_obj_heading_.tags.epub_segment_anchor_tag_is        = tag_in_seg["seg_lv1to4"];
-  _comp_obj_heading_.metainfo.heading_lev_markup            = (!(lev_markup_number.empty) ? lev_markup_number.to!int : 0);
-  _comp_obj_heading_.metainfo.heading_lev_collapsed         = (!(lev_collapsed_number.empty) ? lev_collapsed_number.to!int : 0);
-  _comp_obj_heading_.metainfo.parent_ocn                    = p_["object_number"];
-  _comp_obj_heading_.metainfo.parent_lev_markup             = p_["lev_markup_number"];
-  _comp_obj_heading_.tags.heading_ancestors_text            = lv_ancestors_txt;
-  _comp_obj_heading_.ptr.doc_object                         = cntr_;
-  _comp_obj_heading_.ptr.html_segnames                      = ((lev_markup_number == "4") ? html_segnames_ptr : 0);
-  _comp_obj_heading_.ptr.heading                            = ptr_;
-  _comp_obj_heading_.has.inline_notes_reg                   = flag_notes_reg;
-  _comp_obj_heading_.has.inline_notes_star                  = flag_notes_star;
-  _comp_obj_heading_.has.inline_links                       = flag_links;
-  tag_assoc[_comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = _comp_obj_heading_.tags.in_segment_html;
-  tag_assoc[_comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = _comp_obj_heading_.tags.segment_anchor_tag_epub;
-  debug(_node) {
+    ObjGenericComposite _comp_obj_heading_;
+    _comp_obj_heading_                                        = _comp_obj_heading_.init;
+    _comp_obj_heading_.metainfo.is_of_part                    = "body";
+    _comp_obj_heading_.metainfo.is_of_section                 = "body";
+    _comp_obj_heading_.metainfo.is_of_type                    = "para";
+    _comp_obj_heading_.metainfo.is_a                          = "heading";
+    _comp_obj_heading_.text                                   = _text.to!string.strip;
+    _comp_obj_heading_.metainfo.ocn                           = obj_cite_digits.object_number;
+    _comp_obj_heading_.metainfo.identifier                    = obj_cite_digits.identifier;
+    _comp_obj_heading_.metainfo.dummy_heading                 = (dummy_heading_status == "t") ? true: false;
+    _comp_obj_heading_.metainfo.object_number_off             = obj_cite_digits.off;
+    // _comp_obj_heading_.metainfo.o_n_book_index             = obj_cite_digits.bkidx;
+    _comp_obj_heading_.metainfo.object_number_type            = obj_cite_digits.type;
+    _comp_obj_heading_.tags.segment_anchor_tag_epub           = tag_in_seg["seg_lv1to4"];
+    _comp_obj_heading_.tags.anchor_tag_html                   = tag_in_seg["seg_lv4"];
+    _comp_obj_heading_.tags.in_segment_html                   = _comp_obj_heading_.tags.anchor_tag_html;
+    _comp_obj_heading_.tags.heading_lev_anchor_tag            = lev_anchor_tag;
+    _comp_obj_heading_.tags.html_segment_anchor_tag_is        = tag_in_seg["seg_lv4"];
+    _comp_obj_heading_.tags.epub_segment_anchor_tag_is        = tag_in_seg["seg_lv1to4"];
+    _comp_obj_heading_.metainfo.heading_lev_markup            = (!(lev_markup_number.empty) ? lev_markup_number.to!int : 0);
+    _comp_obj_heading_.metainfo.heading_lev_collapsed         = (!(lev_collapsed_number.empty) ? lev_collapsed_number.to!int : 0);
+    _comp_obj_heading_.metainfo.parent_ocn                    = p_["object_number"];
+    _comp_obj_heading_.metainfo.parent_lev_markup             = p_["lev_markup_number"];
+    _comp_obj_heading_.tags.heading_ancestors_text            = lv_ancestors_txt;
+    _comp_obj_heading_.ptr.doc_object                         = cntr_;
+    _comp_obj_heading_.ptr.html_segnames                      = ((lev_markup_number == "4") ? html_segnames_ptr : 0);
+    _comp_obj_heading_.ptr.heading                            = ptr_;
+    _comp_obj_heading_.has.inline_notes_reg                   = flag_notes_reg;
+    _comp_obj_heading_.has.inline_notes_star                  = flag_notes_star;
+    _comp_obj_heading_.has.inline_links                       = flag_links;
+    tag_assoc[_comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = _comp_obj_heading_.tags.in_segment_html;
+    tag_assoc[_comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = _comp_obj_heading_.tags.segment_anchor_tag_epub;
+    debug(_node) {
+      if (lev_markup_number.match(rgx.levels_numbered_headings)) {
+        writeln("* ", _node.to!string);
+      }
+    }
+    debug(nodeheading) {
+      if (lev_markup_number.match(rgx.levels_numbered_headings)) {
+        writeln("* ", _node.to!string);
+      }
+    }
+    assert(_comp_obj_heading_.metainfo.parent_lev_markup <= 7);
+    assert(_comp_obj_heading_.metainfo.parent_ocn >= 0);
     if (lev_markup_number.match(rgx.levels_numbered_headings)) {
-      writeln("* ", _node.to!string);
-    }
+      assert(_comp_obj_heading_.metainfo.heading_lev_markup <= 7);
+      assert(_comp_obj_heading_.metainfo.ocn >= 0);
+      if (_comp_obj_heading_.metainfo.parent_lev_markup > 0) {
+        assert(_comp_obj_heading_.metainfo.parent_lev_markup < _comp_obj_heading_.metainfo.heading_lev_markup);
+        if (_comp_obj_heading_.metainfo.ocn != 0) {
+          assert(_comp_obj_heading_.metainfo.parent_ocn < _comp_obj_heading_.metainfo.ocn);
+        }
+      }
+      if (_comp_obj_heading_.metainfo.heading_lev_markup == 0) {
+        assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_sect_A);
+      } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_sect_B) {
+        assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_sect_A);
+      } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_sect_C) {
+        assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_sect_B);
+      } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_sect_D) {
+        assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_sect_C);
+      } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_text_1) {
+        assert(_comp_obj_heading_.metainfo.parent_lev_markup <= DocStructMarkupHeading.h_sect_D);
+      } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_text_2) {
+        assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_text_1);
+      } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_text_3) {
+        assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_text_2);
+      } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_text_4) {
+        assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_text_3);
+      } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_text_5) {
+      }
+    }
+    return _comp_obj_heading_;
+  }
+  invariant() {
   }
-  debug(nodeheading) {
-    if (lev_markup_number.match(rgx.levels_numbered_headings)) {
-      writeln("* ", _node.to!string);
-    }
-  }
-  assert(_comp_obj_heading_.metainfo.parent_lev_markup <= 7);
-  assert(_comp_obj_heading_.metainfo.parent_ocn >= 0);
-  if (lev_markup_number.match(rgx.levels_numbered_headings)) {
-    assert(_comp_obj_heading_.metainfo.heading_lev_markup <= 7);
-    assert(_comp_obj_heading_.metainfo.ocn >= 0);
-    if (_comp_obj_heading_.metainfo.parent_lev_markup > 0) {
-      assert(_comp_obj_heading_.metainfo.parent_lev_markup < _comp_obj_heading_.metainfo.heading_lev_markup);
-      if (_comp_obj_heading_.metainfo.ocn != 0) {
-        assert(_comp_obj_heading_.metainfo.parent_ocn < _comp_obj_heading_.metainfo.ocn);
-      }
-    }
-    if (_comp_obj_heading_.metainfo.heading_lev_markup == 0) {
-      assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_sect_A);
-    } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_sect_B) {
-      assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_sect_A);
-    } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_sect_C) {
-      assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_sect_B);
-    } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_sect_D) {
-      assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_sect_C);
-    } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_text_1) {
-      assert(_comp_obj_heading_.metainfo.parent_lev_markup <= DocStructMarkupHeading.h_sect_D);
-    } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_text_2) {
-      assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_text_1);
-    } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_text_3) {
-      assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_text_2);
-    } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_text_4) {
-      assert(_comp_obj_heading_.metainfo.parent_lev_markup == DocStructMarkupHeading.h_text_3);
-    } else if  (_comp_obj_heading_.metainfo.heading_lev_markup == DocStructMarkupHeading.h_text_5) {
-    }
-  }
-  return _comp_obj_heading_;
-}
-invariant() {
-}
-#+END_SRC
-
-***** }
-
-#+NAME: meta_emitters_metadata_function_close
-#+BEGIN_SRC d
 }
-#+END_SRC
-
-*** function assertions :assertions:
-**** assertions on markup document structure :doc_structure:
-
-#+NAME: abs_functions_assertions
-#+BEGIN_SRC d
+                                                                              /+ abstraction functions emitters ↑ +/
+                                                                              /+ ↓ abstraction functions assertions +/
 @safe pure void assertions_doc_structure()(
   string[string]  an_object,
   string          an_object_key,
@@ -8333,266 +7220,27 @@ invariant() {
 }
 #+END_SRC
 
-*** doc sect keys seq
+* template docSectKeysSeq
 
-#+NAME: template_doc_sect_keys_seq
+#+NAME: docSectKeysSeq
+#+HEADER: :noweb yes
 #+BEGIN_SRC d
-template docSectKeysSeq() {
-  @safe auto docSectKeysSeq(string[][string] document_section_keys_sequenced) {
-    struct doc_sect_keys_seq {
-      string[] scroll() {
-        return document_section_keys_sequenced["scroll"];
-      }
-      string[] seg() {
-        return document_section_keys_sequenced["seg"];
-      }
-      string[] sql() {
-        return document_section_keys_sequenced["sql"];
-      }
-      string[] latex() {
-        return document_section_keys_sequenced["latex"];
-      }
+@safe auto docSectKeysSeq(string[][string] document_section_keys_sequenced) {
+  struct doc_sect_keys_seq {
+    string[] scroll() {
+      return document_section_keys_sequenced["scroll"];
+    }
+    string[] seg() {
+      return document_section_keys_sequenced["seg"];
+    }
+    string[] sql() {
+      return document_section_keys_sequenced["sql"];
+    }
+    string[] latex() {
+      return document_section_keys_sequenced["latex"];
     }
-    return doc_sect_keys_seq();
   }
-}
-#+END_SRC
-
-* 2. Object Setter (Set Abstract Object) :module:spine:metadoc_object_setter:
-
-set abstracted objects for downstream processing
-
-** _module template_
-
-#+HEADER: :tangle "../src/doc_reform/meta/metadoc_object_setter.d"
-#+HEADER: :noweb yes
-#+BEGIN_SRC d
-<<doc_header_including_copyright_and_license>>
-/++
-  object setter:
-  setting of sisu objects for downstream processing
-  metadoc_object_setter.d
-+/
-module doc_reform.meta.metadoc_object_setter;
-template ObjectSetter() {
-  /+ structs +/
-  <<meta_structs_init_docObj_metainfo>>
-  <<meta_structs_init_docObj_txtAttrib>>
-  <<meta_structs_init_docObj_has>>
-  <<meta_structs_init_docObj_table>>
-  <<meta_structs_init_docObj_code_block>>
-  <<meta_structs_init_docObj_stow>>
-  <<meta_structs_init_docObj_pointer>>
-  <<meta_structs_init_docObj_tags>>
-  <<meta_structs_init_docObj_composite>>
-  <<meta_structs_init_docObj_theObjects>>
-}
-#+END_SRC
-
-** 1. initialize structs :struct:
-*** heading attribute
-
-#+BEGIN_SRC d
-struct HeadingAttrib {
-  string lev                                    = "9";
-  int    heading_lev_markup                     = 9;
-  int    heading_lev_collapsed                  = 9;
-  int[]  closes_lev_collapsed                   = [];
-  int[]  closes_lev_markup                      = [];
-  int    array_ptr                              = 0;
-  int    heading_array_ptr_segments             = 0;
-}
-#+END_SRC
-
-*** _composite object_ [#A]
-
-#+NAME: meta_structs_init_docObj_metainfo
-#+BEGIN_SRC d
-struct DocObj_MetaInfo_ {
-  string                 is_of_part                           = ""; // frontmatter, body, backmatter
-  string                 is_of_section                        = ""; // toc, body, glossary, biography, book index, blurb
-  string                 is_of_type                           = ""; // para, block ?
-  string                 is_a                                 = ""; // heading, para, table, code block, group, verse/poem ...
-  alias                  of_part                              = is_of_part;
-  alias                  of_section                           = is_of_section;
-  alias                  is_of                                = is_of_type;
-  string                 attrib                               = "";
-  string                 lang                                 = ""; // blocks: group, block, quote; not codeblock;
-  string                 syntax                               = ""; // codeblock only
-  /+ o_n +/
-  int                    o_n_substantive                      = 0;
-  int                    o_n_non_substantive                  = 0;
-  int                    o_n_glossary                         = 0;
-  int                    o_n_bibliography                     = 0;
-  int                    o_n_book_index                       = 0;
-  int                    o_n_blurb                            = 0;
-  @safe  string object_number_substantive() const @property {
-    return (o_n_substantive == 0) ? "" : o_n_substantive.to!string;
-  }
-  @safe string object_number_non_substantive() const @property {
-    return (o_n_non_substantive == 0) ? "" : o_n_non_substantive.to!string;
-  }
-  @safe string object_number_glossary() const @property {
-    return (o_n_glossary == 0) ? "" : o_n_glossary.to!string;
-  }
-  @safe string object_number_bibliography() const @property {
-    return (o_n_bibliography == 0) ? "" : o_n_bibliography.to!string;
-  }
-  @safe string object_number_book_index() const @property {
-    return (o_n_book_index == 0) ? "" : o_n_book_index.to!string;
-  }
-  @safe string object_number_blurb() const @property {
-    return (o_n_blurb == 0) ? "" : o_n_blurb.to!string;
-  }
-  bool                   object_number_off                    = false;
-  bool                   visible_object_number                = false;
-  int                    object_number_type                   = 0; // { ocn, non, bkidx }
-  /+ node +/
-  string[string][string] node;
-  int                    ocn                                  = 0;
-  string                 identifier                           = "";
-  @safe string object_number() const @property {
-    return (ocn == 0) ? "" : ocn.to!string;
-  }
-  int                    o_n_type                             = 0;
-  int                    heading_lev_markup                   = 9;
-  int                    heading_lev_collapsed                = 9;
-  @safe string marked_up_level() const @property {
-    string _out;
-    switch (heading_lev_markup) {
-    case 0  : _out = "A"; break;
-    case 1  : _out = "B"; break;
-    case 2  : _out = "C"; break;
-    case 3  : _out = "D"; break;
-    case 4  : _out = "1"; break;
-    case 5  : _out = "2"; break;
-    case 6  : _out = "3"; break;
-    case 7  : _out = "4"; break;
-    default : _out = "";  break; // "9";
-    }
-    return _out;
-  }
-  bool                   dummy_heading                        = false;
-  int[]                  markedup_ancestors                   = [ 0, 0, 0, 0, 0, 0, 0, 0,];
-  int[]                  collapsed_ancestors                  = [ 0, 0, 0, 0, 0, 0, 0, 0,];
-  int[]                  dom_structure_markedup_tags_status   = [ 0, 0, 0, 0, 0, 0, 0, 0,];
-  int[]                  dom_structure_collapsed_tags_status  = [ 0, 0, 0, 0, 0, 0, 0, 0,];
-  int                    parent_lev_markup                    = 0;
-  int                    parent_ocn                           = 0;
-  int                    last_decendant_ocn                   = 0;
-}
-#+END_SRC
-
-**** object text attributes
-
-#+NAME: meta_structs_init_docObj_txtAttrib
-#+BEGIN_SRC d
-struct DocObj_TxtAttrib_ {
-  int                    indent_base                         = 0;
-  int                    indent_hang                         = 0;
-  bool                   bullet                              = false;
-  string                 language                            = "";
-}
-#+END_SRC
-
-**** object has within it
-
-#+NAME: meta_structs_init_docObj_has
-#+BEGIN_SRC d
-struct DocObj_Has_ {
-  bool                   inline_links                        = false;
-  bool                   inline_notes_reg                    = false;
-  bool                   inline_notes_star                   = false;
-  bool                   images                              = false;
-  bool                   image_without_dimensions            = false;
-}
-#+END_SRC
-
-**** table attributes
-
-#+NAME: meta_structs_init_docObj_table
-#+BEGIN_SRC d
-struct DocObj_Table_ {
-  int                    number_of_columns                   = 0;
-  double[]               column_widths                       = [];
-  string[]               column_aligns                       = [];
-  bool                   heading                             = false;
-  bool                   walls                               = false;
-}
-#+END_SRC
-
-**** code attributes
-
-#+NAME: meta_structs_init_docObj_code_block
-#+BEGIN_SRC d
-struct DocObj_CodeBlock_ {
-  string                 syntax                              = "";
-  bool                   linenumbers                         = false;
-}
-#+END_SRC
-
-**** stow (things to be protected from regular text transformations, so far links)
-
-#+NAME: meta_structs_init_docObj_stow
-#+BEGIN_SRC d
-struct DocObj_Stow_ {
-  string[]               link                               = [];
-}
-#+END_SRC
-
-**** pointers
-
-#+NAME: meta_structs_init_docObj_pointer
-#+BEGIN_SRC d
-struct DocObj_Pointer_ {
-  int                    doc_object                          = 0;
-  int                    html_segnames                       = 0;
-  int                    heading                             = 0;
-}
-#+END_SRC
-
-**** tags
-
-#+NAME: meta_structs_init_docObj_tags
-#+BEGIN_SRC d
-struct DocObj_Tags_ {
-  string[]               heading_ancestors_text              = [ "", "", "", "", "", "", "", "", ];
-  string                 anchor_tag_html                     = "";
-  string                 in_segment_html                     = "";
-  string                 segment_anchor_tag_epub             = "";
-  string                 html_segment_anchor_tag_is          = "";
-  string                 epub_segment_anchor_tag_is          = "";
-  string                 heading_lev_anchor_tag              = "";
-  string                 segname_prev                        = "";
-  string                 segname_next                        = "";
-  string[]               lev4_subtoc                         = [];
-  string[]               anchor_tags                         = [];
-}
-#+END_SRC
-
-**** composite object the parts
-
-#+NAME: meta_structs_init_docObj_composite
-#+BEGIN_SRC d
-struct ObjGenericComposite {
-  string                 text                                = "";
-  DocObj_MetaInfo_       metainfo;
-  DocObj_TxtAttrib_      attrib;
-  DocObj_Tags_           tags;
-  DocObj_Has_            has;
-  DocObj_Table_          table;
-  DocObj_CodeBlock_      code_block;
-  DocObj_Stow_           stow;
-  DocObj_Pointer_        ptr;
-}
-#+END_SRC
-
-*** The Objects: generic composite object array
-
-#+NAME: meta_structs_init_docObj_theObjects
-#+BEGIN_SRC d
-struct TheObjects {
-  ObjGenericComposite[] oca;
+  return doc_sect_keys_seq();
 }
 #+END_SRC
 
diff --git a/org/ocda_obj_setter.org b/org/ocda_obj_setter.org
new file mode 100644
index 0000000..f499adf
--- /dev/null
+++ b/org/ocda_obj_setter.org
@@ -0,0 +1,313 @@
+-*- mode: org -*-
+#+TITLE:       spine (doc_reform) object-centric document abstraction
+#+DESCRIPTION: documents - structuring, publishing in multiple formats & search
+#+FILETAGS:    :spine:abstraction:
+#+AUTHOR:      Ralph Amissah
+#+EMAIL:       [[mailto:ralph.amissah@gmail.com][ralph.amissah@gmail.com]]
+#+COPYRIGHT:   Copyright (C) 2015 - 2023 Ralph Amissah
+#+LANGUAGE:    en
+#+STARTUP:     content hideblocks hidestars noindent entitiespretty
+#+PROPERTY:    header-args  :noweb yes
+#+PROPERTY:    header-args+ :exports code
+#+PROPERTY:    header-args+ :results no
+#+PROPERTY:    header-args+ :cache no
+#+PROPERTY:    header-args+ :padline no
+#+PROPERTY:    header-args+ :mkdirp yes
+#+OPTIONS:     H:3 num:nil toc:t \n:t ::t |:t ^:nil -:t f:t *:t
+
+- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]
+
+* Object Setter (Set Abstract Object) :module:spine:metadoc_object_setter:
+
+set abstracted objects for downstream processing
+
+** _module template_
+
+#+HEADER: :tangle "../src/doc_reform/meta/metadoc_object_setter.d"
+#+HEADER: :noweb yes
+#+BEGIN_SRC d
+<<doc_header_including_copyright_and_license>>
+/++
+  object setter:
+  setting of sisu objects for downstream processing
+  metadoc_object_setter.d
++/
+module doc_reform.meta.metadoc_object_setter;
+template ObjectSetter() {
+  /+ structs +/
+  <<meta_structs_init_docObj_metainfo>>
+  <<meta_structs_init_docObj_txtAttrib>>
+  <<meta_structs_init_docObj_has>>
+  <<meta_structs_init_docObj_table>>
+  <<meta_structs_init_docObj_code_block>>
+  <<meta_structs_init_docObj_stow>>
+  <<meta_structs_init_docObj_pointer>>
+  <<meta_structs_init_docObj_tags>>
+  <<meta_structs_init_docObj_composite>>
+  <<meta_structs_init_docObj_theObjects>>
+}
+#+END_SRC
+
+** initialize structs :struct:
+*** heading attribute
+
+#+BEGIN_SRC d
+struct HeadingAttrib {
+  string lev                                    = "9";
+  int    heading_lev_markup                     = 9;
+  int    heading_lev_collapsed                  = 9;
+  int[]  closes_lev_collapsed                   = [];
+  int[]  closes_lev_markup                      = [];
+  int    array_ptr                              = 0;
+  int    heading_array_ptr_segments             = 0;
+}
+#+END_SRC
+
+*** _composite object_ [#A]
+
+#+NAME: meta_structs_init_docObj_metainfo
+#+BEGIN_SRC d
+struct DocObj_MetaInfo_ {
+  string                 is_of_part                           = ""; // frontmatter, body, backmatter
+  string                 is_of_section                        = ""; // toc, body, glossary, biography, book index, blurb
+  string                 is_of_type                           = ""; // para, block ?
+  string                 is_a                                 = ""; // heading, para, table, code block, group, verse/poem ...
+  alias                  of_part                              = is_of_part;
+  alias                  of_section                           = is_of_section;
+  alias                  is_of                                = is_of_type;
+  string                 attrib                               = "";
+  string                 lang                                 = ""; // blocks: group, block, quote; not codeblock;
+  string                 syntax                               = ""; // codeblock only
+  /+ o_n +/
+  int                    o_n_substantive                      = 0;
+  int                    o_n_non_substantive                  = 0;
+  int                    o_n_glossary                         = 0;
+  int                    o_n_bibliography                     = 0;
+  int                    o_n_book_index                       = 0;
+  int                    o_n_blurb                            = 0;
+  @safe  string object_number_substantive() const @property {
+    return (o_n_substantive == 0) ? "" : o_n_substantive.to!string;
+  }
+  @safe string object_number_non_substantive() const @property {
+    return (o_n_non_substantive == 0) ? "" : o_n_non_substantive.to!string;
+  }
+  @safe string object_number_glossary() const @property {
+    return (o_n_glossary == 0) ? "" : o_n_glossary.to!string;
+  }
+  @safe string object_number_bibliography() const @property {
+    return (o_n_bibliography == 0) ? "" : o_n_bibliography.to!string;
+  }
+  @safe string object_number_book_index() const @property {
+    return (o_n_book_index == 0) ? "" : o_n_book_index.to!string;
+  }
+  @safe string object_number_blurb() const @property {
+    return (o_n_blurb == 0) ? "" : o_n_blurb.to!string;
+  }
+  bool                   object_number_off                    = false;
+  bool                   visible_object_number                = false;
+  int                    object_number_type                   = 0; // { ocn, non, bkidx }
+  /+ node +/
+  string[string][string] node;
+  int                    ocn                                  = 0;
+  string                 identifier                           = "";
+  @safe string object_number() const @property {
+    return (ocn == 0) ? "" : ocn.to!string;
+  }
+  int                    o_n_type                             = 0;
+  int                    heading_lev_markup                   = 9;
+  int                    heading_lev_collapsed                = 9;
+  @safe string marked_up_level() const @property {
+    string _out;
+    switch (heading_lev_markup) {
+    case 0  : _out = "A"; break;
+    case 1  : _out = "B"; break;
+    case 2  : _out = "C"; break;
+    case 3  : _out = "D"; break;
+    case 4  : _out = "1"; break;
+    case 5  : _out = "2"; break;
+    case 6  : _out = "3"; break;
+    case 7  : _out = "4"; break;
+    default : _out = "";  break; // "9";
+    }
+    return _out;
+  }
+  bool                   dummy_heading                        = false;
+  int[]                  markedup_ancestors                   = [ 0, 0, 0, 0, 0, 0, 0, 0,];
+  int[]                  collapsed_ancestors                  = [ 0, 0, 0, 0, 0, 0, 0, 0,];
+  int[]                  dom_structure_markedup_tags_status   = [ 0, 0, 0, 0, 0, 0, 0, 0,];
+  int[]                  dom_structure_collapsed_tags_status  = [ 0, 0, 0, 0, 0, 0, 0, 0,];
+  int                    parent_lev_markup                    = 0;
+  int                    parent_ocn                           = 0;
+  int                    last_decendant_ocn                   = 0;
+}
+#+END_SRC
+
+**** object text attributes
+
+#+NAME: meta_structs_init_docObj_txtAttrib
+#+BEGIN_SRC d
+struct DocObj_TxtAttrib_ {
+  int                    indent_base                         = 0;
+  int                    indent_hang                         = 0;
+  bool                   bullet                              = false;
+  string                 language                            = "";
+}
+#+END_SRC
+
+**** object has within it
+
+#+NAME: meta_structs_init_docObj_has
+#+BEGIN_SRC d
+struct DocObj_Has_ {
+  bool                   inline_links                        = false;
+  bool                   inline_notes_reg                    = false;
+  bool                   inline_notes_star                   = false;
+  bool                   images                              = false;
+  bool                   image_without_dimensions            = false;
+}
+#+END_SRC
+
+**** table attributes
+
+#+NAME: meta_structs_init_docObj_table
+#+BEGIN_SRC d
+struct DocObj_Table_ {
+  int                    number_of_columns                   = 0;
+  double[]               column_widths                       = [];
+  string[]               column_aligns                       = [];
+  bool                   heading                             = false;
+  bool                   walls                               = false;
+}
+#+END_SRC
+
+**** code attributes
+
+#+NAME: meta_structs_init_docObj_code_block
+#+BEGIN_SRC d
+struct DocObj_CodeBlock_ {
+  string                 syntax                              = "";
+  bool                   linenumbers                         = false;
+}
+#+END_SRC
+
+**** stow (things to be protected from regular text transformations, so far links)
+
+#+NAME: meta_structs_init_docObj_stow
+#+BEGIN_SRC d
+struct DocObj_Stow_ {
+  string[]               link                               = [];
+}
+#+END_SRC
+
+**** pointers
+
+#+NAME: meta_structs_init_docObj_pointer
+#+BEGIN_SRC d
+struct DocObj_Pointer_ {
+  int                    doc_object                          = 0;
+  int                    html_segnames                       = 0;
+  int                    heading                             = 0;
+}
+#+END_SRC
+
+**** tags
+
+#+NAME: meta_structs_init_docObj_tags
+#+BEGIN_SRC d
+struct DocObj_Tags_ {
+  string[]               heading_ancestors_text              = [ "", "", "", "", "", "", "", "", ];
+  string                 anchor_tag_html                     = "";
+  string                 in_segment_html                     = "";
+  string                 segment_anchor_tag_epub             = "";
+  string                 html_segment_anchor_tag_is          = "";
+  string                 epub_segment_anchor_tag_is          = "";
+  string                 heading_lev_anchor_tag              = "";
+  string                 segname_prev                        = "";
+  string                 segname_next                        = "";
+  string[]               lev4_subtoc                         = [];
+  string[]               anchor_tags                         = [];
+}
+#+END_SRC
+
+**** composite object the parts
+
+#+NAME: meta_structs_init_docObj_composite
+#+BEGIN_SRC d
+struct ObjGenericComposite {
+  string                 text                                = "";
+  DocObj_MetaInfo_       metainfo;
+  DocObj_TxtAttrib_      attrib;
+  DocObj_Tags_           tags;
+  DocObj_Has_            has;
+  DocObj_Table_          table;
+  DocObj_CodeBlock_      code_block;
+  DocObj_Stow_           stow;
+  DocObj_Pointer_        ptr;
+}
+#+END_SRC
+
+*** The Objects: generic composite object array
+
+#+NAME: meta_structs_init_docObj_theObjects
+#+BEGIN_SRC d
+struct TheObjects {
+  ObjGenericComposite[] oca;
+}
+#+END_SRC
+
+* document header including copyright & license
+
+#+NAME: doc_header_including_copyright_and_license
+#+BEGIN_SRC text
+/+
+- Name: Spine, Doc Reform [a part of]
+  - Description: documents, structuring, processing, publishing, search
+    - static content generator
+
+  - Author: Ralph Amissah
+    [ralph.amissah@gmail.com]
+
+  - Copyright: (C) 2015 - 2023 Ralph Amissah, All Rights Reserved.
+
+  - License: AGPL 3 or later:
+
+    Spine (SiSU), a framework for document structuring, publishing and
+    search
+
+    Copyright (C) Ralph Amissah
+
+    This program is free software: you can redistribute it and/or modify it
+    under the terms of the GNU AFERO General Public License as published by the
+    Free Software Foundation, either version 3 of the License, or (at your
+    option) any later version.
+
+    This program is distributed in the hope that it will be useful, but WITHOUT
+    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+    FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+    more details.
+
+    You should have received a copy of the GNU General Public License along with
+    this program. If not, see [https://www.gnu.org/licenses/].
+
+    If you have Internet connection, the latest version of the AGPL should be
+    available at these locations:
+    [https://www.fsf.org/licensing/licenses/agpl.html]
+    [https://www.gnu.org/licenses/agpl.html]
+
+  - Spine (by Doc Reform, related to SiSU) uses standard:
+    - docReform markup syntax
+      - standard SiSU markup syntax with modified headers and minor modifications
+    - docReform object numbering
+      - standard SiSU object citation numbering & system
+
+  - Homepages:
+    [https://www.doc_reform.org]
+    [https://www.sisudoc.org]
+
+  - Git
+    [https://git.sisudoc.org/projects/?p=software/spine.git;a=summary]
+
++/
+#+END_SRC
+
+* __END__
diff --git a/org/spine.org b/org/spine.org
index 79a0e5e..5a2dcba 100644
--- a/org/spine.org
+++ b/org/spine.org
@@ -1662,9 +1662,8 @@ auto da = docAbstraction!()(
   _manifest,
   true,
 );
-static assert(da.length==2);
-auto doc_abstraction = da[docAbst.doc_abstract_obj]; /+ head ~ toc ~ body ~ endnotes_seg ~ glossary ~ bibliography ~ bookindex ~ blurb; +/
-auto _doc_has_struct = da[docAbst.doc_has];
+auto doc_abstraction = da.document_the;
+auto _doc_has_struct = da.doc_has;
 if ((_opt_action.debug_do)
   || (_opt_action.debug_do_stages)
 ) {
diff --git a/src/doc_reform/meta/metadoc.d b/src/doc_reform/meta/metadoc.d
index cefee5b..a577530 100644
--- a/src/doc_reform/meta/metadoc.d
+++ b/src/doc_reform/meta/metadoc.d
@@ -132,9 +132,8 @@ template spineAbstraction() {
       _manifest,
       true,
     );
-    static assert(da.length==2);
-    auto doc_abstraction = da[docAbst.doc_abstract_obj]; /+ head ~ toc ~ body ~ endnotes_seg ~ glossary ~ bibliography ~ bookindex ~ blurb; +/
-    auto _doc_has_struct = da[docAbst.doc_has];
+    auto doc_abstraction = da.document_the;
+    auto _doc_has_struct = da.doc_has;
     if ((_opt_action.debug_do)
       || (_opt_action.debug_do_stages)
     ) {
diff --git a/src/doc_reform/meta/metadoc_from_src.d b/src/doc_reform/meta/metadoc_from_src.d
index 59cbc0b..620f884 100644
--- a/src/doc_reform/meta/metadoc_from_src.d
+++ b/src/doc_reform/meta/metadoc_from_src.d
@@ -126,7 +126,17 @@ template docAbstraction() {
   }
   /+ initialize +/
   ObjGenericComposite[] the_document_toc_section, the_document_head_section, the_document_body_section, the_document_bibliography_section, the_document_glossary_section, the_document_blurb_section, the_document_xml_dom_tail_section;
-  string[string] an_object, processing;
+  struct _theDoc {
+    ObjGenericComposite[] toc;
+    ObjGenericComposite[] head;
+    ObjGenericComposite[] body;
+    ObjGenericComposite[] bibliography;
+    ObjGenericComposite[] glossary;
+    ObjGenericComposite[] bookindex;
+    ObjGenericComposite[] blurb;
+    ObjGenericComposite[] endnotes;
+  }
+  string[string] an_object, processing, object_notes;
   string an_object_key;
   string[] anchor_tags;
   string anchor_tag;
@@ -605,708 +615,872 @@ template docAbstraction() {
         writeln("substitution to make: ", conf_make_meta.make.italics[Substitute.markup]);
       }
     }
-                                                                                /+ ↓ ↻ loop markup document/text line by line +/
-    srcDocLoop:
-    foreach (line; markup_sourcefile_content) {                                 /+ ↓ markup document/text line by line +/
-                                                                                // "line" variable can be empty but should never be null
-      /+ scope +/
-      scope(exit) { }
-      scope(failure) {
-        stderr.writefln(
-          "\n%s\n%s\n\n%s:%s\nFAILED while processing the file: ❮❮ %s ❯❯ on line with text:\n%s\n",
-          __MODULE__, __FUNCTION__,
-          __FILE__, __LINE__,
-          manifested.src.filename, line,
-        );
-      }
-      debug(source) {
-        writeln(line);
-      }
-      debug(srclines) {
-        if (!line.empty) {
-          writefln("* %s", line);
+    auto loopMarkupSrcByLine(
+      char[][]         markup_sourcefile_content,
+      string[string]   an_object,
+      uint[string]     pith,
+    ) {
+      struct _loopMarkupSrcByLineStruct {
+        ObjGenericComposite[] toc;
+        ObjGenericComposite[] body;
+        ObjGenericComposite[] glossary;
+        ObjGenericComposite[] blurb;
+        string[string]        object_notes;
+        string[][string]      segnames;
+      }
+      _loopMarkupSrcByLineStruct ret;
+      srcDocLoopLineByLine_:
+      foreach (line; markup_sourcefile_content) {                                 /+ ↓ markup document/text line by line +/
+                                                                                  // "line" variable can be empty but should never be null
+        /+ scope +/
+        scope(exit) { }
+        scope(failure) {
+          stderr.writefln(
+            "\n%s\n%s\n\n%s:%s\nFAILED while processing the file: ❮❮ %s ❯❯ on line with text:\n%s\n",
+            __MODULE__, __FUNCTION__,
+            __FILE__, __LINE__,
+            manifested.src.filename, line,
+          );
         }
-      }
-      if (!line.empty) {
-        pith = line._check_ocn_status_(pith);
-      }
-      if ( pith["block_is"] == eN.blk_is.code
-        && pith["block_state"] == eN.blk_state.on
-      ) {
-        /+ block object: code +/
-        line.flow_txt_block_code(an_object, pith);
-        continue;
-      } else if (!matchFirst(line, rgx.skip_from_regular_parse)) {              /+ object other than "code block" object +/
-                                                                                /+ (includes regular text paragraph, headings & blocks other than code) +/
-                                                                                /+ heading, glossary, blurb, poem, group, block, quote, table +/
-        line = line.inline_markup_faces; // by text line (rather than by text object), linebreaks in para problematic
-        if (line.matchFirst(rgx.heading_biblio)
-        || (pith["section"] == eN.sect.bibliography
-          && ((!(line.matchFirst(rgx.heading_glossary)))
-          && (!(line.matchFirst(rgx.heading_blurb)))
-          && (!(line.matchFirst(rgx.heading)))
-          && (!(line.matchFirst(rgx.comment)))))
+        debug(source) {
+          writeln(line);
+        }
+        debug(srclines) {
+          if (!line.empty) { writefln("* %s", line); }
+        }
+        if (!line.empty) { pith = line._check_ocn_status_(pith); }
+        if ( pith["block_is"] == eN.blk_is.code
+          && pith["block_state"] == eN.blk_state.on
         ) {
-          pith["section"] = eN.sect.bibliography;
-          if (opt_action.backmatter && opt_action.section_biblio) {
-            line.flow_txt_block_biblio(pith, bib_entry, biblio_entry_str_json, biblio_arr_json);
-            debug(bibliobuild) {
-              writeln("-  ", biblio_entry_str_json);
-              writeln("-> ", biblio_arr_json.length);
-            }
+          /+ block object: code +/
+          {
+            auto _get = line.txt_by_line_block_code(an_object, pith);
+            an_object = _get.this_object;
+            pith      = _get.pith;
           }
           continue;
-        } else if (line.matchFirst(rgx.heading_glossary)
-        || (pith["section"] == eN.sect.glossary
-          && ((!(line.matchFirst(rgx.heading_biblio)))
-          && (!(line.matchFirst(rgx.heading_blurb)))
-          && (!(line.matchFirst(rgx.heading)))
-          && (!(line.matchFirst(rgx.comment)))))
-        ) {
-          /+ within section (block object): glossary +/
-          debug(glossary) {
-            writeln(__LINE__);
-            writeln(line);
-          }
-          pith["section"] = eN.sect.glossary;
-          if (opt_action.backmatter && opt_action.section_glossary) {
-            indent = [
-              "hang_position" : 0,
-              "base_position" : 0,
-            ];
-            bullet = false;
-            pith["txt_is"]           = eN.txt_is.para;
-            line_occur["para"]       = eN.bi.off;
-            an_object_key = "glossary_nugget";
-            if (line.matchFirst(rgx.heading_glossary)) {
+        } else if (!matchFirst(line, rgx.skip_from_regular_parse)) {              /+ object other than "code block" object +/
+                                                                                  /+ (includes regular text paragraph, headings & blocks other than code) +/
+                                                                                  /+ heading, glossary, blurb, poem, group, block, quote, table +/
+          line = line.inline_markup_faces; // by text line (rather than by text object), linebreaks in para problematic
+          if (line.matchFirst(rgx.heading_biblio)
+          || (pith["section"] == eN.sect.bibliography
+            && ((!(line.matchFirst(rgx.heading_glossary)))
+            && (!(line.matchFirst(rgx.heading_blurb)))
+            && (!(line.matchFirst(rgx.heading)))
+            && (!(line.matchFirst(rgx.comment)))))
+          ) {
+            pith["section"] = eN.sect.bibliography;
+            if (opt_action.backmatter && opt_action.section_biblio) {
               {
-                comp_obj_heading_                                = comp_obj_heading_.init;
-                comp_obj_heading_.metainfo.is_of_part            = "backmatter";
-                comp_obj_heading_.metainfo.is_of_section         = "glossary";
-                comp_obj_heading_.metainfo.is_of_type            = "para";
-                comp_obj_heading_.metainfo.is_a                  = "heading";
-                comp_obj_heading_.text                           = "Glossary";
-                comp_obj_heading_.metainfo.ocn                   = 0;
-                comp_obj_heading_.metainfo.identifier            = "";
-                comp_obj_heading_.metainfo.dummy_heading         = false;
-                comp_obj_heading_.metainfo.object_number_off     = false;
-                comp_obj_heading_.metainfo.object_number_type    = 0;
-                comp_obj_heading_.tags.segment_anchor_tag_epub   = "_part_glossary";
-                comp_obj_heading_.tags.anchor_tag_html           = comp_obj_heading_.tags.segment_anchor_tag_epub;
-                comp_obj_heading_.tags.in_segment_html           = "glossary";
-                comp_obj_heading_.tags.anchor_tags               = ["section_glossary"];
-                comp_obj_heading_.metainfo.heading_lev_markup    = 1;
-                comp_obj_heading_.metainfo.heading_lev_collapsed = 1;
-                comp_obj_heading_.metainfo.parent_ocn            = 1;
-                comp_obj_heading_.metainfo.parent_lev_markup     = 0;
-                comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 0, 0, 0, 0];
-                comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 0, 0, 0, 0, 0, 0];
-                the_document_glossary_section                    ~= comp_obj_heading_;
-                tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-                tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+                auto _get = line.txt_by_line_block_biblio(pith, bib_entry, biblio_entry_str_json, biblio_arr_json);
+                {
+                  pith                  = _get.pith;
+                  bib_entry             = _get.bib_entry;
+                  biblio_entry_str_json = _get.biblio_entry_str_json;
+                  biblio_arr_json       = _get.biblio_arr_json;
+                }
               }
-              {
-                comp_obj_heading_                                = comp_obj_heading_.init;
-                comp_obj_heading_.metainfo.is_of_part            = "backmatter";
-                comp_obj_heading_.metainfo.is_of_section         = "glossary";
-                comp_obj_heading_.metainfo.is_of_type            = "para";
-                comp_obj_heading_.metainfo.is_a                  = "heading";
-                comp_obj_heading_.text                           = "Glossary";
-                comp_obj_heading_.metainfo.ocn                   = 0;
-                comp_obj_heading_.metainfo.identifier            = "";
-                comp_obj_heading_.metainfo.dummy_heading         = true;
-                comp_obj_heading_.metainfo.object_number_off     = true;
-                comp_obj_heading_.metainfo.object_number_type    = 0;
-                comp_obj_heading_.tags.segment_anchor_tag_epub   = "glossary";
-                comp_obj_heading_.tags.anchor_tag_html           = comp_obj_heading_.tags.segment_anchor_tag_epub;
-                comp_obj_heading_.tags.in_segment_html           = comp_obj_heading_.tags.anchor_tag_html;
-                comp_obj_heading_.metainfo.heading_lev_markup    = 4;
-                comp_obj_heading_.metainfo.heading_lev_collapsed = 2;
-                comp_obj_heading_.metainfo.parent_ocn            = 1;
-                comp_obj_heading_.metainfo.parent_lev_markup     = 0;
-                comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 1, 0, 0, 0];
-                comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 1, 0, 0, 0, 0, 0];
-                comp_obj_heading_.tags.anchor_tags               = ["glossary"];
-                the_document_glossary_section                    ~= comp_obj_heading_;
-                tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-                tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+              debug(bibliobuild) {
+                writeln("-  ", biblio_entry_str_json);
+                writeln("-> ", biblio_arr_json.length);
               }
-            } else {
-              an_object = line.flow_para_match_(an_object, an_object_key, indent, bullet, pith, line_occur);
-              comp_obj_para                               = comp_obj_para.init;
-              comp_obj_para.metainfo.is_of_part           = "backmatter";
-              comp_obj_para.metainfo.is_of_section        = "glossary";
-              comp_obj_para.metainfo.is_of_type           = "para";
-              comp_obj_para.metainfo.is_a                 = "glossary";
-              comp_obj_para.text                          = links_and_images(line.to!string.strip).replaceFirst(rgx.para_attribs, "");
-              comp_obj_para.metainfo.ocn                  = 0;
-              comp_obj_para.metainfo.identifier           = "";
-              comp_obj_para.metainfo.object_number_off    = true;
-              comp_obj_para.metainfo.object_number_type   = 0;
-              comp_obj_para.attrib.indent_hang            = indent["hang_position"];
-              comp_obj_para.attrib.indent_base            = indent["base_position"];
-              comp_obj_para.attrib.bullet                 = bullet;
-              the_document_glossary_section               ~= comp_obj_para;
             }
-            pith["ocn"] = eN.ocn.on;
-          }
-          continue;
-        } else if (line.matchFirst(rgx.heading_blurb)
-        || (pith["section"] == eN.sect.blurb
-          && ((!(line.matchFirst(rgx.heading_glossary)))
-          && (!(line.matchFirst(rgx.heading_biblio)))
-          && (!(line.matchFirst(rgx.heading)))
-          && (!(line.matchFirst(rgx.comment)))))
-        ) {
-          pith["section"] = eN.sect.blurb;
-          debug(blurb) {
-            writeln(__LINE__);
-            writeln(line);
-          }
-          if (opt_action.backmatter && opt_action.section_blurb) {
-            indent = [
-              "hang_position" : 0,
-              "base_position" : 0,
-            ];
-            bullet = false;
-            if (auto m = line.matchFirst(rgx.para_indent)) {
-              debug(paraindent) {
-                writeln(line);
-              }
-              indent["hang_position"] = (m["indent"]).to!int;
-              indent["base_position"] = (m["indent"]).to!int;
-            } else if (line.matchFirst(rgx.para_bullet)) {
-              debug(parabullet) {
-                writeln(line);
-              }
-              bullet = true;
-            } else if (auto m = line.matchFirst(rgx.para_indent_hang)) {
-              debug(paraindenthang) {
-                writeln(line);
-              }
+            continue;
+          } else if (line.matchFirst(rgx.heading_glossary)
+          || (pith["section"] == eN.sect.glossary
+            && ((!(line.matchFirst(rgx.heading_biblio)))
+            && (!(line.matchFirst(rgx.heading_blurb)))
+            && (!(line.matchFirst(rgx.heading)))
+            && (!(line.matchFirst(rgx.comment)))))
+          ) {
+            /+ within section (block object): glossary +/
+            debug(glossary) {
+              writeln(__LINE__);
+              writeln(line);
+            }
+            pith["section"] = eN.sect.glossary;
+            if (opt_action.backmatter && opt_action.section_glossary) {
               indent = [
-                "hang_position" : (m["hang"]).to!int,
-                "base_position" : (m["indent"]).to!int,
+                "hang_position" : 0,
+                "base_position" : 0,
               ];
-            } else if (auto m = line.matchFirst(rgx.para_bullet_indent)) {
-              debug(parabulletindent) {
-                writeln(line);
+              bullet = false;
+              pith["txt_is"]           = eN.txt_is.para;
+              line_occur["para"]       = eN.bi.off;
+              an_object_key = "glossary_nugget";
+              if (line.matchFirst(rgx.heading_glossary)) {
+                {
+                  comp_obj_heading_                                = comp_obj_heading_.init;
+                  comp_obj_heading_.metainfo.is_of_part            = "backmatter";
+                  comp_obj_heading_.metainfo.is_of_section         = "glossary";
+                  comp_obj_heading_.metainfo.is_of_type            = "para";
+                  comp_obj_heading_.metainfo.is_a                  = "heading";
+                  comp_obj_heading_.text                           = "Glossary";
+                  comp_obj_heading_.metainfo.ocn                   = 0;
+                  comp_obj_heading_.metainfo.identifier            = "";
+                  comp_obj_heading_.metainfo.dummy_heading         = false;
+                  comp_obj_heading_.metainfo.object_number_off     = false;
+                  comp_obj_heading_.metainfo.object_number_type    = 0;
+                  comp_obj_heading_.tags.segment_anchor_tag_epub   = "_part_glossary";
+                  comp_obj_heading_.tags.anchor_tag_html           = comp_obj_heading_.tags.segment_anchor_tag_epub;
+                  comp_obj_heading_.tags.in_segment_html           = "glossary";
+                  comp_obj_heading_.tags.anchor_tags               = ["section_glossary"];
+                  comp_obj_heading_.metainfo.heading_lev_markup    = 1;
+                  comp_obj_heading_.metainfo.heading_lev_collapsed = 1;
+                  comp_obj_heading_.metainfo.parent_ocn            = 1;
+                  comp_obj_heading_.metainfo.parent_lev_markup     = 0;
+                  comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 0, 0, 0, 0];
+                  comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 0, 0, 0, 0, 0, 0];
+                  the_document_glossary_section                    ~= comp_obj_heading_;
+                  tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+                  tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+                }
+                {
+                  comp_obj_heading_                                = comp_obj_heading_.init;
+                  comp_obj_heading_.metainfo.is_of_part            = "backmatter";
+                  comp_obj_heading_.metainfo.is_of_section         = "glossary";
+                  comp_obj_heading_.metainfo.is_of_type            = "para";
+                  comp_obj_heading_.metainfo.is_a                  = "heading";
+                  comp_obj_heading_.text                           = "Glossary";
+                  comp_obj_heading_.metainfo.ocn                   = 0;
+                  comp_obj_heading_.metainfo.identifier            = "";
+                  comp_obj_heading_.metainfo.dummy_heading         = true;
+                  comp_obj_heading_.metainfo.object_number_off     = true;
+                  comp_obj_heading_.metainfo.object_number_type    = 0;
+                  comp_obj_heading_.tags.segment_anchor_tag_epub   = "glossary";
+                  comp_obj_heading_.tags.anchor_tag_html           = comp_obj_heading_.tags.segment_anchor_tag_epub;
+                  comp_obj_heading_.tags.in_segment_html           = comp_obj_heading_.tags.anchor_tag_html;
+                  comp_obj_heading_.metainfo.heading_lev_markup    = 4;
+                  comp_obj_heading_.metainfo.heading_lev_collapsed = 2;
+                  comp_obj_heading_.metainfo.parent_ocn            = 1;
+                  comp_obj_heading_.metainfo.parent_lev_markup     = 0;
+                  comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 1, 0, 0, 0];
+                  comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 1, 0, 0, 0, 0, 0];
+                  comp_obj_heading_.tags.anchor_tags               = ["glossary"];
+                  the_document_glossary_section                    ~= comp_obj_heading_;
+                  tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+                  tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+                }
+              } else {
+                {
+                  auto _get = line.flow_para_match_(an_object, an_object_key, indent, bullet, pith, line_occur);
+                  {
+                    an_object     = _get.this_object;
+                    an_object_key = _get.this_object_key;
+                    pith          = _get.pith;
+                    indent        = _get.indent;
+                    bullet        = _get.bullet;
+                    line_occur    = _get.line_occur;
+                  }
+                }
+                comp_obj_para                               = comp_obj_para.init;
+                comp_obj_para.metainfo.is_of_part           = "backmatter";
+                comp_obj_para.metainfo.is_of_section        = "glossary";
+                comp_obj_para.metainfo.is_of_type           = "para";
+                comp_obj_para.metainfo.is_a                 = "glossary";
+                comp_obj_para.text                          = links_and_images(line.to!string.strip).replaceFirst(rgx.para_attribs, "");
+                comp_obj_para.metainfo.ocn                  = 0;
+                comp_obj_para.metainfo.identifier           = "";
+                comp_obj_para.metainfo.object_number_off    = true;
+                comp_obj_para.metainfo.object_number_type   = 0;
+                comp_obj_para.attrib.indent_hang            = indent["hang_position"];
+                comp_obj_para.attrib.indent_base            = indent["base_position"];
+                comp_obj_para.attrib.bullet                 = bullet;
+                the_document_glossary_section               ~= comp_obj_para;
               }
+              pith["ocn"] = eN.ocn.on;
+            }
+            continue;
+          } else if (line.matchFirst(rgx.heading_blurb)
+          || (pith["section"] == eN.sect.blurb
+            && ((!(line.matchFirst(rgx.heading_glossary)))
+            && (!(line.matchFirst(rgx.heading_biblio)))
+            && (!(line.matchFirst(rgx.heading)))
+            && (!(line.matchFirst(rgx.comment)))))
+          ) {
+            pith["section"] = eN.sect.blurb;
+            debug(blurb) {
+              writeln(__LINE__);
+              writeln(line);
+            }
+            if (opt_action.backmatter && opt_action.section_blurb) {
               indent = [
-                "hang_position" : (m["indent"]).to!int,
-                "base_position" : (m["indent"]).to!int,
+                "hang_position" : 0,
+                "base_position" : 0,
               ];
-              bullet = true;
-            }
-            pith["txt_is"]           = eN.txt_is.para;
-            line_occur["para"]       = eN.bi.off;
-            an_object_key = "blurb_nugget";
-            if (line.matchFirst(rgx.heading_blurb)) {
-              {
-                comp_obj_heading_                                              = comp_obj_heading_.init;
-                comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
-                comp_obj_heading_.metainfo.is_of_section                       = "blurb";
-                comp_obj_heading_.metainfo.is_of_type                          = "para";
-                comp_obj_heading_.metainfo.is_a                                = "heading";
-                comp_obj_heading_.text                                         = "Blurb";
-                comp_obj_heading_.metainfo.ocn                                 = 0;
-                comp_obj_heading_.metainfo.identifier                          = "";
-                comp_obj_heading_.metainfo.dummy_heading                       = false;
-                comp_obj_heading_.metainfo.object_number_off                   = false;
-                comp_obj_heading_.metainfo.object_number_type                  = 0;
-                comp_obj_heading_.tags.segment_anchor_tag_epub                 = "_part_blurb";
-                comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
-                comp_obj_heading_.tags.in_segment_html                         = "blurb";
-                comp_obj_heading_.tags.anchor_tags                             = ["section_blurb"];
-                comp_obj_heading_.metainfo.heading_lev_markup                  = 1;
-                comp_obj_heading_.metainfo.heading_lev_collapsed               = 1;
-                comp_obj_heading_.metainfo.parent_ocn                          = 1;
-                comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
-                comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 0, 0, 0, 0];
-                comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 0, 0, 0, 0, 0, 0];
-                the_document_blurb_section                                     ~= comp_obj_heading_;
-                tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-                tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+              bullet = false;
+              if (auto m = line.matchFirst(rgx.para_indent)) {
+                debug(paraindent) {
+                  writeln(line);
+                }
+                indent["hang_position"] = (m["indent"]).to!int;
+                indent["base_position"] = (m["indent"]).to!int;
+              } else if (line.matchFirst(rgx.para_bullet)) {
+                debug(parabullet) {
+                  writeln(line);
+                }
+                bullet = true;
+              } else if (auto m = line.matchFirst(rgx.para_indent_hang)) {
+                debug(paraindenthang) {
+                  writeln(line);
+                }
+                indent = [
+                  "hang_position" : (m["hang"]).to!int,
+                  "base_position" : (m["indent"]).to!int,
+                ];
+              } else if (auto m = line.matchFirst(rgx.para_bullet_indent)) {
+                debug(parabulletindent) {
+                  writeln(line);
+                }
+                indent = [
+                  "hang_position" : (m["indent"]).to!int,
+                  "base_position" : (m["indent"]).to!int,
+                ];
+                bullet = true;
               }
-              {
+              pith["txt_is"]           = eN.txt_is.para;
+              line_occur["para"]       = eN.bi.off;
+              an_object_key = "blurb_nugget";
+              if (line.matchFirst(rgx.heading_blurb)) {
+                {
+                  comp_obj_heading_                                              = comp_obj_heading_.init;
+                  comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
+                  comp_obj_heading_.metainfo.is_of_section                       = "blurb";
+                  comp_obj_heading_.metainfo.is_of_type                          = "para";
+                  comp_obj_heading_.metainfo.is_a                                = "heading";
+                  comp_obj_heading_.text                                         = "Blurb";
+                  comp_obj_heading_.metainfo.ocn                                 = 0;
+                  comp_obj_heading_.metainfo.identifier                          = "";
+                  comp_obj_heading_.metainfo.dummy_heading                       = false;
+                  comp_obj_heading_.metainfo.object_number_off                   = false;
+                  comp_obj_heading_.metainfo.object_number_type                  = 0;
+                  comp_obj_heading_.tags.segment_anchor_tag_epub                 = "_part_blurb";
+                  comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
+                  comp_obj_heading_.tags.in_segment_html                         = "blurb";
+                  comp_obj_heading_.tags.anchor_tags                             = ["section_blurb"];
+                  comp_obj_heading_.metainfo.heading_lev_markup                  = 1;
+                  comp_obj_heading_.metainfo.heading_lev_collapsed               = 1;
+                  comp_obj_heading_.metainfo.parent_ocn                          = 1;
+                  comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
+                  comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 0, 0, 0, 0];
+                  comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 0, 0, 0, 0, 0, 0];
+                  the_document_blurb_section                                     ~= comp_obj_heading_;
+                  tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+                  tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+                }
+                {
+                  comp_obj_heading_                                              = comp_obj_heading_.init;
+                  comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
+                  comp_obj_heading_.metainfo.is_of_section                       = "blurb";
+                  comp_obj_heading_.metainfo.is_of_type                          = "para";
+                  comp_obj_heading_.metainfo.is_a                                = "heading";
+                  comp_obj_heading_.text                                         = "Blurb";
+                  comp_obj_heading_.metainfo.ocn                                 = 0;
+                  comp_obj_heading_.metainfo.identifier                          = "";
+                  comp_obj_heading_.metainfo.dummy_heading                       = true;
+                  comp_obj_heading_.metainfo.object_number_off                   = true;
+                  comp_obj_heading_.metainfo.object_number_type                  = 0;
+                  comp_obj_heading_.tags.segment_anchor_tag_epub                 = "blurb";
+                  comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
+                  comp_obj_heading_.tags.in_segment_html                         = comp_obj_heading_.tags.anchor_tag_html;
+                  comp_obj_heading_.metainfo.heading_lev_markup                  = 4;
+                  comp_obj_heading_.metainfo.heading_lev_collapsed               = 2;
+                  comp_obj_heading_.metainfo.parent_ocn                          = 1;
+                  comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
+                  comp_obj_heading_.tags.anchor_tags                             = ["blurb"];
+                  comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 1, 0, 0, 0];
+                  comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 1, 0, 0, 0, 0, 0];
+                  the_document_blurb_section                                     ~= comp_obj_heading_;
+                  tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
+                  tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+                }
+              } else if (line.matchFirst(rgx.headings)
+              && (opt_action.backmatter && opt_action.section_blurb)) {
                 comp_obj_heading_                                              = comp_obj_heading_.init;
                 comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
                 comp_obj_heading_.metainfo.is_of_section                       = "blurb";
                 comp_obj_heading_.metainfo.is_of_type                          = "para";
                 comp_obj_heading_.metainfo.is_a                                = "heading";
-                comp_obj_heading_.text                                         = "Blurb";
+                comp_obj_heading_.text                                         = line.to!string;
                 comp_obj_heading_.metainfo.ocn                                 = 0;
                 comp_obj_heading_.metainfo.identifier                          = "";
-                comp_obj_heading_.metainfo.dummy_heading                       = true;
+                comp_obj_heading_.metainfo.dummy_heading                       = false;
                 comp_obj_heading_.metainfo.object_number_off                   = true;
                 comp_obj_heading_.metainfo.object_number_type                  = 0;
                 comp_obj_heading_.tags.segment_anchor_tag_epub                 = "blurb";
                 comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
                 comp_obj_heading_.tags.in_segment_html                         = comp_obj_heading_.tags.anchor_tag_html;
-                comp_obj_heading_.metainfo.heading_lev_markup                  = 4;
-                comp_obj_heading_.metainfo.heading_lev_collapsed               = 2;
+                comp_obj_heading_.metainfo.heading_lev_markup                  = an_object["lev_markup_number"].to!int;    // make int, remove need to conv
+                comp_obj_heading_.metainfo.heading_lev_collapsed               = an_object["lev_collapsed_number"].to!int; // make int, remove need to conv
                 comp_obj_heading_.metainfo.parent_ocn                          = 1;
                 comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
-                comp_obj_heading_.tags.anchor_tags                             = ["blurb"];
-                comp_obj_heading_.metainfo.dom_structure_markedup_tags_status  = [ 1, 1, 0, 0, 1, 0, 0, 0];
-                comp_obj_heading_.metainfo.dom_structure_collapsed_tags_status = [ 1, 1, 1, 0, 0, 0, 0, 0];
                 the_document_blurb_section                                     ~= comp_obj_heading_;
                 tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
                 tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
+              } else if (!(line.empty)) {
+                {
+                  auto _get = line.flow_para_match_(an_object, an_object_key, indent, bullet, pith, line_occur);
+                  {
+                    an_object     = _get.this_object;
+                    an_object_key = _get.this_object_key;
+                    pith          = _get.pith;
+                    indent        = _get.indent;
+                    bullet        = _get.bullet;
+                    line_occur    = _get.line_occur;
+                  }
+                }
+                comp_obj_para                               = comp_obj_para.init;
+                comp_obj_para.metainfo.is_of_part           = "backmatter";
+                comp_obj_para.metainfo.is_of_section        = "blurb";
+                comp_obj_para.metainfo.is_of_type           = "para";
+                comp_obj_para.metainfo.is_a                 = "blurb";
+                comp_obj_para.text                          = links_and_images(line.to!string.strip).replaceFirst(rgx.para_attribs, "");
+                comp_obj_para.metainfo.ocn                  = 0;
+                comp_obj_para.metainfo.identifier           = "";
+                comp_obj_para.metainfo.object_number_off    = true;
+                comp_obj_para.metainfo.object_number_type   = 0;
+                comp_obj_para.attrib.indent_hang            = indent["hang_position"];
+                comp_obj_para.attrib.indent_base            = indent["base_position"];
+                comp_obj_para.has.inline_links              = true;
+                comp_obj_para.attrib.bullet                 = bullet;
+                the_document_blurb_section                  ~= comp_obj_para;
               }
-            } else if (line.matchFirst(rgx.headings)
-            && (opt_action.backmatter && opt_action.section_blurb)) {
-              comp_obj_heading_                                              = comp_obj_heading_.init;
-              comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
-              comp_obj_heading_.metainfo.is_of_section                       = "blurb";
-              comp_obj_heading_.metainfo.is_of_type                          = "para";
-              comp_obj_heading_.metainfo.is_a                                = "heading";
-              comp_obj_heading_.text                                         = line.to!string;
-              comp_obj_heading_.metainfo.ocn                                 = 0;
-              comp_obj_heading_.metainfo.identifier                          = "";
-              comp_obj_heading_.metainfo.dummy_heading                       = false;
-              comp_obj_heading_.metainfo.object_number_off                   = true;
-              comp_obj_heading_.metainfo.object_number_type                  = 0;
-              comp_obj_heading_.tags.segment_anchor_tag_epub                 = "blurb";
-              comp_obj_heading_.tags.anchor_tag_html                         = comp_obj_heading_.tags.segment_anchor_tag_epub;
-              comp_obj_heading_.tags.in_segment_html                         = comp_obj_heading_.tags.anchor_tag_html;
-              comp_obj_heading_.metainfo.heading_lev_markup                  = an_object["lev_markup_number"].to!int;    // make int, remove need to conv
-              comp_obj_heading_.metainfo.heading_lev_collapsed               = an_object["lev_collapsed_number"].to!int; // make int, remove need to conv
-              comp_obj_heading_.metainfo.parent_ocn                          = 1;
-              comp_obj_heading_.metainfo.parent_lev_markup                   = 0;
-              the_document_blurb_section                                     ~= comp_obj_heading_;
-              tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
-              tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
-            } else if (!(line.empty)) {
-              an_object = line.flow_para_match_(an_object, an_object_key, indent, bullet, pith, line_occur);
-              comp_obj_para                               = comp_obj_para.init;
-              comp_obj_para.metainfo.is_of_part           = "backmatter";
-              comp_obj_para.metainfo.is_of_section        = "blurb";
-              comp_obj_para.metainfo.is_of_type           = "para";
-              comp_obj_para.metainfo.is_a                 = "blurb";
-              comp_obj_para.text                          = links_and_images(line.to!string.strip).replaceFirst(rgx.para_attribs, "");
-              comp_obj_para.metainfo.ocn                  = 0;
-              comp_obj_para.metainfo.identifier           = "";
-              comp_obj_para.metainfo.object_number_off    = true;
-              comp_obj_para.metainfo.object_number_type   = 0;
-              comp_obj_para.attrib.indent_hang            = indent["hang_position"];
-              comp_obj_para.attrib.indent_base            = indent["base_position"];
-              comp_obj_para.has.inline_links              = true;
-              comp_obj_para.attrib.bullet                 = bullet;
-              the_document_blurb_section                  ~= comp_obj_para;
+              pith["ocn"] = eN.ocn.on;
             }
-            pith["ocn"] = eN.ocn.on;
-          }
-          continue;
-        } else if (pith["block_state"] == eN.blk_state.on) {
-          if (pith["block_is"]    == eN.blk_is.quote) {
-            line = line
-              ._doc_header_and_make_substitutions_(conf_make_meta)
-              ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
-            an_object = line.flow_txt_block_quote(an_object, pith);
-            continue;
-          } else if (pith["block_is"]    == eN.blk_is.group) {
-            line = line
-              ._doc_header_and_make_substitutions_(conf_make_meta)
-              ._doc_header_and_make_substitutions_fontface_(conf_make_meta)
-              .replaceAll(rgx.para_delimiter, mkup.br_line_spaced ~ "$1");
-            an_object = line.flow_txt_block_group(an_object, pith);
             continue;
-          } else if (pith["block_is"]    == eN.blk_is.block) {
-            line = line
-              ._doc_header_and_make_substitutions_(conf_make_meta)
-              ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
-            if (auto m = line.match(rgx.spaces_keep)) {
+          } else if (pith["block_state"] == eN.blk_state.on) {
+            if (pith["block_is"]    == eN.blk_is.quote) {
               line = line
-                .replaceAll(rgx.spaces_keep, (m.captures[1]).translate([ ' ' : mkup.nbsp ]));
-            }
-            an_object = line.flow_txt_block_block(an_object, pith);
-            continue;
-          } else if (pith["block_is"]    == eN.blk_is.poem) {
-            an_object = line.flow_txt_block_poem(an_object, pith, cntr, object_number_poem, conf_make_meta, tag_in_seg);
-            continue;
-          } else if (pith["block_is"]    == eN.blk_is.table) {
-            an_object = line.flow_txt_block_table(an_object, pith, conf_make_meta);
-            continue;
-          }
-        } else {                                                                /+ not within a block group +/
-          assert(
-            (pith["block_state"] == eN.blk_state.off)
-            || (pith["block_state"] == eN.blk_state.closing),
-            "block status: none or closed"
-          );
-          if (line.matchFirst(rgx.block_open)) {
-            if (line.matchFirst(rgx.block_poem_open)) {                                    /+ poem to verse exceptions! +/
-              object_reset(an_object);
-              processing.remove("verse");
-              object_number_poem["start"] = obj_cite_digits.object_number.to!string;
+                ._doc_header_and_make_substitutions_(conf_make_meta)
+                ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
+              {
+                auto _get = line.txt_by_line_block_quote(an_object, pith);
+                {
+                  an_object = _get.this_object;
+                  pith      = _get.pith;
+                }
+              }
+              continue;
+            } else if (pith["block_is"]    == eN.blk_is.group) {
+              line = line
+                ._doc_header_and_make_substitutions_(conf_make_meta)
+                ._doc_header_and_make_substitutions_fontface_(conf_make_meta)
+                .replaceAll(rgx.para_delimiter, mkup.br_line_spaced ~ "$1");
+              {
+                auto _get = line.txt_by_line_block_group(an_object, pith);
+                {
+                  an_object = _get.this_object;
+                  pith      = _get.pith;
+                }
+              }
+              continue;
+            } else if (pith["block_is"]    == eN.blk_is.block) {
+              line = line
+                ._doc_header_and_make_substitutions_(conf_make_meta)
+                ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
+              if (auto m = line.match(rgx.spaces_keep)) {
+                line = line
+                  .replaceAll(rgx.spaces_keep, (m.captures[1]).translate([ ' ' : mkup.nbsp ]));
+              }
+              {
+                auto _get = line.txt_by_line_block_block(an_object, pith);
+                {
+                  an_object = _get.this_object;
+                  pith      = _get.pith;
+                }
+              }
+              continue;
+            } else if (pith["block_is"]    == eN.blk_is.poem) {
+              {
+                auto _get = line.txt_by_line_block_poem(an_object, pith, cntr, object_number_poem, conf_make_meta, tag_in_seg);
+                {
+                  an_object = _get.this_object;
+                  pith      = _get.pith;
+                  cntr      = _get.cntr;
+                }
+              }
+              continue;
+            } else if (pith["block_is"]    == eN.blk_is.table) {
+              {
+                auto _get = line.txt_by_line_block_table(an_object, pith, conf_make_meta);
+                {
+                  an_object      = _get.this_object;
+                  pith           = _get.pith;
+                  conf_make_meta = _get.conf_make_meta;
+                }
+              }
+              continue;
             }
-            line.flow_txt_block_start(pith, dochas, object_number_poem);
-            continue;
-          } else if (!line.empty) {                                             /+ line not empty +/
-                                                                                /+ non blocks (headings, paragraphs) & closed blocks +/
-            assert(
-              !line.empty,
-              "line tested, line not empty surely:\n  \"" ~ line ~ "\""
-            );
+          } else {                                                                /+ not within a block group +/
             assert(
               (pith["block_state"] == eN.blk_state.off)
               || (pith["block_state"] == eN.blk_state.closing),
-              "code block status: none or closed"
+              "block status: none or closed"
             );
-            if (pith["block_state"] == eN.blk_state.closing) {
-              debug(check) {
-                writeln(__LINE__);
-                writeln(line);
+            if (line.matchFirst(rgx.block_open)) {
+              if (line.matchFirst(rgx.block_poem_open)) {                                    /+ poem to verse exceptions! +/
+                object_reset(an_object);
+                processing.remove("verse");
+                object_number_poem["start"] = obj_cite_digits.object_number.to!string;
+              }
+              {
+                auto _get = line.txt_by_line_block_start(pith, dochas, object_number_poem);
+                {
+                  pith               = _get.pith;
+                  dochas             = _get.dochas;
+                  object_number_poem = _get.object_number_poem;
+                }
               }
+              continue;
+            } else if (!line.empty) {                                             /+ line not empty - non blocks (headings, paragraphs) & closed blocks +/
               assert(
-                line.matchFirst(rgx.book_index_item)
-                || line.matchFirst(rgx.book_index_item_open)
-                || pith["section"] == eN.sect.book_index,
-                "\nblocks closed, unless followed by book index, non-matching line:\n  \""
-                ~ line ~ "\""
+                !line.empty,
+                "line tested, line not empty surely:\n  \"" ~ line ~ "\""
               );
-            }
-            if (line.matchFirst(rgx.book_index_item)
-            || line.matchFirst(rgx.book_index_item_open)
-            || pith["section"] == eN.sect.book_index)  {                            /+ book_index +/
-              an_object = line.flow_book_index_(an_object, book_idx_tmp, pith, opt_action);
-            } else {                                                                       /+ not book_index +/
-              an_object_key = "body_nugget";
-              if (auto m = line.matchFirst(rgx.comment)) {                                 /+ matched comment +/
-                debug(comment) {
+              assert(
+                (pith["block_state"] == eN.blk_state.off)
+                || (pith["block_state"] == eN.blk_state.closing),
+                "code block status: none or closed"
+              );
+              if (pith["block_state"] == eN.blk_state.closing) {
+                debug(check) {
+                  writeln(__LINE__);
                   writeln(line);
                 }
-                an_object[an_object_key]                ~= line ~= "\n";
-                comp_obj_comment                        = comp_obj_comment.init;
-                comp_obj_comment.metainfo.is_of_part    = "comment"; // breaks flow
-                comp_obj_comment.metainfo.is_of_section = "comment"; // breaks flow
-                comp_obj_comment.metainfo.is_of_type    = "comment";
-                comp_obj_comment.metainfo.is_a          = "comment";
-                comp_obj_comment.text                   = an_object[an_object_key].strip;
-                the_document_body_section               ~= comp_obj_comment;
-                flow_common_reset_(line_occur, an_object, pith);
-                processing.remove("verse");
-                ++cntr;
-              } else if ((line_occur["para"] == eN.bi.off
-                && line_occur["heading"] == eN.bi.off)
-                && pith["txt_is"] == eN.txt_is.off
-              ) {                             /+ heading or para but neither flag nor line exists +/
-                if ((conf_make_meta.make.headings.length > 2)
-                && (pith["make_headings"] == eN.bi.off)) {                      /+ heading found +/
-                  heading_match_str = line.flow_heading_found_(heading_match_str, conf_make_meta.make.headings, heading_match_rgx, pith);
+                assert(
+                  line.matchFirst(rgx.book_index_item)
+                  || line.matchFirst(rgx.book_index_item_open)
+                  || pith["section"] == eN.sect.book_index,
+                  "\nblocks closed, unless followed by book index, non-matching line:\n  \""
+                  ~ line ~ "\""
+                );
+              }
+              if (line.matchFirst(rgx.book_index_item)
+              || line.matchFirst(rgx.book_index_item_open)
+              || pith["section"] == eN.sect.book_index)  {                            /+ book_index +/
+                {
+                  auto _get = line.flow_book_index_(an_object, book_idx_tmp, pith, opt_action);
+                  {
+                    an_object = _get.this_object;
+                    pith      = _get.pith;
+                    book_idx_tmp      = _get.book_idx_tmp;
+                  }
                 }
-                if (pith["make_headings"] == eN.bi.on
-                  && (line_occur["para"] == eN.bi.off
+              } else {                                                                /+ not book_index +/
+                an_object_key = "body_nugget";
+                if (auto m = line.matchFirst(rgx.comment)) {                                 /+ matched comment +/
+                  debug(comment) {
+                    writeln(line);
+                  }
+                  an_object[an_object_key]                ~= line ~= "\n";
+                  comp_obj_comment                        = comp_obj_comment.init;
+                  comp_obj_comment.metainfo.is_of_part    = "comment"; // breaks flow
+                  comp_obj_comment.metainfo.is_of_section = "comment"; // breaks flow
+                  comp_obj_comment.metainfo.is_of_type    = "comment";
+                  comp_obj_comment.metainfo.is_a          = "comment";
+                  comp_obj_comment.text                   = an_object[an_object_key].strip;
+                  the_document_body_section               ~= comp_obj_comment;
+                  {
+                    auto _get = txt_by_line_common_reset_(line_occur, an_object, pith);
+                    {
+                      line_occur = _get.line_occur;
+                      an_object  = _get.this_object;
+                      pith       = _get.pith;
+                    }
+                  }
+                  processing.remove("verse");
+                  ++cntr;
+                } else if ((line_occur["para"] == eN.bi.off
                   && line_occur["heading"] == eN.bi.off)
                   && pith["txt_is"] == eN.txt_is.off
-                ) {                           /+ heading make set +/
-                  line = line.flow_heading_make_set_(line_occur, heading_match_rgx, pith);
-                }
-                /+ TODO node info: all headings identified at this point,
-                   - extract node info here??
-                   - how long can it wait?
-                   - should be incorporated in composite objects
-                   - should happen before endnote links set (they need to be moved down?)
-                +/
-                if (line.matchFirst(rgx.headings)) {                                        /+ heading match +/
-                  line = line._doc_header_and_make_substitutions_(conf_make_meta);
-                  an_object = line.flow_heading_matched_(
-                    an_object,
-                    line_occur,
-                    an_object_key,
-                    lv,
-                    collapsed_lev,
-                    pith,
-                    conf_make_meta,
-                  );
-                } else if (line_occur["para"] == eN.bi.off) {                              /+ para match +/
-                  an_object_key = "body_nugget";
+                ) {                             /+ heading or para but neither flag nor line exists +/
+                  if ((conf_make_meta.make.headings.length > 2)
+                  && (pith["make_headings"] == eN.bi.off)) {                      /+ heading found +/
+                    {
+                      auto _get = line.flow_heading_found_(heading_match_str, conf_make_meta.make.headings, heading_match_rgx, pith);
+                      {
+                        heading_match_str = _get.heading_match_str;
+                        heading_match_rgx = _get.heading_match_rgx;
+                        pith              = _get.pith;
+                      }
+                    }
+                  }
+                  if (pith["make_headings"] == eN.bi.on
+                    && (line_occur["para"] == eN.bi.off
+                    && line_occur["heading"] == eN.bi.off)
+                    && pith["txt_is"] == eN.txt_is.off
+                  ) {                           /+ heading make set +/
+                    {
+                      auto _get = line.flow_heading_make_set_(line_occur, heading_match_rgx, pith);
+                      {
+                        line      = _get.line;
+                        an_object = _get.this_object;
+                        pith      = _get.pith;
+                      }
+                    }
+                  }
+                  /+ TODO node info: all headings identified at this point,
+                     - extract node info here??
+                     - how long can it wait?
+                     - should be incorporated in composite objects
+                     - should happen before endnote links set (they need to be moved down?)
+                  +/
+                  if (line.matchFirst(rgx.headings)) {                                        /+ heading match +/
+                    line = line._doc_header_and_make_substitutions_(conf_make_meta);
+                    {
+                      auto _get = line.flow_heading_matched_(
+                        an_object,
+                        line_occur,
+                        an_object_key,
+                        lv,
+                        collapsed_lev,
+                        pith,
+                        conf_make_meta,
+                      );
+                      {
+                        an_object = _get.this_object;
+                        pith      = _get.pith;
+                      }
+                    }
+                  } else if (line_occur["para"] == eN.bi.off) {                              /+ para match +/
+                    an_object_key = "body_nugget";
+                    line = line
+                      ._doc_header_and_make_substitutions_(conf_make_meta)
+                      ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
+                    {
+                      auto _get = line.flow_para_match_(an_object, an_object_key, indent, bullet, pith, line_occur);
+                      {
+                        an_object     = _get.this_object;
+                        an_object_key = _get.this_object_key;
+                        pith          = _get.pith;
+                        indent        = _get.indent;
+                        bullet        = _get.bullet;
+                        line_occur    = _get.line_occur;
+                      }
+                    }
+                  }
+                } else if (line_occur["heading"] > eN.bi.off) {                              /+ heading +/
+                  debug(heading) {
+                    writeln(line);
+                  }
+                  an_object[an_object_key] ~= line ~= "\n";
+                  ++line_occur["heading"];
+                } else if (line_occur["para"] > eN.bi.off) {                                 /+ paragraph +/
+                  debug(para) {
+                    writeln(an_object_key, "-> ", line);
+                  }
                   line = line
                     ._doc_header_and_make_substitutions_(conf_make_meta)
                     ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
-                  an_object = line.flow_para_match_(an_object, an_object_key, indent, bullet, pith, line_occur);
+                  an_object[an_object_key] ~= " " ~ line;
+                  ++line_occur["para"];
                 }
-              } else if (line_occur["heading"] > eN.bi.off) {                              /+ heading +/
-                debug(heading) {
-                  writeln(line);
-                }
-                an_object[an_object_key] ~= line ~= "\n";
-                ++line_occur["heading"];
-              } else if (line_occur["para"] > eN.bi.off) {                                 /+ paragraph +/
-                debug(para) {
-                  writeln(an_object_key, "-> ", line);
+              }
+            } else if (pith["block_state"] == eN.blk_state.closing) {             /+ line empty, with blocks flag +/
+              {
+                auto _get = line.flow_block_flag_line_empty_(
+                  an_object,
+                  bookindex_extract_hash,
+                  the_document_body_section,
+                  bookindex_unordered_hashes,
+                  obj_cite_digits,
+                  comp_obj_heading,
+                  cntr,
+                  pith,
+                  object_number_poem,
+                  conf_make_meta,
+                  tag_in_seg,
+                );
+                {
+                  an_object                  = _get.this_object;
+                  the_document_body_section  = _get.the_document_body_section;
+                  bookindex_unordered_hashes = _get.bookindex_unordered_hashes;
+                  obj_cite_digits            = _get.obj_cite_digits;
+                  comp_obj_heading           = _get.comp_obj_heading;
+                  cntr                       = _get.cntr;
+                  pith                       = _get.pith;
                 }
-                line = line
-                  ._doc_header_and_make_substitutions_(conf_make_meta)
-                  ._doc_header_and_make_substitutions_fontface_(conf_make_meta);
-                an_object[an_object_key] ~= " " ~ line;
-                ++line_occur["para"];
               }
-            }
-          } else if (pith["block_state"] == eN.blk_state.closing) {             /+ line empty, with blocks flag +/
-            an_object = line.flow_block_flag_line_empty_(
-              an_object,
-              bookindex_extract_hash,
-              the_document_body_section,
-              bookindex_unordered_hashes,
-              obj_cite_digits,
-              comp_obj_heading,
-              cntr,
-              pith,
-              object_number_poem,
-              conf_make_meta,
-              tag_in_seg,
-            );
-          } else {                                                              /+ line.empty, post contents, empty variables: +/
-            assert(
-              line.empty,
-              "\nline should be empty:\n  \""
-              ~ line ~ "\""
-            );
-            assert(
-              (pith["block_state"] == eN.blk_state.off),
-              "code block status: none"
-            );
-            if (_new_doc) {
-              tag_assoc   = tag_assoc.init;
-              lv0to3_tags = lv0to3_tags.init;
-              tag_in_seg  = tag_in_seg.init;
-            }
-            if (pith["txt_is"] == eN.txt_is.heading
-              && line_occur["heading"] > eN.bi.off
-            ) {                                      /+ heading object (current line empty) +/
-              obj_cite_digits = (an_object["lev_markup_number"].to!int == 0)
-              ? ocn_emit(eN.ocn.reset)
-              : ocn_emit(pith["ocn"]);
-              an_object["is"] = "heading";
-              an_object_key = "body_nugget";
-              TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_object_and_anchor_tags_tuple
-                = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, ((_new_doc) ? Yes._new_doc : No._new_doc));
-              an_object["substantive"] = substantive_object_and_anchor_tags_tuple[sObj.content];
-              anchor_tag = substantive_object_and_anchor_tags_tuple[sObj.anchor_tag];
+            } else {                                                              /+ line.empty, post contents, empty variables: +/
+              assert(
+                line.empty,
+                "\nline should be empty:\n  \""
+                ~ line ~ "\""
+              );
+              assert(
+                (pith["block_state"] == eN.blk_state.off),
+                "code block status: none"
+              );
               if (_new_doc) {
-                cnt1 = 1;
-                cnt2 = 1;
-                cnt3 = 1;
-                _new_doc = false;
+                tag_assoc   = tag_assoc.init;
+                lv0to3_tags = lv0to3_tags.init;
+                tag_in_seg  = tag_in_seg.init;
               }
-              if (
-                an_object["lev_markup_number"].to!int == 4
-                && (!(anchor_tag.empty)
-                || (lv0to3_tags.length > 0))
-              ) {
-                tag_in_seg["seg_lv4"]    = anchor_tag;
-                tag_in_seg["seg_lv1to4"] = anchor_tag;
-                lev_anchor_tag = anchor_tag;
-                tag_assoc[anchor_tag]["seg_lv4"]    = tag_in_seg["seg_lv4"];
-                tag_assoc[anchor_tag]["seg_lv1to4"] = tag_in_seg["seg_lv1to4"];
-                if (lv0to3_tags.length > 0) { /+ names used for html markup segments 1 to 4 (rather than epub which has separate segments for A to D) +/
-                  foreach (lv0_to_lv3_html_tag; lv0to3_tags) {
-                    tag_assoc[lv0_to_lv3_html_tag]["seg_lv4"] = anchor_tag;
+              if (pith["txt_is"] == eN.txt_is.heading
+                && line_occur["heading"] > eN.bi.off
+              ) {                                      /+ heading object (current line empty) +/
+                obj_cite_digits = (an_object["lev_markup_number"].to!int == 0)
+                ? ocn_emit(eN.ocn.reset)
+                : ocn_emit(pith["ocn"]);
+                an_object["is"] = "heading";
+                an_object_key = "body_nugget";
+                TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_object_and_anchor_tags_tuple
+                  = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, ((_new_doc) ? Yes._new_doc : No._new_doc));
+                an_object["substantive"] = substantive_object_and_anchor_tags_tuple[sObj.content];
+                anchor_tag = substantive_object_and_anchor_tags_tuple[sObj.anchor_tag];
+                if (_new_doc) {
+                  cnt1 = 1;
+                  cnt2 = 1;
+                  cnt3 = 1;
+                  _new_doc = false;
+                }
+                if (
+                  an_object["lev_markup_number"].to!int == 4
+                  && (!(anchor_tag.empty)
+                  || (lv0to3_tags.length > 0))
+                ) {
+                  tag_in_seg["seg_lv4"]    = anchor_tag;
+                  tag_in_seg["seg_lv1to4"] = anchor_tag;
+                  lev_anchor_tag = anchor_tag;
+                  tag_assoc[anchor_tag]["seg_lv4"]    = tag_in_seg["seg_lv4"];
+                  tag_assoc[anchor_tag]["seg_lv1to4"] = tag_in_seg["seg_lv1to4"];
+                  if (lv0to3_tags.length > 0) { /+ names used for html markup segments 1 to 4 (rather than epub which has separate segments for A to D) +/
+                    foreach (lv0_to_lv3_html_tag; lv0to3_tags) {
+                      tag_assoc[lv0_to_lv3_html_tag]["seg_lv4"] = anchor_tag;
+                    }
+                  }
+                  anchor_tag_ = anchor_tag;
+                  lv0to3_tags = lv0to3_tags.init;
+                } else if (an_object["lev_markup_number"].to!int > 4) {
+                  tag_in_seg["seg_lv4"]    = anchor_tag_;
+                  tag_in_seg["seg_lv1to4"] = anchor_tag_;
+                  lev_anchor_tag           = anchor_tag;
+                  tag_assoc[anchor_tag]["seg_lv4"] = tag_in_seg["seg_lv4"];
+                  tag_assoc[anchor_tag]["seg_lv1to4"] = tag_in_seg["seg_lv1to4"];
+                } else if (an_object["lev_markup_number"].to!int < 4) {
+                  string segn;
+                  switch (an_object["lev_markup_number"].to!int) {                           /+ names used for epub markup segments A to D +/
+                  case 0:
+                    segn = "_the_title";
+                    goto default;
+                  case 1:
+                    segn = "_part_" ~ cnt1.to!string;
+                    ++cnt1;
+                    goto default;
+                  case 2:
+                    segn = "_part_" ~ cnt1.to!string ~ "_" ~ cnt2.to!string;
+                    ++cnt2;
+                    goto default;
+                  case 3:
+                    segn =  "_part_" ~ cnt1.to!string ~ "_" ~ cnt2.to!string ~ "_" ~ cnt3.to!string;
+                    ++cnt3;
+                    goto default;
+                  default:
+                    lv0to3_tags ~= obj_cite_digits.object_number.to!string;
+                    lv0to3_tags ~= segn;
+                    tag_in_seg["seg_lv4"]    = segn; // for html segname need following lv4 not yet known
+                    tag_in_seg["seg_lv1to4"] = segn;
+                    break;
                   }
                 }
-                anchor_tag_ = anchor_tag;
-                lv0to3_tags = lv0to3_tags.init;
-              } else if (an_object["lev_markup_number"].to!int > 4) {
-                tag_in_seg["seg_lv4"]    = anchor_tag_;
-                tag_in_seg["seg_lv1to4"] = anchor_tag_;
-                lev_anchor_tag           = anchor_tag;
-                tag_assoc[anchor_tag]["seg_lv4"] = tag_in_seg["seg_lv4"];
-                tag_assoc[anchor_tag]["seg_lv1to4"] = tag_in_seg["seg_lv1to4"];
-              } else if (an_object["lev_markup_number"].to!int < 4) {
-                string segn;
-                switch (an_object["lev_markup_number"].to!int) {                           /+ names used for epub markup segments A to D +/
-                case 0:
-                  segn = "_the_title";
-                  goto default;
-                case 1:
-                  segn = "_part_" ~ cnt1.to!string;
-                  ++cnt1;
-                  goto default;
-                case 2:
-                  segn = "_part_" ~ cnt1.to!string ~ "_" ~ cnt2.to!string;
-                  ++cnt2;
-                  goto default;
-                case 3:
-                  segn =  "_part_" ~ cnt1.to!string ~ "_" ~ cnt2.to!string ~ "_" ~ cnt3.to!string;
-                  ++cnt3;
-                  goto default;
-                default:
-                  lv0to3_tags ~= obj_cite_digits.object_number.to!string;
-                  lv0to3_tags ~= segn;
-                  tag_in_seg["seg_lv4"]    = segn; // for html segname need following lv4 not yet known
-                  tag_in_seg["seg_lv1to4"] = segn;
-                  break;
+                an_object["bookindex_nugget"]
+                  = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
+                bookindex_unordered_hashes
+                  = bookindex_extract_hash.bookindex_nugget_hash(an_object["bookindex_nugget"], obj_cite_digits, tag_in_seg);
+                /+ (incrementally build toc) table of contents here! +/
+                _anchor_tag                   = obj_cite_digits.identifier;
+                {
+                  auto _get = obj_im.flow_table_of_contents_gather_headings(
+                    an_object,
+                    conf_make_meta,
+                    tag_in_seg,
+                    _anchor_tag,
+                    lev4_subtoc,
+                    the_document_toc_section,
+                  );
+                  {
+                    the_document_toc_section = _get.the_document_toc_section;
+                    lev4_subtoc              = _get.lev4_subtoc;
+                  }
                 }
+                if (an_object["lev_markup_number"] == "4") {
+                  segnames["html"] ~= tag_in_seg["seg_lv4"];
+                  html_segnames_ptr = html_segnames_ptr_cntr;
+                  html_segnames_ptr_cntr++;
+                }
+                if (an_object["lev_markup_number"].to!int <= 4) {
+                  segnames["epub"] ~= tag_in_seg["seg_lv1to4"];
+                }
+                auto comp_obj_heading = node_construct.node_emitter_heading(
+                    an_object["substantive"],
+                    an_object["lev_markup_number"],
+                    an_object["lev_collapsed_number"],
+                    an_object["dummy_heading_status"],
+                    tag_in_seg,
+                    lev_anchor_tag,
+                    tag_assoc,
+                    obj_cite_digits,                              // OCNset
+                    cntr,                                         // int
+                    heading_ptr,                                  // int
+                    lv_ancestors_txt,                             // string[]
+                    an_object["is"],                              // string
+                    html_segnames_ptr,                            // int
+                    substantive_object_and_anchor_tags_tuple[sObj.notes_reg],
+                    substantive_object_and_anchor_tags_tuple[sObj.notes_star],
+                    substantive_object_and_anchor_tags_tuple[sObj.links],
+                  );
+                ++heading_ptr;
+                debug(segments) {
+                  writeln(an_object["lev_markup_number"]);
+                  writeln(tag_in_seg["seg_lv4"]);
+                  writeln(tag_in_seg["seg_lv1to4"]);
+                }
+                the_document_body_section ~= comp_obj_heading;
+                debug(objectrelated1) { // check
+                  writeln(line);
+                }
+                {
+                  auto _get = txt_by_line_common_reset_(line_occur, an_object, pith);
+                  {
+                    line_occur = _get.line_occur;
+                    an_object  = _get.this_object;
+                    pith       = _get.pith;
+                  }
+                }
+                an_object.remove("lev");
+                an_object.remove("lev_markup_number");
+                processing.remove("verse");
+                ++cntr;
+              } else if (pith["txt_is"] == eN.txt_is.para
+                && line_occur["para"] > eN.bi.off
+              ) { /+ paragraph object (current line empty) - repeated character paragraph separator +/
+                if ((an_object[an_object_key].to!string).matchFirst(rgx.repeated_character_line_separator)) {
+                  pith["ocn"] = eN.ocn.off;
+                }
+                obj_cite_digits = ocn_emit(pith["ocn"]);
+                an_object["bookindex_nugget"] = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
+                bookindex_unordered_hashes = bookindex_extract_hash.bookindex_nugget_hash(an_object["bookindex_nugget"], obj_cite_digits, tag_in_seg);
+                an_object["is"] = "para";
+                auto comp_obj_heading = node_construct.node_location_emitter(
+                    content_non_header,
+                    tag_in_seg,
+                    lev_anchor_tag,
+                    tag_assoc,
+                    obj_cite_digits,
+                    cntr,
+                    heading_ptr-1,
+                    an_object["is"],
+                  );
+                TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
+                  = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
+                an_object["substantive"] = substantive_obj_misc_tuple[sObj.content];
+                anchor_tag = substantive_obj_misc_tuple[sObj.anchor_tag];
+                comp_obj_para                                       = comp_obj_para.init;
+                comp_obj_para.metainfo.is_of_part                   = "body";
+                comp_obj_para.metainfo.is_of_section                = "body";
+                comp_obj_para.metainfo.is_of_type                   = "para";
+                comp_obj_para.metainfo.is_a                         = "para";
+                comp_obj_para.text                                  = an_object["substantive"].to!string.strip;
+                comp_obj_para.tags.html_segment_anchor_tag_is       = tag_in_seg["seg_lv4"];
+                comp_obj_para.tags.epub_segment_anchor_tag_is       = tag_in_seg["seg_lv1to4"];
+                comp_obj_para.metainfo.ocn                          = obj_cite_digits.object_number;
+                comp_obj_para.metainfo.identifier                   = obj_cite_digits.identifier;
+                comp_obj_para.metainfo.object_number_off            = (obj_cite_digits.off == 0)   ? true : false; // TODO
+                comp_obj_para.metainfo.o_n_book_index               = obj_cite_digits.bkidx;
+                comp_obj_para.metainfo.object_number_type           = obj_cite_digits.type;
+                comp_obj_para.attrib.indent_hang                    = indent["hang_position"];
+                comp_obj_para.attrib.indent_base                    = indent["base_position"];
+                comp_obj_para.attrib.bullet                         = bullet;
+                comp_obj_para.tags.anchor_tags                      = [anchor_tag]; anchor_tag="";
+                comp_obj_para.has.inline_notes_reg                  = substantive_obj_misc_tuple[sObj.notes_reg];
+                comp_obj_para.has.inline_notes_star                 = substantive_obj_misc_tuple[sObj.notes_star];
+                comp_obj_para.has.inline_links                      = substantive_obj_misc_tuple[sObj.links];
+                comp_obj_para.has.image_without_dimensions          = substantive_obj_misc_tuple[sObj.image_no_dimensions];
+                the_document_body_section                           ~= comp_obj_para;
+                tag_assoc                                           = an_object.inline_para_link_anchor(tag_in_seg, tag_assoc);
+                {
+                  auto _get = txt_by_line_common_reset_(line_occur, an_object, pith);
+                  {
+                    line_occur = _get.line_occur;
+                    an_object  = _get.this_object;
+                    pith       = _get.pith;
+                  }
+                }
+                indent = [
+                  "hang_position" : 0,
+                  "base_position" : 0,
+                ];
+                bullet = false;
+                processing.remove("verse");
+                ++cntr;
+              // } else { // could be useful to test line variable should be empty and never null
               }
-              an_object["bookindex_nugget"]
-                = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
-              bookindex_unordered_hashes
-                = bookindex_extract_hash.bookindex_nugget_hash(an_object["bookindex_nugget"], obj_cite_digits, tag_in_seg);
-              /+ (incrementally build toc) table of contents here! +/
-              _anchor_tag                   = obj_cite_digits.identifier;
-              the_document_toc_section      = obj_im.flow_table_of_contents_gather_headings(
-                an_object,
-                conf_make_meta,
-                tag_in_seg,
-                _anchor_tag,
-                lev4_subtoc,
-                the_document_toc_section,
-              );
-              if (an_object["lev_markup_number"] == "4") {
-                segnames["html"] ~= tag_in_seg["seg_lv4"];
-                html_segnames_ptr = html_segnames_ptr_cntr;
-                html_segnames_ptr_cntr++;
-              }
-              if (an_object["lev_markup_number"].to!int <= 4) {
-                segnames["epub"] ~= tag_in_seg["seg_lv1to4"];
+            }                                                                     // close else for line empty
+          }                                                                       // close else for not the above
+        }                                                                         // close after non code, other blocks or regular text
+        /+ unless (the_document_body_section.length == 0) ? +/
+        if (the_document_body_section.length > 0) {
+          if (((the_document_body_section[$-1].metainfo.is_a == "para")
+            || (the_document_body_section[$-1].metainfo.is_a == "heading")
+            || (the_document_body_section[$-1].metainfo.is_a == "quote")
+            || (the_document_body_section[$-1].metainfo.is_a == "group")
+            || (the_document_body_section[$-1].metainfo.is_a == "block")
+            || (the_document_body_section[$-1].metainfo.is_a == "verse"))
+          && (the_document_body_section.length > previous_length)) {
+            if ((the_document_body_section[$-1].metainfo.is_a == "heading")
+            && (the_document_body_section[$-1].metainfo.heading_lev_markup < 5)) {
+              pith["section"] = eN.sect.unset;
+            }
+            if (the_document_body_section[$-1].metainfo.is_a == "verse") {             /+ scan for endnotes for whole poem (each verse in poem) +/
+              foreach (i; previous_length .. the_document_body_section.length) {
+                if (the_document_body_section[i].metainfo.is_a == "verse") {
+                  if ((the_document_body_section[i].text).match(
+                    rgx.inline_notes_al_all_note
+                  )) {
+                    object_notes = note_section.gather_notes_for_endnote_section(
+                      the_document_body_section,
+                      tag_in_seg,
+                      (i).to!int,
+                    );
+                  }
+                }
               }
-              auto comp_obj_heading
-                = node_construct.node_emitter_heading(
-                  an_object["substantive"],
-                  an_object["lev_markup_number"],
-                  an_object["lev_collapsed_number"],
-                  an_object["dummy_heading_status"],
+            } else {                                                                   /+ scan object for endnotes +/
+              previous_length = the_document_body_section.length.to!int;
+              if ((the_document_body_section[$-1].text).match(
+                rgx.inline_notes_al_all_note
+              )) {
+                previous_count = (the_document_body_section.length -1).to!int;
+                object_notes = note_section.gather_notes_for_endnote_section(
+                  the_document_body_section,
                   tag_in_seg,
-                  lev_anchor_tag,
-                  tag_assoc,
-                  obj_cite_digits,                              // OCNset
-                  cntr,                                         // int
-                  heading_ptr,                                  // int
-                  lv_ancestors_txt,                             // string[]
-                  an_object["is"],                              // string
-                  html_segnames_ptr,                            // int
-                  substantive_object_and_anchor_tags_tuple[sObj.notes_reg],
-                  substantive_object_and_anchor_tags_tuple[sObj.notes_star],
-                  substantive_object_and_anchor_tags_tuple[sObj.links],
+                  (the_document_body_section.length-1).to!int,
                 );
-              ++heading_ptr;
-              debug(segments) {
-                writeln(an_object["lev_markup_number"]);
-                writeln(tag_in_seg["seg_lv4"]);
-                writeln(tag_in_seg["seg_lv1to4"]);
-              }
-              the_document_body_section ~= comp_obj_heading;
-              debug(objectrelated1) { // check
-                writeln(line);
-              }
-              flow_common_reset_(line_occur, an_object, pith);
-              an_object.remove("lev");
-              an_object.remove("lev_markup_number");
-              processing.remove("verse");
-              ++cntr;
-            } else if (pith["txt_is"] == eN.txt_is.para
-              && line_occur["para"] > eN.bi.off
-            ) {
-              /+ paragraph object (current line empty) +/
-              /+ repeated character paragraph separator +/
-              if ((an_object[an_object_key].to!string).matchFirst(rgx.repeated_character_line_separator)) {
-                pith["ocn"] = eN.ocn.off;
-              }
-              obj_cite_digits = ocn_emit(pith["ocn"]);
-              an_object["bookindex_nugget"]
-                = ("bookindex_nugget" in an_object) ? an_object["bookindex_nugget"] : "";
-              bookindex_unordered_hashes
-                = bookindex_extract_hash.bookindex_nugget_hash(an_object["bookindex_nugget"], obj_cite_digits, tag_in_seg);
-              an_object["is"] = "para";
-              auto comp_obj_heading
-                = node_construct.node_location_emitter(
-                  content_non_header,
-                  tag_in_seg,
-                  lev_anchor_tag,
-                  tag_assoc,
-                  obj_cite_digits,
-                  cntr,
-                  heading_ptr-1,
-                  an_object["is"],
-                );
-              TxtAndAnchorTagPlusHasFootnotesUrlsImages substantive_obj_misc_tuple
-                = obj_im.obj_inline_markup_and_anchor_tags_and_misc(an_object, an_object_key, conf_make_meta, No._new_doc);
-              an_object["substantive"] = substantive_obj_misc_tuple[sObj.content];
-              anchor_tag = substantive_obj_misc_tuple[sObj.anchor_tag];
-              comp_obj_para                                       = comp_obj_para.init;
-              comp_obj_para.metainfo.is_of_part                   = "body";
-              comp_obj_para.metainfo.is_of_section                = "body";
-              comp_obj_para.metainfo.is_of_type                   = "para";
-              comp_obj_para.metainfo.is_a                         = "para";
-              comp_obj_para.text                                  = an_object["substantive"].to!string.strip;
-              comp_obj_para.tags.html_segment_anchor_tag_is       = tag_in_seg["seg_lv4"];
-              comp_obj_para.tags.epub_segment_anchor_tag_is       = tag_in_seg["seg_lv1to4"];
-              comp_obj_para.metainfo.ocn                          = obj_cite_digits.object_number;
-              comp_obj_para.metainfo.identifier                   = obj_cite_digits.identifier;
-              comp_obj_para.metainfo.object_number_off            = (obj_cite_digits.off == 0)   ? true : false; // TODO
-              comp_obj_para.metainfo.o_n_book_index               = obj_cite_digits.bkidx;
-              comp_obj_para.metainfo.object_number_type           = obj_cite_digits.type;
-              comp_obj_para.attrib.indent_hang                    = indent["hang_position"];
-              comp_obj_para.attrib.indent_base                    = indent["base_position"];
-              comp_obj_para.attrib.bullet                         = bullet;
-              comp_obj_para.tags.anchor_tags                      = [anchor_tag]; anchor_tag="";
-              comp_obj_para.has.inline_notes_reg                  = substantive_obj_misc_tuple[sObj.notes_reg];
-              comp_obj_para.has.inline_notes_star                 = substantive_obj_misc_tuple[sObj.notes_star];
-              comp_obj_para.has.inline_links                      = substantive_obj_misc_tuple[sObj.links];
-              comp_obj_para.has.image_without_dimensions          = substantive_obj_misc_tuple[sObj.image_no_dimensions];
-              the_document_body_section                           ~= comp_obj_para;
-              tag_assoc                                           = an_object.inline_para_link_anchor(tag_in_seg, tag_assoc);
-              flow_common_reset_(line_occur, an_object, pith);
-              indent = [
-                "hang_position" : 0,
-                "base_position" : 0,
-              ];
-              bullet = false;
-              processing.remove("verse");
-              ++cntr;
-            } else {
-              // could be useful to test line variable should be empty and never null
-            }
-          }                                                                     // close else for line empty
-        }                                                                       // close else for not the above
-      }                                                                         // close after non code, other blocks or regular text
-      /+ unless (the_document_body_section.length == 0) ? +/
-      if (the_document_body_section.length > 0) {
-        if (((the_document_body_section[$-1].metainfo.is_a == "para")
-          || (the_document_body_section[$-1].metainfo.is_a == "heading")
-          || (the_document_body_section[$-1].metainfo.is_a == "quote")
-          || (the_document_body_section[$-1].metainfo.is_a == "group")
-          || (the_document_body_section[$-1].metainfo.is_a == "block")
-          || (the_document_body_section[$-1].metainfo.is_a == "verse"))
-        && (the_document_body_section.length > previous_length)) {
-          if ((the_document_body_section[$-1].metainfo.is_a == "heading")
-          && (the_document_body_section[$-1].metainfo.heading_lev_markup < 5)) {
-            pith["section"] = eN.sect.unset;
-          }
-          if (the_document_body_section[$-1].metainfo.is_a == "verse") {             /+ scan for endnotes for whole poem (each verse in poem) +/
-            foreach (i; previous_length .. the_document_body_section.length) {
-              if (the_document_body_section[i].metainfo.is_a == "verse") {
-                if ((the_document_body_section[i].text).match(
-                  rgx.inline_notes_al_all_note
-                )) {
-                  note_section.gather_notes_for_endnote_section(
-                    the_document_body_section,
-                    tag_in_seg,
-                    (i).to!int,
-                  );
-                }
               }
             }
-          } else {                                                                   /+ scan object for endnotes +/
             previous_length = the_document_body_section.length.to!int;
-            if ((the_document_body_section[$-1].text).match(
-              rgx.inline_notes_al_all_note
-            )) {
-              previous_count = (the_document_body_section.length -1).to!int;
-              note_section.gather_notes_for_endnote_section(
-                the_document_body_section,
-                tag_in_seg,
-                (the_document_body_section.length-1).to!int,
-              );
-            }
           }
-          previous_length = the_document_body_section.length.to!int;
         }
       }
-    }                                                                           /+ ← srcDocLoop closed: loop markup document/text line by line +/
-    /+ ↓ post loop markup document/text +/
+      ret.toc          = the_document_toc_section;
+      ret.body         = the_document_body_section;
+      ret.glossary     = the_document_glossary_section;
+      ret.blurb        = the_document_blurb_section;
+      ret.object_notes = object_notes;
+      ret.segnames     = segnames;
+      return ret;
+    }
+    { // loopMarkupSrcByLine
+      auto _doc_by_line = loopMarkupSrcByLine(markup_sourcefile_content, an_object, pith);
+      the_document_toc_section      = _doc_by_line.toc;
+      the_document_body_section     = _doc_by_line.body;
+      the_document_glossary_section = _doc_by_line.glossary;
+      the_document_blurb_section    = _doc_by_line.blurb;
+      segnames                      = _doc_by_line.segnames;
+      object_notes                  = _doc_by_line.object_notes; // endnotes, compare, not sure is used
+      destroy(_doc_by_line);
+    }
     { // EOF
       comp_obj_heading_                                              = comp_obj_heading_.init;
       comp_obj_heading_.metainfo.is_of_part                          = "backmatter";
@@ -1333,7 +1507,7 @@ template docAbstraction() {
       tag_assoc[comp_obj_heading_.tags.anchor_tag_html]["seg_lv4"]            = comp_obj_heading_.tags.in_segment_html;
       tag_assoc[comp_obj_heading_.tags.segment_anchor_tag_epub]["seg_lv1to4"] = comp_obj_heading_.tags.segment_anchor_tag_epub;
     }
-    auto en_tuple = note_section.endnote_objects(obj_cite_digits, opt_action);
+    auto en_tuple = note_section.endnote_objects(obj_cite_digits, opt_action); // endnotes, check
     auto the_document_endnotes_section = en_tuple[0];
     obj_cite_digits = en_tuple[1];
     debug(endnotes) {
@@ -1370,8 +1544,15 @@ template docAbstraction() {
     }
     auto biblio_unsorted_incomplete = biblio_arr_json.dup;
     auto biblio = Bibliography();
-    auto biblio_ordered
-      = biblio.flow_bibliography_(biblio_unsorted_incomplete, bib_arr_json);
+    JSONValue[] biblio_ordered;
+    {
+      auto _get = biblio.flow_bibliography_(biblio_unsorted_incomplete, bib_arr_json);
+      {
+        biblio_ordered             = _get.biblio_sorted;
+        bib_arr_json               = _get.bib_arr_json;
+        biblio_unsorted_incomplete = _get.biblio_unsorted_incomplete;
+      }
+    }
     if (biblio_ordered.length > 0) {
       {
         comp_obj_heading_                                 = comp_obj_heading_.init;
@@ -2513,181 +2694,94 @@ template docAbstraction() {
     dom_structure_collapsed_tags_status_buffer  = [ 0, 0, 0, 0, 0, 0, 0, 0,];
     lev_anchor_tag = "";
     anchor_tag = "";
-    @safe auto doc_has() {
-      struct DocHas_ {
-        uint inline_links() {
-          return dochas["inline_links"];
-        }
-        uint inline_notes_reg() {
-          return dochas["inline_notes"];
-        }
-        uint inline_notes_star() {
-          return dochas["inline_notes_star"];
-        }
-        uint codeblocks() {
-          return dochas["codeblock"];
-        }
-        uint tables() {
-          return dochas["table"];
-        }
-        uint blocks() {
-          return dochas["block"];
-        }
-        uint groups() {
-          return dochas["group"];
-        }
-        uint poems() {
-          return dochas["poem"];
-        }
-        uint quotes() {
-          return dochas["quote"];
-        }
-        ulong images() { // TODO not ideal rethink
-          return (image_list.to!string.strip("[","]").split(",").length);
-        }
-        auto imagelist() {
-          return image_list;
-        }
-        auto keys_seq() {
-          return docSectKeysSeq!()(document_section_keys_sequenced);
-        }
-        string[] segnames_lv4() {
-          return segnames_4;
-        }
-        string[] segnames_lv_0_to_4() {
-          return segnames_0_to_4;
-        }
-        string[string][string] tag_associations() {
-          return tag_assoc;
-        }
+    struct DocHas_ {
+      uint inline_links() {
+        return dochas["inline_links"];
+      }
+      uint inline_notes_reg() {
+        return dochas["inline_notes"];
+      }
+      uint inline_notes_star() {
+        return dochas["inline_notes_star"];
       }
+      uint codeblocks() {
+        return dochas["codeblock"];
+      }
+      uint tables() {
+        return dochas["table"];
+      }
+      uint blocks() {
+        return dochas["block"];
+      }
+      uint groups() {
+        return dochas["group"];
+      }
+      uint poems() {
+        return dochas["poem"];
+      }
+      uint quotes() {
+        return dochas["quote"];
+      }
+      ulong images() { // TODO not ideal rethink
+        return (image_list.to!string.strip("[","]").split(",").length);
+      }
+      auto imagelist() {
+        return image_list;
+      }
+      auto keys_seq() {
+        return docSectKeysSeq!()(document_section_keys_sequenced);
+      }
+      string[] segnames_lv4() {
+        return segnames_4;
+      }
+      string[] segnames_lv_0_to_4() {
+        return segnames_0_to_4;
+      }
+      string[string][string] tag_associations() {
+        return tag_assoc;
+      }
+    }
+    @safe auto doc_has() {
       return DocHas_();
     }
-    auto t = tuple(
-      document_the,
-      doc_has,
-    );
-    return t;
-                                                                                /+ post loop markup document/text ↑ +/
+    struct retStruct {
+      ObjGenericComposite[][string] document_the;
+      DocHas_                       doc_has;
+    }
+    retStruct ret;
+    {
+      ret.document_the = document_the;
+      ret.doc_has      = doc_has;
+    }
+    return ret;
   }                                                                             /+ ← closed: abstract doc source +/
-                                                                                /+ ↓ abstraction functions +/
-  @safe static string[string] object_reset()(string[string] an_object) {
-    an_object.remove("body_nugget");
-    an_object.remove("substantive");
-    an_object.remove("is");
-    an_object.remove("attrib");
-    an_object.remove("bookindex_nugget");
-    return an_object;
-  }
-  @system void flow_common_reset_()(
-    return ref int[string]     line_occur,
-    return ref string[string]  an_object,
-    return ref uint[string]    pith,
+  @system auto txt_by_line_common_reset_()(
+    int[string]     line_occur,
+    string[string]  an_object,
+    uint[string]    pith,
   ) {
     line_occur["heading"]                               = eN.bi.off;
     line_occur["para"]                                  = eN.bi.off;
     pith["txt_is"]                                      = eN.txt_is.off;
     an_object                                           = an_object.object_reset;
+    struct retStruct {
+      int[string]     line_occur;
+      string[string]  this_object;
+      uint[string]    pith;
+    }
+    retStruct ret;
+    {
+      ret.line_occur  = line_occur;
+      ret.this_object = an_object;
+      ret.pith        = pith;
+    }
+    return ret;
   }
-  @safe static uint[string] _check_ocn_status_()(
-    char[]       line,
-    uint[string] pith,
-  ) {
-    static auto rgx = RgxI();
-    if (!(line.empty)) {
-      if (pith["no_ocn_multiple_objects"] == eN.bi.off) {
-        /+ not multi-line object, check whether object_number is on or turned off +/
-        if (line.matchFirst(rgx.object_number_block_marks)) {                      /+ switch off object_number +/
-          if (line.matchFirst(rgx.object_number_off_block)) {
-            pith["no_ocn_multiple_objects"]             = eN.bi.on;
-            pith["ocn"]                                 = eN.ocn.off;
-            debug(ocnoff) {
-              writeln(line);
-            }
-          }
-          if (line.matchFirst(rgx.object_number_off_block_dummy_heading)) {
-            pith["no_ocn_multiple_objects"]             = eN.bi.on;
-            pith["dummy_heading_multiple_objects"]      = eN.bi.on;
-            pith["ocn"]                                 = eN.ocn.off;
-            debug(ocnoff) {
-              writeln(line);
-            }
-          }
-        } else if (pith["no_ocn_multiple_objects"] == eN.bi.off) {
-            pith["dummy_heading_status"]                = eN.bi.off;
-            if (pith["dummy_heading_multiple_objects"]) {
-              pith["dummy_heading_status"]              = eN.bi.on;
-            }
-            if (line.matchFirst(rgx.object_number_off)) {
-              pith["ocn"]                               = eN.ocn.off;
-            } else if (line.matchFirst(rgx.object_number_off_dummy_heading)) {
-              pith["ocn"]                               = eN.ocn.off;
-              pith["dummy_heading_status"]              = eN.bi.on;
-            } else {
-              pith["ocn"]                               = eN.ocn.on;
-              pith["dummy_heading_status"]              = eN.bi.off;
-            }
-          } else {
-            pith["ocn"] = pith["no_ocn_multiple_objects"];
-          }
-      } else if (pith["no_ocn_multiple_objects"] == eN.bi.on) {
-        if (line.matchFirst(rgx.object_number_off_block_close)) {
-          pith["no_ocn_multiple_objects"]               = eN.bi.off;
-          pith["ocn"]                                   = eN.ocn.on;
-          pith["dummy_heading_status"]                  = eN.bi.off;
-          debug(ocnoff) {
-            writeln(line);
-          }
-        }
-      }
-    }
-    return pith;
-  }
-  @safe char[] _doc_header_and_make_substitutions_(CMM)(
-    char[]  line,
-    CMM     conf_make_meta,
-  ) {
-    enum Substitute { match, markup, }
-    if (conf_make_meta.make.substitute) {
-      foreach(substitution_pair; conf_make_meta.make.substitute) {
-        line = line.replaceAll(
-          regex("\b" ~ substitution_pair[Substitute.match]),
-          substitution_pair[Substitute.markup]
-        );
-      }
-    }
-    return line;
-  }
-  @safe char[] _doc_header_and_make_substitutions_fontface_(CMM)(
-    char[]  line,
-    CMM     conf_make_meta,
-  ) {
-    enum Substitute { match, markup, }
-    if ( conf_make_meta.make.bold) {
-      line = line.replaceAll(
-        regex("\b" ~ conf_make_meta.make.bold[Substitute.match]),
-        conf_make_meta.make.bold[Substitute.markup]
-      );
-    }
-    if (conf_make_meta.make.emphasis) {
-      line = line.replaceAll(
-        regex("\b" ~ conf_make_meta.make.emphasis[Substitute.match]),
-        conf_make_meta.make.emphasis[Substitute.markup]
-      );
-    }
-    if (conf_make_meta.make.italics) {
-      line = line.replaceAll(
-        regex("\b" ~ conf_make_meta.make.italics[Substitute.match]),
-        conf_make_meta.make.italics[Substitute.markup]
-      );
-    }
-    return line;
-  }
-  @safe void flow_txt_block_start()(
-               char[]         line,
-    return ref uint[string]   pith,
-    return ref uint[string]   dochas,
-    return ref string[string] object_number_poem
+  @safe auto txt_by_line_block_start()(
+    char[]         line,
+    uint[string]   pith,
+    uint[string]   dochas,
+    string[string] object_number_poem
   ) {
     static auto rgx = RgxI();
     if (auto m = line.matchFirst(rgx.block_curly_code_open)) {
@@ -2868,11 +2962,23 @@ template docAbstraction() {
       pith["block_state"]             = eN.blk_state.on;
       pith["block_delim"]             = eN.blk_delim.tic;
     }
+    struct retStruct {
+      uint[string]    pith;
+      uint[string]    dochas;
+      string[string]  object_number_poem;
+    }
+    retStruct ret;
+    {
+      ret.pith               = pith;
+      ret.dochas             = dochas;
+      ret.object_number_poem = object_number_poem;
+    }
+    return ret;
   }
-  @safe string[string] flow_txt_block_quote()(
-               char[]          line,
-               string[string]  an_object,
-    return ref uint[string]    pith,
+  @safe auto txt_by_line_block_quote()(
+    char[]          line,
+    string[string]  an_object,
+    uint[string]    pith,
   ) {
     static auto rgx = RgxI();
     if (pith["block_is"] == eN.blk_is.quote){
@@ -2908,12 +3014,21 @@ template docAbstraction() {
         }
       }
     }
-    return an_object;
+    struct retStruct {
+      uint[string]    pith;
+      string[string]  this_object;
+    }
+    retStruct ret;
+    {
+      ret.pith        = pith;
+      ret.this_object = an_object;
+    }
+    return ret;
   }
-  @safe string[string] flow_txt_block_group()(
-               char[]          line,
-               string[string]  an_object,
-    return ref uint[string]    pith,
+  @safe auto txt_by_line_block_group()(
+    char[]          line,
+    string[string]  an_object,
+    uint[string]    pith,
   ) {
     static auto rgx = RgxI();
     if (pith["block_is"] == eN.blk_is.group) {
@@ -2949,12 +3064,21 @@ template docAbstraction() {
         }
       }
     }
-    return an_object;
+    struct retStruct {
+      uint[string]    pith;
+      string[string]  this_object;
+    }
+    retStruct ret;
+    {
+      ret.pith        = pith;
+      ret.this_object = an_object;
+    }
+    return ret;
   }
-  @safe string[string] flow_txt_block_block()(
-               char[]          line,
-               string[string]  an_object,
-    return ref uint[string]    pith,
+  @safe auto txt_by_line_block_block()(
+    char[]          line,
+    string[string]  an_object,
+    uint[string]    pith,
   ) {
     static auto rgx = RgxI();
     if (pith["block_is"] == eN.blk_is.block) {
@@ -2990,16 +3114,25 @@ template docAbstraction() {
         }
       }
     }
-    return an_object;
+    struct retStruct {
+      uint[string]    pith;
+      string[string]  this_object;
+    }
+    retStruct ret;
+    {
+      ret.pith        = pith;
+      ret.this_object = an_object;
+    }
+    return ret;
   }
-  @safe string[string]  flow_txt_block_poem(CMM)(
-               char[]          line,
-               string[string]  an_object,
-    return ref uint[string]    pith,
-    return ref int             cntr,
-               string[string]  object_number_poem,
-               CMM             conf_make_meta,
-               string[string]  tag_in_seg,
+  @safe auto txt_by_line_block_poem(CMM)(
+    char[]          line,
+    string[string]  an_object,
+    uint[string]    pith,
+    int             cntr,
+    string[string]  object_number_poem,
+    CMM             conf_make_meta,
+    string[string]  tag_in_seg,
   ) {
     static auto rgx = RgxI();
     if (pith["block_is"] == eN.blk_is.poem) {
@@ -3234,12 +3367,23 @@ template docAbstraction() {
         }
       }
     }
-    return an_object;
+    struct retStruct {
+      int             cntr;
+      uint[string]    pith;
+      string[string]  this_object;
+    }
+    retStruct ret;
+    {
+      ret.cntr        = cntr;
+      ret.pith        = pith;
+      ret.this_object = an_object;
+    }
+    return ret;
   }
-  @safe void flow_txt_block_code()(
-               char[]          line,
-    return ref string[string]  an_object,
-    return ref uint[string]    pith,
+  @safe auto txt_by_line_block_code()(
+    char[]          line,
+    string[string]  an_object,
+    uint[string]    pith,
   ) {
     static auto rgx = RgxI();
     if ( pith["block_is"] == eN.blk_is.code) {
@@ -3279,12 +3423,22 @@ template docAbstraction() {
         }
       }
     }
+    struct retStruct {
+      uint[string]    pith;
+      string[string]  this_object;
+    }
+    retStruct ret;
+    {
+      ret.pith        = pith;
+      ret.this_object = an_object;
+    }
+    return ret;
   }
-  @system string[string] flow_txt_block_table(CMM)(
-               char[]          line,
-               string[string]  an_object,
-    return ref uint[string]    pith,
-    return ref CMM             conf_make_meta,
+  @system auto txt_by_line_block_table(CMM)(
+    char[]          line,
+    string[string]  an_object,
+    uint[string]    pith,
+    CMM             conf_make_meta,
   ) {
     static auto rgx = RgxI();
     if (pith["block_is"] == eN.blk_is.table) {
@@ -3307,15 +3461,25 @@ template docAbstraction() {
           pith["block_is"]            = eN.blk_is.table;
           pith["block_state"]         = eN.blk_state.off;
           pith["block_delim"]         = eN.blk_delim.off;
-          line.flow_table_closed_make_special_notation_table_(
-            an_object,
-            the_document_body_section,
-            obj_cite_digits,
-            comp_obj_heading,
-            cntr,
-            pith,
-            conf_make_meta,
-          );
+          {
+            auto _get = line.flow_table_closed_make_special_notation_table_(
+              an_object,
+              the_document_body_section,
+              obj_cite_digits,
+              comp_obj_heading,
+              cntr,
+              pith,
+              conf_make_meta,
+            );
+            {
+              an_object                 = _get.this_object;
+              the_document_body_section = _get.the_document_body_section;
+              obj_cite_digits           = _get.obj_cite_digits;
+              comp_obj_heading          = _get._comp_obj_heading;
+              cntr                      = _get.cntr;
+              pith                      = _get.pith;
+            }
+          }
         } else {
           debug(table) {
             writeln(line);
@@ -3338,37 +3502,48 @@ template docAbstraction() {
         }
       }
     }
-    return an_object;
-  }
-  @safe final string biblio_tag_map()(string abr) {
-    auto btm = [
-      "au"        : "author_raw",
-      "ed"        : "editor_raw",
-      "ti"        : "fulltitle",
-      "lng"       : "language",
-      "jo"        : "journal",
-      "vol"       : "volume",
-      "edn"       : "edition",
-      "yr"        : "year",
-      "pl"        : "place",
-      "pb"        : "publisher",
-      "pub"       : "publisher",
-      "pg"        : "pages",
-      "pgs"       : "pages",
-      "sn"        : "short_name"
-    ];
-    return btm[abr];
+    struct retStruct {
+      CMM             conf_make_meta;
+      uint[string]    pith;
+      string[string]  this_object;
+    }
+    retStruct ret;
+    {
+      ret.conf_make_meta = conf_make_meta,
+      ret.pith           = pith;
+      ret.this_object    = an_object;
+    }
+    return ret;
   }
-  @system void flow_txt_block_biblio(
+  @system auto txt_by_line_block_biblio(
     char[]                  line,
-    return ref uint[string] pith,
-    return ref int          bib_entry,
-    return ref string       biblio_entry_str_json,
-    return ref string[]     biblio_arr_json,
+    uint[string] pith,
+    int          bib_entry,
+    string       biblio_entry_str_json,
+    string[]     biblio_arr_json,
   ) {
     mixin spineBiblio;
     auto jsn = BibJsnStr();
     static auto rgx = RgxI();
+    string biblio_tag_map()(string abr) {
+      auto btm = [
+        "au"        : "author_raw",
+        "ed"        : "editor_raw",
+        "ti"        : "fulltitle",
+        "lng"       : "language",
+        "jo"        : "journal",
+        "vol"       : "volume",
+        "edn"       : "edition",
+        "yr"        : "year",
+        "pl"        : "place",
+        "pb"        : "publisher",
+        "pub"       : "publisher",
+        "pg"        : "pages",
+        "pgs"       : "pages",
+        "sn"        : "short_name"
+      ];
+      return btm[abr];
+    }
     if (line.matchFirst(rgx.heading_biblio)) {
       pith["section"] = eN.sect.bibliography;
     }
@@ -3478,21 +3653,137 @@ template docAbstraction() {
       }
       header_tag_value        = "";
     }
+    struct retStruct {
+      uint[string]    pith;
+      int             bib_entry;
+      string          biblio_entry_str_json;
+      string[]        biblio_arr_json;
+    }
+    retStruct ret;
+    {
+      ret.pith                  = pith;
+      ret.bib_entry             = bib_entry;
+      ret.biblio_entry_str_json = biblio_entry_str_json;
+      ret.biblio_arr_json       = biblio_arr_json;
+    }
+    return ret;
   }
-  @system void flow_table_closed_make_special_notation_table_(N,CMM)(
-               char[]                line,
-    return ref string[string]        an_object,
-    return ref ObjGenericComposite[] the_document_body_section,
-    return ref N                     obj_cite_digits,
-    return ref ObjGenericComposite   _comp_obj_heading,
-    return ref int                   cntr,
-    return ref uint[string]          pith,
-    CMM                              conf_make_meta
+                                                                                /+ ↓ abstraction functions +/
+  @safe static string[string] object_reset()(string[string] an_object) {
+    an_object.remove("body_nugget");
+    an_object.remove("substantive");
+    an_object.remove("is");
+    an_object.remove("attrib");
+    an_object.remove("bookindex_nugget");
+    return an_object;
+  }
+  @safe static uint[string] _check_ocn_status_()(
+    char[]       line,
+    uint[string] pith,
+  ) {
+    static auto rgx = RgxI();
+    if (!(line.empty)) {
+      if (pith["no_ocn_multiple_objects"] == eN.bi.off) {
+        /+ not multi-line object, check whether object_number is on or turned off +/
+        if (line.matchFirst(rgx.object_number_block_marks)) {                      /+ switch off object_number +/
+          if (line.matchFirst(rgx.object_number_off_block)) {
+            pith["no_ocn_multiple_objects"]             = eN.bi.on;
+            pith["ocn"]                                 = eN.ocn.off;
+            debug(ocnoff) {
+              writeln(line);
+            }
+          }
+          if (line.matchFirst(rgx.object_number_off_block_dummy_heading)) {
+            pith["no_ocn_multiple_objects"]             = eN.bi.on;
+            pith["dummy_heading_multiple_objects"]      = eN.bi.on;
+            pith["ocn"]                                 = eN.ocn.off;
+            debug(ocnoff) {
+              writeln(line);
+            }
+          }
+        } else if (pith["no_ocn_multiple_objects"] == eN.bi.off) {
+            pith["dummy_heading_status"]                = eN.bi.off;
+            if (pith["dummy_heading_multiple_objects"]) {
+              pith["dummy_heading_status"]              = eN.bi.on;
+            }
+            if (line.matchFirst(rgx.object_number_off)) {
+              pith["ocn"]                               = eN.ocn.off;
+            } else if (line.matchFirst(rgx.object_number_off_dummy_heading)) {
+              pith["ocn"]                               = eN.ocn.off;
+              pith["dummy_heading_status"]              = eN.bi.on;
+            } else {
+              pith["ocn"]                               = eN.ocn.on;
+              pith["dummy_heading_status"]              = eN.bi.off;
+            }
+          } else {
+            pith["ocn"] = pith["no_ocn_multiple_objects"];
+          }
+      } else if (pith["no_ocn_multiple_objects"] == eN.bi.on) {
+        if (line.matchFirst(rgx.object_number_off_block_close)) {
+          pith["no_ocn_multiple_objects"]               = eN.bi.off;
+          pith["ocn"]                                   = eN.ocn.on;
+          pith["dummy_heading_status"]                  = eN.bi.off;
+          debug(ocnoff) {
+            writeln(line);
+          }
+        }
+      }
+    }
+    return pith;
+  }
+  @safe char[] _doc_header_and_make_substitutions_(CMM)(
+    char[]  line,
+    CMM     conf_make_meta,
+  ) {
+    enum Substitute { match, markup, }
+    if (conf_make_meta.make.substitute) {
+      foreach(substitution_pair; conf_make_meta.make.substitute) {
+        line = line.replaceAll(
+          regex("\b" ~ substitution_pair[Substitute.match]),
+          substitution_pair[Substitute.markup]
+        );
+      }
+    }
+    return line;
+  }
+  @safe char[] _doc_header_and_make_substitutions_fontface_(CMM)(
+    char[]  line,
+    CMM     conf_make_meta,
+  ) {
+    enum Substitute { match, markup, }
+    if ( conf_make_meta.make.bold) {
+      line = line.replaceAll(
+        regex("\b" ~ conf_make_meta.make.bold[Substitute.match]),
+        conf_make_meta.make.bold[Substitute.markup]
+      );
+    }
+    if (conf_make_meta.make.emphasis) {
+      line = line.replaceAll(
+        regex("\b" ~ conf_make_meta.make.emphasis[Substitute.match]),
+        conf_make_meta.make.emphasis[Substitute.markup]
+      );
+    }
+    if (conf_make_meta.make.italics) {
+      line = line.replaceAll(
+        regex("\b" ~ conf_make_meta.make.italics[Substitute.match]),
+        conf_make_meta.make.italics[Substitute.markup]
+      );
+    }
+    return line;
+  }
+  @system auto flow_table_closed_make_special_notation_table_(CMM)(
+    char[]                line,
+    string[string]        an_object,
+    ObjGenericComposite[] the_document_body_section,
+    OCNset                obj_cite_digits,
+    ObjGenericComposite   _comp_obj_heading,
+    int                   cntr,
+    uint[string]          pith,
+    CMM                   conf_make_meta
   ) {
     comp_obj_block = comp_obj_block.init;
     obj_cite_digits = ocn_emit(pith["ocn"]);
-    auto comp_obj_location
-      = node_construct.node_location_emitter(
+    auto comp_obj_location = node_construct.node_location_emitter(
         content_non_header,
         tag_in_seg,
         lev_anchor_tag,
@@ -3514,25 +3805,49 @@ template docAbstraction() {
     comp_obj_block.metainfo.o_n_book_index                      = obj_cite_digits.bkidx;
     comp_obj_block.metainfo.object_number_type                  = obj_cite_digits.type;
     comp_obj_block                                              = comp_obj_block.flow_table_instructions(an_object["table_head"]);
-    comp_obj_block                                              = comp_obj_block.flow_table_substantive_munge_special(an_object["substantive"]);
+    {
+      auto _get = comp_obj_block.flow_table_substantive_munge_special(an_object["substantive"]);
+      {
+        comp_obj_block           = _get.table_object;
+        an_object["substantive"] = _get.table_substantive;
+      }
+    }
     the_document_body_section                                   ~= comp_obj_block;
     object_reset(an_object);
     processing.remove("verse");
     ++cntr;
+    struct retStruct {
+      string[string]        this_object;
+      ObjGenericComposite[] the_document_body_section;
+      OCNset                obj_cite_digits;
+      ObjGenericComposite   _comp_obj_heading;
+      int                   cntr;
+      uint[string]          pith;
+    }
+    retStruct ret;
+    {
+      ret.this_object               = an_object;
+      ret.the_document_body_section = the_document_body_section;
+      ret.obj_cite_digits           = obj_cite_digits;
+      ret._comp_obj_heading         = _comp_obj_heading;
+      ret.cntr                      = cntr;
+      ret.pith                      = pith;
+    }
+    return ret;
   }
-  @system string[string] flow_block_flag_line_empty_(B,N,CMM,Ts)(
-               char[]                   line,
-               string[string]           an_object,
-               B                        bookindex_extract_hash,
-    return ref ObjGenericComposite[]    the_document_body_section,
-    return ref string[][string][string] bookindex_unordered_hashes,
-    return ref N                        obj_cite_digits,
-    return ref ObjGenericComposite      _comp_obj_heading,
-    return ref int                      cntr,
-    return ref uint[string]             pith,
-    string[string]                      object_number_poem,
-    CMM                                 conf_make_meta,
-    Ts                                  tag_in_seg,
+  @system auto flow_block_flag_line_empty_(B,CMM,Ts)(
+    char[]                   line,
+    string[string]           an_object,
+    B                        bookindex_extract_hash,
+    ObjGenericComposite[]    the_document_body_section,
+    string[][string][string] bookindex_unordered_hashes,
+    OCNset                   obj_cite_digits,
+    ObjGenericComposite      _comp_obj_heading,
+    int                      cntr,
+    uint[string]             pith,
+    string[string]           object_number_poem,
+    CMM                      conf_make_meta,
+    Ts                       tag_in_seg,
   ) {
     assert(
       line.empty,
@@ -3825,7 +4140,13 @@ template docAbstraction() {
         comp_obj_block.metainfo.o_n_book_index                  = obj_cite_digits.bkidx;
         comp_obj_block.metainfo.object_number_type              = obj_cite_digits.type;
         comp_obj_block                                          = comp_obj_block.flow_table_instructions(an_object["table_head"]);
-        comp_obj_block                                          = comp_obj_block.flow_table_substantive_munge(an_object["substantive"]);
+        {
+          auto _get = comp_obj_block.flow_table_substantive_munge(an_object["substantive"]);
+          {
+            comp_obj_block           = _get.table_object;
+            an_object["substantive"] = _get.table_substantive;
+          }
+        }
         the_document_body_section                               ~= comp_obj_block;
         pith["block_is"]                                        = eN.blk_is.table;
         pith["block_state"]                                     = eN.blk_state.off;
@@ -3835,14 +4156,33 @@ template docAbstraction() {
         ++cntr;
       }
     }
-    return an_object;
+    struct retStruct {
+      string[string]           this_object;
+      ObjGenericComposite[]    the_document_body_section;
+      string[][string][string] bookindex_unordered_hashes;
+      OCNset                   obj_cite_digits;
+      ObjGenericComposite      comp_obj_heading;
+      int                      cntr;
+      uint[string]             pith;
+    }
+    retStruct ret;
+    {
+      ret.this_object                = an_object;
+      ret.the_document_body_section  = the_document_body_section;
+      ret.bookindex_unordered_hashes = bookindex_unordered_hashes;
+      ret.obj_cite_digits            = obj_cite_digits;
+      ret.comp_obj_heading           = _comp_obj_heading; //
+      ret.cntr                       = cntr;
+      ret.pith                       = pith;
+    }
+    return ret;
   }
-  @system string[string] flow_book_index_(B)(
-               char[]          line,
-               string[string]  an_object,
-    return ref string          book_idx_tmp,
-    return ref uint[string]    pith,
-               B               opt_action,
+  @system auto flow_book_index_(B)(
+    char[]          line,
+    string[string]  an_object,
+    string          book_idx_tmp,
+    uint[string]    pith,
+    B               opt_action,
   ) {
     static auto rgx = RgxI();
     if (auto m = line.match(rgx.book_index_item)) {                                   /+ match book_index +/
@@ -3885,14 +4225,25 @@ template docAbstraction() {
         }
       }
     }
-    return an_object;
+    struct retStruct {
+      string[string]  this_object;
+      uint[string]    pith;
+      string          book_idx_tmp;
+    }
+    retStruct ret;
+    {
+      ret.this_object    = an_object;
+      ret.pith           = pith;
+      ret.book_idx_tmp   = book_idx_tmp;
+    }
+    return ret;
   }
-  @safe string[string] flow_heading_found_()(
-               char[]                line,
-               string[string]        heading_match_str,
-               string[]              _make_unmarked_headings,
-    return ref Regex!(char)[string]  heading_match_rgx,
-    return ref uint[string]          pith,
+  @safe auto flow_heading_found_()(
+    char[]                line,
+    string[string]        heading_match_str,
+    string[]              _make_unmarked_headings,
+    Regex!(char)[string]  heading_match_rgx,
+    uint[string]          pith,
   ) {
     static auto rgx = RgxI();
     if ((_make_unmarked_headings.length > 2)
@@ -3966,9 +4317,20 @@ template docAbstraction() {
       }
       pith["make_headings"] = eN.bi.on;
     }
-    return heading_match_str;
+    struct retStruct {
+      string[string]       heading_match_str;
+      Regex!(char)[string] heading_match_rgx;
+      uint[string]         pith;
+    }
+    retStruct ret;
+    {
+      ret.heading_match_str = heading_match_str;
+      ret.heading_match_rgx = heading_match_rgx;
+      ret.pith              = pith;
+    }
+    return ret;
   }
-  @safe char[] flow_heading_make_set_()(
+  @safe auto flow_heading_make_set_()(
                char[]                line,
                int[string]           line_occur,
     return ref Regex!(char)[string]  heading_match_rgx,
@@ -4022,17 +4384,28 @@ template docAbstraction() {
         }
       }
     }
-    return line;
+    struct retStruct {
+      char[]          line;
+      uint[string]    pith;
+      string[string]  this_object;
+    }
+    retStruct ret;
+    {
+      ret.line           = line;
+      ret.pith           = pith;
+      ret.this_object    = an_object;
+    }
+    return ret;
   }
-  @safe string[string] flow_heading_matched_(CMM)(
-               char[]          line,
-               string[string]  an_object,
-    return ref int[string]     line_occur,
-    return ref string          an_object_key,
-    return ref int[string]     lv,
-    return ref int[string]     collapsed_lev,
-    return ref uint[string]    pith,
-    return ref CMM             conf_make_meta,
+  @safe auto flow_heading_matched_(CMM)(
+    char[]          line,
+    string[string]  an_object,
+    int[string]     line_occur,
+    string          an_object_key,
+    int[string]     lv,
+    int[string]     collapsed_lev,
+    uint[string]    pith,
+    CMM             conf_make_meta,
   ) {
     static auto rgx = RgxI();
     static auto mkup = InlineMarkup();
@@ -4194,16 +4567,35 @@ template docAbstraction() {
         writeln(line.strip);
       }
     }
-    return an_object;
+    struct retStruct {
+      string[string]  this_object;
+      int[string]     line_occur;
+      string          an_object_key;
+      int[string]     lv;
+      int[string]     collapsed_lev;
+      uint[string]    pith;
+      CMM             conf_make_meta;
+    }
+    retStruct ret;
+    {
+      ret.this_object    = an_object;
+      ret.line_occur     = line_occur;
+      ret.an_object_key  = an_object_key;
+      ret.lv             = lv;
+      ret.collapsed_lev  = collapsed_lev;
+      ret.pith           = pith;
+      ret.conf_make_meta = conf_make_meta;
+    }
+    return ret;
   }
-  @safe string[string] flow_para_match_()(
-               char[]         line,
-               string[string]  an_object,
-    return ref string          an_object_key,
-    return ref int[string]     indent,
-    return ref bool            bullet,
-    return ref uint[string]    pith,
-    return ref int[string]     line_occur,
+  @safe auto flow_para_match_()(
+    char[]         line,
+    string[string]  an_object,
+    string          an_object_key,
+    int[string]     indent,
+    bool            bullet,
+    uint[string]    pith,
+    int[string]     line_occur,
   ) {
     static auto rgx = RgxI();
     if (line_occur["para"] == eN.bi.off) {
@@ -4247,7 +4639,24 @@ template docAbstraction() {
       }
       ++line_occur["para"];
     }
-    return an_object;
+    struct retStruct {
+      uint[string]    pith;
+      string[string]  this_object;
+      string          this_object_key;
+      int[string]     indent;
+      bool            bullet;
+      int[string]     line_occur;
+    }
+    retStruct ret;
+    {
+      ret.pith            = pith;
+      ret.this_object     = an_object;
+      ret.this_object_key = an_object_key;
+      ret.indent          = indent;
+      ret.bullet          = bullet;
+      ret.line_occur      = line_occur;
+    }
+    return ret;
   }
   @safe char[] font_faces_line()(
     char[]  textline,
@@ -4272,8 +4681,8 @@ template docAbstraction() {
     return textline;
   }
   @safe ObjGenericComposite flow_table_instructions(H)(
-    return ref ObjGenericComposite  table_object,
-               H                    table_head,
+    ObjGenericComposite  table_object,
+    H                    table_head,
   ) {
     static auto rgx = RgxI();
     table_object.metainfo.is_of_part        = "body";
@@ -4296,9 +4705,9 @@ template docAbstraction() {
     }
     return table_object;
   }
-  @safe ObjGenericComposite flow_table_array_munge(T)(
-    return ref ObjGenericComposite  table_object,
-    return ref T                    table_array,
+  @safe auto flow_table_array_munge()(
+    ObjGenericComposite  table_object,
+    string[][]           table_array,
   ) {
     static auto rgx = RgxI();
     static auto mng = InlineMarkup();
@@ -4333,26 +4742,24 @@ template docAbstraction() {
         }
         col_num_ = idx_c;
         _table_substantive ~= col ~ mng.tc_s;
-        if (idx_r == 0 && comp_obj_block.table.heading) {
+        if (idx_r == 0 && table_object.table.heading) {
         } else if (col.match(rgx.numeric_col) && idx_r == 1) { // conditions reversed to avoid: gdc compiled program run segfault
-          if ((comp_obj_block.table.column_aligns.length > idx_c)
-          && (comp_obj_block.table.column_aligns[idx_c].matchFirst(rgx.table_col_align_match))) {
-            comp_obj_block.table.column_aligns[idx_c]
-              = comp_obj_block.table.column_aligns[idx_c];
-          } else if (comp_obj_block.table.column_aligns.length > idx_c) {
-            comp_obj_block.table.column_aligns[idx_c] = "r";
+          if ((table_object.table.column_aligns.length > idx_c)
+          && (table_object.table.column_aligns[idx_c].matchFirst(rgx.table_col_align_match))) {
+            table_object.table.column_aligns[idx_c] = table_object.table.column_aligns[idx_c];
+          } else if (table_object.table.column_aligns.length > idx_c) {
+            table_object.table.column_aligns[idx_c] = "r";
           } else {
-            comp_obj_block.table.column_aligns ~= "r";
+            table_object.table.column_aligns ~= "r";
           }
         } else if (idx_r == 1) {
-          if ((comp_obj_block.table.column_aligns.length > idx_c)
-          && (comp_obj_block.table.column_aligns[idx_c].matchFirst(rgx.table_col_align_match))) {
-            comp_obj_block.table.column_aligns[idx_c]
-              = comp_obj_block.table.column_aligns[idx_c];
-          } else if (comp_obj_block.table.column_aligns.length > idx_c) {
-            comp_obj_block.table.column_aligns[idx_c] = "l";
+          if ((table_object.table.column_aligns.length > idx_c)
+          && (table_object.table.column_aligns[idx_c].matchFirst(rgx.table_col_align_match))) {
+            table_object.table.column_aligns[idx_c] = table_object.table.column_aligns[idx_c];
+          } else if (table_object.table.column_aligns.length > idx_c) {
+            table_object.table.column_aligns[idx_c] = "l";
           } else {
-            comp_obj_block.table.column_aligns ~= "l";
+            table_object.table.column_aligns ~= "l";
           }
         }
       }
@@ -4366,12 +4773,12 @@ template docAbstraction() {
       }
       _table_substantive = _table_substantive.replaceFirst(rgx.table_col_separator_nl, "\n");
     }
-    if (comp_obj_block.table.number_of_columns != col_num) {
-      if (comp_obj_block.table.number_of_columns == 0) {
-        comp_obj_block.table.number_of_columns = (col_num).to!int;
+    if (table_object.table.number_of_columns != col_num) {
+      if (table_object.table.number_of_columns == 0) {
+        table_object.table.number_of_columns = (col_num).to!int;
       } else {
         debug(table_dev) {
-          writeln(comp_obj_block.table.number_of_columns, " != ", col_num);
+          writeln(table_object.table.number_of_columns, " != ", col_num);
         }
       }
     }
@@ -4411,46 +4818,85 @@ template docAbstraction() {
       writeln(_table_substantive);
     }
     debug(table_res) {
-      writeln("aligns: ", comp_obj_block.table.column_aligns, "\n",
-        "no. of columns: ", comp_obj_block.table.number_of_columns, "\n",
-        "col widths: ", comp_obj_block.table.column_widths,
-          " sum: ", comp_obj_block.table.column_widths.sum, "\n",
+      writeln("aligns: ", table_object.table.column_aligns, "\n",
+        "no. of columns: ", table_object.table.number_of_columns, "\n",
+        "col widths: ", table_object.table.column_widths,
+          " sum: ", table_object.table.column_widths.sum, "\n",
         _table_substantive);
     }
-    comp_obj_block.text = _table_substantive;
-    return table_object;
+    table_object.text = _table_substantive;
+    struct retStruct {
+      ObjGenericComposite table_object;
+      string[][]          table_array;
+    }
+    retStruct ret;
+    {
+      ret.table_object      = table_object;
+      ret.table_array       = table_array;
+    }
+    return ret;
   }
-  @system ObjGenericComposite flow_table_substantive_munge(T)(
-    return ref ObjGenericComposite  table_object,
-    return ref T                    table_substantive,
+  @system auto flow_table_substantive_munge()(
+    ObjGenericComposite  table_object,
+    string               table_substantive,
   ) {
     static auto rgx = RgxI();
     static auto munge = ObjInlineMarkupMunge();
     string[] _table_rows = (table_substantive).split(rgx.table_row_delimiter);
     string[] _table_cols;
-    string[][] _table;
+    string[][] _table_array;
     foreach(col; _table_rows) {
       _table_cols = col.split(rgx.table_col_delimiter);
-      _table ~= _table_cols;
+      _table_array ~= _table_cols;
     }
-    table_object = table_object.flow_table_array_munge(_table);
-    return table_object;
+    {
+      auto _get = table_object.flow_table_array_munge(_table_array);
+      {
+        table_object = _get.table_object;
+        _table_array = _get.table_array; // what do you do with this? how is this passed down?
+      }
+    }
+    struct retStruct {
+      ObjGenericComposite  table_object;
+      string               table_substantive;
+    }
+    retStruct ret;
+    {
+      ret.table_object      = table_object;
+      ret.table_substantive = table_substantive; // has anything been changed here?
+    }
+    return ret;
   }
-  @system ObjGenericComposite flow_table_substantive_munge_special(T)(
-    return ref ObjGenericComposite  table_object,
-    return ref T                    table_substantive,
+  @system auto flow_table_substantive_munge_special()(
+    ObjGenericComposite  table_object,
+    string               table_substantive,
   ) {
     static auto rgx = RgxI();
     static auto munge = ObjInlineMarkupMunge();
     string[] _table_rows = (table_substantive).split(rgx.table_row_delimiter_special);
     string[] _table_cols;
-    string[][] _table;
+    string[][] _table_array;
     foreach(col; _table_rows) {
       _table_cols = col.split(rgx.table_col_delimiter_special);
-      _table ~= _table_cols;
+      _table_array ~= _table_cols;
     }
-    table_object = table_object.flow_table_array_munge(_table);
-    return table_object;
+    {
+      auto _get = table_object.flow_table_array_munge(_table_array);
+      {
+        table_object = _get.table_object;
+        _table_array = _get.table_array;
+      }
+    }
+    struct retStruct {
+      ObjGenericComposite  table_object;
+      string               table_substantive;
+    }
+    retStruct ret;
+    {
+      ret.table_object      = table_object;
+      ret.table_substantive = table_substantive;
+    }
+    return ret;
   }
                                                                                 /+ abstraction functions ↑ +/
                                                                                 /+ ↓ abstraction function emitters +/
@@ -4865,13 +5311,13 @@ template docAbstraction() {
      heading_toc_ = (m.post).replaceAll(rgx.inline_notes_curly_gen, "");
      return heading_toc_;
     };
-    @safe ObjGenericComposite[] flow_table_of_contents_gather_headings(CMM)(
-                 string[string]         obj_,
-                 CMM                    conf_make_meta,
-                 string[string]         tag_in_seg,
-                 string                 _anchor_tag,
-      return ref string[][string]       lev4_subtoc,
-                 ObjGenericComposite[]  the_document_toc_section,
+    @safe auto flow_table_of_contents_gather_headings(CMM)( //
+      string[string]         obj_,
+      CMM                    conf_make_meta,
+      string[string]         tag_in_seg,
+      string                 _anchor_tag,
+      string[][string]       lev4_subtoc,
+      ObjGenericComposite[]  the_document_toc_section,
     ) {
       ObjGenericComposite comp_obj_toc;
       mixin InternalMarkup;
@@ -4948,7 +5394,16 @@ template docAbstraction() {
       default:
         break;
       }
-      return the_document_toc_section;
+      struct retStruct {
+        ObjGenericComposite[] the_document_toc_section;
+        string[][string]      lev4_subtoc;
+      }
+      retStruct ret;
+      {
+        ret.the_document_toc_section = the_document_toc_section;
+        ret.lev4_subtoc              = lev4_subtoc;
+      }
+      return ret;
     }
     invariant() {
     }
@@ -5326,9 +5781,9 @@ template docAbstraction() {
     string[] object_numbers;
     string[][string][string] bi_hash_nugget;
     string[] bi_main_terms_split_arr;
-    @safe string[][string][string] bookindex_nugget_hash(N,S)(
+    @safe string[][string][string] bookindex_nugget_hash(S)(
       string bookindex_section,
-      N      obj_cite_digits,
+      OCNset obj_cite_digits,
       S      tag_in_seg,
     ) {
       debug(asserts) {
@@ -5453,9 +5908,9 @@ template docAbstraction() {
         ++mkn;
       }
     }
-    @system auto bookindex_build_abstraction_section(N,B)(
+    @system auto bookindex_build_abstraction_section(B)(
       string[][string][string] bookindex_unordered_hashes,
-      N                        obj_cite_digits,
+      OCNset                   obj_cite_digits,
       B                        opt_action,
     ) {
       debug(asserts) {
@@ -5708,8 +6163,8 @@ template docAbstraction() {
       }
       return endnotes_;
     }
-    @safe private auto endnote_objects(N,O)(
-      N              obj_cite_digits,
+    @safe private auto endnote_objects(O)(
+      OCNset         obj_cite_digits,
       O              opt_action,
     ) {
       mixin spineNode;
@@ -5821,9 +6276,9 @@ template docAbstraction() {
   }
                                                                                 /+ +/
   struct Bibliography {
-    @system public JSONValue[] flow_bibliography_()(
-      return ref string[]    biblio_unsorted_incomplete,
-      return ref JSONValue[] bib_arr_json
+    @system public auto flow_bibliography_()(
+      string[]    biblio_unsorted_incomplete,
+      JSONValue[] bib_arr_json
     ) {
       JSONValue[] biblio_unsorted
         = biblio_make_unsorted_array_of_json_objects(biblio_unsorted_incomplete, bib_arr_json); // TODO lookat returns
@@ -5844,7 +6299,18 @@ template docAbstraction() {
           cntr++;
         }
       }
-      return biblio_sorted__;
+      struct retStruct {
+        JSONValue[] biblio_sorted;
+        JSONValue[] bib_arr_json;
+        string[]    biblio_unsorted_incomplete;
+      }
+      retStruct ret;
+      {
+        ret.biblio_sorted  = biblio_sorted__;
+        ret.bib_arr_json  = bib_arr_json;
+        ret.biblio_unsorted_incomplete  = biblio_unsorted_incomplete;
+      }
+      return ret;
     }
     @system final private JSONValue[] biblio_make_unsorted_array_of_json_objects()(
       string[]      biblio_unordered,
@@ -5905,12 +6371,12 @@ template docAbstraction() {
     int obj_cite_digit;
     int[string] p_; // p_ parent_
     static auto rgx = RgxI();
-    @safe ObjGenericComposite node_location_emitter(La,Ta,N)(
+    @safe ObjGenericComposite node_location_emitter(La,Ta)(
       string         lev_markup_number,
       string[string] tag_in_seg,
       La             lev_anchor_tag,
       Ta             tag_assoc,
-      N              obj_cite_digits,
+      OCNset         obj_cite_digits,
       int            cntr_,
       int            ptr_,
       string         is_
@@ -5959,7 +6425,7 @@ template docAbstraction() {
     }
     invariant() {
     }
-    @safe ObjGenericComposite node_emitter_heading(Hd,TaL,TA,N,fNr,fNs,fL)(
+    @safe ObjGenericComposite node_emitter_heading(Hd,TaL,TA,fNr,fNs,fL)(
       string         _text,
       string         lev_markup_number,
       string         lev_collapsed_number,
@@ -5967,7 +6433,7 @@ template docAbstraction() {
       string[string] tag_in_seg,
       TaL            lev_anchor_tag,
       TA             tag_assoc,
-      N              obj_cite_digits,
+      OCNset         obj_cite_digits,
       int            cntr_,
       int            ptr_,
       string[]       lv_ancestors_txt,