Re: [bug-gnu-libiconv] man page title

[Bruno Haible]

Hi Mike,

> One of the people using the man pages for libiconv that has been ported to
> z/OS
> was surprised to see the title of the man pages for the various iconv
> commands
> with:
>  Linux Programmer's Manual
> in the middle of the first line.
> I noticed commands like 'less' and 'find' have
>   General Commands Manual
> and gnu make has:
>   User Commands
> 
> Would it be possible to change this to something OS-agnostic?

Indeed, it does not make sense to view man1 pages as part of a
"Programmer's Manual". For man2 pages, it makes sense to have
the title "Linux Programmer's Manual", but for man1 and man3 pages
it does not.

Currently, the title of the man pages of the Linux man-pages project
depends on the distro:

          Debian                            Ubuntu

  man1:   General Commands Manual           Linux User Manual
  man2:   System Calls Manual               Linux Programmer's Manual
  man3:   Library Functions Manual          Linux Programmer's Manual
  man4:   Kernel Interfaces Manual          Linux Programmer's Manual
  man5:   File Formats Manual               File Formats Manual
  man7:   Miscellaneous Information Manual  Linux Programmer's Manual
  man8:   System Manager's Manual           System Manager's Manual

Some of these titles come from the GNU groff package, which has:

.  ds an*section1 General Commands Manual\"
.  ds an*section2 System Calls Manual\"
.  ds an*section3 Library Functions Manual\"
.  ds an*section4 Kernel Interfaces Manual\"
.  ds an*section5 File Formats Manual\"
.  ds an*section6 Games Manual\"
.  ds an*section7 Miscellaneous Information Manual\"
.  ds an*section8 System Manager's Manual\"
.  ds an*section9 Kernel Developer's Manual\"

Roumen Petrov wrote:
> iconv as part of GNU C library should be "Linux ..."

That should better be "GNU Commands Manual" or "GNU Programmer's Manual",
respectively. Since it's not kernel related; it's the same on the Hurd
as on Linux.

> but outside perhaps should  skip manual  argument

Agree. Done:
https://git.savannah.gnu.org/gitweb/?p=libiconv.git;a=commitdiff;h=db5e62f4c66124a6edecf17a61c823dc5e0b159f

Bruno