changelog explains rational behind sisu-0.60 removal of generated document output from the main sisu

* changelog explains rational behind sisu-0.60 removal of generated document output from the main (sisu) source tarball

* configuration files changed to output generated content to sisu-doc tarball directory tree

3 files changed, 27 insertions, 3 deletions

diff --git a/CHANGELOG b/CHANGELOG
index bdc62e32..6c88d112 100644
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -3,6 +3,30 @@ Reverse Chronological:
 
 %% STABLE MANIFEST
 
+%% sisu_0.60.0.orig.tar.gz (2007-09-26:39/3)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.60.0.orig.tar.gz
+  sisu_0.60.0.orig.tar.gz
+  sisu_0.60.0-1.dsc
+  sisu_0.60.0-1.diff.gz
+
+  * generated documentation moved out of source tarball entirely, in sisu-0.59
+    series sisu documentation as generated by sisu was introduced, (the debian
+    package made a separate sub-package of this), however: this made the
+    tarball much larger than it was previously (in the order of 5 times the
+    size, over 10Mb instead of under 2), and; this has very unattractive
+    implications for source control management / git, as much of the output is
+    in binary file format which as they include information on when they were
+    built and which version of sisu they were built with, have different hash
+    values from one generation to the next, which means large diffs and
+    repeated storing of binary files which may contain essentially the same
+    data, and rapid growth in size of the git repository. Solution sisu-0.60:
+    * keep the sisu source tarball to as little binary content as is necessary
+      by separating out the documents produced (this keeps diffs to essentials,
+      and both the tarball and repository smaller in size)
+    * keep a separate tarball for documentation as generated sisu-doc; offer
+      that as a package on its own, (request that debian consider it for
+      inclusion as such).
+
 %% sisu_0.59.1.orig.tar.gz (2007-09-25:39/2)
 http://www.jus.uio.no/sisu/pkg/src/sisu_0.59.1.orig.tar.gz
   cf512ec871aeb7cdabc0b3b35b7e6d05 10952059 sisu_0.59.1.orig.tar.gz
diff --git a/conf/sisu/sisurc.yml b/conf/sisu/sisurc.yml
index 8dc1f51a..c5409774 100644
--- a/conf/sisu/sisurc.yml
+++ b/conf/sisu/sisurc.yml
@@ -60,7 +60,6 @@ flag:
   iii:          '-NhwpoabxXyYv'            # includes verbose; -m run by default
   iv:           '-NhwpoabxXYDyv --import'  # includes verbose; -m run by default
   v:            '-NhwpoabxXYDyv --update'  # includes verbose; -m run by default
-
 #% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal
 default:
   papersize:    'A4'
@@ -82,7 +81,6 @@ default:
 #    user:       '[username]'
 #    port:       '[port (default is 5432]'
 #  sqlite:
-#    user:       '[username]'
 #    path:       ~ # './sisu_sqlite.db'
 #    port:       "**"
 #% possible values ~, true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'.
diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile b/data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile
index 2ca8ea19..269c2751 100644
--- a/data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile
+++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile
@@ -158,7 +158,9 @@ def filelist_manpage
   files
 end
 def man_section(files_array,man_no='1')
-  path_man_sisu_output='../../../manuals_generated/sisu_manual/man'
+  path_man_sisu_output='/home/ralph/grotto/theatre/dbld/builds/sisu/sisu-doc/doc/manuals_generated/sisu_manual/man'
+  #path_man_sisu_output='~sisudocout/sisu_manual/man'
+  ##path_man_sisu_output='../../../manuals_generated/sisu_manual/man'
   path_man_sisu_package='../../../../../man'
   files_array.each do |x|
     y=x.gsub(/(\S+?)\.1$/,"\\1.#{man_no}")