debian man page for emvendor

EMVENDOR(1)						User Contributed Perl Documentation					       EMVENDOR(1)

Name
       emvendor - retrieve vendor-specific package configuration strings

Synopsis
	emvendor -V|--vendor VENDOR -p|--package PACKAGE -k|--key KEY
	emvendor -?|-h|--help|--version

Commands
	-v|--vendor VENDOR:    the vendor name from dpkg-vendor
	-p|--package PACKAGE:  the package name (usually source)
	-k|--key KEY:	       arbitrary string for the key of the data

       All commands must be specified every time.

       On success, the string is printed and emvendor exits with zero.

       In the case of error, emvendor dies with an empty string on STDERR and exits with a non-zero return value.

Description
       emvendor provides a way for debian/rules to call in a string for a particular package that fits into the rules for that package and
       conforms to the requirements of the vendor.

       http://wiki.debian.org/EmdebianAuditDetail#Vendor

       It is fairly obvious that specifying each vendor in the debian/rules file of each package is not going to be particularly flexible.

	DEB_VENDOR=$(shell dpkg-vendor --query vendor)
	ifeq (Debian,$(DEB_VENDOR))
	 # Debian build
	 EXCONFARGS=--disable-mono --disable-monodoc
	else
	 # any-vendor build
	 EXCONFARGS=$(shell emvendor --vendor $(DEB_VENDOR) --package avahi --key EXCONFARGS)
	endif

       or use the short options:

	EXCONFARGS=$(shell foo-bar -V $(DEB_VENDOR) -p avahi -k EXCONFARGS)

       The values themselves are in a vendor-specific conf file in /etc/emvendor.d/

	$ cat /etc/foo-bar.d/emdebian-crush
	[avahi]
	EXCONFARGS=--disable-mono --disable-monodoc --disable-python
	--disable-doxygen-doc --disable-pygtk --disable-python-dbus
	--disable-core-docs --disable-qt3 --disable-qt4 --disable-gobject
	--with-distro debian

	[busybox]
	foo=

       (Note that the value has to be all on one line which is a little awkward - also note that values are not able to include the equals sign
       which could be more of an issue.)

       Packages that need two strings can do so - the key string is entirely arbitrary as long as it fits in the style of a typical ini file.

       Therefore, the key can be matched to the needs of the relevant package.

       "emdebian-buildsupport" provides /etc/emvendor.d/emdebian-crush with all the content for all packages that need such details.

emvendor and dpkg-vendor
       dpkg-vendor supports vendor functionality but emvendor adds an extra hierarchy, organised by Debian source package name. It would be
       possible to include the relevant strings in /etc/dpkg/origins/vendor but each identifier string would need to be unique across all packages
       for each vendor, which is an unrealistic limitation.

perl v5.14.2							    2012-09-26							       EMVENDOR(1)