=head1 SYNOPSIS
-B<dh_install> [B<-X>I<item>] [B<--autodest>] [B<--sourcedir=>I<dir>] [S<I<debhelper options>>] [S<I<file> ... I<dest>>]
+B<dh_install> [B<-X>I<item>] [B<--autodest>] [B<--sourcedir=>I<dir>] [S<I<debhelper options>>] [S<I<file|dir> ... I<destdir>>]
=head1 DESCRIPTION
relative to the package build directory. You may use wildcards in the names of
the files to install (in v3 mode and above).
+Note that if you list exactly one filename or wildcard-pattern on a line by
+itself, with no explicit destination, then B<dh_install>
+will automatically guess the destination to use, the same as if the
+--autodest option were used.
+
=back
=head1 OPTIONS
will be copied to F<debian/package/usr/>. If the filename is
F<debian/tmp/etc/passwd>, it will be copied to F<debian/package/etc/>.
-Note that if you list exactly one filename or wildcard-pattern on a line by
-itself in a
-F<debian/package.install> file, with no explicit destination, then B<dh_install>
-will automatically guess the destination even if this flag is not set.
-
-=item I<file> ... I<dest>
+=item I<file|dir> ... I<destdir>
Lists files (or directories) to install and where to install them to.
The files will be installed into the first package F<dh_install> acts on.
}
}
-=head1 EXAMPLE
-
-Suppose your package's upstream F<Makefile> installs a binary, a man page, and
-a library into appropriate subdirectories of F<debian/tmp>. You want to put
-the library into package libfoo, and the rest into package foo. Your rules
-file will run "B<dh_install --sourcedir=debian/tmp>". Make F<debian/foo.install>
-contain:
-
- usr/bin
- usr/share/man/man1
-
-While F<debian/libfoo.install> contains:
-
- usr/lib/libfoo*.so.*
-
-If you want a libfoo-dev package too, F<debian/libfoo-dev.install> might contain:
-
- usr/include
- usr/lib/libfoo*.so
- usr/share/man/man3
-
=head1 LIMITATIONS
B<dh_install> cannot rename files or directories, it can only install them