~vcs-imports/debian-policy/master

« back to all changes in this revision

Viewing changes to policy/ap-pkg-sourcepkg.rst

  • Committer: Russ Allbery
  • Author(s): Guillem Jover
  • Date: 2023-09-10 18:22:46 UTC
  • Revision ID: git-v1:01c18a882d2a21ee234f1bbc1d994e96625f2630
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 try to
make them less ambiguous and 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»

Show diffs side-by-side

added added

removed removed

Lines of Context:
93
93
    dpkg-gencontrol -Pdebian/pkg -ppackage
94
94
 
95
95
The ``-P`` tells ``dpkg-gencontrol`` that the package is being built in
96
 
a non-default directory, and the ``-p`` tells it which package's control
97
 
file should be generated.
 
96
a non-default directory, and the ``-p`` tells it which binary package's
 
97
control file should be generated.
98
98
 
99
99
``dpkg-gencontrol`` also adds information to the list of files in
100
100
``debian/files``, for the benefit of (for example) a future invocation