| Index: third_party/dpkg-dev/scripts/Dpkg/Control.pm
 | 
| diff --git a/third_party/dpkg-dev/scripts/Dpkg/Control.pm b/third_party/dpkg-dev/scripts/Dpkg/Control.pm
 | 
| new file mode 100644
 | 
| index 0000000000000000000000000000000000000000..fae49d924b9077349db1fe94e4c1a0ea193e9500
 | 
| --- /dev/null
 | 
| +++ b/third_party/dpkg-dev/scripts/Dpkg/Control.pm
 | 
| @@ -0,0 +1,200 @@
 | 
| +# Copyright © 2007-2009 Raphaël Hertzog <hertzog@debian.org>
 | 
| +#
 | 
| +# This program is free software; you can redistribute it and/or modify
 | 
| +# it under the terms of the GNU General Public License as published by
 | 
| +# the Free Software Foundation; either version 2 of the License, or
 | 
| +# (at your option) any later version.
 | 
| +#
 | 
| +# This program is distributed in the hope that it will be useful,
 | 
| +# but WITHOUT ANY WARRANTY; without even the implied warranty of
 | 
| +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | 
| +# GNU General Public License for more details.
 | 
| +#
 | 
| +# You should have received a copy of the GNU General Public License
 | 
| +# along with this program.  If not, see <https://www.gnu.org/licenses/>.
 | 
| +
 | 
| +package Dpkg::Control;
 | 
| +
 | 
| +use strict;
 | 
| +use warnings;
 | 
| +
 | 
| +our $VERSION = '1.00';
 | 
| +
 | 
| +use Dpkg::Gettext;
 | 
| +use Dpkg::ErrorHandling;
 | 
| +use Dpkg::Control::Types;
 | 
| +use Dpkg::Control::Hash;
 | 
| +use Dpkg::Control::Fields;
 | 
| +
 | 
| +use Exporter qw(import);
 | 
| +
 | 
| +use parent qw(Dpkg::Control::Hash);
 | 
| +
 | 
| +our @EXPORT = qw(CTRL_UNKNOWN CTRL_INFO_SRC CTRL_INFO_PKG CTRL_INDEX_SRC
 | 
| +                 CTRL_INDEX_PKG CTRL_PKG_SRC CTRL_PKG_DEB CTRL_FILE_CHANGES
 | 
| +                 CTRL_FILE_VENDOR CTRL_FILE_STATUS CTRL_CHANGELOG);
 | 
| +
 | 
| +=encoding utf8
 | 
| +
 | 
| +=head1 NAME
 | 
| +
 | 
| +Dpkg::Control - parse and manipulate official control-like information
 | 
| +
 | 
| +=head1 DESCRIPTION
 | 
| +
 | 
| +The Dpkg::Control object is a smart version of Dpkg::Control::Hash.
 | 
| +It associates a type to the control information. That type can be
 | 
| +used to know what fields are allowed and in what order they must be
 | 
| +output.
 | 
| +
 | 
| +The types are constants that are exported by default. Here's the full
 | 
| +list:
 | 
| +
 | 
| +=over 4
 | 
| +
 | 
| +=item CTRL_UNKNOWN
 | 
| +
 | 
| +This type is the default type, it indicates that the type of control
 | 
| +information is not yet known.
 | 
| +
 | 
| +=item CTRL_INFO_SRC
 | 
| +
 | 
| +Corresponds to the first block of information in a F<debian/control> file in
 | 
| +a Debian source package.
 | 
| +
 | 
| +=item CTRL_INFO_PKG
 | 
| +
 | 
| +Corresponds to subsequent blocks of information in a F<debian/control> file
 | 
| +in a Debian source package.
 | 
| +
 | 
| +=item CTRL_INDEX_SRC
 | 
| +
 | 
| +Corresponds to an entry in a F<Sources> file of a source package
 | 
| +repository.
 | 
| +
 | 
| +=item CTRL_INDEX_PKG
 | 
| +
 | 
| +Corresponds to an entry in a F<Packages> file of a binary package
 | 
| +repository.
 | 
| +
 | 
| +=item CTRL_PKG_SRC
 | 
| +
 | 
| +Corresponds to a .dsc file of a Debian source package.
 | 
| +
 | 
| +=item CTRL_PKG_DEB
 | 
| +
 | 
| +Corresponds to the F<control> file generated by dpkg-gencontrol
 | 
| +(F<DEBIAN/control>) and to the same file inside .deb packages.
 | 
| +
 | 
| +=item CTRL_FILE_CHANGES
 | 
| +
 | 
| +Corresponds to a .changes file.
 | 
| +
 | 
| +=item CTRL_FILE_VENDOR
 | 
| +
 | 
| +Corresponds to a vendor file in $Dpkg::CONFDIR/origins/.
 | 
| +
 | 
| +=item CTRL_FILE_STATUS
 | 
| +
 | 
| +Corresponds to an entry in dpkg's F<status> file ($Dpkg::ADMINDIR/status).
 | 
| +
 | 
| +=item CTRL_CHANGELOG
 | 
| +
 | 
| +Corresponds to the output of dpkg-parsechangelog.
 | 
| +
 | 
| +=back
 | 
| +
 | 
| +=head1 FUNCTIONS
 | 
| +
 | 
| +All the methods of Dpkg::Control::Hash are available. Those listed below
 | 
| +are either new or overridden with a different behaviour.
 | 
| +
 | 
| +=over 4
 | 
| +
 | 
| +=item my $c = Dpkg::Control->new(%opts)
 | 
| +
 | 
| +If the "type" option is given, it's used to setup default values
 | 
| +for other options. See set_options() for more details.
 | 
| +
 | 
| +=cut
 | 
| +
 | 
| +sub new {
 | 
| +    my ($this, %opts) = @_;
 | 
| +    my $class = ref($this) || $this;
 | 
| +
 | 
| +    my $self = Dpkg::Control::Hash->new();
 | 
| +    bless $self, $class;
 | 
| +    $self->set_options(%opts);
 | 
| +
 | 
| +    return $self;
 | 
| +}
 | 
| +
 | 
| +=item $c->set_options(%opts)
 | 
| +
 | 
| +Changes the value of one or more options. If the "type" option is changed,
 | 
| +it is used first to define default values for others options. The option
 | 
| +"allow_pgp" is set to 1 for CTRL_PKG_SRC and CTRL_FILE_CHANGES and to 0
 | 
| +otherwise. The option "drop_empty" is set to 0 for CTRL_INFO_PKG and
 | 
| +CTRL_INFO_SRC and to 1 otherwise. The option "name" is set to a textual
 | 
| +description of the type of control information.
 | 
| +
 | 
| +The output order is also set to match the ordered list returned by
 | 
| +Dpkg::Control::Fields::field_ordered_list($type).
 | 
| +
 | 
| +=cut
 | 
| +
 | 
| +sub set_options {
 | 
| +    my ($self, %opts) = @_;
 | 
| +    if (exists $opts{type}) {
 | 
| +        my $t = $opts{type};
 | 
| +        $$self->{allow_pgp} = ($t & (CTRL_PKG_SRC | CTRL_FILE_CHANGES)) ? 1 : 0;
 | 
| +        $$self->{drop_empty} = ($t & (CTRL_INFO_PKG | CTRL_INFO_SRC)) ?  0 : 1;
 | 
| +        if ($t == CTRL_INFO_SRC) {
 | 
| +            $$self->{name} = _g('general section of control info file');
 | 
| +        } elsif ($t == CTRL_INFO_PKG) {
 | 
| +            $$self->{name} = _g("package's section of control info file");
 | 
| +        } elsif ($t == CTRL_CHANGELOG) {
 | 
| +            $$self->{name} = _g('parsed version of changelog');
 | 
| +        } elsif ($t == CTRL_INDEX_SRC) {
 | 
| +            $$self->{name} = sprintf(_g("entry in repository's %s file"), 'Sources');
 | 
| +        } elsif ($t == CTRL_INDEX_PKG) {
 | 
| +            $$self->{name} = sprintf(_g("entry in repository's %s file"), 'Packages');
 | 
| +        } elsif ($t == CTRL_PKG_SRC) {
 | 
| +            $$self->{name} = sprintf(_g('%s file'), '.dsc');
 | 
| +        } elsif ($t == CTRL_PKG_DEB) {
 | 
| +            $$self->{name} = _g('control info of a .deb package');
 | 
| +        } elsif ($t == CTRL_FILE_CHANGES) {
 | 
| +            $$self->{name} = sprintf(_g('%s file'), '.changes');
 | 
| +        } elsif ($t == CTRL_FILE_VENDOR) {
 | 
| +            $$self->{name} = _g('vendor file');
 | 
| +        } elsif ($t == CTRL_FILE_STATUS) {
 | 
| +            $$self->{name} = _g("entry in dpkg's status file");
 | 
| +        }
 | 
| +        $self->set_output_order(field_ordered_list($opts{type}));
 | 
| +    }
 | 
| +
 | 
| +    # Options set by the user override default values
 | 
| +    $$self->{$_} = $opts{$_} foreach keys %opts;
 | 
| +}
 | 
| +
 | 
| +=item $c->get_type()
 | 
| +
 | 
| +Returns the type of control information stored. See the type parameter
 | 
| +set during new().
 | 
| +
 | 
| +=cut
 | 
| +
 | 
| +sub get_type {
 | 
| +    my ($self) = @_;
 | 
| +    return $$self->{type};
 | 
| +}
 | 
| +
 | 
| +=back
 | 
| +
 | 
| +=head1 AUTHOR
 | 
| +
 | 
| +Raphaël Hertzog <hertzog@debian.org>.
 | 
| +
 | 
| +=cut
 | 
| +
 | 
| +1;
 | 
| 
 |