improve apt.8.xml

cmdline/apt.cc

@@ -76,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"
       " 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;

doc/apt.8.xml

@@ -13,7 +13,6 @@
 <refentry>
 
  <refentryinfo>
-   &apt-author.jgunthorpe;
    &apt-author.team;
    &apt-email;
    &apt-product;
@@ -42,18 +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>show</option></term>
+     <listitem><para><literal>show</literal> shows the package information
+     for the given package(s).
      </para></listitem>
      </varlistentry>
 
@@ -80,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>