~vcs-imports/debian-policy/master

« back to all changes in this revision

Viewing changes to policy/ch-relationships.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:
31
31
Whitespace may appear at any point in the version specification subject
32
32
to the rules in :ref:`s-controlsyntax`, and must appear
33
33
where it's necessary to disambiguate; it is not otherwise significant.
34
 
All of the relationship fields can only be folded in source package
 
34
All of the relationship fields can only be folded in source package template
35
35
control files. For consistency and in case of future changes to ``dpkg``
36
36
it is recommended that a single space be used after a version
37
37
relationship and before a version number; it is also conventional to put
87
87
 
88
88
For binary relationship fields and the ``Built-Using`` field, the
89
89
architecture restriction syntax is only supported in the source package
90
 
control file ``debian/control``. When the corresponding binary package
 
90
template control file ``debian/control``. When the corresponding binary package
91
91
control file is generated, the relationship will either be omitted or
92
92
included without the architecture restriction based on the architecture
93
93
of the binary package. This means that architecture restrictions must
132
132
``baz`` on any architecture using a kernel other than Linux.
133
133
 
134
134
Note that the binary package relationship fields such as ``Depends``
135
 
appear in one of the binary package stanzas of the control file,
 
135
appear in one of the binary package stanzas of the template control file,
136
136
whereas the build-time relationships such as ``Build-Depends`` appear in
137
 
the source package stanza of the control file (which is the first
 
137
the source package stanza of the template control file (which is the first
138
138
section).
139
139
 
140
140
.. _s-binarydeps: