The following commit has been merged in the master branch:
commit 690f099bf2d05bf2f02a5952cfc4dd4b6fe66d0a
Author: Guillem Jover <[email protected]>
Date: Sun Mar 7 07:00:12 2010 +0100
man: Document “dpkg-query -l” abbreviated state information
Closes: #383869
Based-on-patch-by: Marc-Jano Knopp <[email protected]>
diff --git a/debian/changelog b/debian/changelog
index 5ea3d02..a4f3ea4 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -161,6 +161,9 @@ dpkg (1.15.6) UNRELEASED; urgency=low
* Document in the man page the effects of setting TMPDIR for dpkg and
dpkg-deb, HOME for dselect and dpkg and PAGER for dpkg. Closes: #572836
* Document the exit codes for dpkg-query. Closes: #571798
+ * Document “dpkg-query -l” abbreviated state information in the man page.
+ Based on a patch by Marc-Jano Knopp <[email protected]>.
+ Closes: #383869
[ Modestas Vainius ]
* Implement symbol patterns (Closes: #563752). From now on, it is possible to
diff --git a/man/dpkg-query.1 b/man/dpkg-query.1
index c07c613..abff692 100644
--- a/man/dpkg-query.1
+++ b/man/dpkg-query.1
@@ -26,6 +26,40 @@ with \*(lqlibc6\*(rq:
\fBdpkg\-query \-l \(aqlibc6*\(aq\fP
.fi
+The first three columns of the output show the desired action, the package
+status, and errors, in that order.
+
+Desired action:
+.nf
+ u = Unknown
+ i = Install
+ h = Hold
+ r = Remove
+ p = Purge
+.fi
+
+Package status:
+.nf
+ n = Not-installed
+ c = Config-files
+ H = Half-installed
+ U = Unpacked
+ F = Half-configured
+ W = Triggers-awaiting
+ t = Triggers-pending
+ i = Installed
+.fi
+
+Error flags:
+.nf
+ <empty> = (none)
+ R = Reinst-required
+.fi
+
+An uppercase status or error letter indicates the package is likely to
+cause severe problems. Please refer to \fBdpkg\fP(1) for information
+about the above states and flags.
+
The output format of this option is not configurable, but varies
automatically to fit the terminal width. It is intended for human
readers, and is not easily machine-readable. See \fB\-W\fP (\fB\-\-show\fP)
--
dpkg's main repository
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
