sisu-0.60 intruduces separate sisu-doc package, rationale in CHANGELOG

1 files changed, 38 insertions, 4 deletions

diff --git a/data/doc/sisu/CHANGELOG b/data/doc/sisu/CHANGELOG
index e0b8156f..9dc35163 100644
--- a/data/doc/sisu/CHANGELOG
+++ b/data/doc/sisu/CHANGELOG
@@ -3,11 +3,45 @@ Reverse Chronological:
 
 %% STABLE MANIFEST
 
-%% sisu_0.59.1.orig.tar.gz (2007-09-24:39/1)
+%% 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).
+
+  * sysenv, sisurc.yml allow use of relative output paths, expand to absolute
+
+  * html segmented, bugfix: footnotes for headings levels :A,:B and :C
+    correctly placed in first segment when batch-processing files/output
+
+  * help, (hub), minor reorganisation and a change in info returned, most
+    significantly the response for typing 'sisu' without options
+
+  * sysenv, syslink issue, additional check
+
+%% 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
-  sisu_0.59.1.orig.tar.gz
-  sisu_0.59.1-1.dsc
-  sisu_0.59.1-1.diff.gz
+  cf512ec871aeb7cdabc0b3b35b7e6d05 10952059 sisu_0.59.1.orig.tar.gz
+  a260c1dbec59c78cd0e330b5cd790f6a 617 sisu_0.59.1-1.dsc
+  55837afd842d274afc2180fca519d260 141832 sisu_0.59.1-1.diff.gz
 
   * plaintext, more space between endnotes where chosen (default remains
     footnotes)