'\" '\" Copyright 1991 Regents of the University of California '\" Permission to use, copy, modify, and distribute this '\" documentation for any purpose and without fee is hereby '\" granted, provided that this notice appears in all copies. '\" The University of California makes no representations about '\" the suitability of this material for any purpose. It is '\" provided "as is" without express or implied warranty. '\" '\" $Header: /a/cvs/386BSD/ports/tk/doc/wish.1,v 1.1.1.1 1993/08/09 01:21:07 jkh Exp $ SPRITE (Berkeley) '/" .so man.macros .HS WISH cmds .BS '\" Note: do not modify the .SH NAME line immediately below! .SH NAME wish \- Simple windowing shell .SH SYNOPSIS \fBwish\fR ?\fIoptions\fR?\fR .SH OPTIONS .IP "\fB\-display \fIdisplay\fR" 15 Display (and screen) on which to display window. .IP "\fB\-file \fIfileName\fR" 15 Read commands from \fIfileName\fR rather than standard input. The last element in \fIfileName\fR will be used as the title for the application and name of its interpreter for \fBsend\fR commands (unless overridden by the \fB\-name\fR option\fR). .IP "\fB\-geometry \fIgeometry\fR" 15 Initial geometry to use for window. .IP "\fB\-name \fIname\fR" 15 Use \fIname\fR as the title to be displayed in the window, and as the name of the interpreter for \fBsend\fR commands. .IP "\fB\-sync\fR" 15 Execute all X server commands synchronously, so that errors are reported immediately. This will result in much slower execution, but it is useful for debugging. .IP "\fB\-help\fR" 15 Print a summary of the command-line options and exit. .BE .SH DESCRIPTION .PP \fBWish\fR is a simple program consisting of the Tcl command language, the Tk toolkit, and a main program that reads commands from standard input or from a file. If \fBwish\fR is invoked with no arguments, it creates a small window and reads Tcl commands interactively from standard input. It will continue processing commands until all windows have been deleted or until end-of-file is reached on standard input. .PP If the \fB\-file\fR option is provided to Tk, then it reads Tcl commands from the file named in the \fB\-file\fR option. These commands will normally create an interactive interface consisting of one or more widgets. When the end of the command file is reached, \fBwish\fR will continue to respond to X events until all windows have been deleted. .PP The \fBwish\fR program provides a few Tcl commands in addition to those already provided by the Tcl and Tk libraries. However, these commands are intended for debugging purposes only and should not be widely used. In particular, they will probably be eliminated in some future release. If you wish to use these commands you'll have to read the code to see what they do. .SH KEYWORDS shell, toolkit