NAME

       Debian::LicenseReconcile::CopyrightDatum - copyright data as an object

VERSION

       Version 0.4

DESCRIPTION

       This module conceives of copyright data as a mapping from strings (the individual
       copyright holders) to sets of years.

       Copyright data can be compared. Datum "A" is contained in Datum "B" if for every key "k"
       in "A", "A{k}" is contained in "B{l}", where "l" is the key in "B" that most closely
       matches "k". When matching strings they are paired off in a 1-1 manner.

SYNOPSIS

           use Debian::LicenseReconcile::CopyrightDatum;

           my $copyright = Debian::LicenseReconcile::CopyrightDatum->new($text);

           my $explanation = "";
           if (not $copyright->contains($copyright2, \$explanation)) {
               warn $explanation;
           }

SUBROUTINES/METHODS

   new
       This constructor parses a copyright string.

   contains
       This method returns a boolean indicating whether the object contains the argument.  The
       method will respect the argument if it is a Debian::LicenseReconcile::CopyrightDatum and
       otherwise stringify and parse it.  It may also take an optional reference. If this is set
       on failing to veryify containment the reason found will be placed in that reference.

   copyright_holders
       This method returns the list of copyright holders parsed from the original string.

   years
       Given an exactly matching copyright holder this returns the set of years as an
       Set::IntSpan object.

   as_hash
       Returns a hash reference of the objects data.

AUTHOR

       Nicholas Bamber, "<nicholas at periapt.co.uk>"

LICENSE AND COPYRIGHT

       Copyright 2012 Nicholas Bamber "<nicholas at periapt.co.uk>".

       This program is free software; you can redistribute it and/or modify it under the terms of
       either: the GNU General Public License as published by the Free Software Foundation; or
       the Artistic License.

       See http://dev.perl.org/licenses/ for more information.

perl v5.18.1                                2013-10-Debian::LicenseReconcile::CopyrightDatum(3pm)