install-xpi (1)

Leading comments

Copyright (c) 2010-2011 Benjamin Drung <bdrung@debian.org>

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIR...

(The comments found at the beginning of the groff file "man1/install-xpi.1".)

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>