|Summary:||libbsd 0.8.4 move of man pages to section 3bsd incomplete?|
|Product:||libbsd||Reporter:||Sebastian Pipping <webmaster>|
|Component:||libbsd||Assignee:||Guillem Jover <guillem>|
|Status:||RESOLVED FIXED||QA Contact:|
|i915 platform:||i915 features:|
Description Sebastian Pipping 2017-06-21 18:15:38 UTC
Hi! I noticed that f20e6972b3a5ef4d1bfa2e3b2577caa3f9e357fc moved man pages from section 3 to section 3bsd (which is cool, because there we collisions previously, e.g. ). I wonder if the installation directory should still be /usr/share/man/man3 (rather than /usr/share/man/man3bsd) but latter did not make my man find the man page out of the box any more (while former still does, despite file ending .3bsd(.bz2)). Also inside the man page, the header still says section 3, e.g. "HUMANIZE_NUMBER(3)". I would expect "HUMANIZE_NUMBER(3bsd)" here from a user point of view. I'm curious about what can and should change and what should not. Best Sebastian  https://bugs.gentoo.org/show_bug.cgi?id=617462
Comment 1 Guillem Jover 2017-06-22 03:09:14 UTC
Hi! Yeah we had similar collisions in Debian, so this was the most future-proof way to go about. :) The directory is fine as it is, you might also have things like «.3perl» and similar in your distribution already. The suffix extension is standard man practice, it should be documented in man(1) (at least for man-db :). Regarding the section number inside the man, I considered changing that, but discarded it because it might make people use such links which might not be portable. OTOH I also considered that not doing so was in a way not completely correct. So I'm a bit undecided on this. Will ponder about it a bit and let you know.
Comment 2 Guillem Jover 2017-06-24 15:32:05 UTC
This should now be fixed in libbsd 0.8.5. Closing.