Libc-1044.1.2.tar.gz

[apple/libc.git] / stdio / FreeBSD / stdio.3

diff --git a/stdio/FreeBSD/stdio.3 b/stdio/FreeBSD/stdio.3
index 71488a1baf489131decd275805dab765c00956d7..1cf1be677da6c3ab6438ea32b456106a794a3975 100644 (file)
--- a/stdio/FreeBSD/stdio.3
+++ b/stdio/FreeBSD/stdio.3
@@ -41,6 +41,20 @@
 .Vt FILE *stdin ;
 .Vt FILE *stdout ;
 .Vt FILE *stderr ;
+.Pp
+Note:
+The current implementation does not allow these variables
+to be evaluated at C compile/link time.
+That is, a runtime calculation must be performed, such as:
+.Bd -literal -offset indent
+#include <stdio.h>
+
+static FILE *var;
+
+int main() {
+    var = stdout;
+}
+.Ed
 .Sh DESCRIPTION
 The standard
 .Tn I/O
@@ -228,11 +242,21 @@ and
 .Dv putchar_unlocked
 exist and will be used if the macro
 definitions are explicitly removed.
+.Sh LEGACY SYNOPSIS
+The -D_NONSTD_SOURCE flag can be used
+to allow stdin, stdout, and/or stderr
+to be evaluated at compile/link time, as:
+.Bd -literal -offset indent
+#include <stdio.h>
+
+static FILE *var = stdout;
+.Ed
 .Sh SEE ALSO
 .Xr close 2 ,
 .Xr open 2 ,
 .Xr read 2 ,
-.Xr write 2
+.Xr write 2 ,
+.Xr compat 5
 .Sh STANDARDS
 The
 .Nm
@@ -242,8 +266,9 @@ library conforms to
 .Bl -column "Description"
 .It Sy "Function       Description"
 .It "asprintf  formatted output conversion"
+.It ""
 .It "clearerr  check and reset stream status"
-.It "dprintf   formatted output conversion"
+.It ""
 .It "fclose    close a stream"
 .It "fdopen    stream open functions"
 .It "feof      check and reset stream status"
@@ -275,6 +300,7 @@ library conforms to
 .It "fwopen    open a stream"
 .It "fwprintf  formatted wide character output conversion"
 .It "fwrite    binary stream input/output"
+.It ""
 .It "getc      get next character or word from input stream"
 .It "getchar   get next character or word from input stream"
 .It "getdelim  get a line from a stream"
@@ -283,9 +309,11 @@ library conforms to
 .It "getw      get next character or word from input stream"
 .It "getwc     get next wide character from input stream"
 .It "getwchar  get next wide character from input stream"
+.It ""
 .It "mkdtemp   create unique temporary directory"
 .It "mkstemp   create unique temporary file"
 .It "mktemp    create unique temporary file"
+.It ""
 .It "perror    system error messages"
 .It "printf    formatted output conversion"
 .It "putc      output a character or word to a stream"
@@ -294,8 +322,10 @@ library conforms to
 .It "putw      output a character or word to a stream"
 .It "putwc     output a wide character to a stream"
 .It "putwchar  output a wide character to a stream"
+.It ""
 .It "remove    remove directory entry"
 .It "rewind    reposition a stream"
+.It ""
 .It "scanf     input format conversion"
 .It "setbuf    stream buffering operations"
 .It "setbuffer stream buffering operations"
@@ -308,13 +338,15 @@ library conforms to
 .It "swprintf  formatted wide character output conversion"
 .It "sys_errlist       system error messages"
 .It "sys_nerr  system error messages"
+.It ""
 .It "tempnam   temporary file routines"
 .It "tmpfile   temporary file routines"
 .It "tmpnam    temporary file routines"
+.It ""
 .It "ungetc    un-get character from input stream"
 .It "ungetwc   un-get wide character from input stream"
+.It ""
 .It "vasprintf formatted output conversion"
-.It "vdprintf  formatted output conversion"
 .It "vfprintf  formatted output conversion"
 .It "vfscanf   input format conversion"
 .It "vfwprintf formatted wide character output conversion"
@@ -325,6 +357,7 @@ library conforms to
 .It "vsscanf   input format conversion"
 .It "vswprintf formatted wide character output conversion"
 .It "vwprintf  formatted wide character output conversion"
+.It ""
 .It "wprintf   formatted wide character output conversion"
 .El
 .Sh BUGS