new module proposal: verror

[Eric Blake]

Based on Bruno's objection to alter the API of error.h, and my desire to still 
have a useful va_list error variant for use in m4, I propose this new module.  
Any objections to installing this?

If my bug reports to glibc result in glibc adding something similar, I can 
revisit this module to merge upstream to glibc.

ChangeLog
2006-08-04  Eric Blake  <address@hidden>

        * modules/verror: New module.
        * MODULES.html.sh: Document it.

lib/ChangeLog
2006-08-04  Eric Blake  <address@hidden>

        * verror.h, verror.c: New files.

m4/ChangeLog
2006-08-04  Eric Blake  <address@hidden>

        * verror.m4: New file.


Index: MODULES.html.sh
===================================================================
RCS file: /sources/gnulib/gnulib/MODULES.html.sh,v
retrieving revision 1.133
diff -u -r1.133 MODULES.html.sh
--- MODULES.html.sh     25 Jul 2006 06:20:19 -0000      1.133
+++ MODULES.html.sh     4 Aug 2006 16:01:34 -0000
@@ -2084,6 +2084,7 @@
   func_module readutmp
   func_module sig2str
   func_module sysexits
+  func_module verror
   func_module visibility
   func_end_table
 
Index: lib/verror.c
===================================================================
RCS file: lib/verror.c
diff -N lib/verror.c
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ lib/verror.c        4 Aug 2006 16:01:35 -0000
@@ -0,0 +1,49 @@
+/* va_list error handler for noninteractive utilities
+   Copyright (C) 2006 Free Software Foundation, Inc.
+
+   This program is free software; you can redistribute it and/or modify
+   it under the terms of the GNU General Public License as published by
+   the Free Software Foundation; either version 2, or (at your option)
+   any later version.
+
+   This program is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU General Public License for more details.
+
+   You should have received a copy of the GNU General Public License along
+   with this program; if not, write to the Free Software Foundation,
+   Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
+
+/* Written by Eric Blake.  */
+
+#ifdef HAVE_CONFIG_H
+# include <config.h>
+#endif
+
+#include "verror.h"
+#include "xvasprintf.h"
+
+#include <stdarg.h>
+#include <stdlib.h>
+
+/* Print the program name and error message FORMAT, which is a printf-style
+   format string with optional args.
+   If ERRNUM is nonzero, print its corresponding system error message.
+   Exit with status STATUS if it is nonzero.  */
+void
+verror (int status, int errnum, const char *format, va_list args)
+{
+  char *message = xvasprintf (format, args);
+  error (status, errnum, message);
+  free (message);
+}
+
+void
+verror_at_line (int status, int errnum, const char *file,
+                unsigned int line_number, const char *format, va_list args)
+{
+  char *message = xvasprintf (format, args);
+  error_at_line (status, errnum, file, line_number, message);
+  free (message);
+}
Index: lib/verror.h
===================================================================
RCS file: lib/verror.h
diff -N lib/verror.h
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ lib/verror.h        4 Aug 2006 16:01:35 -0000
@@ -0,0 +1,45 @@
+/* Declaration for va_list error-reporting function
+   Copyright (C) 2006 Free Software Foundation, Inc.
+
+   This program is free software; you can redistribute it and/or modify
+   it under the terms of the GNU General Public License as published by
+   the Free Software Foundation; either version 2, or (at your option)
+   any later version.
+
+   This program is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU General Public License for more details.
+
+   You should have received a copy of the GNU General Public License along
+   with this program; if not, write to the Free Software Foundation,
+   Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
+
+#ifndef _VERROR_H
+#define _VERROR_H 1
+
+#include "error.h"
+#include <stdarg.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* Print a message with `vfprintf (stderr, FORMAT, args)';
+   if ERRNUM is nonzero, follow it with ": " and strerror (ERRNUM).
+   If STATUS is nonzero, terminate the program with `exit (STATUS)'.  */
+
+extern void verror (int __status, int __errnum, const char *__format,
+                    va_list args)
+     __attribute__ ((__format__ (__printf__, 3, 0)));
+
+extern void verror_at_line (int __status, int __errnum, const char *__fname,
+                            unsigned int __lineno, const char *__format,
+                            va_list args)
+     __attribute__ ((__format__ (__printf__, 5, 0)));
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* verror.h */
Index: m4/verror.m4
===================================================================
RCS file: m4/verror.m4
diff -N m4/verror.m4
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ m4/verror.m4        4 Aug 2006 16:01:35 -0000
@@ -0,0 +1,11 @@
+#serial 1
+dnl Copyright (C) 2006 Free Software Foundation, Inc.
+dnl This file is free software; the Free Software Foundation
+dnl gives unlimited permission to copy and/or distribute it,
+dnl with or without modifications, as long as this notice is preserved.
+
+AC_DEFUN([gl_VERROR],
+[
+  AC_LIBSOURCES([verror.c, verror.h])
+  AC_LIBOBJ([verror])
+])
Index: modules/verror
===================================================================
RCS file: modules/verror
diff -N modules/verror
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ modules/verror      4 Aug 2006 16:01:35 -0000
@@ -0,0 +1,25 @@
+Description:
+verror() and verror_at_line() functions: Error reporting with va_list.
+
+Files:
+lib/verror.h
+lib/verror.c
+m4/verror.m4
+
+Depends-on:
+error
+xvasprintf
+
+configure.ac:
+gl_VERROR
+
+Makefile.am:
+
+Include:
+"verror.h"
+
+License:
+LGPL
+
+Maintainer:
+Eric Blake