src/usr.bin/makewhatis, branch release/9.2.0

MFC r237348:

2012-06-23T00:37:32+00:00

Currently the code uses gzFile * for a zlib file descriptor, which
is not correct.  The code works by accident because gzFile is
currently defined as void *, and internally it would be casted from
or to its real type.

A newer version of zlib will instead define it as a pointer to a
specific type pointer (namely, struct gzFile_s *).  This therefore
would cause stricter checks and compiler would catch this type
mismatch.

This change does not cause any changes to the resulting binary,
as validated with md5(1).

Modernize scandir(3) and alphasort(3) interfaces according to the IEEE

2010-01-04T15:40:17+00:00

Std 1003.1-2008. Both Linux and Solaris conforms to the new definitions,
so we better follow too (older glibc used old BSDish alphasort prototype
and corresponding type of the comparision function for scandir). While
there, change the definitions of the functions to ANSI C and fix several
style issues nearby.

Remove requirement for "sys/types.h" include for functions from manpage.

POSIX also requires that alphasort(3) sorts as if strcoll(3) was used,
but leave the strcmp(3) call in the function for now.

Adapt in-tree callers of scandir(3) to new declaration. The fact that
select_sections() from catman(1) could modify supplied struct dirent is
a bug.

PR:	standards/142255
MFC after:	2 weeks

%.s expects an int as the length specifier, so cast properly.

2009-06-23T23:37:25+00:00

Teach makewhatis.c to treat .SS with the same severity as .SH.

2007-10-18T12:53:11+00:00

At least one port (net-mgmt/net-snmp) creates man-pages which are
in the format:

	.SH NAME
	The Net-SNMP agent \- The snmp agent responds to SNMP queries from management stations.

	.PP
	.SS "Modules"

At this moment, makewhatis determines the end of the .SH NAME section
as where it finds .SH again, but there is none here, is it "terminated"
by the .SS.

PR:		bin/116706
Submitted by:	edwin@
Approved by:	re (Ken Smith), grog (mentor)
MFC after:	1 week

Prepare for MACHINE and hw.machine switching to "pc98" on FreeBSD/pc98.

2005-12-05T14:22:12+00:00

Reviewed by:	nyan

Added the EXIT STATUS section where appropriate.

2005-01-17T07:44:44+00:00

Mechanically kill hard sentence breaks.

2004-07-02T22:22:35+00:00

Removed trailing whitespace.

2004-07-02T19:07:33+00:00

Install /usr/libexec/makewhatis.local and /usr/libexec/catman.local.

2002-11-18T10:11:22+00:00

This has slipped through the cracks of The Great Perl Script Rewrite.

Repocopied by:	joe

ANSIify function definitions.

2002-09-04T23:29:10+00:00

Add some constness to avoid some warnings.
Remove use register keyword.
Deal with missing/unneeded extern/prototypes.
Some minor type changes/casts to avoid warnings.

Reviewed by:	md5