Bug#881714: libio-aio-perl: IO::AIO comes with a useful command line utility (a kind of fast find) which is not installed in the debian package

[Marc Lehmann]

Package: libio-aio-perl
Version: bin/treescan not installed
Severity: normal

Dear Maintainer,

the IO::AIO package comes with a utility called "treescan" which is
installed when the package is installed by normal means.

Apparently, the debian package moves it into the documetation folder as an
example.

While it might serve as an example (just like any application of any
library might serve as an example) it's explicitgly not packages as an
example - example files normally go into eg/, executable porgrams go into
bin/ and are installed normally, so the debian package shouldn't change it
into an example and not install it properly.

While I am the author of IO::AIO and naturally have a totally inflated
notion of how important treescan is, it is nevertheless a useful tool
(at the very least, for me, and it cost me a while to understand
why the treescan tool is missing on some customer server evem
though the libio-aio-perl package is installed and there is no e.g.
libio-aio-perl-bin or so either), and debian should have a good reason of
patching the upstream package to move it into example-only status :)

To give an example of how it can be useful, this is a find on a standard
debian /usr with cold cache on an ssd with both treescan and find:

   time treescan /usr|grep -i xyzzy\$ >/dev/null
   real    0m9.331s

   time find /usr -iname "*.xyzzy" >/dev/null
   real    0m13.723s

The differences between find and treescan on rotational media with lots of
files are much more spectacular and cans be the difference between an hour
and 6 minutes.

So, it's useful. So go and please pleas epackage it or don't call your
package libio-aio-perl when it doesn't actually package that perl module
:)

I rest my case, thanks for your attention and thanks for your work on
Debian GNU/Linux!

-- System Information:
Debian Release: 9.1
  APT prefers stable
  APT policy: (990, 'stable'), (500, 'stable-updates'), (500, 'unstable'), (500, 'testing'), (1, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 4.13.12-041312-generic (SMP w/8 CPU cores)
Locale: LANG=C, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE=C (charmap=UTF-8)
Shell: /bin/sh linked to /usr/bin/bash
Init: systemd (via /run/systemd/system)

Versions of packages libio-aio-perl depends on:
ii  libc6                       2.24-11+deb9u1
ii  libcommon-sense-perl        3.74-2
ii  perl                        5.24.1-3+deb9u2
ii  perl-base [perlapi-5.24.1]  5.24.1-3+deb9u2
pn  perlapi-5.26.0              <none>

libio-aio-perl recommends no packages.

libio-aio-perl suggests no packages.