From cbffab246997fb5a06211dfb706b54e5ae5bb59f Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 16:58:51 +0200 Subject: Adding upstream version 1.21.22. Signed-off-by: Daniel Baumann --- man/deb-changelog.pod | 233 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 233 insertions(+) create mode 100644 man/deb-changelog.pod (limited to 'man/deb-changelog.pod') diff --git a/man/deb-changelog.pod b/man/deb-changelog.pod new file mode 100644 index 0000000..9f0d523 --- /dev/null +++ b/man/deb-changelog.pod @@ -0,0 +1,233 @@ +# dpkg manual page - deb-changelog(5) +# +# Copyright © 1996-1998 Ian Jackson and Christian Schwarz +# Copyright © 1998, 2001 Manoj Srivastava +# Copyright © 2001 Julian Gilbey +# Copyright © 2003 Josip Rodin +# Copyright © 2008, 2010 Russ Allbery +# Copyright © 2010 Charles Plessy +# Copyright © 2014 Bill Allombert +# Copyright © 2015-2017 Guillem Jover +# +# This is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +=encoding utf8 + +=head1 NAME + +deb-changelog - dpkg source packages' changelog file format + +=head1 SYNOPSIS + +B + +=head1 DESCRIPTION + +Changes in the packaged version of a project are explained in the +changelog file I. +This includes modifications made in the source package compared to the +upstream one as well as other changes and updates to the package. + +The format of the I allows the package building +tools to discover which version of the package is being built and find +out other release-specific information. + +That format is a series of entries like this: + +Z<> + I (I) I; I + [optional blank line(s), stripped] + * I + I + [blank line(s), included in B(1) output] + * I + [optional blank line(s), stripped] + -- I > I + +I and I are the source package name and version +number. +I is delimited by parenthesis U+00028 ‘B<(>’ and +U+0029 ‘B<)>’. + +I lists one or more space-separated distributions where +this version should be installed when it is uploaded; it is copied to the +B field in the I<.changes> file. +I must be terminated by a semicolon (U+003B ‘B<;>’). + +I lists zero or more comma-separated I=I +items. +Each keyword can contain only minus and case insensitive alphanumeric +characters, as they need to be mapped to B(5) field names. +The only Is currently supported by B are B +and B. +B's value is used for the B field in the +I<.changes> file for the upload. +B with a B value, is used to denote that this +changelog entry is for a binary-only non-maintainer upload (an automatic +binary rebuild with the only change being the changelog entry). + +The change details may in fact be any series of lines starting with +at least two spaces (U+0020 B), but conventionally each +change starts with an +asterisk and a separating space and continuation lines are indented +so as to bring them in line with the start of the text above. +Blank lines may be used here to separate groups of changes, if desired. + +If this upload resolves bugs recorded in the distribution bug tracking +system, they may be automatically closed on the inclusion of this +package into the distribution archive by including the string: + +=over + +BI + +=back + +in the change details, where B<#>I is the bug number. +The exact Perl regular expression is: + +=over + +B + +=back + +That is, the string should consist of the word B followed by +a comma-separated list of bug numbers. +Bug numbers may be preceded by the word B and/or a B<#> sign, +as in C. +The words B and B are not case sensitive. +The list of bug numbers may span multiple lines. + +This information is conveyed via the B field in the I<.changes> +file. +Where, depending on the archive maintenance software, all the bug numbers +listed might get automatically closed. + +The maintainer name and email address used in the changelog should be the +details of the person who prepared this release of the package. +They are B necessarily those of the uploader or usual package +maintainer. +The information here will be copied to the B field in the +I<.changes> file, and then later might be used to send an acknowledgment +when the upload has been installed in the distribution archive. + +The I has the following format (compatible and with the same +semantics of RFC2822 and RFC5322, or what «date -R» generates): + +=over + +IB<,> I
I I IB<:>IB<:>I B<+>I + +=back + +where: + +=over + +=item I + +Is one of: +B, B, B, B, B, B, B. + +=item I
+ +Is a one- or two-digit day of the month (B<01>-B<31>), where the leading +zero is optional, but conventionally does not get omitted. + +=item I + +Is one of: +B, B, B, B, B, B, B, B, +B, B, B, B. + +=item I + +Is the four-digit year (e.g. 2010). + +=item I + +Is the two-digit hour (B<00>-B<23>). + +=item I + +Is the two-digit minutes (B<00>-B<59>). + +=item I + +Is the two-digit seconds (B<00>-B<60>). + +=item [B<+->]I + +Is the time zone offset from Coordinated Universal Time (UTC). +‘B<+>’ indicates that the time is ahead of (i.e., east of) UTC and +‘B<->’ indicates that the time is behind (i.e., west of) UTC. +The first two digits indicate the hour difference from UTC and the last +two digits indicate the number of additional minutes difference from UTC. +The last two digits must be in the range B<00>-B<59>. + +=back + +The first “title” line with the package name must start at the left +hand margin. +The “trailer” line with the maintainer and date details must be +preceded by exactly one space (U+0020 B). +The maintainer details and the date must be separated by exactly two +spaces (U+0020 B). +Each part of the I can be separated by one or more spaces +(U+0020 B), except after the comma where it can be separated +by zero or more spaces (U+0020 B). + +Any line that consists entirely (i.e., no leading whitespace) of B<#> +or B style comments or RCS keywords. + +Vim modelines or Emacs local variables, and ancient changelog entries with +other formats at the end of the file should be accepted and preserved on +output, but their contents might be otherwise ignored and parsing stopped +at that point. + +The entire changelog must be encoded in UTF-8. + +=head1 FILES + +=over + +=item I + +=back + +=head1 EXAMPLES + + dpkg (1.17.18) unstable; urgency=low + + [ Guillem Jover ] + * Handle empty minimum versions when initializing dependency versions, + as the code is mapping the minimum version 0 to '' to avoid outputting + useless versions. Regression introduced in dpkg 1.17.17. Closes: #764929 + + [ Updated programs translations ] + * Catalan (Guillem Jover). + + [ Updated dselect translations ] + * Catalan (Guillem Jover). + * German (Sven Joachim). + + -- Guillem Jover Sun, 12 Oct 2014 15:47:44 +0200 + +=head1 SEE ALSO + +B(5), +B(7), +B(5), +B(1). -- cgit v1.2.3