summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rwxr-xr-xdh_installcron34
-rw-r--r--dh_installcron.127
-rwxr-xr-xdh_installdeb54
-rw-r--r--dh_installdeb.149
-rwxr-xr-xdh_installdebconf72
-rw-r--r--dh_installdebconf.158
6 files changed, 150 insertions, 144 deletions
diff --git a/dh_installcron b/dh_installcron
index 0ebb4b56..9813f6e0 100755
--- a/dh_installcron
+++ b/dh_installcron
@@ -1,9 +1,27 @@
#!/usr/bin/perl -w
-#
-# Install cron scripts into the appropriate places.
+
+=head1 NAME
+
+dh_installcron - install cron scripts into etc/cron.*
+
+=cut
use strict;
use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+ dh_installcron [debhelper options]
+
+=head1 DESCRIPTION
+
+dh_installcron is a debhelper program that is responsible for installing
+cron scripts into etc/cron.*/ in package build directories. The files
+debian/package.cron.daily, debian/package.cron.weekly,
+debian/package.cron.monthly, and debian/package.cron.d are installed.
+
+=cut
+
init();
foreach my $package (@{$dh{DOPACKAGES}}) {
@@ -26,3 +44,15 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
doit("install","-m",644,$cron,"$tmp/etc/cron.d/$package");
}
}
+
+=head1 SEE ALSO
+
+L<debhelper(1)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut
diff --git a/dh_installcron.1 b/dh_installcron.1
deleted file mode 100644
index 2dd53dee..00000000
--- a/dh_installcron.1
+++ /dev/null
@@ -1,27 +0,0 @@
-.TH DH_INSTALLCRON 1 "" "Debhelper Commands" "Debhelper Commands"
-.SH NAME
-dh_installcron \- install cron scripts into etc/cron.*
-.SH SYNOPSIS
-.B dh_installcron
-.I "[debhelper options]"
-.SH "DESCRIPTION"
-dh_installcron is a debhelper program that is responsible for installing
-cron scripts into etc/cron.* in package build directories. The files
-debian/package.cron.daily, debian/package.cron.weekly,
-debian/package.cron.monthly, and debian/package.cron.d are installed.
-.SH OPTIONS
-.TP
-.B debhelper options
-See
-.BR debhelper (1)
-for a list of options common to all debhelper commands.
-.SH ENVIRONMENT
-See
-.BR debhelper (1)
-for a list of environment variables that affect all debhelper commands.
-.SH "SEE ALSO"
-.BR debhelper (1)
-.SH "CONFORMS TO"
-Debian policy, version 3.0.1
-.SH AUTHOR
-Joey Hess <joeyh@debian.org>
diff --git a/dh_installdeb b/dh_installdeb
index d0af6b50..a97fc009 100755
--- a/dh_installdeb
+++ b/dh_installdeb
@@ -1,9 +1,47 @@
#!/usr/bin/perl -w
-#
-# Install files from debian/ into the package's DEBIAN directory.
+
+=head1 NAME
+
+dh_installdeb - install files into the DEBIAN directory
+
+=cut
use strict;
use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+ dh_installdeb [debhelper options]
+
+=head1 DESCRIPTION
+
+dh_installdeb is a debhelper program that is responsible for installing
+files into the DEBIAN directories in package build directories with the
+correct permissions.
+
+dh_installdeb automatically installs the following files from debian/ into
+the DEBIAN directory:
+ package.postinst
+ package.preinst
+ package.postrm
+ package.prerm
+ package.shlibs
+ package.conffiles
+
+The postinst, preinst, postrm, and prerm are handled specially: If a
+corresponding file named debian/script.debhelper exists, the contents of that
+file are merged into the script as follows: If the script exists, then
+anywhere in it that "#DEBHELPER#" appears, the text of the .debhelper file is
+inserted. If the script does not exist, then a script is generated from
+the .debhelper file. The .debhelper files are created by other debhelper
+programs, such as L<dh_installmenu(1)>, and are shell script fragments.
+
+If DH_COMPAT is set to 3 or higher, all files in the etc/ directory in a
+package will automatically be flagged as conffiles by this program, so
+there is no need to list them manually in package.conffiles.
+
+=cut
+
init();
foreach my $package (@{$dh{DOPACKAGES}}) {
@@ -66,3 +104,15 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
}
}
}
+
+=head1 SEE ALSO
+
+L<debhelper(1)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut
diff --git a/dh_installdeb.1 b/dh_installdeb.1
deleted file mode 100644
index 78f1d7c6..00000000
--- a/dh_installdeb.1
+++ /dev/null
@@ -1,49 +0,0 @@
-.TH DH_INSTALLDEB 1 "" "Debhelper Commands" "Debhelper Commands"
-.SH NAME
-dh_installdeb \- install files into the DEBIAN directory
-.SH SYNOPSIS
-.B dh_installdeb
-.I "[debhelper options]"
-.SH "DESCRIPTION"
-dh_installdeb is a debhelper program that is responsible for installing
-files into the DEBIAN directories in package build directories with the
-correct permissions.
-.P
-dh_installdeb automatically installs the following files from debian/ into
-the DEBIAN directory:
- package.postinst
- package.preinst
- package.postrm
- package.prerm
- package.shlibs
- package.conffiles
-.P
-The postinst, preinst, postrm, and prerm are handled specially: If a
-corresponding file named debian/script.debhelper exists, the contents of that
-file are merged into the script as follows: If the script exists, then
-anywhere in it that "#DEBHELPER#" appears, the text of the .debhelper file is
-inserted. If the script does not exist, then a script is generated from
-the .debhelper file. The .debhelper files are created by other debhelper
-programs, such as
-.BR dh_installmenu (1)
-, and are shell script fragments.
-.P
-If DH_COMPAT is set to 3 or higher, all files in the etc/ directory in a
-package will automatically be flagged as conffiles by this program, so
-there is no need to list them manually in package.conffiles.
-.SH OPTIONS
-.TP
-.B debhelper options
-See
-.BR debhelper (1)
-for a list of options common to all debhelper commands.
-.SH ENVIRONMENT
-See
-.BR debhelper (1)
-for a list of environment variables that affect all debhelper commands.
-.SH "SEE ALSO"
-.BR debhelper (1)
-.SH "CONFORMS TO"
-Debian policy, version 3.0.1
-.SH AUTHOR
-Joey Hess <joeyh@debian.org>
diff --git a/dh_installdebconf b/dh_installdebconf
index 0392b810..420d23a3 100755
--- a/dh_installdebconf
+++ b/dh_installdebconf
@@ -1,9 +1,61 @@
#!/usr/bin/perl -w
-#
-# Integration with debconf.
+
+=head1 NAME
+
+dh_fixperms - fix permissions of files in package build directories
+
+=cut
use strict;
use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+ dh_installdebconf [debhelper options] [-n]
+
+=head1 DESCRIPTION
+
+dh_installdebconf is a debhelper program that is responsible for installing
+files used by the debconf package into package build directories.
+
+It also automatically generates the postrm commands needed to
+interface with debconf. See L<dh_installdeb(1)> for an explanation of how
+that works.
+
+Files named debian/package.config and debian/package.templates are
+installed into the DEBIAN directory in the package build directory.
+
+Note that if you use debconf, your package probably needs to depend on it.
+
+=head1 LOCALIZED TEMPLATE FILES
+
+Debconf also supports localized template files, and this program has some
+support to aid working with them. You may find it easiest to keep the
+translations in separate files, and merge them only at build time. See
+L<debconf-mergetemplate(1)> and L<debconf-getlang(1)> for details.
+
+This program will automatically call debconf-mergetemplate and merge
+templates on the fly if it finds your template files are accompnied
+by translated files that have the same name as the template file, with a
+dot and a locale name repended.
+
+For example, if you have a German translation,
+debian/package.templates.de is merged with debian/package.templates.
+
+If you use this feature, your package should build-depend on debconf-utils.
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-n>, B<--noscripts>
+
+Do not modify postrm script.
+
+=back
+
+=cut
+
init();
foreach my $package (@{$dh{DOPACKAGES}}) {
@@ -22,11 +74,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
if ($templates ne '') {
# Are there translated templates too?
-<<<<<<< dh_installdebconf
- my @trans=glob("$templates.??", "$templates.??_??");
-=======
my @trans=(glob("$templates.??"), glob("$templates.??_??"));
->>>>>>> 1.5
if (@trans) {
complex_doit("debconf-mergetemplate @trans $templates > $tmp/DEBIAN/templates");
chmod 0644, "$tmp/DEBIAN/templates";
@@ -42,3 +90,15 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
autoscript($package,"postrm","postrm-debconf");
}
}
+
+=head1 SEE ALSO
+
+L<debhelper(1)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut
diff --git a/dh_installdebconf.1 b/dh_installdebconf.1
deleted file mode 100644
index 18ccf57b..00000000
--- a/dh_installdebconf.1
+++ /dev/null
@@ -1,58 +0,0 @@
-.TH DH_INSTALLDEBCONF 1 "" "Debhelper Commands" "Debhelper Commands"
-.SH NAME
-dh_installdebconf \- install debconf files into package build directories
-.SH SYNOPSIS
-.B dh_installdebconf
-.I "[debhelper options] [-n]"
-.SH "DESCRIPTION"
-dh_installdebconf is a debhelper program that is responsible for installing
-files used by the debconf package into package build directories.
-.P
-It also automatically generates the postrm commands needed to
-interface with debconf. See
-.BR dh_installdeb (1)
-for an explanation of how this works.
-.P
-Files named debian/package.config and debian/package.templates are installed
-into the DEBIAN directory in the package build directory.
-.P
-Note that if you use debconf, your package probably needs to depend on it.
-.SH "LOCALIZED TEMPLATE FILES"
-Debconf also supports localized template files, and this program has some
-support to aid working with them. You may find it easiest to keep the
-translations in separate files, and merge them only at build time. See
-.BR debconf-mergetemplate (1)
-for details.
-.P
-This program will automatically call
-.BR debconf-mergetemplate (1)
-and merge templates on the fly if it finds your template files are accompnied
-by translated files that have the same name as the template file, with a
-dot and two letters prepended.
-.P
-For example, if you have a German translation,
-debian/package.templates.de is merged with debian/package.templates.
-.P
-If you use this feature, your package should build-depend on debconf-utils.
-.SH OPTIONS
-.TP
-.B debhelper options
-See
-.BR debhelper (1)
-for a list of options common to all debhelper commands.
-.TP
-.B \-n, \--noscripts
-Do not modify postrm script.
-.SH ENVIRONMENT
-See
-.BR debhelper (1)
-for a list of environment variables that affect all debhelper commands.
-.SH NOTES
-Note that this command is not idempotent. "dh_clean -k" should be called
-between invocations of this command. Otherwise, it may cause multiple
-instances of the same text to be added to maintainer scripts.
-.SH "SEE ALSO"
-.TP
-.BR debhelper (1)
-.SH AUTHOR
-Joey Hess <joeyh@debian.org>