+Wed Aug 1 17:31:23 CEST 2001 Wichert Akkerman <wakkerma@debian.org>
+
+ * main/dpkg-query.8: added
+ * main/Makefile.in, debian/rules: install dpkg-query.8
+
+Wed Aug 1 16:37:47 CEST 2001 Wichert Akkerman <wakkerma@debian.org>
+
+ * main/dpkg.8: remove Linux references
+
Wed Aug 1 15:35:32 CEST 2001 Wichert Akkerman <wakkerma@debian.org>
* debian/copyright: mention we have copyright for 2001 as well
* Handle window resize in dselect main menu. Closes: Bug#98275
* update-rc.d moved to the sysvinit package
- -- Wichert Akkerman <wakkerma@debian.org> UNRELEASED
+ -- Wichert Akkerman <wakkerma@debian.org> Wed, 1 Aug 2001 15:12:57 +0200
dpkg (1.9.16) unstable; urgency=low
fi ; \
done ; \
install -d -m 755 -o root -g root $(TMP_DPKG)/usr/share/man/$$i/man8 ; \
- for m in dpkg.8 dpkg-split.8 start-stop-daemon.8 \
+ for m in dpkg.8 dpkg-query.8 dpkg-split.8 start-stop-daemon.8 \
cleanup-info.8 dpkg-divert.8 dpkg-statoverride.8 \
install-info.8 update-alternatives.8 ; do \
if [ -f $(INSTALL_TMP)/usr/share/man/$$i/man8/$$m ] ; then \
cleanup.c select.c packages.c configure.c remove.c \
help.c depcon.c errors.c update.c
-MAN8PAGES = dpkg.8
+MAN8PAGES = dpkg.8 dpkg-query.8
OBJECTS = $(patsubst %.c, %.o, $(SOURCES))
GENFILES = $(OBJECTS) archtable.h dpkg dpkg-static
--- /dev/null
+.TH DPKG\-QUERY 8 "August 2001" "Debian Project" "dpkg suite"
+.SH NAME
+dpkg\-query \- a tool to query the dpkg database
+
+.SH SYNOPSIS
+.B dpkg-query
+
+.SH DESCRIPTION
+\fBdpkg-query\fP is a tool to show information about packages listed in
+the \fBdpkg\fP database.
+
+
+.SH COMMANDS
+.TP
+\fB-l\fP | \fB--list\fP \fIpackage-name-pattern\fP ...
+List packages matching given pattern. If no \fIpackage-name-pattern\fP
+is given, list all packages in \fI/var/lib/dpkg/available\fP. Normal
+shell wildchars 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 \*(lqlibc5\*(rq:
+
+.T
+.nf
+ \fBdpkg-query -l 'libc5*'\fP
+.fi
+.TP
+\fB-W\fP | \fB--show\fP \fIpackage-name-pattern\fP ...
+Just like the \fB--list\fP option this will list all packages matching
+the given pattern. However the output can be customized using the
+\fB--showformat\fP option.
+.TP
+\fB-s\fP | \fB--status\fP \fIpackage-name\fP ...
+Report status of specified package. This just displays the entry in
+the installed package status database.
+.TP
+\fB-L\fP | \fB--listfiles\fP \fIpackage\fP ...
+List files installed to your system from \fBpackage\fP.
+However, note that files created by package-specific
+installation-scripts are not listed.
+.TP
+\fB-S\fP | \fB--search\fP \fIfilename-search-pattern\fP ...
+Search for a filename from installed packages. All standard shell
+wildchars can be used in the pattern.
+.TP
+\fB--licence\fP | \fB--license\fP
+Display licence and copyright information.
+.TP
+\fB--version\fP
+Display version information.
+
+.SH OPTIONS
+.TP
+\fB--admindir=\fIdir\fP
+Change the location of the \fBdpkg\fR database. The default location is
+\fI/var/lib/dpkg\fP.
+.TP
+\fB--showformat=\fP\fIformat\fR
+This option is used to specify the format of the output \fB--show\fP
+will produce. The format is a string that will be output for each package
+listed. It can include the standard escape sequences \en (newline), \er
+(carriage return) or \e\e (plain backslash). Package information can be
+included by inserting variable references to package fields using the
+${var[;width]} syntax. Fields are printed be right-aligned unless the
+width is negative in which case left aligenment will be used.
+
+.SH ENVIRONMENT
+.TP
+\fBCOLUMNS\fP
+This setting influences the output of the \fB--list\fP option by changing
+the width of its output.
+
+.SH AUTHOR
+Copyright 2001 Wichert Akkerman
+.UR mailto:wakkerma@debian.org
+<wakkerma@debian.org>
+.UE
+.sp
+This is free software; see the GNU General Public Licence version 2 or
+later for copying conditions. There is NO warranty.
+
+
+.SH SEE ALSO
+.BR dpkg (8)
+
.SH DESCRIPTION
\fBdpkg\fP is a medium-level tool to install, build, remove and manage
-Debian GNU/Linux packages. The primary and more user-friendly
+Debian packages. The primary and more user-friendly
front-end for \fBdpkg\fP is \fBdselect\fP(8). \fBdpkg\fP itself is
controlled entirely via command line parameters, which consist of exactly
one action and zero or more options. The action-parameter tells dpkg
combined with information from \fIPackages-file\fP. With action
\fB--update-avail\fP, old information is replaced with the information
in the \fIPackages-file\fP. The \fIPackages-file\fP distributed with
-Debian GNU/Linux is simply named \fIPackages\fP. \fBdpkg\fP keeps its
+Debian is simply named \fIPackages\fP. \fBdpkg\fP keeps its
record of available packages in \fI/var/lib/dpkg/available\fP.
.TP
\fBdpkg -A\fP | \fB--record-avail\fP \fIpackage_file\fP ...
.nf
\fBdpkg -b\fP | \fB--build\fP \fIdirectory\fP [\fIfilename\fP]
- Build a Debian GNU/Linux package.
+ Build a deb package.
\fBdpkg -c\fP | \fB--contents\fP \fIfilename\fP
- List contents of Debian GNU/Linux package.
+ List contents of a deb package.
\fBdpkg -e\fP | \fB--control\fP \fIfilename\fP [\fIdirectory\fP]
Extract control-information from a package.
\fBdpkg -x\fP | \fB--extract\fP \fIfilename directory\fP