From 5d6d4ebb82042239ea228662db31110a81adfebb Mon Sep 17 00:00:00 2001 From: ericm Date: Tue, 25 Apr 2000 00:54:52 +0000 Subject: * unix/mkLinks: * doc/OpenFileChnl.3: Added man entry for Tcl_Ungets [Bug: 1834]. --- ChangeLog | 6 ++++++ doc/OpenFileChnl.3 | 41 +++++++++++++++++++++++++++++++---------- unix/mkLinks | 4 ++++ 3 files changed, 41 insertions(+), 10 deletions(-) diff --git a/ChangeLog b/ChangeLog index 2cd9998..b25b58d 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,6 +1,12 @@ 2000-04-24 Eric Melski * unix/mkLinks: + * doc/OpenFileChnl.3: Added man entry for Tcl_Ungets [Bug: 1834]. + + * unix/mkLinks: + * doc/SourceRCFile.3: Man page for Tcl_SourceRCFile [Bug: 1833]. + + * unix/mkLinks: * doc/ParseCmd.3: Added documentation for Tcl_ParseVar [Bug: 1828]. 2000-04-24 Jeff Hobbs diff --git a/doc/OpenFileChnl.3 b/doc/OpenFileChnl.3 index 1e56009..45d1410 100644 --- a/doc/OpenFileChnl.3 +++ b/doc/OpenFileChnl.3 @@ -4,13 +4,13 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: OpenFileChnl.3,v 1.8 2000/04/14 23:01:52 hobbs Exp $ +'\" RCS: @(#) $Id: OpenFileChnl.3,v 1.9 2000/04/25 00:54:53 ericm Exp $ .so man.macros .TH Tcl_OpenFileChannel 3 8.3 Tcl "Tcl Library Procedures" .BS '\" Note: do not modify the .SH NAME line immediately below! .SH NAME -Tcl_OpenFileChannel, Tcl_OpenCommandChannel, Tcl_MakeFileChannel, Tcl_GetChannel, Tcl_GetChannelNames, Tcl_GetChannelNamesEx, Tcl_RegisterChannel, Tcl_UnregisterChannel, Tcl_Close, Tcl_ReadChars, Tcl_Read, Tcl_GetsObj, Tcl_Gets, Tcl_WriteObj, Tcl_WriteChars, Tcl_Write, Tcl_Flush, Tcl_Seek, Tcl_Tell, Tcl_GetChannelOption, Tcl_SetChannelOption, Tcl_Eof, Tcl_InputBlocked, Tcl_InputBuffered \- buffered I/O facilities using channels +Tcl_OpenFileChannel, Tcl_OpenCommandChannel, Tcl_MakeFileChannel, Tcl_GetChannel, Tcl_GetChannelNames, Tcl_GetChannelNamesEx, Tcl_RegisterChannel, Tcl_UnregisterChannel, Tcl_Close, Tcl_ReadChars, Tcl_Read, Tcl_GetsObj, Tcl_Gets, Tcl_WriteObj, Tcl_WriteChars, Tcl_Write, Tcl_Flush, Tcl_Seek, Tcl_Tell, Tcl_GetChannelOption, Tcl_SetChannelOption, Tcl_Eof, Tcl_InputBlocked, Tcl_InputBuffered, Tcl_Ungets \- buffered I/O facilities using channels .SH SYNOPSIS .nf \fB#include \fR @@ -62,6 +62,9 @@ int \fBTcl_Gets\fR(\fIchannel, lineRead\fR) .sp int +\fBTcl_Ungets\fR(\fIchannel, input, inputLen, addAtEnd\fR) +.sp +int \fBTcl_WriteObj\fR(\fIchannel, writeObjPtr\fR) .sp int @@ -72,28 +75,28 @@ int .VE .sp int -\fBTcl_Flush\fR(\fIchannel\fR) +\fBTcl_Eof\fR(\fIchannel\fR) .sp int -\fBTcl_Seek\fR(\fIchannel, offset, seekMode\fR) +\fBTcl_Flush\fR(\fIchannel\fR) .sp int -\fBTcl_Tell\fR(\fIchannel\fR) +\fBTcl_InputBlocked\fR(\fIchannel\fR) .sp int -\fBTcl_GetChannelOption\fR(\fIinterp, channel, optionName, optionValue\fR) +\fBTcl_InputBuffered\fR(\fIchannel\fR) .sp int -\fBTcl_SetChannelOption\fR(\fIinterp, channel, optionName, newValue\fR) +\fBTcl_Seek\fR(\fIchannel, offset, seekMode\fR) .sp int -\fBTcl_Eof\fR(\fIchannel\fR) +\fBTcl_Tell\fR(\fIchannel\fR) .sp int -\fBTcl_InputBlocked\fR(\fIchannel\fR) +\fBTcl_GetChannelOption\fR(\fIinterp, channel, optionName, optionValue\fR) .sp int -\fBTcl_InputBuffered\fR(\fIchannel\fR) +\fBTcl_SetChannelOption\fR(\fIinterp, channel, optionName, newValue\fR) .sp .SH ARGUMENTS .AS Tcl_ChannelType newClientProcPtr in @@ -193,6 +196,13 @@ New value for the option given by \fIoptionName\fR. .VS 8.3 .AP char *pattern in The pattern to match on, passed to Tcl_StringMatch, or NULL. +.AP char *input in +The input to add to a channel buffer. +.AP int inputLen in +Length of the input +.AP int addToEnd in +Flag indicating whether the input should be added to the end or +beginning of the channel buffer. .VE .BE @@ -438,6 +448,17 @@ of input unavailability. characters are appended to the appended to the dynamic string given by \fIdsPtr\fR rather than a Tcl object. +.SH "TCL_UNGETS" +.PP +\fBTcl_Ungets\fR is used to add data to the input queue of a channel, +at either the head or tail of the queue. \fIInput\fR is a pointer to +the data that is to be added. \fIInputLen\fR gives the length of the +input to add. \fIAddAtEnd\fR, in non-zero, indicates that the data is +to be added at the end of queue; otherwise it will be added at the +head of the queue. If \fIchannel\fR has a "sticky" EOF set, no data will be +added to the input queue. \fBTcl_Ungets\fR returns \fIinputLen\fR or +-1 if an error occurs. + .SH "TCL_WRITECHARS, TCL_WRITEOBJ, AND TCL_WRITE" .PP \fBTcl_WriteChars\fR accepts \fIbytesToWrite\fR bytes of character data at diff --git a/unix/mkLinks b/unix/mkLinks index eb21723..521d988 100644 --- a/unix/mkLinks +++ b/unix/mkLinks @@ -668,6 +668,10 @@ if test -r OpenFileChnl.3; then ln OpenFileChnl.3 Tcl_Gets.3 fi if test -r OpenFileChnl.3; then + rm -f Tcl_Ungets.3 + ln OpenFileChnl.3 Tcl_Ungets.3 +fi +if test -r OpenFileChnl.3; then rm -f Tcl_GetsObj.3 ln OpenFileChnl.3 Tcl_GetsObj.3 fi -- cgit v0.12