This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg.
View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=8764902d1127224adeb5ff1f0034809f42a5ee52 commit 8764902d1127224adeb5ff1f0034809f42a5ee52 Author: Guillem Jover <[email protected]> AuthorDate: Sun Dec 14 17:40:10 2025 +0100 man: Clarify binary stanza default field values and inheritance rules Document how the Section, Priority and Homepage fields inherit their values, their defaults, and when the behavior was introduced. --- man/deb-changes.pod | 8 ++++++-- man/deb-src-control.pod | 27 ++++++++++++++++++++------- 2 files changed, 26 insertions(+), 9 deletions(-) diff --git a/man/deb-changes.pod b/man/deb-changes.pod index ab552ad48..3f8ca8b2f 100644 --- a/man/deb-changes.pod +++ b/man/deb-changes.pod @@ -184,8 +184,12 @@ Each line consists of space-separated entries describing the file: the md5sum, the file size, the file section, the file priority, and the file name. -If the section or priority are omitted from the package, -these default to B<unknown> and B<optional> respectively +If the section is omitted in the source package template control file, +it defaults to B<unknown> +(since dpkg 1.22.13). + +If the priority is omitted in the source package template control file, +it defaults to B<optional> (since dpkg 1.22.13). This field lists all files that make up the upload. diff --git a/man/deb-src-control.pod b/man/deb-src-control.pod index 8daef4687..84f59257d 100644 --- a/man/deb-src-control.pod +++ b/man/deb-src-control.pod @@ -359,13 +359,6 @@ A list of these packages is in the build-essential package. =head1 BINARY FIELDS -Note that the -B<Priority>, B<Section> -and -B<Homepage> -fields can also be in a binary stanza to override the global value from the -source package. - =over =item B<Package:> I<binary-package-name> (required) @@ -436,6 +429,26 @@ L<deb-control(5)> manual page, as they are copied literally to the control file of the binary package. +=item B<Section:> I<section> + +Overrides the value from the same field in the source package stanza. + +If there is no field in the binary or source stanza, +then the it defaults to B<unknown> +(since dpkg 1.22.13). + +=item B<Priority:> I<priority> + +Overrides the value from the same field in the source package stanza. + +If there is no field in the binary or source stanza, +then the it defaults to B<optional> +(since dpkg 1.22.13). + +=item B<Homepage:> I<url> + +Overrides the value from the same field in the source package stanza. + =item B<Depends:> I<package-list> =item B<Pre-Depends:> I<package-list> -- Dpkg.Org's dpkg
