debian::control::stanza::source(3pm) [debian man page]

Debian::Control::Stanza::Source(3pm)			User Contributed Perl Documentation		      Debian::Control::Stanza::Source(3pm)

NAME

       Debian::Control::Stanza::Source - source stanza of Debian source package control file

SYNOPSIS

	   my $src = Debian::Control::Stanza::Source->new(\%data);
	   print $src;			       # auto-stringification
	   print $src->Build_Depends;	       # Debian::Dependencies object

DESCRIPTION

       Debian::Control::Stanza::Source can be used for representation and manipulation of "Source:" stanza of Debian source package control files
       in an object-oriented way. Converts itself to a textual representation in string context.

FIELDS

       The supported fields for source stanzas are listed below. For more information about each field's meaning, consult the section named
       "Source package control files -- debian/control" of the Debian Policy Manual at http://www.debian.org/doc/debian-policy/
       <http://www.debian.org/doc/debian-policy/>

       Note that real control fields may contain dashes in their names. These are replaced with underscores.

       Source
       Section
       Priority
       Maintainer
       Uploaders
       DM_Upload_Allowed
       Build_Conflicts
       Build_Conflicts_Indep
       Build_Depends
       Build_Depends_Indep
       Standards_Version
       Vcs_Browser
       Vcs_Bzr
       Vcs_CVS
       Vcs_Git
       Vcs_Svn
       Homepage
       XS_Autobuild

       All Build_... fields are converted into objects of Debian::Dependencies class upon construction.

CONSTRUCTOR

       new
       new( { field => value, ... } )
	   Creates a new Debian::Control::Stanza::Source object and optionally initializes it with the supplied data.

SEE ALSO

       Debian::Control::Stanza::Source inherits most of its functionality from Debian::Control::Stanza

COPYRIGHT &; LICENSE
       Copyright (C) 2009 Damyan Ivanov dmn@debian.org

       This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as
       published by the Free Software Foundation.

       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.

perl v5.14.2							    2012-01-15				      Debian::Control::Stanza::Source(3pm)

Debian::Control(3pm)					User Contributed Perl Documentation				      Debian::Control(3pm)

NAME

       Debian::Control - manage Debian source package control files

SYNOPSIS

	   my $c = Debian::Control->new();	   # construct a new
	   $c->read($file);			   # parse debian/control file
	   $c->write($file);			   # write to file
	   print $c->source->Source;
	   print $c->source->Build_Depends;	   # Debian::Dependencies object
	   $c->binary->{'libfoo-perl'}->Description(
	       "Foo Perl module
" .
	       " Foo makes this and that"
	   );

DESCRIPTION

       Debian::Control can be used for representation and manipulation of Debian source package control files in an object-oriented way. It
       provides easy reading and writing of the debian/control file found in Debian source packages.

FIELDS

       source
	   An instance of Debian::Control::Stanza::Source class. Contains the source stanza of the Debian source package control file.

       binary
	   A hash reference (actually Tie::IxHash instance) with keys being binary package names and values instances of
	   Debian::Control::Stanza::Binary class.  Contains the information of the binary package stanzas of Debian source package control file.

CONSTRUCTOR

       new Constructs a new Debian::Control instance.

	   The "source" field is initialized with an empty instance of Debian::Control::Stanza::Source and "binary" field is initialized with an
	   empty instance of Tie::IxHash.

METHODS

       read file
	   Parse "control" in debian and populate "source" and "binary" accessors.

	   file can be either a file name, an opened file handle or a string scalar reference.

       write file
	   Writes a debian/control-like file in file with the contents defined in the "source" and "binary" fields.

	   file can be either a file name, an opened file handle or a string scalar reference.

	   All dependency lists are sorted before writing.

       is_arch_dep
	   Returns true if the package is architecture-dependent. This is determined by the "Architecture" field of the first binary package. If
	   it equals to "all", then the package is architecture-independent; otherwise it is architecture-dependent.

	   Returns undef if it is not possible to determine whether the package is architecture-dependent or not. This is the case when there are
	   no binary package stanzas present or the first has no "Archiitecture" field.

SEE ALSO

       Debian::Control::Stanza::Source, Debian::Control::Stanza::Binary, Debian::Control::FromCPAN

COPYRIGHT &; LICENSE
       Copyright (C) 2009 Damyan Ivanov dmn@debian.org

       This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as
       published by the Free Software Foundation.

       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.

perl v5.14.2							    2012-01-15						      Debian::Control(3pm)