Nicholas Bamber > Debian-Copyright-0.2 > Debian::Copyright::Stanza::OrSeparated

Download:
Debian-Copyright-0.2.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.2   Source  

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.

syntax highlighting: