summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Kalnischkies <kalnischkies@gmail.com>2009-09-24 12:18:16 +0200
committerDavid Kalnischkies <kalnischkies@gmail.com>2009-09-24 12:18:16 +0200
commit3ba36dfffbf5f158090f53a15b94e67db98057aa (patch)
tree298058e78510d02533bbe2fd3d70c86dc36d5cf0
parent5900bd8dd90ebe61697a82fc18f3b1a9edaeedfa (diff)
clarify the note for the pkgnames command in the manpage (Closes: #547599)
-rw-r--r--debian/changelog2
-rw-r--r--doc/apt-cache.8.xml7
2 files changed, 7 insertions, 2 deletions
diff --git a/debian/changelog b/debian/changelog
index 4bf132367..e21ed2dfd 100644
--- 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
+ * 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:
diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml
index 26d55a519..9851135b1 100644
--- 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>
- <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
- <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>