r55458 - in /trunk/libcatalyst-modules-perl/debian: README.source changelog

[jawnsy-guest at users.alioth.debian.org]

Author: jawnsy-guest
Date: Sun Apr  4 18:08:21 2010
New Revision: 55458

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=55458
Log:
Added information about this bundle to README.source and wrapped
the existing quilt writeup accordingly

Modified:
    trunk/libcatalyst-modules-perl/debian/README.source
    trunk/libcatalyst-modules-perl/debian/changelog

Modified: trunk/libcatalyst-modules-perl/debian/README.source
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libcatalyst-modules-perl/debian/README.source?rev=55458&op=diff
==============================================================================
--- trunk/libcatalyst-modules-perl/debian/README.source (original)
+++ trunk/libcatalyst-modules-perl/debian/README.source Sun Apr  4 18:08:21 2010
@@ -1,16 +1,49 @@
+This package is a bundle of several upstream distributions, so it cannot
+be updated in the usual manner (using uscan, uupdate, svn-upgrade, etc.)
+
+Instead, you must check which versions have been updated using:
+  cd tarballs
+  ./check-upstream-versions
+ (you must be in the tarballs directory to read packages.cfg)
+
+When new versions are detected, download them into the appropriate tarball
+directories using an appropriate tool, such as wget. Directory numbers
+refer to the build sequence, so modules in 01 arebuilt first, then 02, and
+so forth). Remove the old version (using svn rm) and add the new version
+(using svn add). Adding new packages is similar, except there is obviously
+no removal of old versions.
+
+Lastly, you must update the control metadata files. If adding new modules,
+you must corresponding data to packages.cfg or the tarball will not be
+recognized. The format of the file should be self-explanatory and should
+be updated when copyright information changes, when the upstream package
+URL changes, or when the short description should be different.
+
+By running the command:
+  cd tarballs
+  ./check-upstream-versions control
+the debian/control and debian/copyright files will be updated as needed.
+
+This means any new packages will have their names and descriptions added
+to debian/control, and the filenames and/or copyright data in d/copyright
+will be updated accordingly.
+
+==========================================================================
+
 This package uses quilt to manage all modifications to the upstream
-source.  Changes are stored in the source package as diffs in
-debian/patches and applied during the build.
+source. Changes are stored as diffs in debian/patches inside the source
+package and applied during the build.
 
-In order to patch a module, the directory debian/patches/$(Module-Name) has to
-exist.  Then run
-    export QUILT_PATCHES=patches
-    make -f debian/rules patch
-and change to the module directory in build-area/$(xx)/$(Module-Name).  The
-symlink "patches" there should point to a directory in debian/patches.  You can
-now use quilt as usual.
+In order to patch a specific upstream distribution, the directory
+debian/patches/$(Module-Name) has to exist.
+Then run
+  export QUILT_PATCHES=patches
+  make -f debian/rules patch
+and change to the module directory in build-area/$(xx)/$(Module-Name).
+The symlink "patches" there should point to a directory in debian/patches.
+You can now use quilt as usual.
 
 Run
-    make -f debian/rules unpatch
+  make -f debian/rules unpatch
 to remove all applied patches.
 

Modified: trunk/libcatalyst-modules-perl/debian/changelog
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libcatalyst-modules-perl/debian/changelog?rev=55458&op=diff
==============================================================================
--- trunk/libcatalyst-modules-perl/debian/changelog (original)
+++ trunk/libcatalyst-modules-perl/debian/changelog Sun Apr  4 18:08:21 2010
@@ -8,6 +8,8 @@
   * Catalyst::Devel was moved into its own package
   * Update debian/* years of copyright
   * Moved debian/copyright information to new DEP5 format
+  * Added information about this bundle to README.source and wrapped
+    the existing quilt writeup accordingly
 
   [ gregor herrmann ]
   * Updated: