.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "Config::Model::models::Dpkg::Copyright 3pm" .TH Config::Model::models::Dpkg::Copyright 3pm "2021-06-06" "perl v5.32.1" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Config::Model::models::Dpkg::Copyright \- Configuration class Dpkg::Copyright .SH "DESCRIPTION" .IX Header "DESCRIPTION" Configuration classes used by Config::Model .PP Machine-readable debian/copyright. Parameters from former version of \s-1DEP\-5\s0 are flagged as deprecated. The idea is to enable migration from older specs to \s-1CANDIDATE\s0 spec. .PP To edit a copyright file, go into your package development directory and run: .PP .Vb 1 \& cme edit dpkg\-copyright .Ve .PP To check you file run: .PP .Vb 1 \& cme check dpkg\-copyright .Ve .PP To upgrade your file from an old spec, run: .PP .Vb 1 \& cme migrate dpkg\-copyright .Ve .SH "Elements" .IX Header "Elements" .SS "Format" .IX Subsection "Format" \&\s-1URI\s0 of the format specification. \fI Mandatory. Type uniline. \fR .IP "default value :" 4 .IX Item "default value :" https://www.debian.org/doc/packaging\-manuals/copyright\-format/1.0/ .SS "Upstream-Name" .IX Subsection "Upstream-Name" The name upstream uses for the software. \fI Optional. Type uniline. \fR .PP Note: Upstream-Name is migrated with '\f(CW$name\fR' and with: .IP "\(bu" 4 \&\f(CW$name\fR => \f(CW\*(C`\- Name\*(C'\fR .SS "Upstream-Contact" .IX Subsection "Upstream-Contact" The preferred address(es) to reach the upstream project. May be free-form text, but by convention will usually be written as a list of \s-1RFC5822\s0 addresses or URIs. \fI Optional. Type list of uniline. \fR .PP Note: Upstream-Contact values are migrated from '\- Upstream\-Maintainer' .SS "Source" .IX Subsection "Source" An explanation from where the upstream source came from. Typically this would be a \s-1URL,\s0 but it might be a free-form explanation. The Debian Policy, 12.5 requires this information unless there are no upstream sources, which is mainly the case for native Debian packages. If the upstream source has been modified to remove non-free parts, that should be explained in this field. \fI Optional. Type string. \fR .PP Note: Source is migrated with '\f(CW\*(C`$old || $older ;\*(C'\fR' and with: .IP "\(bu" 4 \&\f(CW$old\fR => \f(CW\*(C`\- Upstream\-Source\*(C'\fR .IP "\(bu" 4 \&\f(CW$older\fR => \f(CW\*(C`\- Original\-Source\-Location\*(C'\fR .SS "Disclaimer" .IX Subsection "Disclaimer" This field can be used in the case of non-free and contrib packages (see [Policy 12.5]( http://www.debian.org/doc/debian\-policy/ch\-docs.html#s\-copyrightfile)) \fI Optional. Type string. \fR .SS "Comment" .IX Subsection "Comment" This field can provide additional information. For example, it might quote an e\-mail from upstream justifying why the license is acceptable to the main archive, or an explanation of how this version of the package has been forked from a version known to be DFSG-free, even though the current upstream version is not. \fI Optional. Type string. \fR .PP Note: Comment is migrated with '\f(CW$old\fR' and with: .IP "\(bu" 4 \&\f(CW$old\fR => \f(CW\*(C`\- X\-Comment\*(C'\fR .SS "Copyright" .IX Subsection "Copyright" Copyright information for the package as a whole, which may be different or simplified from a combination of all the per-file copyright information. See also Copyright below in the Files paragraph section. \fI Optional. Type string. \fR .SS "Files" .IX Subsection "Files" Patterns indicating files having the same license and sharing copyright holders. See files pattern documentation for details. \fI Optional. Type hash of node of class Dpkg::Copyright::Content . \fR .SS "Files-Excluded" .IX Subsection "Files-Excluded" White space separated list of file patterns to exclude from the package. This field is only used by uscan. Example: \f(CW\*(C`*/Makefile.in aclocal.m4\*(C'\fR. See also UscanEnhancements and the files pattern documentation . \fI Optional. Type string. \fR .SS "Global-License" .IX Subsection "Global-License" \&\fI Optional. Type node of class Dpkg::Copyright::GlobalLicense . \fR .SS "Format-Specification" .IX Subsection "Format-Specification" \&\fBDeprecated\fR \fI Optional. Type uniline. \fR .SS "Name" .IX Subsection "Name" \&\fBDeprecated\fR \fI Optional. Type uniline. \fR .SS "Maintainer" .IX Subsection "Maintainer" Line(s) containing the preferred address(es) to reach current upstream maintainer(s). May be free-form text, but by convention will usually be written as a list of \s-1RFC2822\s0 addresses or URIs. \fBDeprecated\fR \fI Optional. Type list of uniline. \fR .SS "Upstream-Maintainer" .IX Subsection "Upstream-Maintainer" \&\fBDeprecated\fR \fI Optional. Type list of uniline. \fR .PP Note: Upstream-Maintainer values are migrated from '\- Maintainer' .SS "Upstream-Source" .IX Subsection "Upstream-Source" \&\fBDeprecated\fR \fI Optional. Type string. \fR .SS "Original-Source-Location" .IX Subsection "Original-Source-Location" \&\fBDeprecated\fR \fI Optional. Type string. \fR .SS "License" .IX Subsection "License" \&\fI Optional. Type hash of node of class Dpkg::Copyright::LicenseSpec . \fR .SS "X\-Comment" .IX Subsection "X-Comment" \&\fBDeprecated\fR \fI Optional. Type string. \fR .SH "SEE ALSO" .IX Header "SEE ALSO" .IP "\(bu" 4 cme .IP "\(bu" 4 Config::Model::models::Dpkg::Copyright::Content .IP "\(bu" 4 Config::Model::models::Dpkg::Copyright::GlobalLicense .IP "\(bu" 4 Config::Model::models::Dpkg::Copyright::LicenseSpec .SH "AUTHOR" .IX Header "AUTHOR" .IP "Dominique Dumont" 4 .IX Item "Dominique Dumont" .SH "COPYRIGHT" .IX Header "COPYRIGHT" .PD 0 .IP "2010,2011 Dominique Dumont" 4 .IX Item "2010,2011 Dominique Dumont" .PD .SH "LICENSE" .IX Header "LICENSE" .IP "\s-1LGPL2\s0" 4 .IX Item "LGPL2"