This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch master in repository dpkg.
View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=1e2bd2441bd6980cda9d4d14f7ca720c04280284 commit 1e2bd2441bd6980cda9d4d14f7ca720c04280284 Author: Guillem Jover <guil...@debian.org> AuthorDate: Sat Dec 29 12:19:46 2018 +0100 man: Clarify dpkg-query(1) --list option behavior Make it clear what will be printed when no arguments are specified. Closes: #917098 --- debian/changelog | 2 ++ man/dpkg-query.man | 18 ++++++++++-------- 2 files changed, 12 insertions(+), 8 deletions(-) diff --git a/debian/changelog b/debian/changelog index 345b91a3c..458f09cce 100644 --- a/debian/changelog +++ b/debian/changelog @@ -3,6 +3,8 @@ dpkg (1.19.3) UNRELEASED; urgency=medium [ Guillem Jover ] * Documentation: - dpkg(1): Clarify --remove action. Closes: #914478 + - dpkg-query(1): Clarify --list option behavior when no arguments are + specified. Closes: #917098 * Code internals: - dpkg-maintscript-helper: Use an explicit escape instead of a literal backslash. diff --git a/man/dpkg-query.man b/man/dpkg-query.man index 484395a22..0fbc8f30c 100644 --- a/man/dpkg-query.man +++ b/man/dpkg-query.man @@ -34,14 +34,16 @@ the \fBdpkg\fP database. .SH COMMANDS .TP .BR \-l ", " \-\-list " [\fIpackage-name-pattern\fP...]" -List packages matching given pattern. If no \fIpackage-name-pattern\fP -is given, list all packages in \fI%ADMINDIR%/status\fP, excluding -the ones marked as not-installed (i.e. those which have been previously -purged). Normal shell wildcard characters are allowed -in \fIpackage-name-pattern\fP. Please note you will probably have to -quote \fIpackage-name-pattern\fP to prevent the shell from performing -filename expansion. For example this will list all package names starting -with \*(lqlibc6\*(rq: +List all known packages matching one or more patterns, regardless of their +status, which includes any real or virtual package referenced in any +dependency relationship field (such as \fBBreaks\fP, \fBEnhances\fP, etc.). +If no \fIpackage-name-pattern\fP is given, list all packages in +\fI%ADMINDIR%/status\fP, excluding the ones marked as not-installed (i.e. +those which have been previously purged). +Normal shell wildcard characters are allowed in \fIpackage-name-pattern\fP. +Please note you will probably have to quote \fIpackage-name-pattern\fP to +prevent the shell from performing filename expansion. +For example this will list all package names starting with \*(lqlibc6\*(rq: .nf \fBdpkg\-query \-l 'libc6*'\fP -- Dpkg.Org's dpkg