.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "EMVENDOR 1"
.TH EMVENDOR 1 "2012-09-26" "perl v5.14.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "Name"
.IX Header "Name"
emvendor \- retrieve vendor-specific package configuration strings
.SH "Synopsis"
.IX Header "Synopsis"
.Vb 2
\& emvendor \-V|\-\-vendor VENDOR \-p|\-\-package PACKAGE \-k|\-\-key KEY
\& emvendor \-?|\-h|\-\-help|\-\-version
.Ve
.SH "Commands"
.IX Header "Commands"
.Vb 3
\& \-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
.Ve
.PP
All commands must be specified every time.
.PP
On success, the string is printed and emvendor exits with zero.
.PP
In the case of error, emvendor dies with an empty string on \s-1STDERR\s0
and exits with a non-zero return value.
.SH "Description"
.IX Header "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 \fBand\fR
conforms to the requirements of the vendor.
.PP
http://wiki.debian.org/EmdebianAuditDetail#Vendor
.PP
It is fairly obvious that specifying each vendor in the \fIdebian/rules\fR
file of each package is not going to be particularly flexible.
.PP
.Vb 8
\& 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
.Ve
.PP
or use the short options:
.PP
.Vb 1
\& EXCONFARGS=$(shell foo\-bar \-V $(DEB_VENDOR) \-p avahi \-k EXCONFARGS)
.Ve
.PP
The values themselves are in a vendor-specific conf file in
\&\fI/etc/emvendor.d/\fR
.PP
.Vb 6
\& $ 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=
.Ve
.PP
(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.)
.PP
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.
.PP
Therefore, the key can be matched to the needs of the relevant package.
.PP
\&\f(CW\*(C`emdebian\-buildsupport\*(C'\fR provides \fI/etc/emvendor.d/emdebian\-crush\fR with
all the content for all packages that need such details.
.SH "emvendor and dpkg-vendor"
.IX Header "emvendor and dpkg-vendor"
\&\fIdpkg-vendor\fR supports vendor functionality but \fIemvendor\fR adds an
extra hierarchy, organised by Debian source package name. It would be
possible to include the relevant strings in \fI/etc/dpkg/origins/vendor\fR
but each identifier string would need to be unique across all packages
for each vendor, which is an unrealistic limitation.