Subject: lib/5720: psignal(3) has wrong types for sys_siglist and sys_signame
To: None <gnats-bugs@gnats.netbsd.org>
From: John F. Woods <jfw@funhouse.com>
List: netbsd-bugs
Date: 07/07/1998 14:18:49
>Number:         5720
>Category:       lib
>Synopsis:       psignal(3) has wrong types for sys_siglist and sys_signame
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    lib-bug-people (Library Bug People)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Jul  7 11:20:00 1998
>Last-Modified:
>Originator:     John F. Woods
>Organization:
Misanthropes-R-Us
>Release:        June 20 1998
>Environment:
	
System: NetBSD jfwhome.funhouse.com 1.3F NetBSD 1.3F (JFW) #5: Sat Jun 20 09:52:15 EDT 1998 jfw@jfwhome.funhouse.com:/usr/src/sys/arch/i386/compile/JFW i386


>Description:
	The psignal manual page lists the types of sys_siglist and sys_signame
as "extern char *sys_siglist[]" etc when in reality they are declared as 
"extern const char * const sys_siglist[]" in <signal.h>.  Also note that
the manual page says one should include <sys/signal.h>, when it is <signal.h>
which declares psignal() and the arrays.

>How-To-Repeat:
	RTFM.  RTFH.
>Fix:
*** psignal.3.orig	Tue Jul  7 14:14:54 1998
--- psignal.3	Tue Jul  7 14:16:04 1998
***************
*** 44,54 ****
  .Sh LIBRARY
  .Lb libc
  .Sh SYNOPSIS
! .Fd #include <sys/signal.h>
  .Ft void
  .Fn psignal "unsigned sig" "const char *s"
! .Vt extern char *sys_siglist[];
! .Vt extern char *sys_signame[];
  .Sh DESCRIPTION
  The
  .Fn psignal
--- 44,54 ----
  .Sh LIBRARY
  .Lb libc
  .Sh SYNOPSIS
! .Fd #include <signal.h>
  .Ft void
  .Fn psignal "unsigned sig" "const char *s"
! .Vt extern const char * const sys_siglist[];
! .Vt extern const char * const sys_signame[];
  .Sh DESCRIPTION
  The
  .Fn psignal
>Audit-Trail:
>Unformatted: