stdio/FreeBSD/stdio.3.patch

   1 --- stdio.3.bsdnew      2009-11-11 13:33:16.000000000 -0800
   2 +++ stdio.3     2009-11-11 15:14:22.000000000 -0800
   3 @@ -41,6 +41,20 @@
   4  .Vt FILE *stdin ;
   5  .Vt FILE *stdout ;
   6  .Vt FILE *stderr ;
   7 +.Pp
   8 +Note:
   9 +The current implementation does not allow these variables
  10 +to be evaluated at C compile/link time.
  11 +That is, a runtime calculation must be performed, such as:
  12 +.Bd -literal -offset indent
  13 +#include <stdio.h>
  14 +
  15 +static FILE *var;
  16 +
  17 +int main() {
  18 +    var = stdout;
  19 +}
  20 +.Ed
  21  .Sh DESCRIPTION
  22  The standard
  23  .Tn I/O
  24 @@ -228,11 +242,21 @@ and
  25  .Dv putchar_unlocked
  26  exist and will be used if the macro
  27  definitions are explicitly removed.
  28 +.Sh LEGACY SYNOPSIS
  29 +The -D_NONSTD_SOURCE flag can be used
  30 +to allow stdin, stdout, and/or stderr
  31 +to be evaluated at compile/link time, as:
  32 +.Bd -literal -offset indent
  33 +#include <stdio.h>
  34 +
  35 +static FILE *var = stdout;
  36 +.Ed
  37  .Sh SEE ALSO
  38  .Xr close 2 ,
  39  .Xr open 2 ,
  40  .Xr read 2 ,
  41 -.Xr write 2
  42 +.Xr write 2 ,
  43 +.Xr compat 5
  44  .Sh STANDARDS
  45  The
  46  .Nm
  47 @@ -242,8 +266,9 @@ library conforms to
  48  .Bl -column "Description"
  49  .It Sy "Function       Description"
  50  .It "asprintf  formatted output conversion"
  51 +.It ""
  52  .It "clearerr  check and reset stream status"
  53 -.It "dprintf   formatted output conversion"
  54 +.It ""
  55  .It "fclose    close a stream"
  56  .It "fdopen    stream open functions"
  57  .It "feof      check and reset stream status"
  58 @@ -275,6 +300,7 @@ library conforms to
  59  .It "fwopen    open a stream"
  60  .It "fwprintf  formatted wide character output conversion"
  61  .It "fwrite    binary stream input/output"
  62 +.It ""
  63  .It "getc      get next character or word from input stream"
  64  .It "getchar   get next character or word from input stream"
  65  .It "getdelim  get a line from a stream"
  66 @@ -283,9 +309,11 @@ library conforms to
  67  .It "getw      get next character or word from input stream"
  68  .It "getwc     get next wide character from input stream"
  69  .It "getwchar  get next wide character from input stream"
  70 +.It ""
  71  .It "mkdtemp   create unique temporary directory"
  72  .It "mkstemp   create unique temporary file"
  73  .It "mktemp    create unique temporary file"
  74 +.It ""
  75  .It "perror    system error messages"
  76  .It "printf    formatted output conversion"
  77  .It "putc      output a character or word to a stream"
  78 @@ -294,8 +322,10 @@ library conforms to
  79  .It "putw      output a character or word to a stream"
  80  .It "putwc     output a wide character to a stream"
  81  .It "putwchar  output a wide character to a stream"
  82 +.It ""
  83  .It "remove    remove directory entry"
  84  .It "rewind    reposition a stream"
  85 +.It ""
  86  .It "scanf     input format conversion"
  87  .It "setbuf    stream buffering operations"
  88  .It "setbuffer stream buffering operations"
  89 @@ -308,13 +338,15 @@ library conforms to
  90  .It "swprintf  formatted wide character output conversion"
  91  .It "sys_errlist       system error messages"
  92  .It "sys_nerr  system error messages"
  93 +.It ""
  94  .It "tempnam   temporary file routines"
  95  .It "tmpfile   temporary file routines"
  96  .It "tmpnam    temporary file routines"
  97 +.It ""
  98  .It "ungetc    un-get character from input stream"
  99  .It "ungetwc   un-get wide character from input stream"
 100 +.It ""
 101  .It "vasprintf formatted output conversion"
 102 -.It "vdprintf  formatted output conversion"
 103  .It "vfprintf  formatted output conversion"
 104  .It "vfscanf   input format conversion"
 105  .It "vfwprintf formatted wide character output conversion"
 106 @@ -325,6 +357,7 @@ library conforms to
 107  .It "vsscanf   input format conversion"
 108  .It "vswprintf formatted wide character output conversion"
 109  .It "vwprintf  formatted wide character output conversion"
 110 +.It ""
 111  .It "wprintf   formatted wide character output conversion"
 112  .El
 113  .Sh BUGS