merge from gcc

[binutils.git] / libiberty / vprintf.c

diff --git a/libiberty/vprintf.c b/libiberty/vprintf.c
index 65b425a4d6b2c977355b296a7bb4205cb3295798..c57c3e4f318431ebafa54e412407d4f72b97e13b 100644 (file)
--- a/libiberty/vprintf.c
+++ b/libiberty/vprintf.c
@@ -1,3 +1,20 @@
+/*
+
+@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
+
+*/
+
 #ifdef __STDC__
 #include <stdarg.h>
 #else