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 ++++++++++++++++++++++ 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