1 files changed, 78 insertions, 0 deletions
diff --git a/debian/README.building b/debian/README.building
new file mode 100644
index 0000000..c0cad80
--- /dev/null
+++ b/debian/README.building
@@ -0,0 +1,78 @@
+Building the gutenprint Debian packages	                 -*- mode: text -*-
+=======================================
+
+
+Prerequisites
+-------------
+
+The packages that must be installed to build the gutenprint packages
+are listed in the Build-Depends field of the control file
+debian/control[.in].  However, these are the prerequisites to build
+the Debianised source.  Other packages may be needed if building
+directly from CVS; it is less likely other tools will be needed if
+building from a distributed tarball.  Other tools that might
+potentially be needed are the latest versions of gettext, texi2html,
+docbook-utils and imagemagick.  build-essential and devscripts should
+also be installed in order to build Debian packages.
+
+# apt-get build-dep gutenprint
+
+should do this automatically, if the gutenprint sources are available
+in your APT sources.list.
+
+
+Getting the source
+------------------
+
+Since 5.0.0 (and its prereleases), building from upstream CVS or
+the release tarball is no longer supported (and in fact, not even
+possible).  The Debian packaging is only provided in the Debian
+diff.
+
+To get the source, run
+
+$ apt-get source gutenprint
+
+or download it from your nearest Debian mirror.
+
+
+Making changes
+--------------
+
+If needed, modify debian/changelog to change the version
+numbering. The version number should be the same as the package
+version number, followed by a hyphen and a Debian package revision
+number e.g. 4.2.0-1 for release 4.2.0, Debian revision 1.  Run
+
+$ debian/rules debian/control
+
+after changing the version number, to ensure the control file is
+up-to-date.
+
+
+If any source changes are required, please use dpatch, and place
+the patch under debian/patches.  Once you have created a diff,
+create a dpatch as follows:
+
+dpatch patch-template -p '0n_patch_name' "Patch description" \
+< mypatch.diff > debian/patches/0n_patch_name.dpatch
+
+and add "0n_patch_name.dpatch" to debian/patches/00list
+
+
+Building
+--------
+
+To build the packages:
+
+$ dpkg-buildpackage -rfakeroot -us -uc
+or
+$ debuild -us -uc -L -i
+
+It should build without problems on Debian 3.1 (sarge) and unstable,
+but will no longer build on Debian 3.0 (woody) and earlier distributions.
+
+
+I hope you like it!
+
+Roger Leigh <rleigh@debian.org> -- Sun, 14 Aug 2005 13:11:35 +0100