debian man page for debian::control::stanza::commaseparated

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)