Skip to content

Draft: abuild: rename man pages for perl vendor modules

There are more than 20 packages in the aports that manually handle conflicting man pages between perl-doc and perl--doc. This tries to solve the issue with a different approach:

Because the code of perl modules is installed into vendor_perl whereas main/perl installs into core_perl, name clashes in the implementation do not result in file conflicts and the implementation can be installed side by side. This renames the man pages with the 3pm suffix for vendor modules to 3pm-vendor, to also allow the man pages to be installed side by side.

Note that this approach is preferred over just removing the "duplicaiton", as in fact two different implementations with the same name are available that may differ in their API and semantics. Hence, separate documentation is also sensible. The postfix 3vendor-pm for vendor modules instead of 3pm (still used for core modules) was chosen because it is alphabetically greater than 3pm, so that perl core man pages are preferred over vendor man pages, if both are available for the same name. Calling man 3vendor-pm foo would still allow to show the vendor man page explicitly.

Merge request reports