diff options
Diffstat (limited to 'contrib/tcl/doc')
| -rw-r--r-- | contrib/tcl/doc/CrtModalTmt.3 | 71 | ||||
| -rw-r--r-- | contrib/tcl/doc/GetFile.3 | 130 |
2 files changed, 0 insertions, 201 deletions
diff --git a/contrib/tcl/doc/CrtModalTmt.3 b/contrib/tcl/doc/CrtModalTmt.3 deleted file mode 100644 index 85f079fc85cc..000000000000 --- a/contrib/tcl/doc/CrtModalTmt.3 +++ /dev/null @@ -1,71 +0,0 @@ -'\" -'\" Copyright (c) 1995-1996 Sun Microsystems, Inc. -'\" -'\" See the file "license.terms" for information on usage and redistribution -'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. -'\" -'\" SCCS: @(#) CrtModalTmt.3 1.3 96/03/25 20:00:19 -'\" -.so man.macros -.TH Tcl_CreateModalTimeout 3 7.5 Tcl "Tcl Library Procedures" -.BS -.SH NAME -Tcl_CreateModalTimeout, Tcl_DeleteModalTimeout \- special timer for modal operations -.SH SYNOPSIS -.nf -\fB#include <tcl.h>\fR -.sp -\fBTcl_CreateModalTimeout\fR(\fImilliseconds, proc, clientData\fR) -.sp -\fBTcl_DeleteModalTimeout\fR(\fIproc, clientData\fR) -.SH ARGUMENTS -.AS Tcl_TimerToken milliseconds -.AP int milliseconds in -How many milliseconds to wait before invoking \fIproc\fR. -.AP Tcl_TimerProc *proc in -Procedure to invoke after \fImilliseconds\fR have elapsed. -.AP ClientData clientData in -Arbitrary one-word value to pass to \fIproc\fR. -.BE - -.SH DESCRIPTION -.PP -\fBTcl_CreateModalTimeout\fR provides an alternate form of timer -from those provided by \fBTcl_CreateTimerHandler\fR. -These timers are called ``modal'' because they are typically -used in situations where a particular operation must be completed -before the application does anything else. -If such an operation needs a timeout, it cannot use normal timer -events: if normal timer events were processed, arbitrary Tcl scripts -might be invoked via other event handlers, which could interfere with -the completion of the modal operation. -The purpose of modal timers is to allow a single timeout to occur -without allowing any normal timer events to occur. -.PP -\fBTcl_CreateModalTimeout\fR behaves just like \fBTcl_CreateTimerHandler\fR -except that it creates a modal timeout. -Its arguments have the same meaning as for \fBTcl_CreateTimerHandler\fR -and \fIproc\fR is invoked just as for \fBTcl_CreateTimerHandler\fR. -\fBTcl_DeleteModalTimeout\fR deletes the most recently created -modal timeout; its arguments must match the corresponding arguments -to the most recent call to \fBTcl_CreateModalTimeout\fR. -.PP -Modal timeouts differ from a normal timers in three ways. First, -they will trigger regardless of whether the TCL_TIMER_EVENTS flag -has been passed to \fBTcl_DoOneEvent\fR. -Typically modal timers are used with the TCL_TIMER_EVENTS flag -off so that normal timers don't fire but modal ones do. -Second, if several modal timers have been created they stack: -only the top timer on the stack (the most recently created one) -is active at any point in time. -Modal timeouts must be deleted in inverse order from their creation. -Third, modal timeouts are not deleted when they fire: once a modal -timeout has fired, it will continue firing every time \fBTcl_DoOneEvent\fR -is called, until the timeout is deleted by calling -\fBTcl_DeleteModalTimeout\fR. -.PP -Modal timeouts are only needed in a few special situations, and they -should be used with caution. - -.SH KEYWORDS -callback, clock, handler, modal timeout diff --git a/contrib/tcl/doc/GetFile.3 b/contrib/tcl/doc/GetFile.3 deleted file mode 100644 index 68ffd219a8ac..000000000000 --- a/contrib/tcl/doc/GetFile.3 +++ /dev/null @@ -1,130 +0,0 @@ -'\" -'\" Copyright (c) 1995-1996 Sun Microsystems, Inc. -'\" -'\" See the file "license.terms" for information on usage and redistribution -'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. -'\" -'\" SCCS: @(#) GetFile.3 1.8 96/03/25 20:03:31 -'\" -.so man.macros -.TH Tcl_GetFile 3 7.5 Tcl "Tcl Library Procedures" -.BS -.SH NAME -Tcl_GetFile, Tcl_FreeFile, Tcl_GetFileInfo \- procedures to manipulate generic file handles -.SH SYNOPSIS -.nf -\fB#include <tcl.h>\fR -.sp -Tcl_File -\fBTcl_GetFile\fR(\fIosHandle, type\fR) -.sp -\fBTcl_FreeFile\fR(\fIhandle\fR) -.sp -ClientData -\fBTcl_GetFileInfo\fR(\fIhandle, typePtr\fR) -.sp -ClientData -\fBTcl_GetNotifierData\fR(\fIhandle, freeProcPtr\fR) -.sp -\fBTcl_SetNotifierData\fR(\fIhandle, freeProc, clientData\fR) -.SH ARGUMENTS -.AS Tcl_FileFreeProc **freeProcPtr -.AP ClientData osHandle in -Platform-specific file handle to be associated with the generic file handle. -.AP int type in -The type of platform-specific file handle associated with the generic file -handle. See below for a list of valid types. -.AP Tcl_File handle in -Generic file handle associated with platform-specific file information. -.AP int *typePtr in/out -If \fI*typePtr\fR is not NULL, then the specified word is set to -contain the type associated with \fIhandle\fR. -.AP Tcl_FileFreeProc *freeProc in -Procedure to call when \fIhandle\fR is deleted. -.AP Tcl_FileFreeProc **freeProcPtr in/out -Pointer to location in which to store address of current free procedure -for file handle. Ignored if NULL. -.AP ClientData clientData in -Arbitrary one-word value associated with the given file handle. This -data is owned by the caller. -.BE - -.SH DESCRIPTION -.PP -A \fBTcl_File\fR is an opaque handle used to refer to files in a -platform independent way in Tcl routines like -\fBTcl_CreateFileHandler\fR. A file handle has an associated -platform-dependent \fIosHandle\fR, a \fItype\fR and additional private -data used by the notifier to generate events for the file. The type -is an integer that determines how the platform-specific drivers will -interpret the \fIosHandle\fR. The types that are defined by the core -are: -.TP 22 -\fBTCL_UNIX_FD\fR -The \fIosHandle\fR is a Unix file descriptor. -.TP 22 -\fBTCL_MAC_FILE\fR -The file is a Macintosh file handle. -.TP 22 -\fBTCL_WIN_FILE\fR -The \fIosHandle\fR is a Windows normal file \fBHANDLE\fR. -.TP 22 -\fBTCL_WIN_PIPE\fR -The \fIosHandle\fR is a Windows anonymous pipe \fBHANDLE\fR. -.TP 22 -\fBTCL_WIN_SOCKET\fR -The \fIosHandle\fR is a Windows \fBSOCKET\fR. -.TP 22 -\fBTCL_WIN_CONSOLE\fR -The \fIosHandle\fR is a Windows console buffer \fBHANDLE\fR. -.PP -\fBTcl_GetFile\fR locates the file handle corresponding to a particular -\fIosHandle\fR and a \fItype\fR. If a file handle already existed for the -given file, then that handle will be returned. If this is the first time that -the file handle for a particular file is being retrieved, then a new file -handle will be allocated and returned. -.PP -When a file handle is no longer in use, it should be deallocated with -a call to \fBTcl_FreeFile\fR. A call to this function will invoke the -notifier free procedure \fIproc\fR, if there is one. After the -notifier has cleaned up, any resources used by the file handle will be -deallocated. \fBTcl_FreeFile\fR will not close the platform-specific -\fIosHandle\fR. -.PP -\fBTcl_GetFileInfo\fR may be used to retrieve the platform-specific -\fIosHandle\fR and type associated with a file handle. If -\fItypePtr\fR is not NULL, then the word at \fI*typePtr\fR is set to -the type of the file handle. The return value of the function is the -associated platform-specific \fIosHandle\fR. Note that this function -may be used to extract the platform-specific file handle from a -\fBTcl_File\fR so that it may be used in external interfaces. -However, programs written using this interface will be -platform-specific. -.PP -The \fBTcl_SetNotifierData\fR and \fBTcl_GetNotifierData\fR procedures are -intended to be used only by notifier writers. See the -\fITcl_CreateEventSource(3)\fR manual entry for more information on -the notifier. -.PP -\fBTcl_SetNotifierData\fR may be used by notifier writers to associate -notifier-specific information with a \fBTcl_File\fR. The \fIdata\fR -argument specifies a word that may be retrieved with a later call to -\fBTcl_GetNotifierData\fR. If the \fIfreeProc\fR argument is non-NULL -it specifies the address of a procedure to invoke when the -\fBTcl_File\fR is deleted. \fIfreeProc\fR should have arguments and -result that match the type \fBTcl_FileFreeProc\fR: -.CS -typedef void Tcl_FileFreeProc( - ClientData \fIclientData\fR); -.CE -When \fIfreeProc\fR is invoked the \fIclientData\fR argument will be -the same as the corresponding argument passed to -\fBTcl_SetNotifierData\fR. -.PP -\fBTcl_GetNotifierData\fR returns the \fIclientData\fR associated with -the given \fBTcl_File\fR, and if the \fIfreeProcPtr\fR field is -non-\fBNULL\fR, the address indicated by it gets the address of the -free procedure stored with this file. - -.SH KEYWORDS -generic file handle, file type, file descriptor, notifier |
