From 15e330dc6c3ac4de3d4ae646d836aeedfe9b1232 Mon Sep 17 00:00:00 2001
From: Ralph Amissah <ralph@amissah.com>
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 ++++++++++++++++++++++
conf/sisu/sisurc.yml | 2 --
.../sisu/sisu_markup_samples/sisu_manual/Rantfile | 4 +++-
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}")
--
cgit v1.2.3