[bug #44707] grog(1) (1.22.3 - Solaris 10 X86_64) reports ".../grog/subs.pl 397: Unknown file name extension ..."

[anonymous]

URL:
  <http://savannah.gnu.org/bugs/?44707>

                 Summary: grog(1) (1.22.3 - Solaris 10 X86_64) reports
".../grog/subs.pl 397: Unknown file name extension ..."
                 Project: GNU troff
            Submitted by: None
            Submitted on: Fri 03 Apr 2015 12:56:26 AM UTC
                Severity: 3 - Normal
              Item Group: Incorrect behaviour
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None

    _______________________________________________________

Details:

Greetings,

I'm using groff-1.22.3 on a Solaris 10 (X86_64) system and noticed
that grog(1) reports ".../grog/subs.pl 397: Unknown file name
extension ..." in some cases.

For the record, I thought I would document these cases.

>From /usr/share/man, 144 cases like the following:

  Unknown file name extension /usr/share/man/man5/abort.5sql

Given that Solaris 10 has 106 separate man<sect> directories, it
probably a bug that .5sql pages (from the Sun delivered postgres) are
not in the man5sql subdirectory (but a postgres local build does
exactly the same thing).  And given no complaints for all the other
system manual pages, I'm guessing this mismatch in section names is
the cause of the warning.

Locally we compile Free, Libre, and Open Source Software with a unique
prefix for each product instance
(e.g. /pkgs/64-bit/release/<product>-<version>)

I was beginning to think while reviewing the grog(1) output for FLOSS
packages, that the warning was generated when man<sect>/<name>.<sect>
had mismatching <sect> components.

But then the following paths also report the same issue:

  /pkgs/64-bit/release/smartmontools-X.Y/man/man1m/smartctl.1m
  /pkgs/64-bit/release/smartmontools-X.Y/man/man1m/smartd.1m
  /pkgs/64-bit/release/sudo-X.Y/man/man1m/sudo.1m
  /pkgs/64-bit/release/sudo-X.Y/man/man1m/sudoedit.1m
  /pkgs/64-bit/release/sudo-X.Y/man/man1m/visudo.1m

But all the system (/usr/share/man) section 1m pages don't give this
message. So I'm unsure why I'm getting this message.

Looking at the code, handle_file_ext() seems to about issuing warnings
and making assignments to $tmac_ext. But the list of valid manual
pages extensions in the code is incredibly small.

On Solaris 10 & 11, /usr/share/man/man.cf lists the manual page
extensions presumably in search preference order. See the example
contents of this file at the end of this message, each MANSECTS= entry
is a single line comma separated value list.

I'm happy to get this message for files in the manual page trees that
are not valid manual pages, and in the FLOSS tree there are few
mistakes. But I'm at a loss as to why, for example, otherwise
seemingly valid manual pages generate this warning. Enlightenment
appreciated

Regards,
Peter Bray
Sydney, Australia

On Solaris 10 Update 11, /usr/share/man/man.cf's MANSECT contains 110
entries:

MANSECTS=1,1m,1s,1as,2,3,3c,3malloc,3nsl,3socket,3ldap,3nisdb,3resolv,3rpc,3sip,3slp,3proc,3rt,3c_db,3elf,3kvm,3kstat,3m,3mp,3mvec,3pam,3papi,3aio,3bsm,3tsol,3contract,3cpc,3sec,3secdb,3smartcard,3cfgadm,3crypt,3devid,3door,3devinfo,3lib,3libucb,3head,3nvpair,3rsm,7,7d,7fs,7i,7ipp,7m,7p,9,9e,9f,9p,9s,4,5,4b,3fm,3gen,3exacct,3sysevent,3uuid,3wsreg,3dmi,3snmp,3tnf,3volmgt,3mail,3layout,3ext,3picl,3picltree,3pool,3project,3perl,3lgrp,3sasl,3scf,3dat,3hbaapi,3tecla,3mpapi,3commputil,1b,1c,1f,3ucb,3xnet,3curses,3plot,3xcurses,3dlpi,3gss,6,3tiff,3fontconfig,3xtsol,3mlib,3c++,3cc4,3f,3p,3pi,3rtc,8,l,n

On Solaris 11 Update 2, /usr/share/man/man.cf's MANSECT contains 145 entries:

MANSECTS=1,1m,1s,1as,1t,2,3,3c,3malloc,3nsl,3socket,3ldap,3nisdb,3resolv,3rpc,3sip,3slp,3proc,3c_db,3elf,3kvm,3kstat,3m,3mp,3mvec,3pam,3papi,3tsol,3contract,3cpc,3sec,3cfgadm,3crypt,3devid,3devinfo,3lib,3head,3nvpair,7,7d,7fs,7i,7ipp,7m,7p,9,9e,9f,9p,9s,4,5,4b,3gen,3exacct,3stmf,3iscsit,3sysevent,3uuid,3reparse,3dmi,3snmp,3volmgt,3mail,3layout,3ext,3fm,3fstyp,3picl,3picltree,3pool,3project,3perl,3lgrp,3sasl,3scf,3srpt,3dat,3hbaapi,3tecla,3mpapi,3fcoe,1b,1c,3xnet,3curses,3plot,3xcurses,3dlpi,3dns_sd,3gss,6,3tiff,3fontconfig,3tcl,3tk,3xtsol,3zonestat,3mlib,3c++,3cc4,3f,3p,3pi,3rtc,3rad,8,1erl,1oldap,3commputil,3libmemcached,3oldap,3pcap,3erl,4erl,1openssl,3openssl,5oldap,5openssl,6erl,7openssl,8oldap,3x11,3xres,3xau,3xaw,3xcomposite,3xcursor,3xevie,3xext,3xi,3xinerama,3xmu,3xp,3xrandr,3xss,3xt,3xtst,3xv,3xxf86misc,3xxf86vm,Cg,CgFX,l,n






    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/bugs/?44707>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.gnu.org/