INTRO(9) INTRO(9) NAME intro - introduction to Inferno Tk DESCRIPTION This section of the manual provides a reference for the Inferno Tk implementation, which is accessed by Limbo programs via tk(2), and from sh(1) via sh-tk(1). The following pages were derived by Vita Nuova from documen- tation that is Copyright © 1990 The Regents of the University of Cali- fornia Copyright © 1994-1996 Sun Microsystems, Inc. See copyright(9) for the full copyright notice. The format of the pages has changed to follow the format of the rest of this manual, but more important, the content has been changed (typically in small ways) to reflect the vari- ant of Tk implemented by Inferno. Programming Interface The interface to Inferno Tk is exclusively through the tk(2) module; all the Tk commands described in this section of the manual are excecuted by passing them as strings to the cmd function in that module. The Inferno Tk implementation is based on the Tk 4.0 documentation, but there are many dif- ferences, probably the greatest of which is that there is no associated Tcl implementation, so almost every Inferno application using Tk will need to have some Limbo code asso- ciated with it (the sh-tk(1) shell module can also fulful this rôle). See ``An Overview of Limbo/Tk'' in Volume 2 for a tutorial-style introduction to the use of Inferno Tk which summarises the differences from Tk 4.0. Tk Commands The command string passed to tk->cmd may contain one or more Tk commands, separated by semicolons. A semicolon is not a command separator when it is nested in braces ({}) or brack- ets ([]) or it is escaped by a backslash (\). Each command is divided into words: sequences of characters separated by one or more blanks and tabs. There is also a `super quote' convention: at any point in the command string a single quote mark (') means that the entire rest of the string should be treated as one word. A word beginning with an opening brace ({) continues until the balancing closing brace (}) is reached. The outer brace characters are stripped. A backslash can be used to escape a Page 1 Plan 9 (printed 10/6/24) INTRO(9) INTRO(9) brace in this context. Backslash characters not used to escape braces are left unchanged. A word beginning with an opening bracket ([) continues until the balancing closing bracket (]) is reached. The enclosed string is then evaluated as if it were a command string, and the resulting value is used as the contents of the word. Single commands are executed in order until they are all done or an error is encountered. By convention, an error is signaled by a return value starting with an exclamation mark (!). The return value from tk->cmd is the return value of the first error-producing command or else the return value of the final single command. To execute a single command, the first word is examined. It must either begin with dot (.) in which case it must name an existing widget, which will interpret the rest of the command according to its type, or one of the following words, each of which is documented in a manual page of that name in this section: bind focus lower scrollbar button frame menu see canvas grab menubutton send checkbutton grid pack text cursor image radiobutton update destroy label raise variable entry listbox scale Widget Options Each manual page in this section documents the options that a particular command will accept. A number of options are common to several of the widgets and are named as ``standard options'' near the beginning of the manual page for each widget. These options are documented in options(9). The types of value required as arguments to options within Inferno Tk are documented under types(9). SEE ALSO options(9), types(9), tk(2), sh-tk(1), tkcmd(1), wmlib(2), draw-intro(2), ``An Overview of Limbo/Tk'' in Volume 2. BUGS The bracket ([]) command interpretation is not applied con- sistently throughout the Inferno Tk commands (notably, the argument to the send(9) command will not interpret this cor- rectly). Moreover, if the string to be substituted is sig- nificantly bigger than the command it was substituting, then it will be truncated. Page 2 Plan 9 (printed 10/6/24)