[pkg-opensc-maint] Bug#797529: libengine-pkcs11-openssl: bogus /usr/share/doc directory

[Justin B Rye]

Package: libengine-pkcs11-openssl
Version: 0.1.8-5
Severity: normal

I happened to notice while grepping the Contents file that this
library puts upstream documentation in the wrong place:

	/.
	/usr
	/usr/share
	/usr/share/doc-base
	/usr/share/doc-base/engine-pkcs11
	/usr/share/doc
 ====>	/usr/share/doc/engine_pkcs11
 ====>	/usr/share/doc/engine_pkcs11/NEWS.gz
 ====>	/usr/share/doc/engine_pkcs11/README
	/usr/share/doc/libengine-pkcs11-openssl
	/usr/share/doc/libengine-pkcs11-openssl/changelog.Debian.gz
	/usr/share/doc/libengine-pkcs11-openssl/changelog.gz
	/usr/share/doc/libengine-pkcs11-openssl/copyright
	/usr/share/doc/libengine-pkcs11-openssl/html
	/usr/share/doc/libengine-pkcs11-openssl/html/wiki
	[...]
     
This seems unlikely to be intentional, since for a start the README
has no particular reason to exist besides serving as a signpost in the
direction of the engine_pkcs11 wikidump, but it wrongly claims to be
sitting in the same directory as those HTML docs.

The directory name it's mistakenly hogging is one that can never
collide with any legal inhabitant of the /usr/share/doc/<packagename>/
namespace, but anybody looking for the NEWS file is going to have
trouble finding it, and it is in breach of a Policy 12.3 "should".

-- System Information:
Debian Release: stretch/sid
  APT prefers testing
  APT policy: (990, 'testing'), (50, 'unstable')
Architecture: i386 (i686)

Kernel: Linux 4.2.0-rc8-686-pae (SMP w/1 CPU core)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages libengine-pkcs11-openssl depends on:
ii  libc6        2.19-19
ii  libp11-2     0.2.8-6
ii  libssl1.0.0  1.0.2d-1

libengine-pkcs11-openssl recommends no packages.

libengine-pkcs11-openssl suggests no packages.

-- no debconf information
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package