.B dh_link
.I "[debhelper options] [-A] [source destination ...]"
.SH "DESCRIPTION"
-dh_link is a debhelper program that creates symlinks in package build
+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
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
-(debian/links may be used for the first binary package in debian/control)
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
-ackage 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
+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
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.
+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
-.TP
-.B dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1
+ dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1
+.P
Make bar.1 be a symlink to foo.1
-.TP
-.B dh_link var/lib/foo usr/lib/foo usr/X11R6/man/man1/foo.1x usr/share/man/man1/bar.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
.BR debhelper (1)
.SH BUGS
It's impossible to specify filenames with spaces or other whitespace in them
-in debian/links file. This is more a historical design flaw than a bug.
+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@master.debian.org>
+Joey Hess <joeyh@debian.org>