]> err.no Git - dpkg/commitdiff
Add dpkg-query manpage
authorWichert Akkerman <wakkerma@debian.org>
Wed, 1 Aug 2001 15:32:19 +0000 (15:32 +0000)
committerWichert Akkerman <wakkerma@debian.org>
Wed, 1 Aug 2001 15:32:19 +0000 (15:32 +0000)
ChangeLog
debian/changelog
debian/rules
main/Makefile.in
main/dpkg-query.8 [new file with mode: 0644]
main/dpkg.8

index ca592a88f782f030c52794aa2550863ee2941a19..6945e44fe11ba1b175bf494a0e5e5cff01f4d41c 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+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
index e860f03b73bf65f59ce67c19c52c3d552b50d347..e0b351471f66db74d4d4a9d6e8fd98e84516f8a8 100644 (file)
@@ -35,7 +35,7 @@ dpkg (1.10) unstable; urgency=low
   * 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
 
index 1e13fa7e988f2568185dbc8ff9c682754ca2e615..484c1126161efe64ba5557948029c37742432146 100755 (executable)
@@ -106,7 +106,7 @@ binary-dpkg-most binary-dpkg-static-most: binary-dpkg%-most: stamp-binary%
                        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 \
index 5092ec13c4a679ef65831d0392f21e05925cffd1..f17a67bf481fb655b7533698e37a04940d771de3 100644 (file)
@@ -9,7 +9,7 @@ SOURCES         = main.c enquiry.c filesdb.c archives.c processarc.c \
                  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
diff --git a/main/dpkg-query.8 b/main/dpkg-query.8
new file mode 100644 (file)
index 0000000..f2db7d9
--- /dev/null
@@ -0,0 +1,85 @@
+.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)
+
index 143b63aaa60ec178e5da818ccac863eeac3b7cdd..3eb4712672f089687035c31c7d06851574743d41 100644 (file)
@@ -22,7 +22,7 @@ Tools\fP topic in the same place.
 
 .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
@@ -179,7 +179,7 @@ available.  With action \fB--merge-avail\fP, old information is
 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 ...
@@ -275,9 +275,9 @@ See \fBdpkg-deb\fP(1) for more information about the following actions.
 
 .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