add debian/README.debian4 file for Debian 4.0 (etch) build problem workaround

git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@309 6180dd3e-e324-4e3e-922d-17de1ae2f315

6 files changed, 25 insertions, 5 deletions

diff --git a/ChangeLog b/ChangeLog
index cddf053d..38f26b63 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -2,7 +2,7 @@ Each utility has its own version number, date of last change and
 some description at the top of its ".c" file. All utilities in the main
 directory have their own "man" pages. There is also a sg3_utils man page.
 
-Changelog for sg3_utils-1.28 [20091001] [svn: r308]
+Changelog for sg3_utils-1.28 [20091002] [svn: r309]
   - sg_unmap: new utility for thin provisioning
     - add examples/sg_unmap_example.txt
   - sg_get_lba_status: new utility for thin provisioning
diff --git a/README b/README
index 1f19d892..6d6d785b 100644
--- a/README
+++ b/README
@@ -169,10 +169,13 @@ More generic build information can be found in the INSTALL file.
 In Linux there are package build files for "rpm" based and for "deb" based
 systems. The 'sg3_utils.spec' file in the main directory can be used like
 this: 'rpmbuild -ba sg3_utils.spec' in a rpmbuild tree SPECS directory.
+
 The 'build_debian.sh' script should build several "deb" packages and place
 them in the parent directory. In debian based systems doing
 a 'apt-get install build-essential' is one way to get most of build
-environment needed if it has not already been loaded. 
+environment needed if it has not already been loaded. There are now some
+problems with this script and the superseded Debian 4.0 ("etch"). See
+debian/README.debian4 for a workaround.
 
 Warning
 =======
@@ -361,4 +364,4 @@ See http://sg.danny.cz/sg/tools.html
 
 
 Doug Gilbert
-1st October 2009
+2nd October 2009
diff --git a/build_debian.sh b/build_debian.sh
index 7e815175..ac5a0bf0 100755
--- a/build_debian.sh
+++ b/build_debian.sh
@@ -1,5 +1,8 @@
 #!/bin/sh
 
+# If this script fails on a Debian 4.0 ("etch") system then read
+# the debian/README.debian4 file.
+
 echo "chmod +x debian/rules"
 chmod +x debian/rules
 
diff --git a/debian/README.debian4 b/debian/README.debian4
new file mode 100644
index 00000000..e7e5757b
--- /dev/null
+++ b/debian/README.debian4
@@ -0,0 +1,14 @@
+For whatever reason Debian build scripts (e.g. debhelper and dbclean)
+seem to have changed in such a way to be Debian 4.0 ("etch") unfriendly.
+
+So when the ./build_debian.sh script is called on a Debian 4.0 system,
+it fails saying the debhelper is too old. That can be fixed by editing
+the 'control' file, changing this line:
+    Build-Depends: debhelper (>> 7), libtool, libcam-dev [kfreebsd-i386 kfreebsd-amd64]
+to:
+    Build-Depends: debhelper, libtool, libcam-dev [kfreebsd-i386 kfreebsd-amd64]
+
+The script then dies in dbclean and the hack to get around that is to
+edit the 'compat' file. It contains "7" which needs to be changed to
+"4".
+
diff --git a/debian/changelog b/debian/changelog
index f2319122..e2349917 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,7 +2,7 @@ sg3-utils (1.28-0.1) unstable; urgency=low
 
   * New upstream version
 
- -- Doug Gilbert <dgilbert@interlog.com>  Thu, 01 Oct 2009 17:10:00 -0400
+ -- Doug Gilbert <dgilbert@interlog.com>  Fri, 02 Oct 2009 00:20:00 -0400
 
 sg3-utils (1.27-0.1) unstable; urgency=low
 
diff --git a/sg3_utils.spec b/sg3_utils.spec
index 70b46f2d..b68466e5 100644
--- a/sg3_utils.spec
+++ b/sg3_utils.spec
@@ -79,7 +79,7 @@ fi
 %{_libdir}/*.la
 
 %changelog
-* Thu Oct 01 2009 - dgilbert at interlog dot com
+* Fri Oct 02 2009 - dgilbert at interlog dot com
 - add sg_get_lba_status, sg_unmap, sg_read_block_limits
   * sg3_utils-1.28