From ingham@Clarke.i-pi.com  Mon Jan 15 14:18:51 2001
Return-Path: <ingham@Clarke.i-pi.com>
Received: from Clarke.i-pi.com (Clarke.i-pi.com [198.49.217.12])
	by hub.freebsd.org (Postfix) with ESMTP id B29FB37B400
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 15 Jan 2001 14:18:45 -0800 (PST)
Received: (from ingham@localhost)
	by Clarke.i-pi.com (8.11.1/8.11.1) id f0FMIdS11588;
	Mon, 15 Jan 2001 15:18:39 -0700 (MST)
	(envelope-from ingham)
Message-Id: <200101152218.f0FMIdS11588@Clarke.i-pi.com>
Date: Mon, 15 Jan 2001 15:18:39 -0700 (MST)
From: Kenneth Ingham <ingham@i-pi.com>
Reply-To: ingham@i-pi.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: sigpending(2) man page is inconsistent
X-Send-Pr-Version: 3.2

>Number:         24360
>Category:       docs
>Synopsis:       sigpending(2) man page is inconsistent
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jan 15 14:20:01 PST 2001
>Closed-Date:    Tue Jan 16 21:59:32 GMT 2001
>Last-Modified:  Tue Jan 16 14:00:01 PST 2001
>Originator:     Kenneth Ingham
>Release:        FreeBSD 4.2-STABLE i386
>Organization:
Kenneth Ingham Consulting
>Environment:

4.2-Stable, i386, etc (not relevant to this problem)

>Description:

A quote from the man page:

    RETURN VALUES
	 A 0 value indicated that the call succeeded.  A -1 return value
	 indicates an error occurred and errno is set to indicated the reason.

    ERRORS
	 The sigpending() function does not currently detect any errors.

>How-To-Repeat:

man sigpending

>Fix:

	Move the second sentence under RETURN VALUES to replace the
sentence under ERRORS.

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: ben 
State-Changed-When: Tue Jan 16 21:59:32 GMT 2001 
State-Changed-Why:  
ERRORS section fixed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=24360 

From: Ben Smithurst <csxbcs@comp.leeds.ac.uk>
To: Kenneth Ingham <ingham@i-pi.com>,
	freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/24360: sigpending(2) man page is inconsistent
Date: Tue, 16 Jan 2001 21:49:49 +0000

 The bit about it not detecting errors is rubbish for a start...
 
 ben@freefall:~/tmp$ cat t.c
 #include <err.h>
 #include <signal.h>
 
 int
 main(void) {
 
         if (sigpending((void *)0xdeadbeef) != 0)
                 err(1, "sigpending");
 
         return (0);
 }
 ben@freefall:~/tmp$ ./a.out
 a.out: sigpending: Bad address
 
 I'll do something about this.
 
 -- 
 Ben Smithurst / csxbcs@comp.leeds.ac.uk / ben@FreeBSD.org
 
>Unformatted:
