---
name: "Debian::Copyright::Stanza::OrSeparated"
section: "3pm"
platform: "linux"
package: "libdebian-copyright-perl"
version: "0.2-6"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Debian::Copyright::Stanza::OrSeparated"
---

# Debian::Copyright::Stanza::OrSeparated(3pm)

'or' separated field abstraction

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