Document vfscanf(), which is really just __svfscanf() made public.

SCCS-vsn: lib/libc/stdio/scanf.3 6.4

diff --git a/usr/src/lib/libc/stdio/scanf.3 b/usr/src/lib/libc/stdio/scanf.3
index 05284f5..d5e246f 100644 (file)
--- a/usr/src/lib/libc/stdio/scanf.3
+++ b/usr/src/lib/libc/stdio/scanf.3
@@ -6,12 +6,12 @@
 .\"
 .\" %sccs.include.redist.man%
 .\"
 .\"
 .\" %sccs.include.redist.man%
 .\"

-.\"    @(#)scanf.3     6.3 (Berkeley) %G%
+.\"    @(#)scanf.3     6.4 (Berkeley) %G%

 .\"
 .TH SCANF 3 ""
 .UC 7
 .SH NAME
 .\"
 .TH SCANF 3 ""
 .UC 7
 .SH NAME

-scanf, fscanf, sscanf \- formatted input conversion
+scanf, fscanf, sscanf, vfscanf \- formatted input conversion

 .SH SYNOPSIS
 .B #include <stdio.h>
 .PP
 .SH SYNOPSIS
 .B #include <stdio.h>
 .PP


@@ -35,7 +35,22 @@ scanf, fscanf, sscanf \- formatted input conversion
 [ , pointer ... ]
 .B )
 .br
 [ , pointer ... ]
 .B )
 .br

-.B char *str, *format;
+.B char *str;
+.br
+.B char *format;
+.PP
+.B #include <varargs.h>
+.PP
+.B vfscanf(stream, format, ap)
+.br
+.SM
+.B FILE
+.B *stream;
+.br
+.B char *format;
+.br
+.B va_list ap;
+.br

 .SH DESCRIPTION
 The
 .I scanf
 .SH DESCRIPTION
 The
 .I scanf


@@ -58,6 +73,13 @@ and
 .I sscanf
 reads from the character string
 .IR str .
 .I sscanf
 reads from the character string
 .IR str .

+.I Vfscanf
+is analogous to
+.I vfprintf
+and reads from a named input
+.I stream
+using a variable argument list of pointers (see
+.IR varargs (3)).

 Each successive
 .I pointer
 argument must correspond properly with
 Each successive
 .I pointer
 argument must correspond properly with


@@ -350,3 +372,9 @@ and
 conversions is unfortunate.
 .br
 All of the backwards compatibility formats will be removed in the future.
 conversions is unfortunate.
 .br
 All of the backwards compatibility formats will be removed in the future.

+.br
+There is no
+.I vscanf
+or
+.IR vsscanf .
+.\" Had to draw the line somewhere!