[pkg-java] r8688 - trunk/cglib2.1/debian

[Damien Raude-Morvan]

Author: drazzib-guest
Date: 2009-06-29 20:16:40 +0000 (Mon, 29 Jun 2009)
New Revision: 8688

Modified:
   trunk/cglib2.1/debian/README.source
   trunk/cglib2.1/debian/changelog
Log:
[cglib2.1] Describe patch system in README.source


Modified: trunk/cglib2.1/debian/README.source
===================================================================
--- trunk/cglib2.1/debian/README.source	2009-06-29 20:16:28 UTC (rev 8687)
+++ trunk/cglib2.1/debian/README.source	2009-06-29 20:16:40 UTC (rev 8688)
@@ -1,3 +1,41 @@
+This package uses CDBS (and therefore simple-patchsys.mk) in order to 
+apply patches to the upstream source. Patches are stored in 
+debian/patches and their filenames usually end in .patch or .diff .
+For further details, see the man page for cdbs-edit-patch.
+
+All commands described below should be run from the top directory of the 
+package source tree, unless otherwise stated.
+
+ * To generate the fully patched source, in a form ready for
+   editing, that would be built to create Debian packages, run: 
+
+     make -f debian/rules apply-patches
+
+   Note: It has been proposed that, in future, this should happen 
+   automatically when you run dpkg-source -x on a CDBS 
+   simple-patchsys.mk source package.  However, this proposal has 
+   apparently not yet been implemented, so for now you have to do 
+   it yourself like this.
+
+ * To modify the source and save those modifications so that
+   they will be applied when building the package, pick a
+   suitably informative patch file name, for example
+   01_add_README.source_file.patch, and then run:
+
+     cdbs-edit-patch 01_add_README.source_file.patch
+
+   This will place you in a new shell in a temporary copy of the 
+   source tree.  Make your desired modifications to it, and then 
+   exit the shell to create the patch file containing them (this 
+   file will appear in debian/patches).
+
+ * To remove source modifications that are currently being
+   applied when building the package, run:
+
+     make -f debian/rules reverse-patches
+
+ -- Damien Raude-Morvan <drazzib at drazzib.com>  Mon, 29 Jun 2009 22:13:35 +0200
+
 The upstream supplied source package contains binary jar files and
 pre-built documentation. Currently no clean source distribution
 exists. Therefore, the upstream sources were modified to comply with

Modified: trunk/cglib2.1/debian/changelog
===================================================================
--- trunk/cglib2.1/debian/changelog	2009-06-29 20:16:28 UTC (rev 8687)
+++ trunk/cglib2.1/debian/changelog	2009-06-29 20:16:40 UTC (rev 8688)
@@ -1,4 +1,4 @@
-cglib2.1 (2.1.3.dfsg.2-2) UNRELEASED; urgency=low
+cglib2.1 (2.1.3.dfsg.2-2) unstable; urgency=low
 
   * Use default-java-builddep:
     - Remove B-D on java-gcj-compat-dev (Closes: #526274)
@@ -13,8 +13,9 @@
   * Bump Standards-Version to 3.8.2:
     - Move to "java" section
     - Rename README.Debian-source to README.source
+    - Describe patch system usage in README.source
 
- -- Damien Raude-Morvan <drazzib at drazzib.com>  Wed, 17 Jun 2009 23:56:36 +0200
+ -- Damien Raude-Morvan <drazzib at drazzib.com>  Mon, 29 Jun 2009 22:13:35 +0200
 
 cglib2.1 (2.1.3.dfsg.2-1) unstable; urgency=low