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=dd86bdfc727c493df2492dbf164e11932adc1555 commit dd86bdfc727c493df2492dbf164e11932adc1555 Author: Guillem Jover <[email protected]> AuthorDate: Fri Oct 13 20:30:36 2023 +0200 man: Clarify Maintainer field in dpkg-parsechangelog(1) The field name is confusing as its semantics are better expressed by the Changed-By field name from the .changes file instead of the Maintainer field from the debian/control file. Document its meaning more clearly, matching the description in deb-changelog(5), and add a BUGS section mentioning this issue. In the future this might get fixed through some kind of selectable versioned output interface. Ref: #1053705 --- man/dpkg-parsechangelog.pod | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/man/dpkg-parsechangelog.pod b/man/dpkg-parsechangelog.pod index 52026ed04..4a6ffb182 100644 --- a/man/dpkg-parsechangelog.pod +++ b/man/dpkg-parsechangelog.pod @@ -109,6 +109,10 @@ concatenated (space-separated) comments from all the versions requested. =item B<Maintainer:> I<author> +The name and email address of the person who prepared these changes, +they are B<not> necessarily those of the uploader or the usual package +maintainer. + =item B<Date:> I<date> The date of the entry as a string, as it appears in the changelog. @@ -272,6 +276,13 @@ number itself. =back +=head1 BUGS + +The B<Maintainer> field has a confusing name matching the field in +the F<debian/control> file but not its exact semantics, +where its meaning would be better represented by the B<Changed-By> field +name used in the F<.changes> file. + =head1 SEE ALSO B<deb-changelog>(5). -- Dpkg.Org's dpkg
