NAME

       Dpkg::Control::Info - parse files like debian/control

DESCRIPTION

       It provides an object to access data of files that follow the same syntax as
       debian/control.

METHODS

       $c = Dpkg::Control::Info->new(%opts)
           Create a new Dpkg::Control::Info object. Loads the file from the filename option, if
           no option is specified filename defaults to debian/control.  If a scalar is passed
           instead, it will be used as the filename. If filename is "-", it parses the standard
           input. If filename is undef no loading will be performed.

       $c->reset()
           Resets what got read.

       $c->load($file)
           Load the content of $file. Exits in case of errors. If file is "-", it loads from the
           standard input.

       $c->parse($fh, $description)
           Parse a control file from the given filehandle. Exits in case of errors.  $description
           is used to describe the filehandle, ideally it's a filename or a description of where
           the data comes from. It is used in error messages.  The data in the object is reset
           before parsing new control files.

       $c->[0]
       $c->get_source()
           Returns a Dpkg::Control object containing the fields concerning the source package.

       $c->get_pkg_by_idx($idx)
           Returns a Dpkg::Control object containing the fields concerning the binary package
           numbered $idx (starting at 1).

       $c->get_pkg_by_name($name)
           Returns a Dpkg::Control object containing the fields concerning the binary package
           named $name.

       $c->get_packages()
           Returns a list containing the Dpkg::Control objects for all binary packages.

       $c->output($filehandle)
           Dump the content into a filehandle.

       "$c"
           Return a string representation of the content.

       @{$c}
           Return a list of Dpkg::Control objects, the first one is corresponding to source
           information and the following ones are the binary packages information.

CHANGES

   Version 1.01 (dpkg 1.18.0)
       New argument: The $c->new() constructor accepts an %opts argument.

   Version 1.00 (dpkg 1.15.6)
       Mark the module as public.