NAME

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

VERSION

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

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'.

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.