.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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 >0, 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
.\" ========================================================================
.\"
.IX Title "Config::Model::Dpkg::Dependency 3pm"
.TH Config::Model::Dpkg::Dependency 3pm 2024-03-03 "perl v5.38.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
Config::Model::Dpkg::Dependency \- Checks Debian dependency declarations
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 3
\& use Config::Model ;
\& use Log::Log4perl qw(:easy) ;
\& use Data::Dumper ;
\&
\& Log::Log4perl\->easy_init($WARN);
\&
\& # define configuration tree object
\& my $model = Config::Model\->new ;
\& $model \->create_config_class (
\&    name => "MyClass",
\&    element => [
\&        Depends => {
\&            \*(Aqtype\*(Aq       => \*(Aqleaf\*(Aq,
\&            \*(Aqvalue_type\*(Aq => \*(Aquniline\*(Aq,
\&            class => \*(AqConfig::Model::Dpkg::Dependency\*(Aq,
\&        },
\&    ],
\& ) ;
\&
\& my $inst = $model\->instance(root_class_name => \*(AqMyClass\*(Aq );
\&
\& my $root = $inst\->config_root ;
\&
\& $root\->load( \*(AqDepends="libc6 ( >= 1.0 )"\*(Aq) ;
\& # Connecting to qa.debian.org to check libc6 versions. Please wait ...
\& # Warning in \*(AqDepends\*(Aq value \*(Aqlibc6 ( >= 1.0 )\*(Aq: unnecessary
\& # versioned dependency: >= 1.0. Debian has lenny\-security \->
\& # 2.7\-18lenny6; lenny \-> 2.7\-18lenny7; squeeze\-security \->
\& # 2.11.2\-6+squeeze1; squeeze \-> 2.11.2\-10; wheezy \-> 2.11.2\-10; sid
\& # \-> 2.11.2\-10; sid \-> 2.11.2\-11;
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This class is derived from Config::Model::Value. Its purpose is to
check the value of a Debian package dependency for the following:
.IP \(bu 4
syntax as described in http://www.debian.org/doc/debian\-policy/ch\-relationships.html
.IP \(bu 4
Whether the version specified with \f(CW\*(C`>\*(C'\fR or \f(CW\*(C`>=\*(C'\fR is necessary.
This module checks with Debian server whether older versions can be
found in Debian old-stable or not. If no older version can be found, a
warning is issued (unless the package is known or calculated to be virtual)
.IP \(bu 4
Whether a Perl library is dual life. In this case the dependency is checked according to
Debian Perl policy <http://pkg-perl.alioth.debian.org/policy.html#debian_control_handling>.
Because Debian auto-build systems (buildd) will use the first available alternative,
the dependency should be in the form :
.RS 4
.IP \(bu 4
\&\f(CW\*(C`perl (>= 5.10.1) | libtest\-simple\-perl (>= 0.88)\*(C'\fR when
the required perl version is available in sid. ".
.IP \(bu 4
\&\f(CW\*(C`libcpan\-meta\-perl | perl (>= 5.13.10)\*(C'\fR when the Perl version is not available in sid
.RE
.RS 4
.RE
.SH Cache
.IX Header "Cache"
Queries to Debian server are cached in \f(CW\*(C`~/.config_model_depend_cache\*(C'\fR
for about one month.
.SH BUGS
.IX Header "BUGS"
.IP \(bu 4
Dependencies containing variables (e.g. \f(CW\*(C`${foo}\*(C'\fR) are accepted
as-is. No check are performed.
.IP \(bu 4
Virtual package names are found scanning local apt cache. Hence an unknown package
on your system may be a virtual package on another system.
.IP \(bu 4
More advanced checks can probably be implemented. The author is open to
new ideas. He's even more open to patches (with tests).
.SH AUTHOR
.IX Header "AUTHOR"
Dominique Dumont, ddumont [AT] cpan [DOT] org
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Config::Model,
Config::Model::Value,
Memoize,
Memoize::Expire