NAME

       install-xpi - installs a xpi file into a Debian package

SYNOPSIS

       install-xpi [options] xpi-file

DESCRIPTION

       install-xpi  is  a  helper  tool  for  packaging  XUL extensions. It installs the given xpi file into the
       correct directory and creates the required links based on the data in the install.rdf file.  It  corrects
       the file permissions unless --preserve-permissions is specified.

       install-xpi  will  create  a  configuration  file  in  /etc  if  the  XUL  extension provides one or more
       preferences files in defaults/preferences. The configuration file contains only a  description  where  to
       find  the overridable preferences.  debian/package.js is used as configuration file instead if it exists.
       The placeholder @INSTALLDIR@ is replaces by the  actual  installation  directory.  You  can  disable  the
       creation of a system configuration file with --disable-system-prefs.

OPTIONS

       --disable-system-prefs
              Do not create a system preference file in /etc.

       -x file, --exclude=file
              The  specified  file  from  the xpi file will not be installed. You can use this parameter several
              times.

       -h, --help
              Display a brief help message.

       -i directory, --install-dir=directory
              The xpi file will be installed in the specified directory.  directory must be  an  absolute  path.
              Use this parameter with care.

       -l directory, --link=directory
              An  additional  link  from  the  directory  to the installation directory of the extension will be
              created. You can use this parameter several times.

       -p package, --package=package
              The xpi file will be installed in the specified binary package. If this parameter is not provided,
              the first binary package listed in debian/control will be used.

       --preserve-permissions
              The  permissions  of  the  files  in  the  xpi file will not be modified. If this parameter is not
              provided, install-xpi will try to correct the permissions of the files to 644 (files  that  starts
              with a shebang will be corrected to 755).

       -r, --remove-license-files
              Files with names like copying, licence, or license will not be installed.

       -v, --verbose
              Print more information.

AUTHOR

       Benjamin Drung <bdrung@debian.org>