bugGNU troff - Bugs: bug #44707, grog(1) (1.22.3 - Solaris 10...

 
 

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

Submitted by:  None
Submitted on:  Fri 03 Apr 2015 12:56:26 AM UTC  
 
Category: NoneSeverity: 3 - Normal
Item Group: Incorrect behaviourStatus: None
Privacy: PublicAssigned to: None
Open/Closed: OpenPlanned Release: None

Add a New Comment(Rich Markup)
   

You are not logged in

Please log in, so followups can be emailed to you.

 

Fri 03 Apr 2015 12:56:26 AM UTC, original submission:

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

Anonymous

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach File(s):
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

CC list is empty

 

Do you think this task is very important?
If so, you can click here to add your encouragement to it.
This task has 0 encouragements so far.

Only logged-in users can vote.

 

Please enter the title of George Orwell's famous dystopian book (it's a date):

 

 

No Changes Have Been Made to This Item

Back to the top


Powered by Savane 3.1-cleanup1