2004-07-21 Andrew Cagney <cagney@gnu.org>

[deliverable/binutils-gdb.git] / libiberty / vprintf.c

diff --git a/libiberty/vprintf.c b/libiberty/vprintf.c
index 65b425a4d6b2c977355b296a7bb4205cb3295798..9487896ea5efeea77befdebea6c1397b6cc33358 100644 (file)
--- a/libiberty/vprintf.c
+++ b/libiberty/vprintf.c
@@ -1,10 +1,27 @@
-#ifdef __STDC__
+/*
+
+@deftypefn Supplemental int vprintf (const char *@var{format}, va_list @var{ap})
+@deftypefnx Supplemental int vfprintf (FILE *@var{stream}, const char *@var{format}, va_list @var{ap})
+@deftypefnx Supplemental int vsprintf (char *@var{str}, const char *@var{format}, va_list @var{ap})
+
+These functions are the same as @code{printf}, @code{fprintf}, and
+@code{sprintf}, respectively, except that they are called with a
+@code{va_list} instead of a variable number of arguments.  Note that
+they do not call @code{va_end}; this is the application's
+responsibility.  In @libib{} they are implemented in terms of the
+nonstandard but common function @code{_doprnt}.
+
+@end deftypefn
+
+*/
+
+#include <ansidecl.h>
+#ifdef ANSI_PROTOTYPES
 #include <stdarg.h>
 #else
 #include <varargs.h>
 #endif
 #include <stdio.h>
-#include <ansidecl.h>
 #undef vprintf
 int
 vprintf (format, ap)