From owner-freebsd-doc@FreeBSD.ORG  Tue Aug 10 00:48:32 2010
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id D95641065674;
	Tue, 10 Aug 2010 00:48:32 +0000 (UTC)
	(envelope-from arundel@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id C924A8FC1A;
	Tue, 10 Aug 2010 00:48:32 +0000 (UTC)
Received: from freefall.freebsd.org (localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o7A0mWVB058898;
	Tue, 10 Aug 2010 00:48:32 GMT
	(envelope-from arundel@freefall.freebsd.org)
Received: (from arundel@localhost)
	by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o7A0mWL5058894;
	Tue, 10 Aug 2010 00:48:32 GMT (envelope-from arundel)
Date: Tue, 10 Aug 2010 00:48:32 GMT
Message-Id: <201008100048.o7A0mWL5058894@freefall.freebsd.org>
To: alexbestms@wwu.de, arundel@FreeBSD.org, freebsd-doc@FreeBSD.org
From: arundel@FreeBSD.org
Cc: 
Subject: Re: docs/140474: signal(3) missing reference to NSIG
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 10 Aug 2010 00:48:32 -0000

Synopsis: signal(3) missing reference to NSIG

State-Changed-From-To: open->closed
State-Changed-By: arundel
State-Changed-When: Tue Aug 10 00:24:37 UTC 2010
State-Changed-Why: 
There is no need to add a reference to NSIG in signal(3). Signals should be
referenced by their name. NSIG often is being misused to cycle through all
signals in a for-loop, assigning a certain action to all 0 < signals < NSIG.

This is considered bad style and should be avoided [1]. Thus signal(3) should
not mention NSIG.

Also NSIG has been depricated in 1999 and since then has not been increased in
order to maintain compatibility with legacy software [2]. It has been replaced
by _SIG_MAXSIG.

[1] http://docs.freebsd.org/cgi/getmsg.cgi?fetch=310688+0+archive/2009/freebsd-hackers/20091108.freebsd-hackers
[2] http://docs.freebsd.org/cgi/getmsg.cgi?fetch=481904+0+archive/1999/freebsd-current/19991003.freebsd-current

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