]> git.donarmstrong.com Git - debhelper.git/blob - dh_movefiles.1
r397: horribly broke everything I touched :-)
[debhelper.git] / dh_movefiles.1
1 .TH DH_MOVEFILES 1 "" "Debhelper Commands" "Debhelper Commands"
2 .SH NAME
3 dh_movefiles \- move files out of debian/tmp into subpackages
4 .SH SYNOPSIS
5 .B dh_movefiles
6 .I "[debhelper options] [--sourcedir=dir] [file ..]"
7 .SH "DESCRIPTION"
8 dh_movefiles is a debhelper program that is responsible for moving files out
9 of debian/tmp or some other directory and into other package build
10 directories. This may be useful if your package has a Makefile that installs
11 everything into debian/tmp, and you need to break that up into subpackages.
12 .P
13 Files named debian/package.files list the files to be moved, separated by
14 whitespace. The filenames listed should be relative to debian/tmp/. You can
15 also list directory names, and the whole directory will be moved. You can
16 even use wildcards if you like. If you prefer, you can list the files to
17 move on the command line and this will apply to the first package
18 dh_movefiles is told to act on.
19 .SH OPTIONS
20 .TP
21 .B debhelper options
22 See
23 .BR debhelper (1)
24 for a list of options common to all debhelper commands.
25 .TP
26 .B --sourcedir=dir
27 Instead of moving files out of debian/tmp (the default), this option makes
28 it move files out of some other directory. Since the entire contents of
29 the sourcedir is moved, specifiying something like --sourcedir=/ is very
30 unsafe, so to prevent mistakes, the sourcedir must be a relative filename; it
31 cannot begin with a `/'.
32 .TP
33 .B file ..
34 Lists files to move. The filenames listed should be relative to debian/tmp/.
35 You can also list directory names, and the whole directory will be moved. You
36 can even use wildcards if you like. It is an error to list files here unless
37 you use -p, -i, or -a to tell dh_movefiles which subpackage to put them in.
38 .SH NOTES
39 Note that files are always moved out of debian/tmp by default (even if you
40 have instructed debhelper to use a compatability level higher than one,
41 which does not otherwise use debian/tmp for anything at all). The idea
42 behind this is that the package that is being built can be told to install
43 into debian/tmp, and then files can be moved by dh_movefiles from that
44 directory. Any files or directories that remain are ignored, and get
45 deleted by dh_clean later.
46 .SH ENVIRONMENT
47 See
48 .BR debhelper (1)
49 for a list of environment variables that affect all debhelper commands.
50 .SH "SEE ALSO"
51 .BR debhelper (1)
52 .SH AUTHOR
53 Joey Hess <joeyh@debian.org>