Config...yright(3pm)

📦
version 3.026 · 6 versions
, in ubuntu stonking

🌸 NAME 🌸

okay so bestie, this page is the Config...yright(3pm) man page — User Contributed Perl Documentation, section 3pm, if we're being official. And what it actually documents is one whole configuration class: Config::Model::models::Dpkg::Copyright — AKA the Dpkg::Copyright configuration class. 💅

🦋 DESCRIPTION 🦋

These are the configuration classes used by Config::Model, and they're all about the machine-readable debian/copyright. 🎀

The parameters that came from the former version of DEP-5 are flagged as deprecated. The whole point? To let you migrate from the older specs to the CANDIDATE spec. slay, evolution. ✨

So, wanna edit a copyright file? Go into your package development directory and run:

cme edit dpkg-copyright

Wanna check your file? Run:

cme check dpkg-copyright

Wanna upgrade your file from an old spec? Run:

cme migrate dpkg-copyright

not me giving you three commands and zero fluff, periodt. 👑

🧚 Elements

💜 Format

URI of the format specification. Mandatory. Type uniline.

default value:

https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/

💜 Source

An explanation of where the upstream source came from. Typically this would be a URL, but it might be a free-form explanation too. Debian Policy, 12.5 requires this info — unless there are no upstream sources, which is mainly the case for native Debian packages. And if the upstream source was modified to remove non-free parts, that should be explained in this field as well. Optional. Type string.

Note: Source is migrated with "$old || $older ;" and with:
  • $old => "- Upstream-Source"
  • $older => "- Original-Source-Location"

💜 Upstream-Name

The name upstream uses for the software. Optional. Type uniline.

Note: Upstream-Name is migrated with $name and with:
  • $name => "- Name"

💜 Upstream-Contact

The preferred address(es) to reach the upstream project. May be free-form text, but by convention it will usually be written as a list of RFC5822 addresses or URIs. Optional. Type list of uniline.

Note: Upstream-Contact values are migrated from - Upstream-Maintainer

💜 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). Optional. Type string.

💜 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 explain 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. Optional. Type string.

Note: Comment is migrated with $old and with:
  • $old => "- X-Comment"

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 further down, in the Files paragraph section. Optional. Type string.

💜 Files

Patterns indicating files having the same license and sharing copyright holders. See the files pattern documentation at https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/#files-field for details. Optional. Type hash of node of class Dpkg::Copyright::Content.

💜 Files-Excluded

White space separated list of file patterns to exclude from the package. This field is only used by uscan. Example: "*/Makefile.in aclocal.m4". See also UscanEnhancements (https://wiki.debian.org/UscanEnhancements) and the files pattern documentation (https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/#files-field). Optional. Type string.

💜 Global-License

Optional. Type node of class Dpkg::Copyright::GlobalLicense.

💜 Format-Specification

Deprecated Optional. Type uniline.

💜 Name

Deprecated Optional. Type uniline.

💜 Maintainer

Line(s) containing the preferred address(es) to reach the current upstream maintainer(s). May be free-form text, but by convention it will usually be written as a list of RFC2822 addresses or URIs. Deprecated Optional. Type list of uniline.

💜 Upstream-Maintainer

Deprecated Optional. Type list of uniline.

Note: Upstream-Maintainer values are migrated from - Maintainer

💜 Upstream-Source

Deprecated Optional. Type string.

💜 Original-Source-Location

Deprecated Optional. Type string.

💜 License

Optional. Type hash of node of class Dpkg::Copyright::LicenseSpec.

💜 X-Comment

Deprecated Optional. Type string.

🔥 SEE ALSO 🔥

  • cme
  • Config::Model::models::Dpkg::Copyright::Content
  • Config::Model::models::Dpkg::Copyright::GlobalLicense
  • Config::Model::models::Dpkg::Copyright::LicenseSpec

👑 AUTHOR 👑

Dominique Dumont — an actual icon, we stan. 💖

2010,2011 Dominique Dumont

🎀 LICENSE 🎀

LGPL2

and that's the whole page bestie!! 💕 this one came from perl v5.42.3, dated 2026-08-30, and yeah — the man page name is literally Config...yright(3pm) (they had to truncate it, the name is giving main character energy and wouldn't fit 💀). go forth and write the most immaculate debian/copyright ever. mwah! 💅✨

📦 where this page comes from