Browse Source

man: Attempt to clarify and improve wording of some strange constructs

Reported-by: Helge Kreutzmann
Guillem Jover 12 years ago
parent
commit
46d7b70a2d
4 changed files with 14 additions and 11 deletions
  1. 3 0
      debian/changelog
  2. 2 2
      man/dpkg-maintscript-helper.1
  3. 4 4
      man/dpkg-query.1
  4. 5 5
      man/dpkg.1

+ 3 - 0
debian/changelog

@@ -22,6 +22,9 @@ dpkg (1.17.10) UNRELEASED; urgency=low
   * Make dpkg-maintscript-helper print only once that we are moving a
     conffile, and not on every interim state transition. Closes: #747370
   * Do not use global match variables in perl code.
+  * Man pages:
+    - Attempt to clarify and improve wording of some strange or confused
+      constructs. Reported by Helge Kreutzmann.
 
   [ Updated manpages translations ]
   * German (Helge Kreutzmann).

+ 2 - 2
man/dpkg-maintscript-helper.1

@@ -237,6 +237,6 @@ the currently installed \fBdpkg\fP:
     fi
 .P
 The command \fBsupports\fP will return 0 on success, 1 otherwise. The
-\fBsupports\fP command will check if the required environment variables
-by the script as set by dpkg have been setup, and will consider it a
+\fBsupports\fP command will check if the environment variables as set
+by dpkg and required by the script are present, and will consider it a
 failure in case the environment is not sufficient.

+ 4 - 4
man/dpkg-query.1

@@ -123,10 +123,10 @@ file if it is present.
 \fBWarning\fP: this command is deprecated as it gives direct access to the
 internal dpkg database, please switch to use \fB\-\-control\-list\fP and
 \fB\-\-control\-show\fP instead for all cases where those commands might
-give the same end result. Although there is still at least one case where
-this command is needed (i.e. when having to remove a damaging postrm
-maintainer script), and as long as there is no good solution for that,
-this command will not get removed.
+give the same end result. Although, as long as there is still at least
+one case where this command is needed (i.e. when having to remove a
+damaging postrm maintainer script), and while there is no good solution
+for that, this command will not get removed.
 .TP
 .BR \-S ", " \-\-search " \fIfilename-search-pattern\fP..."
 Search for packages that own files corresponding to the given pattern.

+ 5 - 5
man/dpkg.1

@@ -206,11 +206,11 @@ Removing of a package consists of the following steps:
 .TP
 .BR \-V ", " \-\-verify " [\fIpackage-name\fP...]
 Verifies the integrity of \fIpackage-name\fP or all packages if omitted,
-by comparing information from the package installed paths with information
-from the files taken from the package metadata stored in the \fBdpkg\fP
-database. The origin of the information in the database is the binary
-packages themselves, which gets collected at package unpack time during
-installation.
+by comparing information from the files installed by a package with the
+files metadata information stored in the \fBdpkg\fP database. The origin
+of the files metadata information in the database is the binary packages
+themselves. That metadata gets collected at package unpack time during
+the installation process.
 
 The output format is selectable with the \fB\-\-verify\-format\fP
 option, which by default uses the \fBrpm\fP format, but that might