org file reorganise

1 files changed, 96 insertions, 83 deletions

diff --git a/org/ao_output_debugs.org b/org/ao_output_debugs.org
index fe20f17..07a4dfe 100644
--- a/org/ao_output_debugs.org
+++ b/org/ao_output_debugs.org
@@ -13,8 +13,9 @@
 #+TAGS: assert(a) class(c) debug(d) mixin(m) sdp(s) tangle(T) template(t) WEB(W) noexport(n)
 
 [[./sdp.org][sdp]]  [[./][org/]]
-* 0. Code Skeleton / Outline / Structure (tangles)                   :tangle:
-** code structure:                                          :ao_output_debugs.d:
+* 1. output debugs                                             :debug:output:
+[[./sdp.org][sdp]]  [[./][org/]]
+** 0. code structure:                                     :ao_output_debugs:
 
 #+name: tangle_ao_output_debugs
 #+BEGIN_SRC d :tangle ../src/sdp/ao_output_debugs.d
@@ -27,19 +28,24 @@ template SiSUdebugs() {
     auto ref const S         contents,
     auto ref T               doc_matters,
   ) {
-    mixin SiSUrgxInit;
-    mixin InternalMarkup;
-    <<initialize>>
-    <<book_index_sorted_report>>
-    <<ao_output_debugs>>
-      <<ao_output_debugs_summary>>
+      mixin SiSUrgxInit;
+      mixin InternalMarkup;
+      <<initialize>>
+      <<ao_output_debugs>>
+      debug(checkdoc) {
+        if ((doc_matters.opt_action_bool["debug"])) {
+          <<ao_output_debugs_summary>>
+        }
+        <<ao_output_debugs_checkdoc>>
+      }
+      if ((doc_matters.opt_action_bool["verbose"])) {
+        <<ao_output_debugs_summary_doc>>
+      }
     }
   }
 }
 #+END_SRC
 
-* 1. output debugs                                             :debug:output:
-[[./sdp.org][sdp]]  [[./][org/]]
 
 ** imports
 
@@ -69,7 +75,7 @@ private import
   std.conv : to;
 #+END_SRC
 
-** initialize                                                        :report:
+** initialize                                                       :report:
 
 #+name: initialize
 #+BEGIN_SRC d
@@ -78,7 +84,7 @@ auto markup = InlineMarkup();
 string key;
 #+END_SRC
 
-** (parent)                                                          :parent:
+** (parent)                                                         :parent:
 
 #+name: ao_output_debugs
 #+BEGIN_SRC d
@@ -106,7 +112,7 @@ debug(parent) {
 }
 #+END_SRC
 
-** (dumpdoc)                                                        :objects:
+** (dumpdoc)                                                       :objects:
 
 #+name: ao_output_debugs
 #+BEGIN_SRC d
@@ -130,19 +136,21 @@ debug(dumpdoc) {
 }
 #+END_SRC
 
-** (segnames)                                                        :objects:
+** (segnames)                                                      :objects:
 
-#+name: ao_output_debugs
+#+name: ao_output_debugs_checkdoc
 #+BEGIN_SRC d
-void out_segnames(S,T)(
-  auto ref const S         contents,
-  auto ref T               doc_matters,
-) {
-  foreach (key; doc_matters.keys_seq_seg) {
-    if (contents[key].length > 1) {
-      foreach (obj; contents[key]) {
-        if (obj.heading_lev_markup == 4) {
-          writeln(obj.ptr_html_segnames, ". (", doc_matters.segnames[obj.ptr_html_segnames], ") -> ",  obj.text);
+debug(checkdoc) {
+  void out_segnames(S,T)(
+    auto ref const S         contents,
+    auto ref T               doc_matters,
+  ) {
+    foreach (key; doc_matters.keys_seq_seg) {
+      if (contents[key].length > 1) {
+        foreach (obj; contents[key]) {
+          if (obj.heading_lev_markup == 4) {
+            writeln(obj.ptr_html_segnames, ". (", doc_matters.segnames[obj.ptr_html_segnames], ") -> ",  obj.text);
+          }
         }
       }
     }
@@ -153,69 +161,75 @@ void out_segnames(S,T)(
 ** shared output section arrange
 *** out toc
 
-#+name: ao_output_debugs
+#+name: ao_output_debugs_checkdoc
 #+BEGIN_SRC d
-void out_toc(S)(
-  auto ref const S         contents,
-  string                   key,
-) {
-  if (contents[key].length > 1) {
-    string indent_spaces;
-    foreach (obj; contents[key]) {
-      indent_spaces=markup.indent_by_spaces_provided(obj.indent_hang);
-      writefln(
-        "%s%s",
-        indent_spaces,
-        obj.text
-      );
+debug(checkdoc) {
+  void out_toc(S)(
+    auto ref const S         contents,
+    string                   key,
+  ) {
+    if (contents[key].length > 1) {
+      string indent_spaces;
+      foreach (obj; contents[key]) {
+        indent_spaces=markup.indent_by_spaces_provided(obj.indent_hang);
+        writefln(
+          "%s%s",
+          indent_spaces,
+          obj.text
+        );
+      }
     }
   }
 }
 #+END_SRC
 
-*** out endnotes                                                   :endnotes:
+*** out endnotes                                                 :endnotes:
 
-#+name: ao_output_debugs
+#+name: ao_output_debugs_checkdoc
 #+BEGIN_SRC d
-void out_endnotes(S)(
-  auto ref const S         contents,
-  string                   key,
-) {
-  if (contents[key].length > 1) {
-    foreach (obj; contents[key]) {
-      writefln(
-        "[%s]\n%s",
-        obj.is_a,
-        obj.text
-      );
+debug(checkdoc) {
+  void out_endnotes(S)(
+    auto ref const S         contents,
+    string                   key,
+  ) {
+    if (contents[key].length > 1) {
+      foreach (obj; contents[key]) {
+        writefln(
+          "[%s]\n%s",
+          obj.is_a,
+          obj.text
+        );
+      }
     }
   }
 }
 #+END_SRC
 
-*** out bookindex                                                 :bookindex:
+*** out bookindex                                               :bookindex:
 
-#+name: ao_output_debugs
+#+name: ao_output_debugs_checkdoc
 #+BEGIN_SRC d
-void out_bookindex(S)(
-  auto ref const S         contents,
-  string                   key,
-) {
-  if (contents[key].length > 1) {
-    foreach (obj; contents[key]) {
-      writefln(
-        "[%s][%s]\n%s",
-        obj.obj_cite_number,
-        obj.is_a,
-        obj.text
-      );
+debug(checkdoc) {
+  void out_bookindex(S)(
+    auto ref const S         contents,
+    string                   key,
+  ) {
+    if (contents[key].length > 1) {
+      foreach (obj; contents[key]) {
+        writefln(
+          "[%s][%s]\n%s",
+          obj.obj_cite_number,
+          obj.is_a,
+          obj.text
+        );
+      }
     }
   }
 }
 #+END_SRC
 
 ** sections
-*** heading_section                                                 :heading:
+*** heading_section                                               :heading:
 
 #+name: ao_output_debugs
 #+BEGIN_SRC d
@@ -273,7 +287,7 @@ debug(segnames) {
 }
 #+END_SRC
 
-*** body_section                                                       :body:
+*** body_section                                                     :body:
 
 #+name: ao_output_debugs
 #+BEGIN_SRC d
@@ -346,7 +360,7 @@ debug(dom) {
 }
 #+END_SRC
 
-*** endnotes_section (seg & scroll)                                :endnotes:
+*** endnotes_section (seg & scroll)                              :endnotes:
 **** endnotes
 
 #+name: ao_output_debugs
@@ -367,7 +381,7 @@ debug(section_endnotes_seg) {
 }
 #+END_SRC
 
-*** glossary_section                                               :glossary:
+*** glossary_section                                             :glossary:
 
 #+name: ao_output_debugs
 #+BEGIN_SRC d
@@ -386,7 +400,7 @@ debug(section_glossary) {
 }
 #+END_SRC
 
-*** bibliography_section (seg & scroll)                       :bibliography:
+*** bibliography_section (seg & scroll)                      :bibliography:
 
 #+name: ao_output_debugs
 #+BEGIN_SRC d
@@ -405,7 +419,7 @@ debug(section_bibliography) {
 }
 #+END_SRC
 
-*** bookindex_section (seg & scroll)                              :bookindex:
+*** bookindex_section (seg & scroll)                            :bookindex:
 **** bookindex
 
 #+name: ao_output_debugs
@@ -436,7 +450,7 @@ debug(section_bookindex_scroll) {
 }
 #+END_SRC
 
-*** section_blurb                                                     :blurb:
+*** section_blurb                                                   :blurb:
 
 #+name: ao_output_debugs
 #+BEGIN_SRC d
@@ -455,8 +469,7 @@ debug(blurb_section) {
 }
 #+END_SRC
 
-* end
-** (objects)                                                        :objects:
+** (objects)                                                       :objects:
 
 #+name: ao_output_debugs
 #+BEGIN_SRC d
@@ -480,7 +493,7 @@ debug(objects) {
 }
 #+END_SRC
 
-** (headermakejson)                                             :json:header:
+** (headermakejson)                                            :json:header:
 
 #+name: ao_output_debugs
 #+BEGIN_SRC d
@@ -512,7 +525,7 @@ debug(headermakejson) {
 }
 #+END_SRC
 
-** (headermetadatajson)                                         :json:header:
+** (headermetadatajson)                                        :json:header:
 
 #+name: ao_output_debugs
 #+BEGIN_SRC d
@@ -668,7 +681,7 @@ debug(anchor) {
 }
 #+END_SRC
 
-** (headings)                                                      :headings:
+** (headings)                                                     :headings:
 
 #+name: ao_output_debugs
 #+BEGIN_SRC d
@@ -689,7 +702,7 @@ debug(heading) {                         // heading
 }
 #+END_SRC
 
-** (summary) [+1]                                                   :summary:
+** (summary) [+1]                                                  :summary:
 
 #+name: ao_output_debugs_summary
 #+BEGIN_SRC d
@@ -724,11 +737,11 @@ debug(summary) {
   ];
 #+END_SRC
 
-*** (checkdoc)                                                     :checkdoc:
+*** (checkdoc)                                                   :checkdoc:
 
-#+name: ao_output_debugs_summary
+#+name: ao_output_debugs_summary_doc
 #+BEGIN_SRC d
-debug(checkdoc) {
+if ((doc_matters.opt_action_bool["verbose"])) {
   foreach (k; doc_matters.keys_seq_seg) {
     foreach (obj; contents[k]) {
       if (obj.use != "empty") {
@@ -741,9 +754,9 @@ debug(checkdoc) {
 }
 #+END_SRC
 
-*** output summary
+*** [#A] output summary
 
-#+name: ao_output_debugs_summary
+#+name: ao_output_debugs_summary_doc
 #+BEGIN_SRC d
 writefln(
   "%s\n\"%s\", %s\n%s\n%s\n%s%10d\n%s%10d\n%s%10d\n%s%10d\n%s%10d\n%s%10d\n%s%10d\n%s%10d\n(%s: %s)",