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