describe script usage in the manpage
authorMichael Vogt <mvo@debian.org>
Fri, 24 Jan 2014 19:04:26 +0000 (20:04 +0100)
committerMichael Vogt <mvo@debian.org>
Fri, 24 Jan 2014 19:04:26 +0000 (20:04 +0100)
cmdline/apt.cc
doc/apt.8.xml

index 1704781..60a83c7 100644 (file)
@@ -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
index 91e22b1..3ac54fb 100644 (file)
    </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