aboutsummaryrefslogtreecommitdiff
path: root/contrib/tcl/doc
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/tcl/doc')
-rw-r--r--contrib/tcl/doc/CrtModalTmt.371
-rw-r--r--contrib/tcl/doc/GetFile.3130
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