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

---
 cmdline/apt.cc | 11 -----------
 doc/apt.8.xml  | 10 +++++++++-
 2 files changed, 9 insertions(+), 12 deletions(-)

diff --git a/cmdline/apt.cc b/cmdline/apt.cc
index 170478174..60a83c7ce 100644
--- a/cmdline/apt.cc
+++ b/cmdline/apt.cc
@@ -107,17 +107,6 @@ int main(int argc, const char *argv[])					/*{{{*/
 
    std::vector<CommandLine::Args> Args = getCommandArgs("apt", CommandLine::GetCommand(Cmds, argc, argv));
 
-   if(!isatty(1)) 
-   {
-      std::cerr << std::endl
-                << "WARNING WARNING "
-                << argv[0]
-                << " is *NOT* intended for scripts "
-                << "use at your own peril^Wrisk"
-                << std::endl
-                << std::endl;
-   }
-
    InitOutput();
 
    // Set up gettext support
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