Bug#857325: libapache2-authenntlm-perl: documentation inadequate

[gregor herrmann]

On Tue, 14 Mar 2017 10:09:41 +1100, Hamish Moffatt wrote:

> > > The documentation does not provide any details of how to configure this module.
> > > There is some documentation via "perldoc Apache2::AuthenNTLM" but this isn't referenced in the README.
> > A README is only for additional information, the real documentation
> > is always `man Apache2::AuthenNTLM' = `perldoc Apache2::AuthenNTLM'
> > (which may or may not be sufficient ...).
> I didn't expect to find Apache module documentation in man - certainly the
> other Apache modules I just checked do not have man pages (fastcgi, php5).

Ah, I see, you thought from the "Apache module" side, and I came from
the "typical Perl module like thousands of others" side.
 
> Perhaps you could mention the manpage in the README?

Wouldn't hurt, right.


Cheers,
gregor

-- 
 .''`.  https://info.comodo.priv.at/ - Debian Developer https://www.debian.org
 : :' : OpenPGP fingerprint D1E1 316E 93A7 60A8 104D  85FA BB3A 6801 8649 AA06
 `. `'  Member of VIBE!AT & SPI, fellow of the Free Software Foundation Europe
   `-   NP: Paco De Lucia, Al Di Meola, John Mc Laughlin: Cardeosa
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 963 bytes
Desc: Digital Signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-perl-maintainers/attachments/20170314/278d904d/attachment.sig>