DH_INSTALLYORICK(1)						     Debhelper						       DH_INSTALLYORICK(1)

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 pack-
       ages, 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 direc-
       tory, 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						       DH_INSTALLYORICK(1)