doc, man: Clarify terminology for Debian control files
commitb3bb15c52389a5f24689887a2f8b39e1b1408916
authorGuillem Jover <guillem@debian.org>
Tue, 12 Dec 2023 22:58:35 +0000 (12 23:58 +0100)
committerGuillem Jover <guillem@debian.org>
Tue, 12 Dec 2023 22:58:35 +0000 (12 23:58 +0100)
tree90bc153f9b6c2a8fc62a97451f6e4d7c760385dc
parentb37a4cb15255ed6b1bc9b22d1dbe1e1e3b448b03
doc, man: Clarify terminology for Debian control files

Their current descriptive names are very close and easily confused if
one is not paying close attention. Use new terminology that tries to
make them less ambiguous and more intuitive.

The new and unified terms are:

  * debian/control: «Debian source package template control file»
  * .dsc:           «Debian source package control file»
  * DEBIAN/control: «Debian binary package control file»
  * .changes:       «Debian upload changes control file»

For contents we use these new terms:

  First stanza in debian/control: «source package stanza»
  Next stanzas in debian/control: «binary package stanza»
man/deb-changes.pod
man/deb-control.pod
man/deb-src-control.pod
man/dsc.pod
scripts/Dpkg/Control.pm
scripts/Dpkg/Control/Types.pm