From a1ddd5ea0f6f7eb1751f5b6f0bb884fb7c0d197c Mon Sep 17 00:00:00 2001 From: Alexander Sack Date: Mon, 25 Feb 2008 10:14:46 +0100 Subject: * document xpi.mk in README - update README * document in changelog - update debian/changelog --- README | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) (limited to 'README') diff --git a/README b/README index c0a32eb..a8f5e26 100644 --- a/README +++ b/README @@ -13,6 +13,9 @@ The package contains rules for the following projects: - thunderbird-3.0 - xulrunner-1.9 +In addition there is a xpi.mk which provides standard rules/targets to package +XPI extensions for mozilla/toolkit based applications. + === mozclient === Creates a source tarball from CVS @@ -105,3 +108,48 @@ Example of COMPARE_FILTER_IN tweak: COMPARE_FILTER_IN += \ -e 's,^usr/lib/seamonkey-2.0/extensions/{f13b157f-b174-47e7-a34d-4815ddfdfeb8}.*,,' \ $(NULL) + + +=== xpi.mk === + +targets: +--------- + install-xpi - unpack and install the contents of the .xpi file to the + package named by the MOZ_EXTENSION_PKG parameter + clean-xpi - clean build cruft from install-xpi + +parameters: +------------ + MOZ_EXTENSION_PKG - the binary package that will ship the extension + MOZ_XPI_FILE - the XPI file to unpack and install to the binary package + named by MOZ_EXTENSION_PKG. If not set, xpi.mk will use + the first |*.xpi| file found in the packages top level + directory + MOZ_XPI_EMID - use the given EMID to name the links in the applications + |extensions| directory. If not set, xpi.mk will try to + guess the right EMID by introspecting the |install.rdf| + shipped by the XPI + MOZ_XPI_BUILD_COMMAND + - use the given command _before_ running the normal + |install-xpi| procedure. This parameter is useful for all + those extension sources that have a command/make target + to produce a XPI. + MOZ_XPI_MOZILLA_DIRS + - link the extension to the global |extensions| directory + of the given MOZILLAs. The default value is |firefox| and + |firefox-addons|, which will link the extension to the + /usr/lib/firefox/extensions and /usr/lib/firefox-addons/extensions + directories, respectively. + +cdbs: +------ + If you are using cdbs (debhelper.mk) xpi.mk hooks in appropriately. + cdbs targets to build the packages without any rule. The only thing required + is to include the debhelper.mk from cdbs _before_ including xpi.mk. + + +examples: +---------- + A template is available in the branch available under the following URL: + https://code.launchpad.net/~mozillateam/firefox-extensions/XPI.TEMPLATE + -- cgit v1.2.3