Return to xshell.0 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / man / man1

Annotation of 43BSDTahoe/new/X/man/man1/xshell.0, revision 1.1

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.