>Number:         11878
>Category:       lib
>Synopsis:       math(3) references non-existant infnan(3) man page.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    lib-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Jan 03 03:30:00 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Richard Rauch
>Release:        NetBSD 1.5
>Organization:
  "I probably don't know what I'm talking about."  --rkr@rkr.kcnet.com
>Environment:
System: NetBSD rkr.kcnet.com 1.5_ALPHA NetBSD 1.5_ALPHA (rkrGENERIC) #0: Sun Aug 6 17:44:22 PDT 2000 root@:/usr/src/sys/arch/i386/compile/rkrGENERIC i386


>Description:
	``man math'' references infnan(3) as describing the ``present
	state of affairs'' re. a more general floating point arithmetic
	exception system.  I was curious what was there, but found nothing.

	I do not know if this represents new work that hasn't been
	documented, incomplete work, or work that was finished properly
	a long time ago without cleaning up the math(3) man-page.

	I assume, because of the references to VAX hardware, and the
	stated behavior of halting the process (rather than using a
	UNIX signal), the whole paragraph is simply obsolete.  But,
	I don't know for sure.
>How-To-Repeat:
	man math

	...scan down to paragraph starting, ``This response seems
	excessively punitive,'' which is indented more deeply than
	the surrounding paragraphs.  (It is also, in my xterm window,
	rendered with each word underlined.)  When you get to the
	infnan(3) reference (last sentence of that paragraph), try:

	man infnan

	...which, on my system, tells me that no such man-page exists.
>Fix:
	I don't propose a fix, since I don't know whether it's a case
	of an obsolete reference or a missing man-page.

	(There IS a /usr/src/lib/libm/arch/vax/n_infnan.S, but no
	corresponding VAX-specific man-page.  This suggests to me that
	the reference in math(3) should probably be made VAX-specific
	(or explicitly labeled as such for the human reader).)
>Release-Note:
>Audit-Trail:
>Unformatted: