Subject: standards/2966: Useless comment in abort.c
To: None <gnats-bugs@gnats.netbsd.org>
From: Peter Seebach <seebs@taniemarie.solon.com>
List: netbsd-bugs
Date: 11/26/1996 07:10:52
>Number:         2966
>Category:       standards
>Synopsis:       Comment in abort.c is not helpful.  :)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gnats-admin (GNATS administrator)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Nov 26 05:20:00 1996
>Last-Modified:
>Originator:     Peter Seebach
>Organization:
Peter Seebach - seebs@solon.com - Copyright 1996 Peter Seebach.
C/Unix wizard -- C/Unix questions? Send mail for help.  No, really!
Unsolicited email is not welcome, and will be billed for at consulting rates.
The *other* C FAQ - http://www.solon.com/~seebs/c/c-iaq.html
>Release:        -current of late November
>Environment:
System: NetBSD taniemarie 1.2B NetBSD 1.2B (SEEBS) #0: Fri Nov 22 00:03:56 CST 1996 seebs@taniemarie:/usr/src/sys/arch/amiga/compile/SEEBS amiga

>Description:
	abort.c, in a comment, asks whether or not we should be calling
	atexit()'d functions in abort.  The answer is unambiguously "no";
	those functions are called at *normal* program termination;
	abort() causes abnormal program termination to occur, unless the
	user catches SIGABRT and the handler doesn't return.

	We have failed to document whether temporary files are removed,
	however, this is a required piece of documentation.  (I could
	send-pr that separately, but it's a related issue.  Except, of course,
	that that should be in the man page.)

>How-To-Repeat:
	"man abort"; "more abort.c"
>Fix:
	We should probably remove or change the XXX comment in abort.c, and
	our man page should state whether or not we remove temporary files;
	I assume we don't.
>Audit-Trail:
>Unformatted: