diff options
author | joey <joey> | 2001-02-09 23:30:08 +0000 |
---|---|---|
committer | joey <joey> | 2001-02-09 23:30:08 +0000 |
commit | 379525672c478e9b88f0b4249f20786ef1b07729 (patch) | |
tree | d25a9bd2df01434c38b1166ebd9629edebc8f367 | |
parent | 7f94f1760a87781615730ae5daf9b6b58a7feaf9 (diff) |
r433: this is getting *so* boring.
-rwxr-xr-x | dh_installxfonts | 47 | ||||
-rw-r--r-- | dh_installxfonts.1 | 43 | ||||
-rwxr-xr-x | dh_link | 85 | ||||
-rw-r--r-- | dh_link.1 | 75 | ||||
-rwxr-xr-x | dh_listpackages | 33 | ||||
-rw-r--r-- | dh_listpackages.1 | 25 | ||||
-rwxr-xr-x | dh_makeshlibs | 92 | ||||
-rw-r--r-- | dh_makeshlibs.1 | 66 | ||||
-rwxr-xr-x | dh_md5sums | 54 | ||||
-rw-r--r-- | dh_md5sums.1 | 36 |
10 files changed, 299 insertions, 257 deletions
diff --git a/dh_installxfonts b/dh_installxfonts index 024307cd..bf0ec0fe 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 464fd8fb..00000000 --- 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> @@ -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 9fd210f4..00000000 --- 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 ec9d533c..846fa547 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 53f621b0..00000000 --- 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 20644d80..9d48cd8b 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 488356da..00000000 --- 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> @@ -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 cff1178d..00000000 --- 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> |