r415: * dh_shlibdeps -l can handle relative paths now. Patch from Colin Watson

[debhelper.git] / dh_shlibdeps.1

diff --git a/dh_shlibdeps.1 b/dh_shlibdeps.1
index 77d90c2579f203613e9ea5d7fbdd40a8b0b4f745..14e56b0211ec903bd284e4e6bae146ed6c8d26fa 100644 (file)
--- a/dh_shlibdeps.1
+++ b/dh_shlibdeps.1
@@ -1,56 +1,54 @@
-.TH DH_INSTALLDEBFILES 1
+.TH DH_SHLIBDEPS 1 "" "Debhelper Commands" "Debhelper Commands"
 .SH NAME
 dh_shlibdeps \- calculate shared library dependancies
 .SH SYNOPSIS
 .B dh_shlibdeps
-.I "[-v] [-a] [-i] [-ppackage] [-Ptmpdir] [-uparams]"
+.I "[debhelper options] [-ldirectory] [-uparams] [-Xitem] [-- params]"
 .SH "DESCRIPTION"
 dh_shlibdeps is a debhelper program that is responsible for calculating
-shared library dependancies for all executables found in the package build
-directory.
+shared library dependancies for packages.
 .P
 This program is merely a wrapper around
 .BR dpkg-shlibdeps (1)
-that calls it once for each package listed in the control file. You may 
-prefer to simply run 
-.BR dpkg-shlibdeps (1)
-by hand.
+that calls it once for each package listed in the control file, passing it
+a list of ELF executables and shared libraries it has found.
 .SH OPTIONS
 .TP
-.B \-v
-Verbose mode; show all commands that modify the package build directory.
-.TP
-.B \-a
-Install files for all architecture dependent packages.
+.B debhelper options
+See
+.BR debhelper (1)
+for a list of options common to all debhelper commands.
 .TP
-.B \-i
-Install files for all architecture independent packages.
+.B \-uparams, \--dpkg-shlibdeps-params=params
 .TP
-.B \-ppackage
-Install files for the package named "package".
+.B \-\- params
+Pass "params" to
+.BR dpkg-shlibdeps (1)
 .TP
-.B \-Ptmpdir
-Use "tmpdir" for package build directory. 
+.B \-Xitem, \--exclude=item
+Exclude files that contain "item" anywhere in their filename from being
+passed to dpkg-shlibdeps. This will make their dependancies be ignored.
+This may be useful in some situations, but use it with caution. This option
+may be used more than once to exclude more than one thing.
 .TP
-.B \-uparams
-Pass "params" to 
+.B \-ldirectory
+Before
 .BR dpkg-shlibdeps (1)
-.SH NOTES
-The
-.B \-a
-.B \-i
-and
-.B \-p
-arguments are cumulative. If none are specified, then all packages listed in
-the control file will be effected.
+is run, LD_LIBRARY_PATH will be set to the specified directory.
+This is useful for multi-binary packages where a library
+is built in one package and another package contains binaries linked
+against said library. Relative paths will be made absolute for the
+benefit of dpkg-shlibdeps.
 .SH ENVIRONMENT
-.TP
-.I DH_VERBOSE
-Enables verbose mode
+See
+.BR debhelper (1)
+for a list of environment variables that affect all debhelper commands.
 .SH "SEE ALSO"
-.BR /usr/doc/debhelper/README
+.TP
+.BR debhelper (1)
+.TP
 .BR dpkg-shlibdeps (1)
 .SH "CONFORMS TO"
-Debian policy, version 2.3.0.0
+Debian policy, version 3.0.1
 .SH AUTHOR
-Joey Hess <joeyh@master.debian.org>
+Joey Hess <joeyh@debian.org>