[doc] Why language manpages are in section 1, eg. `perlre(1)`?

[rwp0]

Where eg. perlre(1), perlretut(1), perlreref(1)

Description unix manpages for perl's language-specific documentation such as those prefixed with perl (eg. perlfunc) that should have probably been in section 7 (misc) are in section 1 (commands) of manual pages which is confusing searching an reading on terminal.

---

7p might be a better idea consistent with module manpages in 3p

[Leont]

Essentially this is because our install system doesn't have a concept of a section 7, only sections 1 and 3..

It's entirely possible to add it, but it would probably have to be handled in a bunch of places.

[rwp0]

This might have been a serious error, Unix('s documentation system) as a cultural home of Perl shouldn't suffer pollution because of such misorganization (and ignorances), in my somewhat strict opinion.

I hope to see this corrected in Perl 7, because why not? (How may I help apart from reporting that as an issue?)

Keeping binaries in section 1, modules in 3, and adding section 7 for miscellaneous perl*(1) pages shouldn't be that hard and worthless of spending efforts on.

Being correct has some value in itself, I believe. :-)

---

I think, it would also be nice to see each(3p) C-style function documentation in addition to capitalized Storable(3p) existing module manpages instead of relying solely on platform-agnostic perldoc -f.

Perl could benefit in claiming to be somewhat Unix's de facto scripting (dynamic) language similar to the native compiled C by integrating with it more nicely unlike Python, PHP, and Ruby.