Bug#593909: debian-policy: Clarifications about the syntax of Debian control files.
Charles Plessy <plessy@debian.org> writes:
> I think that it is a good idea. I took your wording, but moved what was
> common between folded and multiline fields to the previous paragraph.
That looks mostly right except I think you moved a bit too much.
> - Many fields' values may span several lines; in this case
> - each continuation line must start with a space or a tab.
> - Any trailing spaces or tabs at the end of individual
> - lines of a field value are ignored.
> + According to the types defined below, fields values may be
> + contained in a logical line that spans several lines. The
> + lines after the first are called continuation lines and
> + must start with a space or a tab. Any trailing spaces or tabs
> + at the end of individual lines of a field value are ignored.
Multiline fields aren't a single logical line that spans several lines.
They have a value that consists of several lines, both real and logical.
Only folded fields consist of a single logical line that spans multiple
lines.
The other two sentences are fine here.
> + <tag>folded</tag>
> + <item>
> + The value of a folded field is a logical line that may span
> + several lines. Whitespace, including any newlines, are not
> + significant in the field values of folded fields.<footnote>
"is not significant" (whitespace is conventionally a mass noun in
technical English).
Otherwise looks great to me.
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: