improve apt.8.xml

diff --cc cmdline/apt.cc
index 5771e664f2c0ac4d32e26996d840e84baf74c6a8,d2eb7a5a3b135f42ed62e9d499c575d8793f2b27..170478174ad365652526c60db5a96c0ae7172a32
--- 1/cmdline/apt.cc
--- 2/cmdline/apt.cc
+++ b/cmdline/apt.cc
@@@ -76,11 -71,11 +76,13 @@@ bool ShowHelp(CommandLine &CmdL
        " 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;

diff --cc doc/apt.8.xml
index 0340e043f186945b2afc0532b49ed8491342e2d5,a0ae9086dd509b84808b1409c6eb5d409225e80a..bb1f6bb91505b7606475823b25e160976d5df31d
--- 1/doc/apt.8.xml
--- 2/doc/apt.8.xml
+++ b/doc/apt.8.xml
@@@ -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>