[Reproducible-commits] [dpkg] 56/105: man: Clarify what characters constitute the deb822(5) syntax
Niko Tyni
ntyni at moszumanska.debian.org
Mon May 2 13:49:52 UTC 2016
This is an automated email from the git hooks/post-receive script.
ntyni pushed a commit to branch ntyni/reproducible_builds
in repository dpkg.
commit 8771da184eea6f58dd04a7e5076fd2b209fdd390
Author: Guillem Jover <guillem at debian.org>
Date: Wed Apr 20 10:43:13 2016 +0200
man: Clarify what characters constitute the deb822(5) syntax
Use Unicode code points and their printable characters to make it clear
what exact characters or ranges we are talking about.
Based-on-a-patch-by: Ben Finney <ben at benfinney.id.au>
---
debian/changelog | 3 +++
man/deb822.5 | 38 +++++++++++++++++++++-----------------
2 files changed, 24 insertions(+), 17 deletions(-)
diff --git a/debian/changelog b/debian/changelog
index f3878a2..33f1f91 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -131,6 +131,9 @@ dpkg (1.18.5) UNRELEASED; urgency=medium
- Clarify that i386 does not suffer performance loss due to PIE anymore
since gcc >= 5 in dpkg-buildflags(1).
- Document in deb822(5) that deb-origin(5) also supports comments.
+ - Clarify which characters constitute the deb822(5) control files syntax
+ by using Unicode code points and their printable characters.
+ Based on a patch by Ben Finney <ben at benfinney.id.au>.
[ Updated programs translations ]
* Dutch (Frans Spiesschaert). Closes: #822797
diff --git a/man/deb822.5 b/man/deb822.5
index 1d2df4c..0cc3513 100644
--- a/man/deb822.5
+++ b/man/deb822.5
@@ -31,8 +31,9 @@ files (\fBdpkg\fP's internal databases are in a similar format).
A control file consists of one or more paragraphs of fields (the paragraphs
are also sometimes referred to as stanzas).
The paragraphs are separated by empty lines.
-Parsers may accept lines consisting solely of spaces and tabs as paragraph
-separators, but control files should use empty lines.
+Parsers may accept lines consisting solely of U+0020 \fBSPACE\fP and
+U+0009 \fBTAB\fP as paragraph separators, but control files should use
+empty lines.
Some control files allow only one paragraph; others allow several, in which
case each paragraph usually refers to a different package.
(For example, in source packages, the first paragraph refers to the source
@@ -41,19 +42,21 @@ source.)
The ordering of the paragraphs in control files is significant.
Each paragraph consists of a series of data fields.
-Each field consists of the field name followed by a colon and then the
-data/value associated with that field.
+Each field consists of the field name followed by a colon
+(U+003A \(oq\fB:\fP\(cq), and then the data/value associated with that field.
The field name is composed of US-ASCII characters excluding control
-characters, space, and colon (i.e., characters in the ranges 33-57 and
-59-126, inclusive).
-Field names must not begin with the comment character (\(oq\fB#\fP\(cq),
-nor with the hyphen character (\(oq\fB\-\fP\(cq).
+characters, space, and colon (i.e., characters in the ranges
+U+0021 \(oq\fB!\fP\(cq through U+0039 \(oq\fB9\fP\(cq, and
+U+003B \(oq\fB;\fP\(cq through U+007E \(oq\fB~\fP\(cq, inclusive).
+Field names must not begin with the comment character
+(U+0023 \(oq\fB#\fP\(cq), nor with the hyphen character
+(U+002D \(oq\fB\-\fP\(cq).
The field ends at the end of the line or at the end of the last continuation
line (see below).
-Horizontal whitespace (spaces and tabs) may occur immediately before or after
-the value and is ignored there; it is conventional to put a single space after
-the colon.
+Horizontal whitespace (U+0020 \fBSPACE\fP and U+0009 \fBTAB\fP) may occur
+immediately before or after the value and is ignored there; it is conventional
+to put a single space after the colon.
For example, a field might be:
.RS
.nf
@@ -81,7 +84,7 @@ specify a different type.
.B folded
The value of a folded field is a logical line that may span several lines.
The lines after the first are called continuation lines and must start with
-a space or a tab.
+a U+0020 \fBSPACE\fP or a U+0009 \fBTAB\fP.
Whitespace, including any newlines, is not significant in the field values
of folded fields.
@@ -111,13 +114,14 @@ names using mixed case as shown below.
Field values are case-sensitive unless the description of the field says
otherwise.
-Paragraph separators (empty lines) and lines consisting only of spaces and
-tabs are not allowed within field values or between fields.
+Paragraph separators (empty lines) and lines consisting only of
+U+0020 \fBSPACE\fP and U+0009 \fBTAB\fP, are not allowed within field
+values or between fields.
Empty lines in field values are usually escaped by representing them by a
-space followed by a dot.
+U+0020 \fBSPACE\fP followed by a dot (U+002E \(oq\fB.\fP\(cq).
-Lines starting with \(oq\fB#\fP\(cq without any preceding whitespace are
-comments lines that are only permitted in source package control files
+Lines starting with U+0023 \(oq\fB#\fP\(cq, without any preceding whitespace
+are comments lines that are only permitted in source package control files
(\fIdebian/control\fP) and in \fBdeb\-origin\fP(5) files.
These comment lines are ignored, even between two continuation lines.
They do not end logical lines.
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/reproducible/dpkg.git
More information about the Reproducible-commits
mailing list