Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 889898 - perl-functions.eclass: Improve doc comment for perl_delete_module_manpages
Summary: perl-functions.eclass: Improve doc comment for perl_delete_module_manpages
Status: CONFIRMED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Eclasses (show other bugs)
Hardware: All Linux
: Normal normal
Assignee: Gentoo Perl team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2023-01-06 02:52 UTC by Alexis
Modified: 2023-01-06 08:19 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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.