doc/apt.conf.5.xml: Start deprecating stuff.

  - Deprecate unquoted values, string concatenation and explain what should
    not be written inside a value (quotes,backslash).

debian/changelog

@@ -1,9 +1,15 @@
 apt (0.7.25) UNRELEASED; urgency=low
 
+  [ Christian Perrier ]
   * Fix apt-ftparchive(1) wrt description of the "-o" option.
     Thanks to Dann Frazier for the patch. Closes: #273100
 
- -- Christian Perrier <bubulle@debian.org>  Sat, 26 Sep 2009 11:17:25 +0200
+  [ Julian Andres Klode ]
+  * doc/apt.conf.5.xml:
+    - Deprecate unquoted values, string concatenation and explain what should
+      not be written inside a value (quotes,backslash).
+
+ -- Julian Andres Klode <jak@debian.org>  Sat, 26 Sep 2009 15:00:28 +0200
 
 apt (0.7.24) unstable; urgency=low
 

doc/apt.conf.5.xml

@@ -59,8 +59,11 @@
    between <literal>/*</literal> and <literal>*/</literal>, just like C/C++ comments.
    Each line is of the form
    <literal>APT::Get::Assume-Yes "true";</literal> The trailing 
-   semicolon is required and the quotes are optional. A new scope can be
-   opened with curly braces, like:</para>
+   semicolon and the quotes are required. The value must be on one line, and
+   there is no kind of string concatenation. It must not include inside quotes.
+   The behavior of the backslash "\" and escaped characters inside a value is
+   undefined and it should not be used. A new scope can be opened with curly
+   braces, like:</para>
 
 <informalexample><programlisting>   
 APT {