summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rwxr-xr-xdh_installxfonts47
-rw-r--r--dh_installxfonts.143
-rwxr-xr-xdh_link85
-rw-r--r--dh_link.175
-rwxr-xr-xdh_listpackages33
-rw-r--r--dh_listpackages.125
-rwxr-xr-xdh_makeshlibs92
-rw-r--r--dh_makeshlibs.166
-rwxr-xr-xdh_md5sums54
-rw-r--r--dh_md5sums.136
10 files changed, 299 insertions, 257 deletions
diff --git a/dh_installxfonts b/dh_installxfonts
index 024307c..bf0ec0f 100755
--- a/dh_installxfonts
+++ b/dh_installxfonts
@@ -1,9 +1,40 @@
#!/usr/bin/perl -w
-#
-# Integration with the Debian X11 font policy.
+
+=head1 NAME
+
+dh_installxfonts - register X fonts
+
+=cut
use strict;
use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+ dh_installxfonts [debhelper options]
+
+=head1 DESCRIPTION
+
+dh_installxfonts is a debhelper program that is responsible for
+registering X fonts, so their corresponding fonts.dir, fonts.alias,
+and fonts.scale be rebuilt properly at install time.
+
+Before calling this program, you should have installed any X fonts
+provided by your package into the appropriate location in the package build
+directory. Also, your package should depend on xbase-clients (>=
+3.3.3.1-5).
+
+It automatically generates the postinst and postrm commands needed to
+register X fonts. See L<dh_installdeb(1)> for an explanation of how this
+works.
+
+=head1 NOTES
+
+See L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, and L<mkfontdir(1x)>
+for more information about X font installation.
+
+=cut
+
init();
foreach my $package (@{$dh{DOPACKAGES}}) {
@@ -34,3 +65,15 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
":;s:#UPDATECMDS#:".join(' ', @updatecmds).":");
}
}
+
+=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_installxfonts.1 b/dh_installxfonts.1
deleted file mode 100644
index 464fd8f..0000000
--- a/dh_installxfonts.1
+++ /dev/null
@@ -1,43 +0,0 @@
-.TH DH_INSTALLXFONTS 1 "" "Debhelper Commands" "Debhelper Commands"
-.SH NAME
-dh_installxfonts \- register X fonts
-.SH SYNOPSIS
-.B dh_installxfonts
-.I "[debhelper options]"
-.SH "DESCRIPTION"
-dh_installxfonts is a debhelper program that is responsible for
-registering X fonts, so their corresponding fonts.dir, fonts.alias,
-and fonts.scale be rebuilt properly at install time.
-.P
-Before calling this program, you should have installed any X fonts
-provided by your package into the appropriate location in the package build
-directory. Also, your package should depend on xbase-clients (>= 3.3.3.1-5).
-.P
-It automatically generates the postinst and postrm commands needed to
-register X fonts. See
-.BR dh_installdeb (1)
-for an explanation of how this works.
-.SH OPTIONS
-.TP
-.B debhelper options
-See
-.BR debhelper (1)
-for a list of options common to all debhelper commands.
-.SH NOTES
-See
-.BR update-fonts-alias (8)
-,
-.BR update-fonts-scale (8)
-and
-.BR mkfontdir (1x)
-for more information about X font installation.
-.SH ENVIRONMENT
-See
-.BR debhelper (1)
-for a list of environment variables that affect all debhelper commands.
-.SH "SEE ALSO"
-.BR debhelper (1)
-.BR update-fonts-alias (8)
-.BR update-fonts-scale (8)
-.SH AUTHOR
-Changwoo Ryu <cwryu@debian.org>
diff --git a/dh_link b/dh_link
index 4dca363..8a2805e 100755
--- a/dh_link
+++ b/dh_link
@@ -1,10 +1,77 @@
#!/usr/bin/perl -w
-#
-# Generate symlinks in debian packages, reading debian/links. The
-# file contains pairs of files and symlinks.
+
+=head1 NAME
+
+dh_link - create symlinks in package build directories
+
+=cut
use strict;
use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+ dh_link [debhelper options] [-A] [source destination ...]
+
+=head1 DESCRIPTION
+
+dh_link is a debhelper program that creates symlinks in package build
+directories.
+
+dh_link accepts a list of pairs of source and destination files. The source
+files are the already existing files that will be symlinked from. The
+destination files are the symlinks that will be created. There B<must> be
+an equal number of source and destination files specified.
+
+The list can be specified in two ways. A file named debian/package.links
+can list pairs of files. If you use this file, you should put each pair
+of files on its own line, and separate the files within the pair with
+whitespace. Also, pairs of files can be specified as parameters - these
+pairs will only be created in the package build directory of the first
+package dh_link is told to act on. By default, this is the first binary
+package in debian/control, but if you use -p, -i, or -a flags, it will be
+the first package specified by those flags.
+
+Be sure you B<do> specify the full filename to both the source and
+destination files (unlike you would do if you were using something like
+L<ln(1)>).
+
+dh_link will generate symlinks that comply with debian policy - absolute
+when policy says they should be absolute, and relative links with as short
+a path as possible. It will also create any subdirectories it needs to to put
+the symlinks in.
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-A>, B<--all>
+
+Create any links specified by command line parameters in ALL packages
+acted on, not just the first.
+
+=item I<source destination ...>
+
+Create a file named "destination" as a link to a file named "source". Do
+this in the package build directory of the first package acted on.
+(Or in all packages if -A is specified.)
+
+=back
+
+=head1 EXAMPLES
+
+ dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1
+
+Make bar.1 be a symlink to foo.1
+
+ dh_link var/lib/foo usr/lib/foo \
+ usr/X11R6/man/man1/foo.1x usr/share/man/man1/bar.1
+
+Make /usr/lib/foo/ be a link to /var/lib/foo/, and bar.1 be a symlink to
+the X man page foo.1x
+
+=cut
+
init();
foreach my $package (@{$dh{DOPACKAGES}}) {
@@ -73,3 +140,15 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
doit("ln","-sf",$src,"$tmp/$dest");
}
}
+
+=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_link.1 b/dh_link.1
deleted file mode 100644
index 9fd210f..0000000
--- a/dh_link.1
+++ /dev/null
@@ -1,75 +0,0 @@
-.TH DH_LINK 1 "" "Debhelper Commands" "Debhelper Commands"
-.SH NAME
-dh_link \- create symlinks in package build directories
-.SH SYNOPSIS
-.B dh_link
-.I "[debhelper options] [-A] [source destination ...]"
-.SH "DESCRIPTION"
-dh_link is a debhelper program that creates symlinks in package build
-directories.
-.P
-dh_link accepts a list of pairs of source and destination files. The source
-files are the already existing files that will be symlinked from. The
-destination files are the symlinks that will be created. There
-.B must
-be an equal number of source and destination files specified.
-.P
-The list can be specified in two ways. A file named debian/package.links
-can list pairs of files. If you use this file, you should put each pair
-of files on its own line, and separate the files within the pair with
-whitespace. Also, pairs of files can be specified as parameters - these
-pairs will only be created in the package build directory of the first
-package dh_link is told to act on. By default, this is the first binary
-package in debian/control, but if you use -p, -i, or -a flags, it will be
-the first package specified by those flags.
-.P
-Be sure you
-.B do
-specify the full filename to both the source and destination files (unlike
-you would do if you were using something like
-.BR ln (1)
-).
-.P
-dh_link will generate symlinks that comply with debian policy - absolute
-when policy says they should be absolute, and relative links with as short a
-path as possible. It will also create any subdirectories it needs to to put
-the symlinks in.
-.SH OPTIONS
-.TP
-.B debhelper options
-See
-.BR debhelper (1)
-for a list of options common to all debhelper commands.
-.TP
-.B \-A, \--all
-Create any links specified by command line parameters in ALL packages
-acted on, not just the first.
-.TP
-.B source destination ...
-Create a file named "destination" as a link to a file named "source". Do
-this in the package build directory of the first package acted on.
-(Or in all packages if -A is specified.)
-.SH EXAMPLES
- dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1
-.P
-Make bar.1 be a symlink to foo.1
-.P
- dh_link var/lib/foo usr/lib/foo \\
- usr/X11R6/man/man1/foo.1x usr/share/man/man1/bar.1
-.P
-Make /usr/lib/foo/ be a link to /var/lib/foo/, and bar.1 be a symlink to the
-X man page foo.1x
-.SH ENVIRONMENT
-See
-.BR debhelper (1)
-for a list of environment variables that affect all debhelper commands.
-.SH "SEE ALSO"
-.BR debhelper (1)
-.SH BUGS
-It's impossible to specify filenames with spaces or other whitespace in them
-in debian/package.links files. This is more a historical design flaw than a
-bug.
-.SH "CONFORMS TO"
-Debian policy, version 3.0.1
-.SH AUTHOR
-Joey Hess <joeyh@debian.org>
diff --git a/dh_listpackages b/dh_listpackages
index ec9d533..846fa54 100755
--- a/dh_listpackages
+++ b/dh_listpackages
@@ -1,9 +1,38 @@
#!/usr/bin/perl -w
-#
-# Output a list of all packages debhelper will act on.
+
+=head1 NAME
+
+dh_listpackages - list binary packages debhelper will act on
+
+=cut
use strict;
use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+ dh_listpackages [debhelper options]
+
+=head1 DESCRIPTION
+
+dh_listpackages is a debhelper program that outputs a list of all binary
+packages debhelper commands will act on. If you pass it some options, it
+will change the list to match the packages other debhelper commands would
+act on if passed the same options.
+
+=cut
+
init();
print join("\n",@{$dh{DOPACKAGES}})."\n";
+=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_listpackages.1 b/dh_listpackages.1
deleted file mode 100644
index 53f621b..0000000
--- a/dh_listpackages.1
+++ /dev/null
@@ -1,25 +0,0 @@
-.TH DH_LISTPACKAGES 1 "" "Debhelper Commands" "Debhelper Commands"
-.SH NAME
-dh_listpackages \- list binary packages debhelper will act on
-.SH SYNOPSIS
-.B dh_listpackages
-.I "[debhelper options]"
-.SH "DESCRIPTION"
-dh_listpackages is a debhelper program that outputs a list of all binary
-packages debhelper commands will act on. If you pass it some options, it
-will change the list to match the packages other debhelper commands would
-act on if passed the same options.
-.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 AUTHOR
-Joey Hess <joeyh@debian.org>
diff --git a/dh_makeshlibs b/dh_makeshlibs
index 20644d8..9d48cd8 100755
--- a/dh_makeshlibs
+++ b/dh_makeshlibs
@@ -1,9 +1,85 @@
#!/usr/bin/perl -w
-#
-# Automatically generate shlibs files.
+
+=head1 NAME
+
+dh_makeshlibs - automatically create shlibs file
+
+=cut
use strict;
use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+ dh_makeshlibs [debhelper options] [-mmajor] [-V[dependancies]] [-n]
+
+=head1 DESCRIPTION
+
+dh_makeshlibs is a debhelper program that automatically scans for shared
+libraries, and generates a shlibs file for the libraries it finds.
+
+It also adds a call to ldconfig in the postinst and postrm scripts (in
+DH_COMPAT=3 mode and above only).
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-m>I<major>, B<--major=>I<major>
+
+Instead of trying to guess the major number of the library from the
+filename of the library, use the major number specified after the -m parameter.
+
+=item B<-V>, B<-V>I<dependancies>
+
+=item B<--version-info>, B<--version-info=>I<dependancies>
+
+By default, the shlibs file generated by this program does not make packages
+depend on any particular version of the package containing the shared
+library. It may be necessary for you to add some version dependancy
+information to the shlibs file. If -V is specified with no dependancy
+information, the current version of the package is plugged into a
+dependancy that looks like "packagename (>= packageversion)". If -V is specified with
+parameters, the parameters can be used to specify the exact dependancy
+information needed (be sure to include the package name).
+
+=item B<-n>, B<--noscripts>
+
+Do not modify postinst/postrm scripts.
+
+=back
+
+=head1 EXAMPLES
+
+ dh_makeshlibs
+
+Assuming this is a package named libfoobar1, generates a shlibs file that
+looks something like:
+ libfoobar 1 libfoobar1
+
+ dh_makeshlibs -V
+
+Assuming the current version of the package is 1.0-3, generates a shlibs
+file that looks something like:
+ libfoobar 1 libfoobar1 (>= 1.0-3)
+
+ dh_makeshlibs -V 'libfoobar1 (>= 1.0)'
+
+Generates a shlibs file that looks something like:
+ libfoobar 1 libfoobar1 (>= 1.0)
+
+=back
+
+=head1 NOTES
+
+There is no guarantee that the program will get the shlibs file right. For
+example, it may not correctly guess the major number of your package. In
+cases like these (and perhaps in general, just to be safe), it is better to
+create a debian/shlibs file by hand, or force it to use the correct major
+number by specifying the -m parameter.
+
+=cut
+
init();
foreach my $package (@{$dh{DOPACKAGES}}) {
@@ -68,3 +144,15 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
doit("chown","0.0","$tmp/DEBIAN/shlibs");
}
}
+
+=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_makeshlibs.1 b/dh_makeshlibs.1
deleted file mode 100644
index 488356d..0000000
--- a/dh_makeshlibs.1
+++ /dev/null
@@ -1,66 +0,0 @@
-.TH DH_MAKESHLIBS 1 "" "Debhelper Commands" "Debhelper Commands"
-.SH NAME
-dh_makeshlibs \- automatically create shlibs file
-.SH SYNOPSIS
-.B dh_makeshlibs
-.I "[debhelper options] [-mmajor] [-V[dependancies]] [-n]"
-.SH "DESCRIPTION"
-dh_makeshlibs is a debhelper program that automatically scans for shared
-libraries, and generates a shlibs file for the libraries it finds.
-.P
-It also adds a call to ldconfig in the postinst and postrm scripts (in
-DH_COMPAT=3 mode and above only).
-.SH OPTIONS
-.TP
-.B debhelper options
-See
-.BR debhelper (1)
-for a list of options common to all debhelper commands.
-.TP
-.B \-mmajor, \--major=major
-Instead of trying to guess the major number of the library from the filename
-of the library, use the major number specified after the -m parameter.
-.TP
-.B \-V[dependancies], \--version-info, \--version-info=dependancies
-By default, the shlibs file generated by this program does not make packages
-depend on any particular version of the package containing the shared
-library. It may be necessary for you to add some version dependancy
-information to the shlibs file. If -V is specified with no dependancy
-information, the current version of the package is plugged into a dependancy
-that looks like "packagename (>= packageversion)". If -V is specified with
-parameters, the parameters can be used to specify the exact dependancy
-information needed (be sure to include the package name).
-.TP
-.B \-n, \--noscripts
-Do not modify postinst/postrm scripts.
-.SH EXAMPLES
-.TP
-.B dh_makeshlibs
-Assuming this is a package named libfoobar1, generates a shlibs file that
-looks something like:
- libfoobar 1 libfoobar1
-.TP
-.B dh_makeshlibs \-V
-Assuming the current version of the package is 1.0-3, generates a shlibs
-file that looks something like:
- libfoobar 1 libfoobar1 (>= 1.0-3)
-.TP
-.B dh_makeshlibs \-V "'libfoobar1 (>= 1.0)'"
-Generates a shlibs file that looks something like:
- libfoobar 1 libfoobar1 (>= 1.0)
-.SH ENVIRONMENT
-See
-.BR debhelper (1)
-for a list of environment variables that affect all debhelper commands.
-.SH "SEE ALSO"
-.BR debhelper (1)
-.SH BUGS
-There is no guarantee that the program will get the shlibs file right. For
-example, it may not correctly guess the major number of your package. In
-cases like these (and perhaps in general, just to be safe), it is better to
-create a debian/shlibs file by hand, or force it to use the correct major
-number by specifying the -m parameter.
-.P
-This is a "do what I Mean" type program - you have been warned!
-.SH AUTHOR
-Joey Hess <joeyh@debian.org>
diff --git a/dh_md5sums b/dh_md5sums
index ad3ae71..51bd54c 100755
--- a/dh_md5sums
+++ b/dh_md5sums
@@ -1,11 +1,47 @@
#!/usr/bin/perl -w
-#
-# Generate a DEBIAN/md5sums file, that lists the md5sums of all files in the
-# package.
+
+=head1 NAME
+
+dh_md5sums - generate DEBIAN/md5sums file
+
+=cut
use strict;
use Cwd;
use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+ dh_md5sums [debhelper options] [-x] [-Xitem] [--include-conffiles]
+
+=head1 DESCRIPTION
+
+dh_md5sums is a debhelper program that is responsible for generating
+a DEBIAN/md5sums file, which lists the md5sums of each file in the package.
+
+All files in DEBIAN/ are omitted from the md5sums file, as are all
+conffiles (unless you use the --include-conffiles switch).
+
+The md5sums file is installed with proper permissions and ownerships.
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-x>, B<--include-conffiles>
+
+Include conffiles in the md5sums list. Note that this information is
+redundant since it is included elsewhere in debian packages.
+
+=item B<-X>I<item>, B<--exclude=>I<item>
+
+Exclude files that contain "item" anywhere in their filename from
+being listed in the md5sums file.
+
+=back
+
+=cut
+
init();
foreach my $package (@{$dh{DOPACKAGES}}) {
@@ -44,3 +80,15 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
doit("chown","0.0","$tmp/DEBIAN/md5sums");
}
}
+
+=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_md5sums.1 b/dh_md5sums.1
deleted file mode 100644
index cff1178..0000000
--- a/dh_md5sums.1
+++ /dev/null
@@ -1,36 +0,0 @@
-.TH DH_MD5SUMS 1 "" "Debhelper Commands" "Debhelper Commands"
-.SH NAME
-dh_md5sums \- generate DEBIAN/md5sums file
-.SH SYNOPSIS
-.B dh_md5sums
-.I "[debhelper options] [-x] [-Xitem]"
-.SH "DESCRIPTION"
-dh_md5sums is a debhelper program that is responsible for generating
-a DEBIAN/md5sums file, which lists the md5sums of each file in the package.
-.P
-All files in DEBIAN/ are omitted from the md5sums file, as are all conffiles
-(unless you use the --include-conffiles switch).
-.P
-The md5sums file is installed with proper permissions and ownerships.
-.SH OPTIONS
-.TP
-.B debhelper options
-See
-.BR debhelper (1)
-for a list of options common to all debhelper commands.
-.TP
-.B \-x, \--include-conffiles
-Include conffiles in the md5sums list. Note that this information is
-redundant since it is included elsewhere in debian packages.
-.TP
-.B \-Xitem, --exclude=item
-Exclude files that contain "item" anywhere in their filename from
-being listed in the md5sums file.
-.SH ENVIRONMENT
-See
-.BR debhelper (1)
-for a list of environment variables that affect all debhelper commands.
-.SH "SEE ALSO"
-.BR debhelper (1)
-.SH AUTHOR
-Joey Hess <joeyh@debian.org>