---
name: "Debian::Copyright::Stanza"
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"
---

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

single stanza of Debian copyright file

## NAME

Debian::Copyright::Stanza - single stanza of Debian copyright file

## VERSION

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

## SYNOPSIS

```
    package Header;
    use base 'Debian::Copyright::Stanza';
    use constant fields => qw(
        Format_Specification
        Name
        Source
        Maintainer
        X_Comment
    );
    1;
```

## DESCRIPTION

Debian::Copyright::Stanza is the base class for Debian::Copyright::Stanza::Header, Debian::Copyright::Stanza::Files and Debian::Copyright::Stanza::License classes.

## FIELDS

Stanza fields are to be defined in the class method *fields*. Typically this can be done like:

```
    use constant fields => qw( Foo Bar Baz );
```

Fields that are to contain dependency lists (as per "is\_dependency\_list" method below) are automatically converted to instances of the Debian::Dependencies class.

## CONSTRUCTOR

### new( { field =\> value, ... } )

Creates a new Debian::Copyright::Stanza object and optionally initialises it with the supplied data. The object is hashref based and tied to Tie::IxHash.

You may use dashes for initial field names, but these will be converted to underscores:

```
    my $s = Debian::Copyright::Stanza::Header( {Name => "Blah"} );
    print $s->Name;
```

## METHODS

### is\_or\_separated($field)

Returns true if the given field is to contain a 'or'-separated list of values. This is used in stringification, when considering where to wrap long lines.

### get($field)

Overrides the default get method from Class::Accessor with Tie::IxHash's FETCH.

### set( $field, $value )

Overrides the default set method from Class::Accessor with Tie::IxHash's STORE.

### as\_string(\[$width\])

Returns a string representation of the object. Ready to be printed into a real *debian/copyright* file. Used as a stringification operator.

## COPYRIGHT & LICENSE

Copyright (C) 2011 Nicholas Bamber \<nicholas@periapt.co.uk\>

This module is substantially based upon Debian::Control::Stanza. Copyright (C) 2009 Damyan Ivanov dmn@debian.org \[Portions\]

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.