From 9170dd1a633b42c0b3ed17969794a237784fa8bf Mon Sep 17 00:00:00 2001 From: gdr-ftp Date: Wed, 29 Apr 1998 03:33:14 +0000 Subject: [PATCH] fsettext.3, funopen.3: Explained how to get binary streams on the result from an funopen(3) call. execl.3: minor "see also" change --- usr.man/man3/execl.3 | 2 +- usr.man/man3/fsettext.3 | 9 ++++++--- usr.man/man3/funopen.3 | 10 +++++++++- 3 files changed, 16 insertions(+), 5 deletions(-) diff --git a/usr.man/man3/execl.3 b/usr.man/man3/execl.3 index 2636d4d..680f042 100644 --- a/usr.man/man3/execl.3 +++ b/usr.man/man3/execl.3 @@ -180,7 +180,7 @@ Implemented from the BSD specification by Devin Reade. .SH SEE ALSO .BR execve (2), .BR fork (2), -.BR exec (3C). +.BR exec (3). .SH HISTORY The GNO implementation of these routines first appeared in the .BR lenviron diff --git a/usr.man/man3/fsettext.3 b/usr.man/man3/fsettext.3 index 23906cc..fcad3ad 100644 --- a/usr.man/man3/fsettext.3 +++ b/usr.man/man3/fsettext.3 @@ -2,9 +2,9 @@ .\" Macros for converting newline translation mode of stdio streams. .\" Devin Reade, 1997 .\" -.\" $Id: fsettext.3,v 1.1 1997/09/19 15:47:54 gdr Exp $ +.\" $Id: fsettext.3,v 1.2 1998/04/29 03:33:13 gdr-ftp Exp $ .\" -.TH FSETTEXT 3 "15 September 1997" GNO "Library Routines" +.TH FSETTEXT 3 "28 April 1998" GNO "Library Routines" .SH NAME .BR fsettext , .BR fsetbinary @@ -37,7 +37,10 @@ by default do newline translations. The macro allows these translations to be disabled. The .BR fsettext macro allows these translations to be reenabled. These macros are not -necessary and should not be used for any other stream pointers. +necessary and should not be used for any other stream pointers, other +than as described in the +.BR funopen (3) +manual page. .LP These macros must be used before any I/O is performed on the associated stream. If I/O has already been performed, the results are undefined. diff --git a/usr.man/man3/funopen.3 b/usr.man/man3/funopen.3 index 6439331..8e8657d 100644 --- a/usr.man/man3/funopen.3 +++ b/usr.man/man3/funopen.3 @@ -33,7 +33,7 @@ .\" .\" @(#)funopen.3 8.1 (Berkeley) 6/9/93 .\" -.TH FUNOPEN 3 "17 September 1997" GNO "Library Routines" +.TH FUNOPEN 3 "28 April 1998" GNO "Library Routines" .SH NAME .BR funopen , .BR fropen , @@ -116,6 +116,13 @@ and as calls to .BR funopen with only a read or write function specified. +.SH GNO IMPLEMENTATION NOTE +Since the underlying (BSD) implementation makes assumptions about the newline +character, the returned stream is always in text (newline translation) mode. +If you need to have a stream open in binary mode, you must call +.BR fsetbinary (3) +on the returned file pointer; this state information is not carried over +from the previous file pointer. .SH RETURN VALUES Upon successful completion, .BR funopen @@ -149,6 +156,7 @@ specified for the routine .BR fclose (3), .BR fopen (3), .BR fseek (3), +.BR fsetbinary (3), .BR setbuf (3) .SH HISTORY The