~vcs-imports/debian-policy/master

« back to all changes in this revision

Viewing changes to policy/ch-maintainerscripts.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:
10
10
management system will run for you when your package is installed,
11
11
upgraded or removed.
12
12
 
13
 
These scripts are the control information files ``preinst``,
 
13
These scripts are the package metadata files ``preinst``,
14
14
``postinst``, ``prerm`` and ``postrm``. They must be proper executable
15
15
files; if they are scripts (which is recommended), they must start with
16
16
the usual ``#!`` convention. They should be readable and executable by
25
25
everything went well.
26
26
 
27
27
Additionally, packages interacting with users using ``debconf`` in the
28
 
``postinst`` script should install a ``config`` script as a control
29
 
information file. See :ref:`s-maintscriptprompt` for
 
28
``postinst`` script should install a ``config`` script as a package
 
29
metadata file. See :ref:`s-maintscriptprompt` for
30
30
details.
31
31
 
32
32
When a package is upgraded a combination of the scripts from the old and