Bug#881343: pk4: Please avoid the use of "avail" in package descriptions

[Chris Lamb]

Source: pk4
Version: 3
Severity: wishlist
Tags: patch

Hi,

First, thanks for writing and maintaining pk4!

I think we spoke about this before but I just can't help but find it
difficult to parse the word "avail".

I'm sure it is 100% correct with respect to the dictionary definition
but the usage here comes across ungainly and ultimately an impediment to
adoption as it makes it somewhat unclear what the package does from the
short description.

Patch attached that uses "extract" which not only moves away from the
problems of avail it also captures rather better what pk4 does, despite
— of course — pk4 doing more than this. :)


Best wishes,

-- 
      ,''`.
     : :'  :     Chris Lamb
     `. `'`      la...@debian.org / chris-lamb.co.uk
       `-

diff --git a/README.md b/README.md
index 1c3e1cf..7d831cb 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# pk4 — avail the Debian source package producing the specified package
+# pk4 — Extract the Debian source package producing the specified package
 
 Please see [the pk4(1)
 manpage](https://manpages.debian.org/unstable/pk4/pk4.1.en.html) for
diff --git a/debian/control b/debian/control
index 63433b0..6fe38d3 100644
--- a/debian/control
+++ b/debian/control
@@ -21,7 +21,7 @@ Depends: ${shlibs:Depends}, ${misc:Depends},
         systemd-sysv
 Recommends: sbuild
 Built-Using: ${misc:Built-Using}
-Description: avail the Debian source package producing the specified package
+Description: Extract the Debian source package producing the specified package
  pk4 resolves the specified argument(s) as either:
  .
  1. the name of a Debian binary package, and selects its Debian source package.
diff --git a/pk4-generate-index.1 b/pk4-generate-index.1
index 57736de..b43dc27 100644
--- a/pk4-generate-index.1
+++ b/pk4-generate-index.1
@@ -32,6 +32,6 @@ Directory to store the pk4 index files in (default 
\fI/var/cache/pk4\fR).
 .SH SEE ALSO
 .TP
 .IR pk4(1)
-avail the Debian source package producing the specified package
+Extract the Debian source package producing the specified package
 .SH AUTHOR
 Michael Stapelberg <stapelberg at debian.org>
diff --git a/pk4-replace.1 b/pk4-replace.1
index 139e199..944055c 100644
--- a/pk4-replace.1
+++ b/pk4-replace.1
@@ -60,7 +60,7 @@ Build-Command:
 .SH SEE ALSO
 .TP
 .IR pk4(1)
-avail the Debian source package producing the specified package
+Extract the Debian source package producing the specified package
 .TP
 .IR sbuild(1)
 build debian packages from source
diff --git a/pk4.1 b/pk4.1
index cdb188e..f95883f 100644
--- a/pk4.1
+++ b/pk4.1
@@ -11,7 +11,7 @@
 .TH pk4 1 "OCTOBER 2017" Linux "User Manuals"
 
 .SH NAME
-pk4 \- avail the Debian source package producing the specified package
+pk4 \- Extract the Debian source package producing the specified package
 
 .SH SYNOPSIS
 .B pk4