Re: FYI: makewhatis bitches from -current

[Marc Espie <Marc.Espie@liafa.jussieu.fr>]

On Sun, Feb 13, 2000 at 08:47:59AM +0100, Jan-Uwe Finck wrote:
> On Thu, Feb 10, 2000 at 11:07:09AM +0100, Marc Espie wrote:
> > On Thu, Feb 10, 2000 at 12:23:03AM -0800, Marco S Hyman wrote:
> > > /usr/libexec/makewhatis /usr/share/man
> > > Weird subject line      ffs_softupdates in /usr/share/man/cat4/ffs_softupdates.0
> > > Can't parse /usr/share/man/cat4/ffs_softupdates.0 (not a manpage ?)
> > > Weird subject line      safe_finger in /usr/share/man/cat8/safe_finger.0
> > > Can't parse /usr/share/man/cat8/safe_finger.0 (not a manpage ?)
> > 
> > Real warnings. Waiting for someone to give a real subject line to those.
> 
> Did someone give a solution to this ? I still bump into it when trying
> to 'make build'...
> 
> The man-pages look normal to me, but I'm no expert.
> Any idea or solution anybody ?
They are not normal.
A standard manpage starts with:
FINGER(1)                  OpenBSD Reference Manual                  FINGER(1)

NAME
     finger - user information lookup program


which is where you get your information for man -k.

Whereas safe_finger starts with:
SAFE_FINGER(8)          OpenBSD System Manager's Manual         SAFE_FINGER(8)

NAME
     safe_finger

and soft_updates with:
FFS_SOFTUPDATES(4)        OpenBSD Programmer's Manual       FFS_SOFTUPDATES(4)

NAME
     ffs_softupdates


which makes them reeeeal useful for man -k.
The fix is easy: get them a real subject line, something descriptive.

Anybody can do that. I left those as an easy commit for someone.
But nobody moves...

In any case, safe_finger is really poorly documented, put politely.
One has to refer to the source to find out why it should be used.
safe_finger - safe tcpd wrapper for finger

As for ffs_softupdates, how about:
ffs_softupdates -  soft updates write speed-up for Berkeley ffs
-- 
	Marc Espie		
|anime, sf, juggling, unicycle, acrobatics, comics...
|AmigaOS, OpenBSD, C++, perl, Icon, PostScript...
| `real programmers don't die, they just get out of beta'