improve apt.8.xml

diff --combined cmdline/apt.cc
index 5771e664f2c0ac4d32e26996d840e84baf74c6a8,d2eb7a5a3b135f42ed62e9d499c575d8793f2b27..170478174ad365652526c60db5a96c0ae7172a32
--- 1/cmdline/apt.cc
--- 2/cmdline/apt.cc
+++ b/cmdline/apt.cc
@@@ -41,7 -41,6 +41,7 @@@
  #include <apt-pkg/pkgsystem.h>
  #include <apt-pkg/indexfile.h>
  #include <apt-pkg/metaindex.h>
 +#include <apt-pkg/hashes.h>
  
  #include <apti18n.h>
  
@@@ -55,12 -54,8 +55,12 @@@
  #include <apt-private/private-upgrade.h>
  #include <apt-private/private-show.h>
  #include <apt-private/private-main.h>
 +#include <apt-private/private-utils.h>
 +#include <apt-private/private-sources.h>
                                                                        /*}}}*/
  
 +
 +
  bool ShowHelp(CommandLine &CmdL)
  {
     ioprintf(c1out,_("%s %s for %s compiled on %s %s\n"),PACKAGE,PACKAGE_VERSION,
@@@ -76,11 -71,11 +76,13 @@@
        " search - search in package descriptions\n"
        " show - show package details\n"
        "\n"
--      " update - update list of available packages\n"
 -      " upgrade - upgrade the systems packages\n"
 -      "\n"
        " install - install packages\n"
-       " upgrade - upgrade the systems packages\n"
+       " remove - remove packages\n"
 +      "\n"
 +      " edit-sources - edit the source information file\n"
++      "\n"
++      " update - update list of available packages\n"
++      " upgrade - upgrade the systems packages\n"
         );
     
     return true;
@@@ -96,8 -91,6 +98,8 @@@ int main(int argc, const char *argv[]
                                     {"remove", &DoInstall},
                                     {"update",&DoUpdate},
                                     {"upgrade",&DoUpgradeWithAllowNewPackages},
 +                                   // misc
 +                                   {"edit-sources",&EditSources},
                                     // helper
                                     {"moo",&DoMoo},
                                     {"help",&ShowHelp},

diff --combined doc/apt.8.xml
index 0340e043f186945b2afc0532b49ed8491342e2d5,a0ae9086dd509b84808b1409c6eb5d409225e80a..bb1f6bb91505b7606475823b25e160976d5df31d
--- 1/doc/apt.8.xml
--- 2/doc/apt.8.xml
+++ b/doc/apt.8.xml
@@@ -13,7 -13,6 +13,6 @@@
  <refentry>
  
   <refentryinfo>
-    &apt-author.jgunthorpe;
     &apt-author.team;
     &apt-email;
     &apt-product;
@@@ -42,18 -41,35 +41,26 @@@
     </para>
  
     <variablelist>
-      <varlistentry><term><option>update</option></term>
-      <listitem><para><literal>update</literal> is used to
-      resynchronize the package index files from their sources.
+      <varlistentry><term><option>list</option></term>
+      <listitem><para><literal>list</literal> is used to
+      display a list of packages. It supports shell pattern for matching
+      package names and the following options:
+        <option>--installed</option>
+        <option>--upgradable</option>
+        <option>--all-versions</option>
+      are supported.
       </para></listitem>
-    </varlistentry>
+      </varlistentry>
       
-      <varlistentry><term><option>upgrade</option></term>
-      <listitem><para><literal>upgrade</literal> is used to install the
-      newest versions of all packages currently installed on the system
-      from the sources enumerated in
-      <filename>/etc/apt/sources.list</filename>. New package will be
-      installed, but existing package will never removed.
+      <varlistentry><term><option>search</option></term>
+      <listitem><para><literal>search</literal> searches for the given
+      term(s) and display matching packages.
+      </para></listitem>
+      </varlistentry>
+ 
 -     <varlistentry><term><option>update</option></term>
 -     <listitem><para><literal>update</literal> is used to
 -     resynchronize the package index files from their sources.
 -     </para></listitem>
 -     </varlistentry>
 -     
 -     <varlistentry><term><option>upgrade</option></term>
 -     <listitem><para><literal>upgrade</literal> is used to install the
 -     newest versions of all packages currently installed on the system
 -     from the sources enumerated in
 -     <filename>/etc/apt/sources.list</filename>. New package will be
 -     installed, but existing package will never removed.
++     <varlistentry><term><option>show</option></term>
++     <listitem><para><literal>show</literal> shows the package information
++     for the given package(s).
       </para></listitem>
       </varlistentry>
  
@@@ -80,6 -96,6 +87,28 @@@
       installed instead of removed.</para></listitem>
       </varlistentry>
  
++     <varlistentry><term><option>edit-sources</option></term>
++     <listitem><para><literal>edit-sources</literal> lets you edit
++     your sources.list file and provides basic sanity checks.
++     </para></listitem>
++     </varlistentry>
++
++     <varlistentry><term><option>update</option></term>
++     <listitem><para><literal>update</literal> is used to
++     resynchronize the package index files from their sources.
++     </para></listitem>
++     </varlistentry>
++     
++     <varlistentry><term><option>upgrade</option></term>
++     <listitem><para><literal>upgrade</literal> is used to install the
++     newest versions of all packages currently installed on the system
++     from the sources enumerated in
++     <filename>/etc/apt/sources.list</filename>. New package will be
++     installed, but existing package will never removed.
++     </para></listitem>
++     </varlistentry>
++
++
     </variablelist>
   </refsect1>