.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
.\"
.\" 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" ''
.    ds C`
.    ds C'
'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.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" 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 "UMEGAYA-ADM 1"
.TH UMEGAYA-ADM 1 "2014-06-01" "perl v5.18.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"
umegaya\-adm \- A tool to administrate the Umegaya database.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBumegaya-adm\fR \fB\-p\fR package \fB\-k\fR key \fB\-v\fR value [\fB\-\-delete] [\fB\-\-verbose\fB]\fR
.PP
\&\fBumegaya-adm\fR \fB\-h\fR, \fB\-\-help\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\f(CW\*(C`umegaya\-adm\*(C'\fR interrogates or modifies the Berkeley database in which
the gathered metadata is stored. If a combination of package, key and
value is given, it will set the value. Otherwise it will give
appropriate information using the of package or key provided as
argument.
.PP
For example:
.PP
.Vb 10
\&    $ umegaya\-adm \-p package \-k key \-v value
\&    $ umegaya\-adm \-p package \-k key 
\&    value
\&    $ umegaya\-adm \-p package \-k key2 \-v value2
\&    $ umegaya\-adm \-p package \-k key2
\&    value2
\&    $ umegaya\-adm \-p package
\&    key value
\&    key2    value2
\&    $ umegaya\-adm \-p package2 \-k key \-v value3
\&    $ umegaya\-adm \-k key
\&    package value
\&    package2    value3
\&    $ umegaya\-adm \-p package2 \-k key \-\-delete
\&    $ umegaya\-adm \-k key
\&    package value
.Ve
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-d\fR, \fB\-\-delete\fR" 8
.IX Item "-d, --delete"
In combination with \fB\-\-key\fR or \fB\-\-package\fR, delete the value(s) instead of
displaying them.
.IP "\fB\-\-list\-entries\fR, \fB\-\-show\-entry\fR, \fB\-\-delete\-entry\fR" 8
.IX Item "--list-entries, --show-entry, --delete-entry"
List all the entries, or show or delete one entry of the Umegaya database.
These entries are package names joined to a Umegaya key by a colon.  Examples:
Xumegaya:NameX, Xumegaya:YAML\-URLX.
.IP "\fB\-k\fR, \fB\-\-key\fR" 8
.IX Item "-k, --key"
If set alone, \f(CW\*(C`umegaya\-adm\*(C'\fR will display all the package-values pairs for the
given key. If set together with \fB\-\-package\fR, \f(CW\*(C`umegaya\-adm\*(C'\fR will display the
corresponding value.
.IP "\fB\-p\fR, \fB\-\-package\fR" 8
.IX Item "-p, --package"
If set alone, \f(CW\*(C`umegaya\-adm\*(C'\fR will display all the key-values pairs for the given
package. If set together with \fB\-\-key\fR, \f(CW\*(C`umegaya\-adm\*(C'\fR will display the
corresponding value.
.IP "\fB\-\-purge\fR" 8
.IX Item "--purge"
Deletes the umegaya database without asking for confirmation.
.IP "\fB\-v\fR, \fB\-\-value\fR" 8
.IX Item "-v, --value"
When this option is set together with \fB\-\-key\fR and \fB\-\-package\fR, \f(CW\*(C`umegaya\-adm\*(C'\fR
sets the given value for the given key of the given package.
.IP "\fB\-\-verbose\fR" 8
.IX Item "--verbose"
Returns the set value to the standard output when used in conjunction with
\&\fB\-\-key\fR, \fB\-\-package\fR, and \fB\-\-value\fR.
.SH "ADVANCED USAGE"
.IX Header "ADVANCED USAGE"
use \f(CW\*(C`umegaya\-adm\*(C'\fR to set special keys for the packages.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIumegaya\fR\|(7), \fIupstream\-metadata.debian.net\fR\|(7)
.SH "AUTHOR"
.IX Header "AUTHOR"
Charles Plessy <plessy@debian.org>
.SH "LICENCE"
.IX Header "LICENCE"
.Vb 2
\&    BOLA \- Buena Onda License Agreement (v1.1)
\&    \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
\&    
\&    This work is provided \*(Aqas\-is\*(Aq, without any express or implied warranty. In no
\&    event will the authors be held liable for any damages arising from the use of
\&    this work.
\&    
\&    To all effects and purposes, this work is to be considered Public Domain.
\&    
\&    
\&    However, if you want to be "buena onda", you should:
\&    
\&    1. Not take credit for it, and give proper recognition to the authors.
\&    2. Share your modifications, so everybody benefits from them.
\&    3. Do something nice for the authors.
\&    4. Help someone who needs it: sign up for some volunteer work or help your
\&       neighbour paint the house.
\&    5. Don\*(Aqt waste. Anything, but specially energy that comes from natural
\&       non\-renewable resources. Extra points if you discover or invent something
\&       to replace them.
\&    6. Be tolerant. Everything that\*(Aqs good in nature comes from cooperation.
.Ve
.SH "SOURCE"
.IX Header "SOURCE"
http://anonscm.debian.org/gitweb/?p=collab\-maint/umegaya.git;a=blob;f=scripts/umegaya\-adm
.SH "POD ERRORS"
.IX Header "POD ERRORS"
Hey! \fBThe above document had some coding errors, which are explained below:\fR
.IP "Around line 9:" 4
.IX Item "Around line 9:"
Unterminated B<...> sequence
.IP "Around line 73:" 4
.IX Item "Around line 73:"
Non-ASCII character seen before =encoding in 'Xumegaya:NameX,'. Assuming \s-1UTF\-8\s0