[debhelper-devel] [debhelper] 01/01: dh_install: Document how to use dh-exec to rename files

[Niels Thykier]

This is an automated email from the git hooks/post-receive script.

nthykier pushed a commit to branch master
in repository debhelper.

commit 2a9c9a24bea706be2bdb547808c4de1b72d2c01f
Author: Niels Thykier <niels at thykier.net>
Date:   Wed Apr 29 20:01:31 2015 +0200

    dh_install: Document how to use dh-exec to rename files
    
    Signed-off-by: Niels Thykier <niels at thykier.net>
---
 debian/changelog |  2 ++
 dh_install       | 19 +++++++++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/debian/changelog b/debian/changelog
index 8faff49..336bb22 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -83,6 +83,8 @@ debhelper (9.20150101.1) UNRELEASED; urgency=medium
   * autoscripts/*-emacsen: Apply patch from Paul Wise to check that
     emacs-package-{install,remove} is (still) present before invoking
     it.  (Closes: #736896)
+  * dh_install.1: Document that dh-exec can be used to do renaming
+    and provie a trivial example of how to achieve it.  (Closes: #245554)
 
   [ Bernhard R. Link ]
   * Dh_lib: apply patch from Guillem Jover to support case-insensitive
diff --git a/dh_install b/dh_install
index 5c56f13..67ebf24 100755
--- a/dh_install
+++ b/dh_install
@@ -258,6 +258,25 @@ if ($dh{LIST_MISSING} || $dh{FAIL_MISSING}) {
 B<dh_install> cannot rename files or directories, it can only install them
 with the names they already have into wherever you want in the package
 build tree.
+
+However, renaming can be achieved by using B<dh-exec> with compat 9 or
+later.  An example debian/I<package>.install file using B<dh-exec>
+could look like:
+
+ #!/usr/bin/dh-exec
+ debian/default.conf => /etc/my-package/start.conf
+
+Please remember the following three things:
+
+=over 4
+
+=item * The package must be using compat 9 or later (see L<debhelper(7)>)
+
+=item * The package will need a build-dependency on dh-exec.
+
+=item * The install file must be marked executable.
+
+=back
   
 =head1 SEE ALSO
 

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debhelper/debhelper.git