D27176.diff
No OneTemporary
Actions

Size

1 KB

Referenced Files

None

Subscribers

None

D27176.diff
View Options

	Index: share/man/man3/sysexits.3
	===================================================================
	--- share/man/man3/sysexits.3
	+++ share/man/man3/sysexits.3
	@@ -26,26 +26,33 @@
	.\" $FreeBSD$
	.\"
	.\" "
	-.Dd January 21, 2010
	+.Dd November 11, 2020
	.Dt SYSEXITS 3
	.Os
	.Sh NAME
	.Nm sysexits
	-.Nd preferable exit codes for programs
	+.Nd exit codes for programs
	.Sh SYNOPSIS
	.In sysexits.h
	.Sh DESCRIPTION
	-According to
	-.Xr style 9 ,
	-it is not a good practice to call
	-.Xr exit 3
	-with arbitrary values to indicate a failure condition when ending
	-a program.
	-Instead, the pre-defined exit codes from
	+.Ss Use of sysexits exit codes is discouraged
	+A few programs exit with the following non-portable error codes.
	+Do not use them.
	+They should be considered deprecated and not used in new code.
	+There are a couple of reasons for it:
	+.Bl -dash
	+.It
	+The choice of an appropriate exit value is often ambiguous.
	+.It
	+The
	.Nm
	-should be used, so the caller of the process can get a rough
	-estimation about the failure class without looking up the source code.
	-.Pp
	+error codes are not portable.
	+.It
	+A message printed out to the
	+.Xr stderr
	+explaining the error is usually better from a user experience perspective.
	+.El
	+.Ss Exit values
	The successful exit is always indicated by a status of 0, or
	.Sy EX_OK .
	Error numbers begin at
	@@ -140,5 +147,3 @@
	.An J\(:org Wunsch
	after the comments in
	.In sysexits.h .
	-.Sh BUGS
	-The choice of an appropriate exit value is often ambiguous.