NAME

       Debian::Copyright::Stanza::OrSeparated - 'or' separated field abstraction

VERSION

       This document describes Debian::Copyright::Stanza::OrSeparated version 0.2 .

SYNOPSIS

           my $f = Debian::Copyright::Stanza::OrSeparated->new('Artistic');
           $f->add('GPL-1+ or BSD');
           print $f->as_string;
               # 'Artistic or GPL-1+ or BSD'
           print "$f";     # the same
           $f->sort;

DESCRIPTION

       Debian::Copyright::Stanza::OrSeparated abstracts handling of the License fields in Files
       blocks, which are lists separated by 'or'. It also supports a body field representing the
       optional extended description of a License field.

CONSTRUCTOR

   new (initial values)
       The initial values list is parsed and may contain strings that are in fact 'or'-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 " or ". The same
       function is used for overloading the stringification operation.

   equals
       Natural implementation of the equality function.

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

   sort
       A handy method for sorting the list.

COPYRIGHT & LICENSE

       Copyright (C) 2011-12 Nicholas Bamber nicholas@periapt.co.uk

       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.