Module Name: src
Committed By: dholland
Date: Sun Oct 24 23:10:51 UTC 2010
Modified Files:
src/lib/libc/string: strerror.3
Log Message:
Mention err/warn. Note that they're generally preferred to perror().
Might want to strengthen the wording.
To generate a diff of this commit:
cvs rdiff -u -r1.15 -r1.16 src/lib/libc/string/strerror.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/string/strerror.3
diff -u src/lib/libc/string/strerror.3:1.15 src/lib/libc/string/strerror.3:1.16
--- src/lib/libc/string/strerror.3:1.15 Mon Oct 16 08:48:45 2006
+++ src/lib/libc/string/strerror.3 Sun Oct 24 23:10:51 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: strerror.3,v 1.15 2006/10/16 08:48:45 wiz Exp $
+.\" $NetBSD: strerror.3,v 1.16 2010/10/24 23:10:51 dholland Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -98,6 +98,13 @@
a colon and space
.Pq Dq Li ":\ " ;
otherwise, only the error message string is printed.
+Note that in most cases the
+.Xr err 3
+and
+.Xr warn 3
+family of functions is preferable to
+.Fn perror ;
+they are more flexible and also print the program name.
.Pp
If the error number is not recognized, these functions pass an error message
string containing
@@ -148,7 +155,9 @@
should be used instead.
.Sh SEE ALSO
.Xr intro 2 ,
-.Xr psignal 3
+.Xr err 3 ,
+.Xr psignal 3 ,
+.Xr warn 3
.Sh STANDARDS
The
.Fn perror
