r39673 - in /website: copyright.pod debhelper.pod

Fri Jul 10 21:53:54 UTC 2009

Author: jawnsy-guest
Date: Fri Jul 10 21:53:48 2009
New Revision: 39673

URL: http://svn.debian.org/wsvn/?sc=1&rev=39673
Log:
Added a section for authors. Added new debhelper.pod file :-)

Added:
    website/debhelper.pod
Modified:
    website/copyright.pod

Modified: website/copyright.pod
URL: http://svn.debian.org/wsvn/website/copyright.pod?rev=39673&op=diff
==============================================================================

--- website/copyright.pod (original)
+++ website/copyright.pod Fri Jul 10 21:53:48 2009
@@ -77,5 +77,19 @@
 License can be found in `/usr/share/common-licenses/GPL' and the Artistic
 License in `/usr/share/common-licenses/Artistic'.
 
+Any decisions that need to be made regarding the licensing, copyright and
+distribution of this file shall be determined by majority vote between the
+current members of the Debian Perl Team, with one vote for all members, and
+an additional vote granted to Debian Developers.
+
+=head2 CONTRIBUTORS
+
+The following people have contributed to the maintainership of this file:
+
+=over
+
+=item * Jonathan Yu <frequency at cpan.org>
+
+=back
+
 =cut
-

Added: website/debhelper.pod
URL: http://svn.debian.org/wsvn/website/debhelper.pod?rev=39673&op=file
==============================================================================
--- website/debhelper.pod (added)
+++ website/debhelper.pod Fri Jul 10 21:53:48 2009
@@ -1,0 +1,101 @@
+=head1 NAME
+
+debhelper - Version number cheatsheet
+
+=head1 INTRODUCTION
+
+This is a guide detailing some common packaging scenarios, and the version of
+debhelper required for them. Contributions are welcomed, especially for any
+packaging scenarios not already discussed here.
+
+=head1 Most Common Scenarios
+
+=head2 Forcing Special Tests
+
+Often, Perl packages will have special tests designated for maintainers only.
+It is often quite beneficial for us to run these tests during build-time, so
+we prefer to add the author tests (if packaged) to Build-Depends-Indep.
+
+Usually there is an environment variable, like B<TEST_AUTHOR>, that will run
+these tests, however. You could enable this flag (and thus the tests) using:
+
+  %:
+    TEST_AUTHOR=1 dh $@
+
+However, the problem is that older versions of lintian used to issue a warning
+when this style was used. Another issue is that TEST_AUTHOR is set for the
+entire length of the build process, rather than just the testing part, so it
+could conceivably have other undesirable side-effects.
+
+You may do this using debhelper overrides, using:
+
+  override_dh_auto_test:
+    TEST_AUTHOR=1 dh_auto_test
+
+This requires support for overrides, introduced in B<debhelper 7.0.50>
+
+=head2 dh --with quilt
+
+When using a quilt patching system with the shorter debian/rules format, you
+may easily indicate that you need quilt by having a clause like this:
+
+  %:
+    dh --with quilt $@
+
+The new C<--with> syntax was added in B<debhelper 7.0.8> and requires
+B<quilt 0.46-7>.
+
+=head2 Short debian/rules Format
+
+Older versions of the rules file were pretty long and repetitive. To get most
+of the same features by default, all you have to do is:
+
+  %:
+    dh $@
+
+Note that the latest version of dh-make-perl does this automatically. It
+requires using B<debhelper 7> or greater.
+
+=head1 Arcane Uses
+
+=head2 Fixing Permissions
+
+Sometimes debhelper's fix permissions stage (dh_fixperms) sets the wrong
+permissions for a given file. You can use an override to fix this, like so:
+
+  override_dh_fixperms:
+    dh_fixperms
+    chmod 644 $(CURDIR)/debian/package-name/usr/share/path/to/file
+
+Using overrides requires B<debhelper 7.0.50>
+
+=head1 LICENSE AND COPYRIGHT
+
+Copyright (c) 2009 Debian Perl Group. All rights reserved.
+
+This document is free software; you may redistribute it and/or modify it
+under the same terms as Perl itself.
+
+Perl is distributed under your choice of the GNU General Public License or
+the Artistic License.
+
+On Debian GNU/Linux systems, the complete text of the GNU General Public
+License can be found in `/usr/share/common-licenses/GPL' and the Artistic
+License in `/usr/share/common-licenses/Artistic'.
+
+Any decisions that need to be made regarding the licensing, copyright and
+distribution of this file shall be determined by majority vote between the
+current members of the Debian Perl Team, with one vote for all members, and
+an additional vote granted to Debian Developers.
+
+=head2 CONTRIBUTORS
+
+The following people have contributed to the maintainership of this file:
+
+=over
+
+=item * Jonathan Yu <frequency at cpan.org>
+
+=back
+
+=cut


