<div dir="auto">Sorry about the upstream list post. I had replied to a couple posts on that list recently and typed it in out of habit, I guess.<div dir="auto"><br></div><div dir="auto">So the options are generally either keep it in $PATH and add docs or move it to /usr/share/doc/? If I were to work on thie docs and submit a patch, how long would you be willing to wait? I might not be able to get to it right away.</div><div dir="auto"><br></div><div dir="auto">oldtechaa</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Feb 26, 2018 4:48 AM, "intrigeri" <<a href="mailto:intrigeri@debian.org" target="_blank">intrigeri@debian.org</a>> wrote:<br type="attribution"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi,<br>
<br>
> oldtechaa:<br>
> I see what you mean. I think a suggestion would still be good.<br>
<br>
> As for its usefulness, it can help with the nuances of the Perl binding.<br>
> Some things get bound kind of weirdly, so personally, I use the C API<br>
> reference but when something doesn't work as it should, I use perli11ndoc.<br>
> The perl-specific examples can be invaluable.<br>
<br>
OK, this makes sense to me.<br>
<br>
> While it's convenient to have it in $PATH, I can see it being a problem,<br>
> especially since having no manpage violates Debian standards, doesn't it?<br>
> The problem is that's true of any executable from what I saw, not just<br>
> those in $PATH.<br>
<br>
The Debian Policy is not specific about this:<br>
<a href="https://www.debian.org/doc/debian-policy/#manual-pages" rel="noreferrer" target="_blank">https://www.debian.org/doc/<wbr>debian-policy/#manual-pages</a><br>
<br>
… but the Lintian check clarifies this with "Each binary in /usr/bin,<br>
/usr/sbin, /bin, /sbin or /usr/games should have a manual page":<br>
<a href="https://lintian.debian.org/tags/binary-without-manpage.html" rel="noreferrer" target="_blank">https://lintian.debian.org/<wbr>tags/binary-without-manpage.<wbr>html</a><br>
<br>
I don't recall seeing a manpage for a script shipped in<br>
/usr/share/doc/$PACKAGE/<wbr>examples.<br>
<br>
> Is there any way we can follow standards but keep<br>
> perli11ndoc, even if it's slightly less convenient?<br>
<br>
Sure: write a manpage (e.g. add POD and generate a manpage from it at<br>
build time or similar).<br>
<br>
Cheers,<br>
--<br>
intrigeri<br>
</blockquote></div></div>