props(1)

NAME

props − graphical interface to set OpenWindows properties

SYNOPSIS

props [ -toolkitoption ... ] [ -init ]

DESCRIPTION

The props program provides a graphical interface to many properties of OpenWindows which are controlled via X resources. The resources props manipulates are stored in the file called .OWdefaults in the user’s home directory. This enables props to ensure properties persist across window sessions.

Upon window system startup, the .OWdefaults file is merged into the X resource manager as specified in the openwin-sys file. This occurs after xinit(1) loads $OPENWINHOME/lib/Xdefaults or .Xdefaults in the user’s home directory if it exists. Thus, the settings in .OWdefaults take precidence over the settings in a user’s .Xdefaults file which in turn take precidence over the system defaults set in $OPENWINHOME/lib/Xdefaults. When properties are changed via props, props updates .OWdefaults and the X resource manager.

The resources handled by props consist of two resource components. The first component is OpenWindows. The second resource component is the name of the particular property being set. For example, the mouse acceleration is controlled by the resource OpenWindows.MouseAcceleration. The OpenWindows toolkits and window manager are designed to respond to the resources manipulated by props. Systems without the OpenWindows toolkits and window manager are not likely to be aware of the OpenWindows resources. Thus, if props is used in a non-OpenWindows environment, the system will probably ignore the settings made via props.

Below is an explaination of the resources handled by props. The second component of each resource name is listed. For example, the name "WorkspaceColor" refers to the complete resource name OpenWindows.WorkspaceColor.

BasicLocale (locale name)
Specifies the basic locale in which the system is running. Permissible locale names are "C" (USA), "ja" (Japan), "ko" (Korea), "zh" (PRC), "zh_TW" (ROC), "de" (Germany), "it" (Italy), "fr" (France), and "sv" (Sweden). Default value: C. This specifies the U.S. locale and the English language.

Beep (enumeration)
Specifies the circumstances under which olwm(1) should beep. Permissible values are the strings "always", "never", and "notices". The string "never" means that olwm should never beep, "notices" means that olwm should beep only when a notice appears, and "always" means that olwm will beep whenever it is appropriate. Default value: always.

BeepDuration (integer)
Specifies how long the keyboard beep should last in milliseconds. Default value: 100.

BoldFont (font name)
Specifies the default bold font used for captions and window titles. Default value: -∗-lucida sans-bold-r-∗-∗-∗-120-∗-∗-∗-∗-∗-∗. This specifies a bold weight, 12-point, regular Lucida Sans font.

DataBackground (color)
Specifies the color for the background of text windows such as those in mailtool, textedit, and the help window. Default value: #ffffff. This specifies white.

DataForeground (color)
Specifies the color for the text in text windows such as those in mailtool, textedit, and the help window. Default value: #000000. This specifies black.

DisplayLang (locale name)
Specifies the locale for the language used when displaying text. See the description of the BasicLocale resource for a list of permissible locale names. Default value: C. This specifies the U.S. locale and the English language.

DragRightDistance (integer)
The number of pixels you must drag the mouse to the right in a menu item to bring up a sub-menu. The sub-menu always comes up when you move over the menu mark (the right-pointing triangle), regardless of the drag-right distance. Default value: 100.

IconLocation (enumeration)
One of the words "top-lr", "top-rl", "bottom-lr", "bottom-rl", "left-tb", "left-bt", "right-tb", or "right-bt". These specify that icons should be arranged along a particular edge of the screen, ordered from left to right or top to bottom as appropriate. The words "top", "bottom", "left", and "right" are synonyms for "top-lr", "bottom-lr", "left-tb", and "right-tb", respectively. These synonyms are used by props. Default value: bottom.

InputLang (locale name)
Specifies the language expected to be typed from the keyboard. See the description of the BasicLocale resource for a list of permissible locale names. Default value: C. This specifies the U.S. locale and the English language.

KeyboardCommands (enumeration)
Permissible values for this resource are "SunView1", "Basic", and "Full". Values are case-sensitive. In Full mode, all OPEN LOOK Mouseless commands implemented by the window manager are active. See the section on Key Binding in the olwm(1) man page for further information. In Basic mode, the keys active are Open, Front, Help, and the colormap keys. In SunView1 mode, the only keys active are Open and Front. Default value: Basic.

KeyClick (boolean)
Specifies whether keys click when pressed. Default value: false.

KeyRepeat (boolean)
Specifies whether repeating keys repeat when held down. Default value: true.

MenuAccelerators (boolean)
Specifies whether menu accelerators are enabled for menus in applications. Default value: true.

MonospaceFont (font name)
Specifies the default monospace font used for text editors and other applications which require a monospace font. Default value: -∗-lucida sans typewriter-medium-r-∗-∗-∗-120-∗-∗-∗-∗-∗-∗. This specifies a medium weight, 12-point, regular Lucida Sans Typewriter font.

MouseAcceleration (integer)
Specifies a multiplier. The mouse pointer will go this many times faster when it moves more than the number of pixels specified by the MouseThreshold resource in a short time. Default value: 2.

MouseThreshold (integer)
Specifies the number of pixels which the mouse must move in a short time for the mouse acceleration to be applied. Default value: 15.

MultiClickTimeout (integer)
The time, in tenths of a second, that differentiates a double-click from two single clicks. Default value: 5.

NumericFormat
Specifies how commas and periods are used in numbers. See the description of the BasicLocale resource for a list of permissible locale names. Default value: C. This specifies the U.S. locale, a numeric format where commas are used to indicate thousands and a period is used to indicate where the fractional part of the number begins. For example, one thousand and a half is "1,000.5".

PaintWorkspace (boolean)
If true, olwm will use the WorkspaceColor resource to set the workspace (root window) background color. If false, olwm will not change the root window background. This is useful If you prefer to set your own workspace color using xsetroot(1) or a similar program. Default value: true.

PointerMapping (enumeration)
Specifies a "left" or "right" handed mapping of the mouse buttons. For a 3-button mouse, "right" means button 1 is SELECT, button 2 is ADJUST, and button 3 is MENU. A value of "left" means button 1 is MENU, button2 is ADJUST, and button 3 is SELECT. For mice with more or less than 3 buttons, the sense of the buttons is reversed as for the 3-button mouse. Default value: right.

PopupJumpCursor (boolean)
Specifies whether to warp the cursor to popup windows. Default value: true.

RegularFont (font name)
Specifies the default font used by the system in general. This font is used for such text as that in buttons and non-bold labels. Default value: -∗-lucida sans-medium-r-∗-∗-∗-120-∗-∗-∗-∗-∗-∗. This specifies a medium weight, 12-point, regular Lucida Sans font.

Scale (enumeration)
Specifies the desktop scale. The scale value indicates the point size of the OPEN LOOK Glyph font and the text fonts used by OpenWindows. Permissible values are "small", "medium", "large", and "extra_large". These correspond to 10, 12, 14, and 19 point fonts, respectively. Default value: medium. This specifies 12 point fonts.

ScreenSaver.IdleTime (integer)
Specifies the number of minutes of idle time required before the screen saver comes on. The ScreenSaver.OnOff resource must be set to "auto" for the screensaver to activate. Default value: 10.

ScreenSaver.OnOff (enumeration)
Specifies whether the screensaver is off or come on automatically. The permissible values are "off" and "auto", respectively. Default value: off.

ScrollbarJumpCursor (boolean)
Specifies whether to warp the cursor to follow the scrollbar elevator. Default value: true.

ScrollbarPlacement (enumeration)
Specifies on which side of windows to place verticle scrollbars. Permissible values are "left" and "right". Default value: right.

SelectDisplaysMenu (boolean)
If true, pressing the SELECT mouse button will bring up a menu item’s sub-menu (if any) instead of executing the sub-menu’s default action. Default value: true.

SetInput (enumeration)
This controls the input focus mode. If the value is "select", it means click-to-focus. If the value is "followmouse", it means focus-follows-mouse. Default value: select.

TimeFormat
Specifies the locale for the date and time format. Date format is mm/dd/yy or dd/mm/yy and the time format is 12- or 24-hour clock. See the description of the BasicLocale resource for a list of permissible locale names. Default value: C. This specifies the U.S. locale which has date format mm/dd/yy and 12-hour clock time format.

WindowColor (color)
Specifies the color of windows. This is the "BG1" color for 3D OPEN LOOK. It is used for the backgrounds of windows, menus, and notices. The 3D effect is achieved by using highlight and shadow colors derived from this color. Default value: #cccccc. This specifies a 20% gray value.

WindowForeground (color)
Specifies the color for foreground components of windows such as captions and text in buttons and footers. Default value: #000000. This specifies black.

WindowMenuAccelerators (boolean)
Specifies whether menu accelerators are enabled for window menus. Default value: true.

WorkspaceBitmapBg (color)
Specifies the color for the background of the workspace bitmap which olwm tiles on the root window if the WorkspaceStyle resource is set to "tilebitmap". Default value: #ffffff. This specifies white.

WorkspaceBitmapFg (color)
Specifies the color for the foreground of the workspace bitmap which olwm tiles on the root window if the WorkspaceStyle resource is set to "tilebitmap". Default value: #000000. This specifies black.

WorkspaceBitmapFile (filename or filepath)
Specifies the bitmap file from which olwm obtains the bitmap to tile on the workspace (root window). If a filename is specified, olwm looks for that file in $OPENWINHOME/etc/workspace/patterns.

WorkspaceColor (color)
Specifies the color for the workspace (root window). On startup, olwm will set the root window’s background color to the color specified by this resource if the WorkspaceStyle resource is set to "paintcolor", and it will restore the default background on shutdown. To turn off this behavior, see the description of the PaintWorkspace resource. Default value: #40a0c0. This specifies a light blue color.

WorkspaceStyle (enumeration)
Specifies how olwm decorates the workspace (root window) when the PaintWorkspace resource is set to true. Permissible values are "paintcolor" and "tilebitmap". If the value is "paintcolor", olwm paints the workspace with the color indicated by the WorkspaceColor resource. If the value is "tilebitmap", olwm tiles the bitmap indicated by the WorkspaceBitmapFile resource using the colors specified by the WorkspaceBitmapFg and WorkspaceBitmapBg resources. Default value: paintcolor.

OPTIONS

The props program accepts all standard command line options accepted by the OLIT toolkit. In addition, it accepts the following.

−init This is the way props is started by xinit upon window system initialization. This is done to ensure the state of the following window server attributes are set in accordance with the resources in the .OWdefaults file in the user’s home directory: key click, key repeat, beep duration, screen saver activation and timeout. When props is started with this option, it checks and resets the server state for these settings if necessary and exits. This option is only meant to be used upon system startup.

FILES

$HOME/.OWdefaults
Contains the resource name-value pairs written by the props program.

$HOME/.openwin-menu-programs
Contains the user’s custom programs menu.

$HOME/.openwin-menu-programs.BAK
Contains a backup version of $HOME/.openwin-menu-programs.

$HOME/.Xdefaults Contains the user’s resource name-value pairs as set outside of props.

$OPENWINHOME/lib/Xdefaults
Contains the system’s default resource name-value pairs.

$OPENWINHOME/lib/app-defaults/Props
Contains strings and layout information for props.

$OPENWINHOME/lib/help/props.info
Contains help text for props.

$OPENWINHOME/lib/openwin-sys
Starts props in initialization mode upon window system startup.

$OPENWINHOME/bin/props
The executable props program.

$OPENWINHOME/etc/workspace/patterns/∗.xbm
Workspace bitmap files.

$OPENWINHOME/etc/workspace/patterns/attributes
Workspace bitmap colors.

/tmp/OWtemp Temporary resource storage file.

Museum