summaryrefslogtreecommitdiffstats
path: root/tk8.6/doc/SetAppName.3
diff options
context:
space:
mode:
authorWilliam Joye <wjoye@cfa.harvard.edu>2016-12-21 22:13:18 (GMT)
committerWilliam Joye <wjoye@cfa.harvard.edu>2016-12-21 22:13:18 (GMT)
commit07e464099b99459d0a37757771791598ef3395d9 (patch)
tree4ba7d8aad13735e52f59bdce7ca5ba3151ebd7e3 /tk8.6/doc/SetAppName.3
parentdeb3650e37f26f651f280e480c4df3d7dde87bae (diff)
downloadblt-07e464099b99459d0a37757771791598ef3395d9.zip
blt-07e464099b99459d0a37757771791598ef3395d9.tar.gz
blt-07e464099b99459d0a37757771791598ef3395d9.tar.bz2
new subtree for tcl/tk
Diffstat (limited to 'tk8.6/doc/SetAppName.3')
-rw-r--r--tk8.6/doc/SetAppName.362
1 files changed, 0 insertions, 62 deletions
diff --git a/tk8.6/doc/SetAppName.3 b/tk8.6/doc/SetAppName.3
deleted file mode 100644
index 3978850..0000000
--- a/tk8.6/doc/SetAppName.3
+++ /dev/null
@@ -1,62 +0,0 @@
-'\"
-'\" Copyright (c) 1994 The Regents of the University of California.
-'\" Copyright (c) 1994-1997 Sun Microsystems, Inc.
-'\"
-'\" See the file "license.terms" for information on usage and redistribution
-'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
-'\"
-.TH Tk_SetAppName 3 4.0 Tk "Tk Library Procedures"
-.so man.macros
-.BS
-.SH NAME
-Tk_SetAppName \- Set the name of an application for 'send' commands
-.SH SYNOPSIS
-.nf
-\fB#include <tk.h>\fR
-.sp
-const char *
-\fBTk_SetAppName\fR(\fItkwin, name\fR)
-.SH ARGUMENTS
-.AS Tk_Window parent
-.AP Tk_Window tkwin in
-Token for window in application. Used only to select a particular
-application.
-.AP "const char" *name in
-Name under which to register the application.
-.BE
-.SH DESCRIPTION
-.PP
-\fBTk_SetAppName\fR associates a name with a given application and
-records that association on the display containing with the application's
-main window.
-After this procedure has been invoked, other applications on the
-display will be able to use the \fBsend\fR command to invoke operations
-in the application.
-If \fIname\fR is already in use by some other application on the
-display, then a new name will be generated by appending
-.QW "\fB #2\fR"
-to \fIname\fR; if this name is also in use,
-the number will be incremented until an unused name is found.
-The return value from the procedure is a pointer to the name actually
-used.
-.PP
-If the application already has a name when \fBTk_SetAppName\fR is
-called, then the new name replaces the old name.
-.PP
-\fBTk_SetAppName\fR also adds a \fBsend\fR command to the application's
-interpreter, which can be used to send commands from this application
-to others on any of the displays where the application has windows.
-.PP
-The application's name registration persists until the interpreter is
-deleted or the \fBsend\fR command is deleted from \fIinterp\fR, at which
-point the name is automatically unregistered and the application
-becomes inaccessible via \fBsend\fR.
-The application can be made accessible again by calling \fBTk_SetAppName\fR.
-.PP
-\fBTk_SetAppName\fR is called automatically by \fBTk_Init\fR,
-so applications do not normally need to call it explicitly.
-.PP
-The command \fBtk appname\fR provides Tcl-level access to the
-functionality of \fBTk_SetAppName\fR.
-.SH KEYWORDS
-application, name, register, send command