]> git.donarmstrong.com Git - debhelper.git/commitdiff
r428: the never ending podization
authorjoey <joey>
Fri, 9 Feb 2001 10:26:46 +0000 (10:26 +0000)
committerjoey <joey>
Fri, 9 Feb 2001 10:26:46 +0000 (10:26 +0000)
dh_installcron
dh_installcron.1 [deleted file]
dh_installdeb
dh_installdeb.1 [deleted file]
dh_installdebconf
dh_installdebconf.1 [deleted file]

index 0ebb4b56604b01baeffc36c16e5fb16e39e8535c..9813f6e080d44199ec3e2e6b442490eac9061355 100755 (executable)
@@ -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 (file)
index 2dd53de..0000000
+++ /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>
index d0af6b50555866e1c71dab46652c276e1f744e61..a97fc00943f88688a9e2aeb3eb4967ece23cd896 100755 (executable)
@@ -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 (file)
index 78f1d7c..0000000
+++ /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>
index 0392b8103406b8957e2fef08bfb7ace659d9667a..420d23a34f5d762be3854bc324dc9dee5366b2cc 100755 (executable)
@@ -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 (file)
index 18ccf57..0000000
+++ /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>