describe script usage in the manpage

diff --git a/cmdline/apt.cc b/cmdline/apt.cc
index 170478174ad365652526c60db5a96c0ae7172a32..60a83c7ceb544929d20964c7d185330b99110c93 100644 (file)
--- 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));
 
 
    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
    InitOutput();
 
    // Set up gettext support

diff --git a/doc/apt.8.xml b/doc/apt.8.xml
index 91e22b1efd501c548ccec7784188c3e8d1dadf75..3ac54fb0b8a42f055a0064023a55f15629e13f50 100644 (file)
--- a/doc/apt.8.xml
+++ b/doc/apt.8.xml
@@ -124,7 +124,15 @@
    </variablelist>
  </refsect1>
 
    </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
 
  <refsect1><title>Differences to &apt-get;</title>
  <para>The <command>apt</command> command is meant to be pleasant for