clarify the note for the pkgnames command in the manpage (Closes: #547599)

diff --git a/debian/changelog b/debian/changelog
index 4bf13236768f396f4f3daae02f96e1773eb38d49..e21ed2dfd3e0b759434172e4a638d62f30f2965e 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -29,6 +29,8 @@ apt (0.7.24) UNRELEASED; urgency=low
       a bit and improve the documentation for this option group.
   * doc/apt.conf.5.xml:
     - document the Acquire::http::Dl-Limit option
       a bit and improve the documentation for this option group.
   * doc/apt.conf.5.xml:
     - document the Acquire::http::Dl-Limit option

+  * doc/apt-cache.8.xml:
+    - clarify the note for the pkgnames command (Closes: #547599)

   * doc/apt.ent, all man pages:
     - move the description of files to globally usable entities
   * doc/apt_preferences.5.xml:
   * doc/apt.ent, all man pages:
     - move the description of files to globally usable entities
   * doc/apt_preferences.5.xml:

diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml
index 26d55a519c5792218f7286aabcb466bfc997f248..9851135b147b85e0c1caabed46d52ca8481c75e9 100644 (file)
--- a/doc/apt-cache.8.xml
+++ b/doc/apt-cache.8.xml
@@ -226,11 +226,14 @@ Reverse Provides:
      </varlistentry>
 
      <varlistentry><term>pkgnames <replaceable>[ prefix ]</replaceable></term>
      </varlistentry>
 
      <varlistentry><term>pkgnames <replaceable>[ prefix ]</replaceable></term>

-     <listitem><para>This command prints the name of each package in the system. The optional
+     <listitem><para>This command prints the name of each package APT knows. The optional

      argument is a prefix match to filter the name list. The output is suitable
      for use in a shell tab complete function and the output is generated 
      extremely quickly. This command is best used with the 
      argument is a prefix match to filter the name list. The output is suitable
      for use in a shell tab complete function and the output is generated 
      extremely quickly. This command is best used with the 

-     <option>--generate</option> option.</para></listitem>
+     <option>--generate</option> option.</para>
+     <para>Note that a package which APT knows of is not nessasarily available to download,
+     installable or installed, e.g. virtual packages are also listed in the generated list.
+     </para></listitem>

      </varlistentry>
      
      <varlistentry><term>dotty <replaceable>pkg(s)</replaceable></term>
      </varlistentry>
      
      <varlistentry><term>dotty <replaceable>pkg(s)</replaceable></term>