>Number:         2885
>Category:       misc
>Synopsis:       Manpage  cross-refs to nonexistent sigpause(2) should be sigsuspend(2) or sigpause(3).
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people (Misc Bug People)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Oct 22 13:50:01 1996
>Last-Modified:
>Originator:     Jonathan Stone
>Organization:
	NetBSD
>Release:        1.2
>Environment:
	
System: NetBSD Fork.DSG.Stanford.EDU 1.2 NetBSD 1.2 (DSG) #48: Fri Sep 27 15:53:46 PDT 1996 jonathan@Whisk.DSG.Stanford.EDU:/aga/n1/src/NetBSD/IP-PLUS/src/sys/arch/i386/compile/DSG i386


>Description:

The sigpause(2) function from 4.2BSD  is deprecated.  NetBSD
emulates sigpause with the sigpause(3) library function.

The signal man-pages still contain cross references to sigpause(2),
but no such manual page exists.  The affected man pages should definitely
reference the sigsuspend(2) interface,  and possibly sigpause(3) as
a documentation aid for backward compatibility.

>How-To-Repeat:

	Do ``man pause''.
	Note the cross-reference to sigpause(2).
	Do ``man 2 sigpause''.
	Observe the error message.
>Fix:

a) Replace all cross-references to sigpause(2) in the section 2 manpages
with cross-references to sigsuspend(2).

Or,

b) add a cross-reference, before sigpause, to refer to sigsuspend,
and globally change
	.Xr sigpause 2
to be
	.Xr sigpause 3
in /usr/src/share/man/man*.
>Audit-Trail:
>Unformatted: