From 8d5f29f47ab21a2b30f0e5457993a10793936f47 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Wed, 26 Sep 2007 22:52:05 +0100 Subject: sisu-0.60 intruduces separate sisu-doc package, rationale in CHANGELOG --- data/doc/sisu/CHANGELOG | 42 ++++++++++++++++++++++++++++++++++++++---- 1 file 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) -- cgit v1.2.3