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

Hamish Moffatt hamish-debian at cloud.net.au
Mon Mar 13 23:09:41 UTC 2017


On 11/03/17 02:48, gregor herrmann wrote:
> On Fri, 10 Mar 2017 15:05:18 +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 ...).
>
> In this case upstream seems rather inactive, so I wouldn't expect
> major improvements in the documentation ...
>

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).

Perhaps you could mention the manpage in the README?


regards

Hamish



More information about the pkg-perl-maintainers mailing list