From a555cf8be53d8b5557f004ecbde8482a169b79f3 Mon Sep 17 00:00:00 2001
From: Michael Vogt <mvo@debian.org>
Date: Fri, 24 Jan 2014 20:04:26 +0100
Subject: describe script usage in the manpage

---
 doc/apt.8.xml | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

(limited to 'doc')

diff --git a/doc/apt.8.xml b/doc/apt.8.xml
index 91e22b1ef..3ac54fb0b 100644
--- a/doc/apt.8.xml
+++ b/doc/apt.8.xml
@@ -124,7 +124,15 @@
    </variablelist>
  </refsect1>
 
-</refsect1>
+ <refsect1><title>Script usage</title>
+  <para>
+   The &apt; commandline is designed as a end-user tool and it may
+   change the output between versions. While it tries to not break
+   backward compatibility there is no guarantee for it either.
+   All features of &apt; are available in  &apt-cache; and &apt-get;
+   via APT options. Please prefer using these commands in your scripts.
+  </para>
+ </refsect1>
 
  <refsect1><title>Differences to &apt-get;</title>
  <para>The <command>apt</command> command is meant to be pleasant for
-- 
cgit v1.2.3