summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDavid Kalnischkies <david@kalnischkies.de>2017-11-17 00:46:34 +0100
committerDavid Kalnischkies <david@kalnischkies.de>2017-11-19 17:24:41 +0100
commit7fba4e0df1768703ce657d8bf8200472c2dd825f (patch)
treeb89a4d08caa1a36dfd3d563207b20e97dfad4e0a /doc
parent5f6da84bb94509fe2e3577ab002a31a0ab0cf880 (diff)
allow multivalue fields in deb822 sources to be folded
The documentation said "spaces", but there is no real reason to be so strict and only allow spaces to separate values as that only leads to very long lines if e.g. multiple URIs are specified which are again hard to deal with from a user PoV which the deb822 format is supposed to avoid. It also deals with multiple consecutive spaces and strange things like tabs users will surely end up using in the real world. The old behviour on encountering folded lines is the generation of URIs which end up containing all these whitespace characters which tends to mess really bad with output and further processing. Closes: 881875
Diffstat (limited to 'doc')
-rw-r--r--doc/sources.list.5.xml8
1 files changed, 5 insertions, 3 deletions
diff --git a/doc/sources.list.5.xml b/doc/sources.list.5.xml
index 56f65927c..694082bea 100644
--- a/doc/sources.list.5.xml
+++ b/doc/sources.list.5.xml
@@ -101,9 +101,11 @@
Options have the same syntax as every other field: A fieldname separated by
a colon (<literal>:</literal>) and optionally spaces from its value(s).
- Note especially that multiple values are separated by spaces, not by
- commas as in the one-line format. Multivalue fields like <literal>Architectures</literal>
- also have <literal>Architectures-Add</literal> and <literal>Architectures-Remove</literal>
+ Note especially that multiple values are separated by whitespaces (like spaces,
+ tabs and newlines), not by commas as in the one-line format.
+
+ Multivalue fields like <literal>Architectures</literal> also have
+ <literal>Architectures-Add</literal> and <literal>Architectures-Remove</literal>
to modify the default value rather than replacing it.
</para><para>
This is a new format supported by apt itself since version 1.1. Previous