From 15e330dc6c3ac4de3d4ae646d836aeedfe9b1232 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Wed, 26 Sep 2007 01:05:55 +0100 Subject: 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 --- CHANGELOG | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) (limited to 'CHANGELOG') 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 -- cgit v1.2.3