Penguin
Recent Changes
Annotated edit history of tixwish(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 wish
2 !!!wish
3 NAME
4 SYNOPSIS
5 OPTIONS
6 DESCRIPTION
7 OPTIONS
8 APPLICATION NAME AND CLASS
9 VARIABLES
10 X RESOURCES
11 SCRIPT FILES
12 PROMPTS
13 KEYWORDS
14 ----
15 !!NAME
16
17
18 tixwish - Windowing shell for interpreting Tix commands.
19 !!SYNOPSIS
20
21
22 __tixwish__ ?''fileName arg arg ...''?
23 !!OPTIONS
24
25
26 __-display__ ''display''
27
28
29 Display (and screen) on which to display
30 window.
31
32
33 __-geometry__ ''geometry''
34
35
36 Initial geometry to use for window. If this option is
37 specified, its value is stored in the __geometry__ global
38 variable of the application's Tcl interpreter.
39
40
41 __-name__ ''name'' Use ''name'' as the title to be
42 displayed in the window, and as the name of the interpreter
43 for __send__ commands.
44
45
46 __-sync__ Execute all X server commands synchronously, so
47 that errors are reported immediately. This will result in
48 much slower execution, but it is useful for
49 debugging.
50
51
52 ________________________________________________________________________________________________________________________________________
53 !!DESCRIPTION
54
55
56 __Tixwish__ is a simple program consisting of the Tcl
57 command language, the Tk toolkit, and a main program that
58 reads commands from standard input or from a file. It
59 creates a main window and then processes Tcl commands. If
60 __tixwish__ is invoked with no arguments, or with a first
61 argument that starts with ``-'', then it reads Tcl commands
62 interactively from standard input. It will continue
63 processing commands until all windows have been deleted or
64 until end-of-file is reached on standard input. If there
65 exists a file __.tixwishrc__ in the home directory of the
66 user, __tixwish__ evaluates the file as a Tcl script just
67 before reading the first command from standard
68 input.
69
70
71 If __tixwish__ is invoked with an initial ''fileName''
72 argument, then ''fileName'' is treated as the name of a
73 script file. __Tixwish__ will evaluate the script in
74 ''fileName'' (which presumably creates a user interface),
75 then it will respond to events until all windows have been
76 deleted. Commands will not be read from standard input.
77 There is no automatic evaluation of __.tixwishrc__ in
78 this case, but the script file can always __source__ it
79 if desired.
80 !!OPTIONS
81
82
83 __Tixwish__ automatically processes all of the
84 command-line options described in the __OPTIONS__ summary
85 above. Any other command-line arguments besides these are
86 passed through to the application using the __argc__ and
87 __argv__ variables described later.
88 !!APPLICATION NAME AND CLASS
89
90
91 The name of the application, which is used for purposes such
92 as __send__ commands, is taken from the __-name__
93 option, if it is specified; otherwise it is taken from
94 ''fileName'', if it is specified, or from the command
95 name by which __tixwish__ was invoked. In the last two
96 cases, if the name contains a ``/'' character, then only the
97 characters after the last slash are used as the application
98 name.
99
100
101 The class of the application, which is used for purposes
102 such as specifying options with a __RESOURCE_MANAGER__
103 property or .Xdefaults file, is the same as its
104 name
105
106
107 except that the first letter is capitalized.
108 !!VARIABLES
109
110
111 __Tixwish__ sets the following Tcl
112 variables:
113
114
115 __argc__ Contains a count of the number of ''arg''
116 arguments (0 if none), not including the options described
117 above.
118
119
120 __argv__ Contains a Tcl list whose elements are the
121 ''arg'' arguments (not including the options described
122 above), in order, or an empty string if there are no
123 ''arg'' arguments.
124
125
126 __argv0__ Contains ''fileName'' if it was specified.
127 Otherwise, contains the name by which __tixwish__ was
128 invoked.
129
130
131 __geometry__
132
133
134 If the __-geometry__ option is specified, __tixwish__
135 copies its value into this variable. If the variable still
136 exists after ''fileName'' has been evaluated,
137 __tixwish__ uses the value of the variable in a __wm
138 geometry__ command to set the main window's
139 geometry.
140
141
142 __tcl_interactive__
143
144
145 Contains 1 if __tixwish__ is reading commands
146 interactively (__fileName__ was not specified and
147 standard input is a terminal-like device), 0
148 otherwise.
149 !!X RESOURCES
150
151
152 __Tixwish__ makes use of several X Resources to determine
153 the __Toolkit Options__ for the Tix library. These X
154 resources must be set using __RESOURCE_MANAGER__
155 properties or .Xdefaults files __before tixwish__ starts
156 running. These resources must be associated with the main
157 window of the __tixwish__ application. These options
158 include:
159
160
161 Name: __ tixScheme
2 perry 162 __Class: __ !TixScheme
1 perry 163 __
164
165
166 Specifies the color scheme to use for the Tix application.
167 Currently only these schemes are supported: Blue, Gray,
2 perry 168 SGIGray, !TixGray, and TK.
1 perry 169
170
171 Name: __ tixFontSet
2 perry 172 __Class: __ !TixFontSet
1 perry 173 __
174
175
2 perry 176 Specifies the !FontSet to use for the Tix application. A
177 !FontSet designates the fonts to use for different types of
178 widgets. Currently only these !FontSets are supported:
1 perry 179 12Point, 14Point and TK.
180
181
182 For example, you may put these two lines in your .Xdefaults
183 file
184
185
186 *tixwish.tixScheme: Gray
187 *tixwish.tixFontSet: 12Point
188 !!SCRIPT FILES
189
190
191 If you create a Tcl script in a file whose first line
192 is
193
194
195 __#!/usr/local/bin/tixwish
196 __
197
198
199 then you can invoke the script file directly from your shell
200 if you mark it as executable. This assumes that
201 __tixwish__ has been installed in the default location in
202 /usr/local/bin; if it's installed somewhere else then you'll
203 have to modify the above line to match. Many UNIX systems do
204 not allow the __#!__ line to exceed about 30 characters
205 in length, so be sure that the __tixwish__ executable can
206 be accessed with a short file name.
207 !!PROMPTS
208
209
210 When __tixwish__ is invoked interactively it normally
211 prompts for each command with ``__%__ ''. You can change
212 the prompt by setting the variables __tcl_prompt1__ and
213 __tcl_prompt2__. If variable __tcl_prompt1__ exists
214 then it must consist of a Tcl script to output a prompt;
215 instead of outputting a prompt __tixwish__ will evaluate
216 the script in __tcl_prompt1__. The variable
217 __tcl_prompt2__ is used in a similar way when a newline
218 is typed but the current command isn't yet complete; if
219 __tcl_prompt2__ isn't set then no prompt is output for
220 incomplete commands.
221 !!KEYWORDS
222
223
224 shell, wish, Tk, toolkit
225 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.