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

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

NAME

       Debian::Control::Stanza::CommaSeparated - comma separated debian/control field abstraction

SYNOPSYS

	   my $f = Debian::Control::Stanza::CommaSeparated->new(
	       'Joe M <joem@there.not>');
	   $f->add('"Smith, Agent" <asmith@hasyou.not>, Joe M <joem@there.not>');
	   print $f->as_string;
	       # 'Joe M <joem@there.not>, "Smith, Agent" <asmith@hasyou.not>'
	   print "$f";	   # the same
	   $f->sort;

DESCRIPTION

       Debian::Control::Stanza::CommaSeparated abstracts handling of comma-separated list of values, often found in debian/control file fields
       like Uploaders.	Note that the various dependency fields in debian/control also use comma-separated values, but the Debian::Dependencies
       class is more suitable for these as it is for example also capable of finding overlapping dependency declarations.

CONSTRUCTOR

       new (initial values)
	   The initial values list is parsed and may contain strings that are in fact comma-separated lists. These are split appropriately using
	   Text::ParseWords' quotewords routine.

METHODS

       as_string
	   Returns text representation of the list. A simple join of the elements by ", ".

	   The same function is used for overloading the stringification operation.

       add @items
	   Adds the ginen items to the list. Items that are already present are not added, keeping the list unique.

       sort
	   A handy method for sorting the list.

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

Debian::Copyright::Stanza(3pm)				User Contributed Perl Documentation			    Debian::Copyright::Stanza(3pm)

NAME

       Debian::Copyright::Stanza - single stanza of Debian copyright file

VERSION

       This document describes Debian::Copyright::Stanza version 0.1 .

SYNOPSIS

	   package Header;
	   use base 'Debian::Copyright::Stanza';
	   use constant fields => qw(
	       Format_Specification
	       Name
	       Source
	       Maintainer
	       X_Comment
	   );

	   1;

DESCRIPTION

       Debian::Copyright::Stanza is the base class for Debian::Copyright::Stanza::Header, Debian::Copyright::Stanza::Files and
       Debian::Copyright::Stanza::License classes.

FIELDS

       Stanza fields are to be defined in the class method fields. Typically this can be done like:

	   use constant fields => qw( Foo Bar Baz );

       Fields that are to contain dependency lists (as per "is_dependency_list" method below) are automatically converted to instances of the
       Debian::Dependencies class.

CONSTRUCTOR

   new( { field => value, ... } )
       Creates a new Debian::Copyright::Stanza object and optionally initialises it with the supplied data. The object is hashref based and tied
       to Tie::IxHash.

       You may use dashes for initial field names, but these will be converted to underscores:

	   my $s = Debian::Copyright::Stanza::Header( {Name => "Blah"} );
	   print $s->Name;

METHODS

   is_or_separated($field)
       Returns true if the given field is to contain a 'or'-separated list of values.  This is used in stringification, when considering where to
       wrap long lines.

   get($field)
       Overrides the default get method from Class::Accessor with Tie::IxHash's FETCH.

   set( $field, $value )
       Overrides the default set method from Class::Accessor with Tie::IxHash's STORE.

   as_string([$width])
       Returns a string representation of the object. Ready to be printed into a real debian/copyright file. Used as a stringification operator.

COPYRIGHT &; LICENSE
       Copyright (C) 2011 Nicholas Bamber <nicholas@periapt.co.uk>

       This module is substantially based upon Debian::Control::Stanza.  Copyright (C) 2009 Damyan Ivanov dmn@debian.org [Portions]

       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.12.4							    2011-08-27					    Debian::Copyright::Stanza(3pm)