[Pkg-samba-maint] Bug#769385: samba-doc: There are no docs, only examples

[Paul Slootman]

Package: samba-doc
Version: 2:4.1.13+dfsg-2
Severity: normal

The package name is a misnomer nowadays.
I installed it expecting to browse the HTMl documentation. I understand
that upstream has removed the HTML documentation, so that's unfortunate.
However, does it make sense to continue calling this package "samba-doc"
while there is no documentation as such included in the package? The
description says:

 This package contains all the manpage documentation for the Samba
 suite.

However all the manpages are included in the main samba package,
as they should be.

I suggest renaming this package to samba-examples, and perhaps
make samba-doc a transitional package that suggests samba-doc-pdf?


Thanks,
Paul Slootman

-- System Information:
Debian Release: jessie/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'stable'), (500, 'oldstable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 3.15.6-wurtel-ws (SMP w/8 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages samba-doc depends on:
ii  dpkg  1.17.12

samba-doc recommends no packages.

samba-doc suggests no packages.

-- no debconf information