Subject: bin/8726: missing man-pages
To: None <gnats-bugs@gnats.netbsd.org>
From: None <D.Thomas@cmcb.uq.edu.au>
List: netbsd-bugs
Date: 11/01/1999 06:24:46
>Number:         8726
>Category:       bin
>Synopsis:       missing man-pages
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    bin-bug-people (Utility Bug People)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Nov  1 06:24:00 1999
>Last-Modified:
>Originator:     Danny Thomas
>Organization:
CMCB, The Uni of Queensland
>Release:        
>Environment:
NetBSD server.vthrc.uq.edu.au 1.4K NetBSD 1.4K (SERVER.v6) #0: Sun Oct 24 02:24:
47 EST 1999     root@server.vthrc.uq.edu.au:/usr/src/sys/arch/i386/compile/SERVE
R.v6 i386
>Description:
Tom Christiansen, who's involved with parts of the perl distribution, released a script which went through system directories reporting commands without man-pages.

here's what it reported on my 1.4K-i386 system:
NB I don't have X installed so it only looked at
   /bin, /sbin, /usr/bin, /usr/sbin

>How-To-Repeat:
#./noman
/bin/[: man: no entry for [ in the manual.
/usr/bin/flex++: man: no entry for flex++ in the manual.
/usr/bin/gencat: man: no entry for gencat in the manual.
/usr/bin/info: man: no entry for info in the manual.
/usr/bin/install-info: man: no entry for install-info in the manual.
/usr/bin/install-sid: man: no entry for install-sid in the manual.
/usr/bin/lessecho: man: no entry for lessecho in the manual.
/usr/bin/makeinfo: man: no entry for makeinfo in the manual.
/usr/bin/mkservdb: man: no entry for mkservdb in the manual.
/usr/bin/neqn: man: no entry for neqn in the manual.
/usr/bin/psroff: man: no entry for psroff in the manual.
/usr/bin/texi2dvi: man: no entry for texi2dvi in the manual.
/usr/bin/texindex: man: no entry for texindex in the manual.
/usr/bin/uulog: man: no entry for uulog in the manual.
/usr/bin/uuname: man: no entry for uuname in the manual.
/usr/bin/uupick: man: no entry for uupick in the manual.
/usr/bin/uusched: man: no entry for uusched in the manual.
/usr/bin/uuto: man: no entry for uuto in the manual.
/usr/sbin/gspa: man: no entry for gspa in the manual.
/usr/sbin/gspahextoc: man: no entry for gspahextoc in the manual.
/usr/sbin/irpd: man: no entry for irpd in the manual.
/usr/sbin/rip6query: man: no entry for rip6query in the manual.

>Fix:
if there's any executables there which don't have man-pages for
a reason (texinfo stuff?), maybe a man-page of a few lines should be
created to let people know the story


there is a man entry for [ but "man [" don't work
flex++.1 should be hard-linked to flex.1
should install-sid be linked to send-pr ?
should lessecho be linked to less ?
  probably not since it only gets mentioned at end
should neqn be linked to eqn ?

I gather info & install-info & makeinfo & texi2dvi & texindex are part of texinfo

psroff is just a script to invoke groff -Tps

couldn't find any reference for gencat
couldn't find any reference for uulog uuname uupick uusched
uuto is referred to in uucp.1
couldn't find anything related to gsp
couldn't find any real candidate for rip6query (search on rip6), was mld6query


I think the only false positives in the above list come from mkservdb & irpd installed from bind-8.2.x 

>Audit-Trail:
>Unformatted: