NAME
dh_installyorick - install Yorick add-on packages
SYNOPSIS
dh_installyorick [debhelper options] [-m] [--no-make-install]
DESCRIPTION
dh_installyorick is a debhelper program that installs the files of your
Yorick add-on at the right place when building a Debian package. For a
simple plug-in package, this is mostly done by calling "make
DESTDIR=debian/<package> install" and then moving arch-independent
files to usr/share. Note that there is no Y_SITE/contrib directory in
the Debian packages, its content is merged into YSITE/i.
Calling "make ... install" can be disabled by using the
"--no-make-install" flag. This is useful in particular for interpreted
add-on packages, which do not ship with a standard Yorick Makefile.
If the "-m" flag is used (but not the "-n" one), dh_installyorick will
also add lines to your package’s postinst and postrm scripts to call
"update-yorickdoc --auto" if the yorick-doc package is installed. It is
necessary to call dh_installdeb after dh_installyorick for this to
work. It is usually not necessary with a recent dpkg supporting
triggers, so this possibility is kept mostly for easing backports and
should be deprecated soon.
dh_installyorick will look for a file named debian/<package>.ynstall
for additional files to install (see YNSTALL FILE below). The prefix
"<package>." can be omitted for the main binary package being built
(usally the first one listed in debian/control).
For the time being, Y_SITE=Y_HOME=/usr/lib/yorick. Requests to install
a file under Y_SITE results in its installation under
/usr/share/yorick. dh_installyorick handles the creation of the
necessary symbolic links from Y_HOME to /usr/share/yorick.
Files that are installed in a directory ending in "/bin" or "/sbin", as
well as files that are pointed at by symbolic link in such a directory,
are installed with execution permission for everyone.
OPTIONS
-m Modify postinst/postrm scripts to add a call to update-yorickdoc.
This is needed only if the target dpkg does not support triggers.
If both "-m" and "-n" are specified, the scripts are not modified.
--no-make-install
Do not call "make DESTDIR=debian/<package> install".
--infofile=
An additional pkg_mngr .info file to install.
Additionally, dh_installyorick abides by the following standard
debhelper options: -a/--arch, -i/--indep, --mainpackage, -n, --no-act,
-N/--no-package, -p/--package, -P/--tmpdir, -s/--same-arch, and
-v/--verbose.
YNSTALL FILE
Blank lines are ignored, several blank character are counted as one,
and line starting with "#" (possibly following one or more blanks) are
ignored. Each non-comment, non-blank line should be of the form:
file [directory [link]]
Where file is the file to install, directory the directory it should be
installed in, and link an optional symbolic link pointing on the
installed file.
file
the relative path from the top directory of the package source to
the file. If link is not specified, file can contain shell globs
and actually denote sevral files. If directory is not specified, it
is guessed from the extension of file: .i files are installed in
Y_SITE/i, .gs and .gp in Y_SITE/g, .info in
Y_SITE/packages/installed, .packinfo, .aliases and .keywords in
/usr/share/yorick-doc, and .so in Y_HOME/lib.
directory
the full path (without leading "/") into which the file should be
installed. If the file is to be installed inside Yorick’s Y_SITE or
Y_HOME directory (which will almost alway be the case), it is
possible (and advisable) to not specify the full path, but to write
"Y_SITE/" or "Y_HOME" followed by the relative path from there. It
is also possible to omit this "Y_SITE/" or "Y_HOME/" prefix if
directory starts whith one of: Y_SITE/i, Y_SITE/i0, Y_SITE/i-start,
Y_SITE/g, Y_SITE/packages, Y_HOME/bin or Y_HOME/lib.
link
the full path to a symbolic link that should point to the installed
file. The same shortcuts apply as for directory.
EXAMPLES
The four following lines in debian/ynstall would be equivalent:
somefile.i /usr/share/yorick/i
somefile.i Y_SITE/i
somefile.i i
somefile.i
Likewise, the following are equivalent:
somefile.i /usr/share/yorick/i0
somefile.i Y_SITE/i0
somefile.i i0
Example with a symlink. Here, somefile.i is a script that is both
useful #included from within Yorick or from the command line. Its first
line reads "#!/usr/bin/yorick -batch".
somefile.i i usr/bin/command_name
SEE ALSO
debhelper(7), update-yorickdoc(1), deb-triggers(5)
This program is a part of yorick-dev but is made to work with
debhelper. Note that only compatibility level 5 has been implemented
and tested. This script is not idempotent, dh_clean -k should be
executed between any two runs.
AUTHORS
Thibaut Paumard <paumard@users.sourceforge.net>
2008-05-15