~vcs-imports/debian-policy/master

« back to all changes in this revision

Viewing changes to policy/ch-binary.rst

  • Committer: Russ Allbery
  • Author(s): Guillem Jover
  • Date: 2023-09-10 18:24:25 UTC
  • Revision ID: git-v1:475e4ab022f1ab202e6fe2817b719e52c9a792b1
Use «package metadata» instead of «control information»

Using «control information» when talking about control files and control
formats, and similar gets confusing fast. Switch to package metadata, as
some of the files in the deb(5) archive control member are not usually
in deb822(5) format.

Show diffs side-by-side

added added

removed removed

Lines of Context:
9
9
on the system when the package is installed, and a set of files that
10
10
provide additional metadata about the package or which are executed when
11
11
the package is installed or removed. This second set of files is called
12
 
*control information files*. Among those files are the package maintainer
 
12
*package metadata files*. Among those files are the package maintainer
13
13
scripts and ``control``, the :ref:`binary package control file
14
14
<s-binarycontrolfiles>` that contains the control fields for the
15
 
package. Other control information files include :ref:`symbols
 
15
package. Other package metadata files include :ref:`symbols
16
16
<s-sharedlibs-symbols>` or :ref:`shlibs <s-sharedlibs-shlibdeps>` used to
17
17
store shared library dependency information and the ``conffiles`` file
18
18
that lists the package's configuration files (described in
23
23
Throughout this document, a *control file* refers to a file in the
24
24
Debian control file format. These files are documented in
25
25
:doc:`Control files and their fields <ch-controlfields>`. Only files
26
 
referred to specifically as *control information files* are the files
27
 
included in the control information file member of the ``.deb`` file
28
 
format used by binary packages. Most control information files are not
29
 
in the Debian control file format.
 
26
referred to specifically as *package metadata files* are the files
 
27
included in the package metadata member (called ``control.tar``) of the
 
28
``.deb`` file format used by binary packages. Most package metadata files
 
29
are not in the Debian control file format.
30
30
 
31
31
.. _s3.1:
32
32
 
391
391
https://www.debian.org/doc/packaging-manuals/debconf_specification.html.
392
392
 
393
393
Packages which use the Debian Configuration Management Specification may
394
 
contain the additional control information files ``config`` and
 
394
contain the additional package metadata files ``config`` and
395
395
``templates``. ``config`` is an additional maintainer script used for
396
396
package configuration, and ``templates`` contains templates used for
397
397
user prompting. The ``config`` script might be run before the