r66889 - /trunk/libhtml-template-pluggable-perl/debian/README.source

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

Author: periapt-guest
Date: Mon Jan  3 23:27:40 2011
New Revision: 66889

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=66889
Log:
adding README.source

Added:
    trunk/libhtml-template-pluggable-perl/debian/README.source

Added: trunk/libhtml-template-pluggable-perl/debian/README.source
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libhtml-template-pluggable-perl/debian/README.source?rev=66889&op=file
==============================================================================
--- trunk/libhtml-template-pluggable-perl/debian/README.source (added)
+++ trunk/libhtml-template-pluggable-perl/debian/README.source Mon Jan  3 23:27:40 2011
@@ -1,0 +1,25 @@
+For most purposes this package is a standard Debian Perl Group package.
+The aspect in which it is special is that some related modules are bundled
+together with the package. So long as you have the appropriate tar balls
+in the correct place you can build using dpkg-buildpackage or
+svn-buildpackage as you would normally.
+
+If you have a fresh checkout from the svn repository and you wish 
+to download all the tarballs to build under svn-buildpackage, then from the
+package root directory run:
+
+    ./debian/update.sh update
+
+To check for new updates drop the "update" argument. If you are building
+under dpkg-buildpackage you need to tell the script about the 
+alternative build directory so run
+
+    DESTDIR=.. ./debian/update.sh update
+
+There are a couple of important caveats about the update.sh script.
+First of all when used in update mode it will DELETE the existing tarballs.
+Secondly when you do update one of the components, the update.sh script 
+will need to be updated. These limitations arise because it is 
+a temporary work around until pkg-components (or even uscan) provides
+something more substantial.
+