version 1, including all changes.
.
| Rev |
Author |
# |
Line |
| 1 |
perry |
1 |
DH_LINK |
| |
|
2 |
!!!DH_LINK |
| |
|
3 |
NAME |
| |
|
4 |
SYNOPSIS |
| |
|
5 |
DESCRIPTION |
| |
|
6 |
OPTIONS |
| |
|
7 |
EXAMPLES |
| |
|
8 |
SEE ALSO |
| |
|
9 |
AUTHOR |
| |
|
10 |
---- |
| |
|
11 |
!!NAME |
| |
|
12 |
|
| |
|
13 |
|
| |
|
14 |
dh_link - create symlinks in package build directories |
| |
|
15 |
!!SYNOPSIS |
| |
|
16 |
|
| |
|
17 |
|
| |
|
18 |
__dh_link__ [[''debhelper options''] [[__-A__] |
| |
|
19 |
[[''source destination ...''] |
| |
|
20 |
!!DESCRIPTION |
| |
|
21 |
|
| |
|
22 |
|
| |
|
23 |
dh_link is a debhelper program that creates symlinks in |
| |
|
24 |
package build directories. |
| |
|
25 |
|
| |
|
26 |
|
| |
|
27 |
dh_link accepts a list of pairs of source and destination |
| |
|
28 |
files. The source files are the already existing files that |
| |
|
29 |
will be symlinked from. The destination files are the |
| |
|
30 |
symlinks that will be created. There __must__ be an equal |
| |
|
31 |
number of source and destination files |
| |
|
32 |
specified. |
| |
|
33 |
|
| |
|
34 |
|
| |
|
35 |
The list can be specified in two ways. A file named |
| |
|
36 |
debian/package.links can list pairs of files. If you use |
| |
|
37 |
this file, you should put each pair of files on its own |
| |
|
38 |
line, and separate the files within the pair with |
| |
|
39 |
whitespace. Also, pairs of files can be specified as |
| |
|
40 |
parameters - these pairs will only be created in the package |
| |
|
41 |
build directory of the first package dh_link is told to act |
| |
|
42 |
on. By default, this is the first binary package in |
| |
|
43 |
debian/control, but if you use -p, -i, or -a flags, it will |
| |
|
44 |
be the first package specified by those flags. |
| |
|
45 |
|
| |
|
46 |
|
| |
|
47 |
Be sure you __do__ specify the full filename to both the |
| |
|
48 |
source and destination files (unlike you would do if you |
| |
|
49 |
were using something like ln(1)). |
| |
|
50 |
|
| |
|
51 |
|
| |
|
52 |
dh_link will generate symlinks that comply with debian |
| |
|
53 |
policy - absolute when policy says they should be absolute, |
| |
|
54 |
and relative links with as short a path as possible. It will |
| |
|
55 |
also create any subdirectories it needs to to put the |
| |
|
56 |
symlinks in. |
| |
|
57 |
|
| |
|
58 |
|
| |
|
59 |
dh_link also scans the package build tree for existing |
| |
|
60 |
symlinks which do not conform to debian policy, and corrects |
| |
|
61 |
them (v4 only). |
| |
|
62 |
!!OPTIONS |
| |
|
63 |
|
| |
|
64 |
|
| |
|
65 |
__-A__, __--all__ |
| |
|
66 |
|
| |
|
67 |
|
| |
|
68 |
Create any links specified by command line parameters in |
| |
|
69 |
ALL packages acted on, not just the |
| |
|
70 |
first. |
| |
|
71 |
|
| |
|
72 |
|
| |
|
73 |
''source destination ...'' |
| |
|
74 |
|
| |
|
75 |
|
| |
|
76 |
Create a file named ``destination'' as a link to a file |
| |
|
77 |
named ``source''. Do this in the package build directory of |
| |
|
78 |
the first package acted on. (Or in all packages if -A is |
| |
|
79 |
specified.) |
| |
|
80 |
!!EXAMPLES |
| |
|
81 |
|
| |
|
82 |
|
| |
|
83 |
dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1 |
| |
|
84 |
Make bar.1 be a symlink to foo.1 |
| |
|
85 |
|
| |
|
86 |
|
| |
|
87 |
dh_link var/lib/foo usr/lib/foo \ |
| |
|
88 |
usr/X11R6/man/man1/foo.1x usr/share/man/man1/bar.1 |
| |
|
89 |
Make /usr/lib/foo/ be a link to /var/lib/foo/, and bar.1 be a symlink to the X man page foo.1x |
| |
|
90 |
!!SEE ALSO |
| |
|
91 |
|
| |
|
92 |
|
| |
|
93 |
debhelper(1) |
| |
|
94 |
|
| |
|
95 |
|
| |
|
96 |
This program is a part of debhelper. |
| |
|
97 |
!!AUTHOR |
| |
|
98 |
|
| |
|
99 |
|
| |
|
100 |
Joey Hess |
| |
|
101 |
---- |
