This is the mail archive of the
libc-alpha@cygnus.com
mailing list for the glibc project.
<err.h> comments incorrect
- To: libc-alpha@cygnus.com
- Subject: <err.h> comments incorrect
- From: Joseph Myers <jsm28@cam.ac.uk>
- Date: Mon, 30 Nov 1998 18:53:34 +0000
- CC: Joseph Myers <jsm28@cam.ac.uk>
>Submitter-Id: net
>Originator: Joseph S. Myers
>Organization:
Trinity College, University of Cambridge, UK
>Confidential: no
>Synopsis: <err.h> comments incorrect
>Severity: non-critical
>Priority: low
>Category: libc
>Class: doc-bug
>Release: libc-2.0.104
>Environment:
Host type: i686-pc-linux-gnu
System: Linux decomino 2.0.36 #1 Mon Nov 16 14:25:34 UTC 1998 i686 unknown
Architecture: i686
Addons: crypt linuxthreads
Build CFLAGS: -g -O6 -funroll-loops -march=pentiumpro
Build CC: gcc
Compiler version: egcs-2.91.57 19980901 (egcs-1.1 release)
Kernel headers: 2.1.130
Symbol versioning: yes
Build static: yes
Build shared: yes
Build pic-default: no
Build profile: yes
Build omitfp: no
Build bounded: no
Build static-nss: no
Stdio: libio
>Description:
The comments in <err.h> describing the functions declared therein are
incorrect.
[ Also, perhaps the attribute declarations should use __format__,
__printf__, and __noreturn__ instead of the non-__ versions? ]
>How-To-Repeat:
>Fix:
--- err.h.orig Mon Nov 30 18:10:03 1998
+++ err.h Mon Nov 30 18:14:09 1998
@@ -30,13 +30,14 @@
__BEGIN_DECLS
-/* Print FORMAT on stderr. */
+/* Print "program: ", FORMAT, ": ", the standard error string for errno,
+ and a newline, on stderr. */
extern void warn __P ((__const char *__format, ...))
__attribute__ ((format (printf, 1, 2)));
extern void vwarn __P ((__const char *__format, __gnuc_va_list))
__attribute__ ((format (printf, 1, 0)));
-/* Print "program: ", and FORMAT, and a newline, on stderr. */
+/* Likewise, but without ": " and the standard error string. */
extern void warnx __P ((__const char *__format, ...))
__attribute__ ((format (printf, 1, 2)));
extern void vwarnx __P ((__const char *__format, __gnuc_va_list))