Provided by: dh-exec_0.12_i386 bug

NAME
       dh-exec-install - Install (and possibly rename) files.


SYNOPSIS
       #! /usr/bin/dh-exec
       debian/default.conf => /etc/my-package/start.conf
       usr/bin/*


DESCRIPTION
       Being a sub-command of dh-exec(1), this program must not be ran
       directly, but through dh-exec, which automatically runs all available
       sub-commands if run bare; or explicitly with dh-exec --with=install.

       It is meant to be used for dh_install(1) files, and those alone. If it
       finds that its input is not such a file, it will do nothing, but echo
       back the contents.

       The purpose of the program is to extend dh_install(1)'s functionality,
       by allowing to specify a destination filename.

       This can be accomplished by a special syntax: the " => " mark between a
       source and a destination means that the source file should be installed
       with the specified destination name.

       For obvious reasons, the source must not be a wildcard, and the
       destination in this case must be a file, and not a directory.

       All other non-comment lines are left alone.


RESTRICTIONS
       Due to the way executable scripts are called from debhelper(1), there
       is no way to know what options were used for the original
       dh_install(1). This means, that the --sourcedir option of dh_install(1)
       will not work correctly when dh-exec-install is in use.


IMPLEMENTATION
       Internally, the renaming happens by creating a temporary directory
       under debian/tmp/, and copying (or moving, if the source was under
       debian/tmp/ to begin with) the file there, with the new name.

       This is done this way to allow dh_install(1) to do the real copying,
       and allow its options to continue working, even when renaming is
       involved.

       The temporary directory is put under debian/tmp so that it will be
       cleaned by dh_prep(1) when the clean target gets to run. Thus, no extra
       code is needed anywhere to clean up the renamed files.


ENVIRONMENT
       DH_EXEC_SCRIPTDIR
           Indicates which directory the command-specific scripts should be
           sought for. If not specified, scripts will be searched for in
           /usr/share/dh-exec/.


FILES
       $DH_EXEC_SCRIPTDIR/dh-exec-install-*
           The various scripts for the higher-level program.


SEE ALSO
       debhelper(1), dh-exec(1), dh_install(1)


AUTHOR
       dh-exec-install is copyright © 2011-2012 by Gergely Nagy
       <algernon@madhouse-project.org>.

                                  2012-05-03                DH-EXEC-INSTALL(1)