--- Begin Message ---
Package: dlocate
Version: 1.02
Severity: normal
Tags: patch
Hi,
the manpages for dlocate, dpkg-hold, dpkg-unhold, dpkg-purge and dpkg-remove
contain many mistakes which can easily confuse first-time users.
For example, the manpage of dpkg-unhold states:
> dpkg-unhold marks package(s) to be held.
while the actual command clearly does the complete opposite.
I have gone through all manpages, fixed the mistakes and created a
patch to be applied for the next upload.
I couldn't find a source code repository for the dlocate package,
so I created a diff between my fixed package and the current package
1.02 in unstable.
Cheers,
Adrian
-- System Information:
Debian Release: wheezy/sid
APT prefers testing
APT policy: (500, 'testing'), (100, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386
Kernel: Linux 3.6-trunk-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) (ignored: LC_ALL
set to en_US.UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages dlocate depends on:
ii dctrl-tools [grep-dctrl] 2.22.2
ii dpkg 1.16.9
ii perl 5.14.2-16
dlocate recommends no packages.
dlocate suggests no packages.
-- no debconf information
diff -ur dlocate-1.02/dlocate.1 dlocate-1.02.new/dlocate.1
--- dlocate-1.02/dlocate.1 2009-06-03 03:11:48.000000000 +0200
+++ dlocate-1.02.new/dlocate.1 2012-12-21 11:36:18.236437259 +0100
@@ -36,7 +36,7 @@
\fBdlocate -F '/usr/bin/['\fP
.TP
.BR \-S
-list all records where only the filename matches
+List all records where only the filename matches
.IR PATTERN .
Note that dlocate uses GNU grep, so normal regexp metacharacters need to be taken into account.
@@ -66,8 +66,6 @@
Both of these will list all the packages whose names start with `libc6'.
-
-
Note that because of the difference between regular expressions and
dpkg's shell\-style pattern matching, the output from \fBdlocate -l\fP
is occasionally different to the output from \fBdpkg -l\fP.
@@ -210,7 +208,7 @@
.TP
.I /var/lib/dlocate/dlocatedb
-plain text listing of all files belonging to all packages (optionally compressed)
+Plain text listing of all files belonging to all packages (optionally compressed)
.TP
.I /var/lib/dlocate/dpkg-list
@@ -289,8 +287,6 @@
and
\fBgrep\-dctrl\fP(1).
-
-
.SH AUTHOR
dlocate was written by Jim Pick <[email protected]> and Craig Sanders
<[email protected]>. dlocate is Free Software licensed under the GNU
diff -ur dlocate-1.02/dpkg-hold.8 dlocate-1.02.new/dpkg-hold.8
--- dlocate-1.02/dpkg-hold.8 2009-06-02 02:00:47.000000000 +0200
+++ dlocate-1.02.new/dpkg-hold.8 2012-12-21 11:30:16.221781379 +0100
@@ -4,7 +4,7 @@
.\" other parms are allowed: see man(7), man(1)
.SH NAME
-dpkg-hold - program to flag for hold a package or packages
+dpkg-hold - mark packages as `hold' to prevent installation
.SH SYNOPSIS
@@ -19,11 +19,10 @@
It achieves this by running `dpkg --set-selections' and piping in the
package name(s) followed by `hold'.
-NOTE: this program does not install, remove, purge any package. it ONLY
+NOTE: This program does not install, remove, purge any package. It ONLY
sets the status of the package. Any actual removal or purging is done
the next time dselect, apt-get, aptitude, etc are run.
-
.SH "SEE ALSO"
\fBdpkg\fP(1),
\fBdpkg-unhold\fP(1),
diff -ur dlocate-1.02/dpkg-purge.8 dlocate-1.02.new/dpkg-purge.8
--- dlocate-1.02/dpkg-purge.8 2009-06-02 02:00:53.000000000 +0200
+++ dlocate-1.02.new/dpkg-purge.8 2012-12-21 11:34:30.467221543 +0100
@@ -4,7 +4,7 @@
.\" other parms are allowed: see man(7), man(1)
.SH NAME
-dpkg-purge - program to flag for purge a package or packages
+dpkg-purge - mark packages for purge
.SH SYNOPSIS
@@ -19,11 +19,10 @@
It achieves this by running `dpkg --set-selections' and piping in the
package name(s) followed by `purge'.
-NOTE: this program does not install, remove, purge any package. it ONLY
+NOTE: This program does not install, remove, purge any package. It ONLY
sets the status of the package. Any actual removal or purging is done
the next time dselect, apt-get, aptitude, etc are run.
-
.SH "SEE ALSO"
\fBdpkg\fP(1),
\fBdpkg-hold\fP(1),
diff -ur dlocate-1.02/dpkg-remove.8 dlocate-1.02.new/dpkg-remove.8
--- dlocate-1.02/dpkg-remove.8 2009-06-02 02:00:57.000000000 +0200
+++ dlocate-1.02.new/dpkg-remove.8 2012-12-21 11:33:25.808890894 +0100
@@ -4,7 +4,7 @@
.\" other parms are allowed: see man(7), man(1)
.SH NAME
-dpkg-remove - program to flag for removal a package or packages
+dpkg-remove - mark packages for removal
.SH SYNOPSIS
@@ -14,16 +14,15 @@
.SH "DESCRIPTION"
.PP
.B dpkg-remove
-marks package(s) to be held.
+marks package(s) to be removed.
It achieves this by running `dpkg --set-selections' and piping in the
package name(s) followed by `deinstall'.
-NOTE: this program does not install, remove, purge any package. it ONLY
+NOTE: This program does not install, remove, purge any package. It ONLY
sets the status of the package. any actual removal or purging is done
the next time dselect, apt-get, aptitude, etc are run.
-
.SH "SEE ALSO"
\fBdpkg\fP(1),
\fBdpkg-hold\fP(1),
diff -ur dlocate-1.02/dpkg-unhold.8 dlocate-1.02.new/dpkg-unhold.8
--- dlocate-1.02/dpkg-unhold.8 2009-06-02 02:01:03.000000000 +0200
+++ dlocate-1.02.new/dpkg-unhold.8 2012-12-21 11:27:53.285473127 +0100
@@ -4,7 +4,7 @@
.\" other parms are allowed: see man(7), man(1)
.SH NAME
-dpkg-unhold - program to flag for installation a package or packages
+dpkg-unhold - mark held packages for installation
.SH SYNOPSIS
@@ -14,19 +14,19 @@
.SH "DESCRIPTION"
.PP
.B dpkg-unhold
-marks package(s) to be held.
+marks package(s) to be installed.
-it achieves this by running `dpkg --set-selections' and piping in the
+It achieves this by running `dpkg --set-selections' and piping in the
package name(s) followed by `install'.
-NOTE: this program does not install, remove, purge any package. it ONLY
-sets the status of the package. any actual removal or purging is done
+NOTE: This program does not install, remove, purge any package. It ONLY
+sets the status of the package. Any actual removal or purging is done
the next time dselect, apt-get, aptitude, etc are run.
.SH "BUGS"
The name is little bit of a misnomer in that it marks the package for
-installation. this effectively "unholds" the package if it is held, but
+installation. This effectively "unholds" the package if it is held, but
will cause dselect/apt/etc to install it if it wasn't already installed.
--- End Message ---
