Codebase list libdebian-copyright-perl / 33732ba
Import upstream version 0.2+git20121121.1.2ed5865 Debian Janitor 1 year, 2 months ago
4 changed file(s) with 89 addition(s) and 66 deletion(s). Raw diff Collapse all Expand all
33 "Nicholas Bamber <nicholas@periapt.co.uk>"
44 ],
55 "dynamic_config" : 1,
6 "generated_by" : "Module::Build version 0.4001, CPAN::Meta::Converter version 2.110440",
6 "generated_by" : "Module::Build version 0.4232",
77 "license" : [
88 "gpl_1"
99 ],
1010 "meta-spec" : {
1111 "url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec",
12 "version" : "2"
12 "version" : 2
1313 },
1414 "name" : "Debian-Copyright",
1515 "prereqs" : {
1616 "build" : {
1717 "requires" : {
18 "Perl6::Slurp" : 0,
19 "Test::Deep" : 0,
20 "Test::Exception" : 0,
21 "Test::LongString" : 0,
22 "Test::More" : 0,
23 "Test::NoWarnings" : 0
18 "Perl6::Slurp" : "0",
19 "Test::Deep" : "0",
20 "Test::Exception" : "0",
21 "Test::LongString" : "0",
22 "Test::More" : "0",
23 "Test::NoWarnings" : "0"
2424 }
2525 },
2626 "configure" : {
3030 },
3131 "runtime" : {
3232 "requires" : {
33 "Array::Unique" : 0,
34 "Class::Accessor" : 0,
35 "Parse::DebControl" : 0,
36 "Tie::IxHash" : 0,
33 "Array::Unique" : "0",
34 "Class::Accessor" : "0",
35 "Parse::DebControl" : "0",
36 "Tie::IxHash" : "0",
3737 "perl" : "v5.10.1"
3838 }
3939 }
7373 "url" : "http://github.com/periapt/Debian-Copyright/tree"
7474 }
7575 },
76 "version" : "0.2"
76 "version" : "0.2",
77 "x_serialization_backend" : "JSON::PP version 4.07"
7778 }
22 author:
33 - 'Nicholas Bamber <nicholas@periapt.co.uk>'
44 build_requires:
5 Perl6::Slurp: 0
6 Test::Deep: 0
7 Test::Exception: 0
8 Test::LongString: 0
9 Test::More: 0
10 Test::NoWarnings: 0
5 Perl6::Slurp: '0'
6 Test::Deep: '0'
7 Test::Exception: '0'
8 Test::LongString: '0'
9 Test::More: '0'
10 Test::NoWarnings: '0'
1111 configure_requires:
12 Module::Build: 0.38
12 Module::Build: '0.38'
1313 dynamic_config: 1
14 generated_by: 'Module::Build version 0.4001, CPAN::Meta::Converter version 2.110440'
14 generated_by: 'Module::Build version 0.4232, CPAN::Meta::Converter version 2.150010'
1515 license: gpl
1616 meta-spec:
1717 url: http://module-build.sourceforge.net/META-spec-v1.4.html
18 version: 1.4
18 version: '1.4'
1919 name: Debian-Copyright
2020 provides:
2121 Debian::Copyright:
2222 file: lib/Debian/Copyright.pm
23 version: 0.2
23 version: '0.2'
2424 Debian::Copyright::Stanza:
2525 file: lib/Debian/Copyright/Stanza.pm
26 version: 0.2
26 version: '0.2'
2727 Debian::Copyright::Stanza::Files:
2828 file: lib/Debian/Copyright/Stanza/Files.pm
29 version: 0.2
29 version: '0.2'
3030 Debian::Copyright::Stanza::Header:
3131 file: lib/Debian/Copyright/Stanza/Header.pm
32 version: 0.2
32 version: '0.2'
3333 Debian::Copyright::Stanza::License:
3434 file: lib/Debian/Copyright/Stanza/License.pm
35 version: 0.2
35 version: '0.2'
3636 Debian::Copyright::Stanza::OrSeparated:
3737 file: lib/Debian/Copyright/Stanza/OrSeparated.pm
38 version: 0.2
38 version: '0.2'
3939 requires:
40 Array::Unique: 0
41 Class::Accessor: 0
42 Parse::DebControl: 0
43 Tie::IxHash: 0
40 Array::Unique: '0'
41 Class::Accessor: '0'
42 Parse::DebControl: '0'
43 Tie::IxHash: '0'
4444 perl: v5.10.1
4545 resources:
4646 license: http://www.gnu.org/licenses/old-licenses/gpl-1.0.txt
4747 repository: http://github.com/periapt/Debian-Copyright/tree
48 version: 0.2
48 version: '0.2'
49 x_serialization_backend: 'CPAN::Meta::YAML version 0.018'
0 # Note: this file was auto-generated by Module::Build::Compat version 0.4001
0 # Note: this file was auto-generated by Module::Build::Compat version 0.4232
11 require 5.010001;
22 use ExtUtils::MakeMaker;
33 WriteMakefile
00 NAME
1
12 Debian::Copyright - manage Debian copyright files
23
34 VERSION
5
46 This document describes Debian::Copyright version 0.2 .
57
68 SYNOPSIS
9
710 my $c = Debian::Copyright->new(); # construct a new
811 $c->read($file1); # parse debian copyright file
912 $c->read($file2); # parse a second
1013 $c->write($ofile); # write to file
1114
1215 DESCRIPTION
16
1317 Debian::Copyright can be used for the representation, manipulation and
14 merging of Debian copyright files in an object-oriented way. It provides
15 easy reading and writing of the debian/copyright file found in Debian
16 source packages. Debian has recently started standardising its copyright
17 files around the machine-readable DEP-5/Format:
18 http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
19 format.
18 merging of Debian copyright files in an object-oriented way. It
19 provides easy reading and writing of the debian/copyright file found in
20 Debian source packages. Debian has recently started standardising its
21 copyright files around the machine-readable "Format:
22 http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/" in
23 DEP-5 format.
2024
21 note on terminology
22 The term "Stanza" derives from the dh-make-perl tool. The official term
25 note on terminology
26
27 The term "Stanza" derives from the dh-make-perl
28 <http://packages.debian.org/sid/dh-make-perl> tool. The official term
2329 would now be "Paragraph". For the purposes of discussing the DEP-5
2430 format the terms are used interchangeably in this documentation.
2531
2632 FIELDS
27 header
28 An instance of Debian::Copyright::Stanza::Header class. Contains the the
29 first stanza of the copyright file. If multiple files were parsed only
30 the first will be retained.
3133
32 files
34 header
35
36 An instance of Debian::Copyright::Stanza::Header class. Contains the
37 the first stanza of the copyright file. If multiple files were parsed
38 only the first will be retained.
39
40 files
41
3342 A hash reference (actually Tie::IxHash instance) with keys being the
34 values of the `Files' clause and values instances of
43 values of the Files clause and values instances of
3544 Debian::Copyright::Stanza::Files class.
3645
37 licenses
46 licenses
47
3848 A hash reference (actually Tie::IxHash instance) with keys being the
39 values of the `License' clause and values instances of
49 values of the License clause and values instances of
4050 Debian::Copyright::Stanza::License class.
4151
4252 CONSTRUCTOR
43 new
53
54 new
55
4456 Constructs a new Debian::Copyright instance.
4557
46 The `header' field is initialised with an empty string. The
47 `files_block' and `license_block' fields are initialised with an empty
48 instance of Tie::IxHash.
58 The header field is initialised with an empty string. The files_block
59 and license_block fields are initialised with an empty instance of
60 Tie::IxHash.
4961
5062 METHODS
51 read *file*
52 Parse debian and accessors.
5363
54 *file* can be either a file name, an opened file handle or a string
64 read file
65
66 Parse "copyright" in debian and accessors.
67
68 file can be either a file name, an opened file handle or a string
5569 scalar reference.
5670
57 write *file*
58 Writes a debian/copyright-like file in *file* with the contents defined
71 write file
72
73 Writes a debian/copyright-like file in file with the contents defined
5974 in the accessor fields.
6075
61 *file* can be either a file name, an opened file handle or a string
76 file can be either a file name, an opened file handle or a string
6277 scalar reference.
6378
6479 LIMITATIONS
65 This module is written with one particular version of DEP-5 in mind.
66 Furthermore version 0.1 of this software was for a draft version the
67 standard. The changes in going from draft to standard were such that it
68 was not worth attempting to maintain backwards compatibility.
80
81 This module is written with one particular version of DEP-5
82 <http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/> in
83 mind. Furthermore version 0.1 of this software was for a draft version
84 the standard. The changes in going from draft to standard were such
85 that it was not worth attempting to maintain backwards compatibility.
86
6987 Test coverage is not yet complete.
7088
7189 INCOMPATIBILITIES
90
7291 This version is not backwards compatible with version 0.1.
7392
7493 ACKNOWLEDGEMENTS
94
7595 Thanks to Charles Plessy for various comments regarding the
7696 documentation.
7797
7898 COPYRIGHT & LICENSE
99
79100 Copyright (C) 2011-2012 Nicholas Bamber nicholas@periapt.co.uk
80101
81102 This module was adapted from Debian::Control. Copyright (C) 2009 Damyan
82103 Ivanov dmn@debian.org [Portions]
83104
84105 This program is free software; you can redistribute it and/or modify it
85 under the terms of the GNU General Public License version 2 as published
86 by the Free Software Foundation.
106 under the terms of the GNU General Public License version 2 as
107 published by the Free Software Foundation.
87108
88109 This program is distributed in the hope that it will be useful, but
89110 WITHOUT ANY WARRANTY; without even the implied warranty of