projects / apple / libc.git / blame
| Commit | Line | Data |
|---|---|---|
| 224c7076 A |
1 | --- _SB/Libc/stdio/FreeBSD/setbuf.3 2004-11-25 11:38:35.000000000 -0800 |
| 2 | +++ _SB/Libc/stdio/FreeBSD/setbuf.3.edit 2006-06-28 16:55:52.000000000 -0700 | |
| 3 | @@ -50,21 +50,37 @@ | |
| 4 | .Sh SYNOPSIS | |
| 5 | .In stdio.h | |
| 6 | .Ft void | |
| 7 | -.Fn setbuf "FILE * restrict stream" "char * restrict buf" | |
| 8 | +.Fo setbuf | |
| 9 | +.Fa "FILE *restrict stream" | |
| 10 | +.Fa "char *restrict buf" | |
| 11 | +.Fc | |
| 12 | .Ft void | |
| 13 | -.Fn setbuffer "FILE *stream" "char *buf" "int size" | |
| 14 | +.Fo setbuffer | |
| 15 | +.Fa "FILE *stream" | |
| 16 | +.Fa "char *buf" | |
| 17 | +.Fa "int size" | |
| 18 | +.Fc | |
| 19 | .Ft int | |
| 20 | -.Fn setlinebuf "FILE *stream" | |
| 21 | +.Fo setlinebuf | |
| 22 | +.Fa "FILE *stream" | |
| 23 | +.Fc | |
| 24 | .Ft int | |
| 25 | -.Fn setvbuf "FILE * restrict stream" "char * restrict buf" "int mode" "size_t size" | |
| 26 | +.Fo setvbuf | |
| 27 | +.Fa "FILE *restrict stream" | |
| 28 | +.Fa "char *restrict buf" | |
| 29 | +.Fa "int type" | |
| 30 | +.Fa "size_t size" | |
| 31 | +.Fc | |
| 32 | .Sh DESCRIPTION | |
| 33 | -The three types of buffering available are unbuffered, block buffered, | |
| 34 | -and line buffered. | |
| 35 | +Three types of buffering are available: | |
| 36 | +unbuffered, block buffered, and line buffered. | |
| 37 | When an output stream is unbuffered, information appears on the | |
| 38 | destination file or terminal as soon as written; | |
| 39 | -when it is block buffered many characters are saved up and written as a block; | |
| 40 | -when it is line buffered characters are saved up until a newline is | |
| 41 | -output or input is read from any stream attached to a terminal device | |
| 42 | +when it is block buffered, | |
| 43 | +many characters are saved up and written as a block; | |
| 44 | +when it is line buffered, | |
| 45 | +characters are saved up until a newline is output | |
| 46 | +or input is read from any stream attached to a terminal device | |
| 47 | (typically | |
| 48 | .Dv stdin ) . | |
| 49 | The function | |
| 50 | @@ -73,17 +89,16 @@ | |
| 51 | (See | |
| 52 | .Xr fclose 3 . ) | |
| 53 | .Pp | |
| 54 | -Normally all files are block buffered. | |
| 55 | +Normally, all files are block buffered. | |
| 56 | When the first | |
| 57 | .Tn I/O | |
| 58 | operation occurs on a file, | |
| 59 | .Xr malloc 3 | |
| 60 | -is called, | |
| 61 | -and an optimally-sized buffer is obtained. | |
| 62 | +is called and an optimally-sized buffer is obtained. | |
| 63 | If a stream refers to a terminal | |
| 64 | (as | |
| 65 | .Dv stdout | |
| 66 | -normally does) it is line buffered. | |
| 67 | +normally does), it is line buffered. | |
| 68 | The standard error stream | |
| 69 | .Dv stderr | |
| 70 | is always unbuffered. | |
| 71 | @@ -93,7 +108,7 @@ | |
| 72 | function | |
| 73 | may be used to alter the buffering behavior of a stream. | |
| 74 | The | |
| 75 | -.Fa mode | |
| 76 | +.Fa type | |
| 77 | argument must be one of the following three macros: | |
| 78 | .Bl -tag -width _IOFBF -offset indent | |
| 79 | .It Dv _IONBF |