![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to xshell.0 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / man / man1|
Return to xshell.0 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / man / man1 |
1.1 root 1:
2:
3:
4: XSHELL(1) UNIX Programmer's Manual XSHELL(1)
5:
6:
7:
8: NAME
9: xshell - X Window System, key/button command exec
10:
11: SYNOPSIS
12: xshell [ _o_p_t_i_o_n_s ] [ _h_o_s_t:_d_i_s_p_l_a_y ] ...
13:
14: DESCRIPTION
15: _X_s_h_e_l_l is a program for starting up X applications with a
16: single key or button stroke. It displays a scallop shell
17: icon in which button and key presses stand for different
18: commands. The user can bind a command string to any key or
19: button by inserting a line like the following in his or her
20:
21: xshell.action.keyname: command to be exec'ed
22:
23: Keynames are simply letters, numbers, and symbols as they
24: appear on the keyboard (e.g. a, $, 9), or one of the follow-
25: ing special names (taken from the X keyboard definitions):
26:
27: KEYPAD0 FUNC1 E1
28: KEYPAD. FUNC2 E2
29: ENTER FUNC3 E3
30: KEYPAD1 FUNC4 E4
31: KEYPAD2 FUNC5 E5
32: KEYPAD3 FUNC6 E6
33: KEYPAD4 FUNC7 LEFTARROW
34: KEYPAD5 FUNC8 RIGHTARROW
35: KEYPAD6 FUNC9 DOWNARROW
36: KEYPAD, FUNC10 UPARROW
37: KEYPAD7 FUNC11 SHIFT
38: KEYPAD8 FUNC12 CONTROL
39: KEYPAD9 FUNC13 LOCK
40: KEYPAD- FUNC14 SYMBOL
41: PF1 FUNC15
42: PF2 FUNC16
43: PF3 FUNC17
44: PF4 FUNC18
45: LEFTBUTTON FUNC19
46: MIDDLEBUTTON FUNC29
47: RIGHTBUTTON
48:
49:
50: Thus, the following `.Xdefaults' definitions specify that
51: the Left Button will spawn a terminal window, the Middle
52: Button an editor, the Right Button a calculator, $ a Bourne
53: shell, and # a superuser shell:
54:
55: xshell.action.LeftButton: xterm =80x65-0+0 -fn 6x10
56: xshell.action.MiddleButton: xted =80x65+0-0
57: xshell.action.RightButton: xterm =20x20-0-0 -fn 6x10 -e dc
58: xshell.action.$: xterm =80x65+0+0 -fn 6x10 -e sh
59: xshell.action.#: xterm =80x65+0+0 -fn 6x10 -e su
60:
61:
62:
63: Printed 9/15/87 31 October 1985 1
64:
65:
66:
67:
68:
69:
70: XSHELL(1) UNIX Programmer's Manual XSHELL(1)
71:
72:
73:
74: _X_s_h_e_l_l breaks the command string up into words by removing
75: all white space (i.e. tabs and spaces) and uses the vfork()
76: and execvp() system calls to spawn off the command. A more
77: complicated parsing algorithm could easily be added, but the
78: current method is adequate (and fast and memory efficient).
79:
80: One thing to keep in mind is that _x_s_h_e_l_l is NOT a window
81: manager. It was written to make popping up frequently used
82: utilities as painless as possible (how many times have you
83: found that you need just 1 more window....). It might make
84: a nice addition to some of the more verbose window managers,
85: but it runs quite nicely as a separate program.
86:
87:
88: ARGUMENTS
89: _X_s_h_e_l_l is designed to be somewhat compatible with _x_c_l_o_c_k in
90: the arguments that it takes. However, _x_s_h_e_l_l will allow you
91: to abbreviate its longer flags to any length you chose.
92: Thus, the -reverse flag can be spelled out, given as -rev,
93: or even just -r:
94:
95: -fg _c_o_l_o_r On color displays, determines the color of the
96: foreground.
97:
98: -bg _c_o_l_o_r On color displays, determines the color of the
99: background.
100:
101: -bd _c_o_l_o_r On color displays, determines the color of the
102: border.
103:
104: -bw _p_i_x_e_l_s
105: Specify the width in pixels of the border around
106: the _x_s_h_e_l_l window.
107:
108: -v[olume] _n
109: Volume for calls to _X_F_e_e_p, used when errors (such
110: as unbound key) are found.
111:
112: -f[lash] _n
113: Number of times to flash the shell window to ack-
114: nowledge a button or key press.
115:
116: -d[elay] _n
117: One-hundredths of a second to wait between flashs
118: (default is 5).
119:
120: -r[everse]
121: Reverse video (swap foreground and background).
122:
123: -q[uiet] Do not `feep' on errors (see volume).
124:
125:
126:
127:
128:
129: Printed 9/15/87 31 October 1985 2
130:
131:
132:
133:
134:
135:
136: XSHELL(1) UNIX Programmer's Manual XSHELL(1)
137:
138:
139:
140: -s[mall] Use a smaller (48x48) version of the shell icon.
141: The default icon is 96x96.
142:
143: =_g_e_o_m_e_t_r_y By default _x_s_h_e_l_l will create a window the size of
144: whatever icon you select; the standard X window
145: geometry argument will override this. See _X(_1)
146: for details.
147:
148: _h_o_s_t:_d_i_s_p_l_a_y
149: specifies the display on which to put the _x_s_h_e_l_l
150: window. This overrides the DISPLAY environment
151: variable.
152:
153:
154: X DEFAULTS
155: To make invoking _x_s_h_e_l_l easier, each of the flags listed
156: above may be specified in the user's
157:
158: Foreground
159: gives the foreground color.
160:
161: Background
162: gives the background color.
163:
164: Border gives the border color.
165:
166: BorderWidth
167: gives the border width.
168:
169: ReverseVideo
170: if "on", the shell icon should be white on black
171: instead of black on white.
172:
173: Volume gives the volume to use in calls to XFeep().
174:
175: Flash gives the number of times to flash the shell win-
176: dow to acknowledge key or button presses.
177:
178: Delay gives hundredths of a second to wait in between
179: flashes.
180:
181: Quiet prevents _x_s_h_e_l_l from feeping at you when you mis-
182: type.
183:
184: IconSize if "small", a halfsize (48x48) version of the
185: scallopshell is used.
186:
187: WindowGeometry
188: gives the shell window size using standard X
189: =WxH+X+Y notation.
190:
191:
192:
193:
194:
195: Printed 9/15/87 31 October 1985 3
196:
197:
198:
199:
200:
201:
202: XSHELL(1) UNIX Programmer's Manual XSHELL(1)
203:
204:
205:
206: ENVIRONMENT
207: DISPLAY To get the default host and display number.
208:
209:
210: SEE ALSO
211: xwm(1), xnwm(1), X(1), execl(3), vfork(2)
212:
213: DIAGNOSTICS
214: If -quiet is not given on the command line or
215: ``xshell.Quiet: on'' does not appear in the user's ._X_d_e_-
216: _f_a_u_l_t_s, _x_s_h_e_l_l will `feep' if a key or button is pressed for
217: which there is no definition in the ._X_d_e_f_a_u_l_t_s file.
218:
219: AUTHOR
220: Copyright 1985, Cognition Inc.
221:
222: Jim Fulton (Cognition Inc.)
223:
224: BUGS
225: _X_s_h_e_l_l uses the XGetDefault call to fetch the command string
226: for a given key. Thus, you cannot bind the colon (``:'')
227: character to a command.
228:
229: A more `user-friendly' interface could include dialog boxes
230: that the user could pop up to type in a command directly so
231: that a full shell doesn't have to be started. Then again,
232: it is nice and compact now and if you really need to do that
233: more than once you should use a real shell.
234:
235: This program along with _x_w_m(_1) and _x_n_w_m have been mostly
236: superceded by _u_w_m(_1).
237:
238:
239:
240:
241:
242:
243:
244:
245:
246:
247:
248:
249:
250:
251:
252:
253:
254:
255:
256:
257:
258:
259:
260:
261: Printed 9/15/87 31 October 1985 4
262:
263:
264:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.