From 4cdfa555d7e07d032bff270a962415b96c3b8741 Mon Sep 17 00:00:00 2001
From: Ralph Amissah <ralph@amissah.com>
Date: Mon, 12 Mar 2012 18:43:27 -0400
Subject: v3dv: sysenv, param, options, output control hooks code modified

* for config file, document headers, & command line
* requiring downstream code changes (in commit that follows)
---
 data/doc/sisu/CHANGELOG_v3 | 47 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

(limited to 'data')

diff --git a/data/doc/sisu/CHANGELOG_v3 b/data/doc/sisu/CHANGELOG_v3
index 93213b05..2e7d3684 100644
--- a/data/doc/sisu/CHANGELOG_v3
+++ b/data/doc/sisu/CHANGELOG_v3
@@ -21,6 +21,53 @@ http://www.jus.uio.no/sisu/pkg/src/sisu_3.1.15.orig.tar.xz
   sisu_3.1.15-1.dsc
   sisu_3.1.15-1.debian.tar.gz
 
+* v3dv: sysenv, ProcessingSettings, start to use hooks to make it possible to
+  control (via: the command line; the document markup header, or; the
+  configuration file) the likes of: ocn, toc, segsubtoc, minitoc,
+  links-to-manifest, search-form, html-navigation, html-navigation-bar,
+  html-right-pane, html-top-band; these are switched on by default and may be
+  switched off in omit lists within configuration file, the document markup
+  header, or command line. The command line takes precedence & may switch on
+  or off overriding settings within the document markup header or the sisu
+  configuration file.
+  * --inc- on by default, but if switched off in doc header or configuration,
+    the command line --inc- has precedence; for each possible exclude
+    configuration the --inc- switch that overrides configuration settings
+  * --exc- == --no-; exclude/switch off feature (but --inc- include has
+    precedence)
+  * document header @build: :omit: [list output features to be omitted]
+  * configuration (sisurc.yml) omit:
+  exclude output feature, overrides configuration settings (omit --dev
+  development branch modifier once merged back to main)
+   --exc-ocn,                 html (seg, scroll), epub, xml, pdf
+     sisu --dev --exc-ocn --html --epub --xml-sax --xml-dom --xhtml -v filename.sst
+   --exc-toc,                 html (scroll), epub, pdf
+     sisu --dev --exc-toc --html --epub --pdf -v filename.sst
+   --exc-segsubtoc            html (seg), epub
+     sisu --dev --exc-segsubtoc --html --epub -v filename.sst
+   --exc-minitoc,             html (seg), concordance, manifest
+     sisu --dev --exc-minitoc --html --concordance -v filename.sst
+   --exc-manifest-minitoc,    manifest
+     sisu --dev --exc-manifest-minitoc --html -v filename.sst
+   --exc-links_to_manifest, --exc-manifest-links,
+                              html (seg, scroll)
+     sisu --dev --exc-manifest-links --html -v filename.sst
+   --exc-search-form,         html (seg, scroll), manifest
+     sisu --dev --exc-search-form --html -v filename.sst
+   --exc-html-minitoc,        html (seg), concordance
+     sisu --dev --exc-html-minitoc --html --concordance -v filename.sst
+   --exc-html-navigation,     html (seg, scroll)?
+     sisu --dev --exc-html-navigation --html -v filename.sst
+   --exc-html-navigation-bar, html (seg)
+     sisu --dev --exc-html-navigation-bar --html -v filename.sst
+   --exc-html-search-form,    html (seg, scroll)
+     sisu --dev --exc-html-search-form --html -v filename.sst
+   --exc-html-right-pane,     html (seg, scroll)
+     sisu --dev --exc-html-right-pane --html -v filename.sst
+   --exc-html-top-band,       html (seg, scroll), concordance
+                              (minitoc is forced on to provide seg navigation)
+     sisu --dev --exc-html-top-band --html --concordance -v filename.sst
+
 * texinfo, fix (break holding back 3.2 merge)
   [proposed next version starts 3.2, (merge dev branch after 3.1.15)]
 
-- 
cgit v1.2.3