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).

diff --git a/debian/changelog b/debian/changelog
index 101ad03a745418350495ea10d594b40efe023302..4f8b72a311de605baa3c6f349e2b0f2570a9e1d7 100644 (file)
--- a/debian/changelog
+++ b/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
 

diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml
index e752f9d27436beba8e88c8b430cceb774bdb05e0..b1522a6142244620a61c380e9c184a996de21fc9 100644 (file)
--- a/doc/apt.conf.5.xml
+++ b/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 {