Bug 889898

Summary:	perl-functions.eclass: Improve doc comment for perl_delete_module_manpages
Product:	Gentoo Linux	Reporter:	Alexis <flexibeast>
Component:	Eclasses	Assignee:	Gentoo Perl team <perl>
Status:	CONFIRMED ---
Severity:	normal	CC:	sam
Priority:	Normal
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---

Description Alexis 2023-01-06 02:52:54 UTC

It might be helpful for the documentation comment for the perl_delete_module_manpages function to mention that module manpages are intentionally removed in order to avoid collisions (as per https://bugs.gentoo.org/119241#c1), and that perldoc should instead be used for accessing module documentation. 

Opening this bug suggested by u/thesamsame in https://www.reddit.com/r/Gentoo/comments/103yfaw/comment/j34o0a6/:

> At the very least, this warrants a comment in the eclass, so please do file a bug anyway, but I think perldoc is likely why, yes.