VLAB Customization

Quick contents

There are two different ways a VLAB user can customize functionality and appearance of VLAB applications. Through environment variables and through configuration files. Further, there are two different sets of configuration files associated with VLAB:

Environment Variables

 
$EDITOR
Used in browser and hyperbrowser with File->Open file menu. If $WINEDITOR is unspecified, then the program specified in $EDITOR is invoked as: winterm -t '$EDITOR %s' -e $EDITOR %s , where %s denotes the selected file.
$VLABBIN
Specifies where VLAB associated binaries are located.
$VLABBROWSERBIN
Specifies which command to execute when File->New browser is invoked from either browser or hyperbrowser.
$VLABCONFIGDIR
Directory where VLAB configuration files are.
$VLABDAEMONBIN
Specifies where the VLAB daemon is.
$VLABDOCDIR
Directory with VLAB documentation.
$VLABHBROWSERBIN
Specifies which command to execute when File->New hbrowser is invoked from either browser or hyperbrowser.
$VLABOBJECTBIN
Specifies the binary of VLAB object.
$VLABROOT
Specifies the oofs default location for browser and hyperbrowser.
$VLABTMPDIR
Specifies where VLAB stores its temporary files (e.g. for drag/drop).
$WINEDITOR
Used in browser and hyperbrowser with File->Open file menu. The command invoked is: $WINEDITOR %s where %s denotes the selected file.
$WINTERM
Used in metatext to bring up a shell when the Modify button is invoked.
Used in browser and hyperbrowser when File->Open shell is invoked.

app-defaults Configuration Files

The files in the app-defaults directory are the standard application default files associated with programs written using Xt/Xm libraries. When VLAB is first installed, there are by default 7 files in this directory: Browser, GetLogin, HBrowser, MetaText, Object, Panels and XLess. After you modify any of these files, you will have to restart the application in order for the changes to take effect. Please refer to the Xt and Motif documentation to find out how to modify these files. It is also possible to use the editres utility to find a complete widget hierarchy of each VLAB application. Please note that the app-defaults directory has to be properly inserted into your $XUSERFILESEARCHPATH environment variable in order for Xt/Xm to find these files (this is done by the config.[c]sh script).

config Configuration Files

There are 5 files in the config directory.

browser

This file contains the appearance settings you set through browser's customization dialog. For example, the file could contain the following entries:
 

Customization file for Browser 3.0
FontName -adobe-helvetica-bold-r-normal--17-120-100-100-p-92-iso8859-1
IconSize 41
BackgroundColor 17 17 17
LineColor 255 247 59
SelectionColor 158 97 178
TextColor 255 248 251
BoxBorderColor 0 164 0
BoxInsideColor 0 63 0
LinkColor 0 255 255
Compacting True
Dither False
LinesType Comb
ParentPosition Centered
ZoomType Customized
BoxHeight 15
BoxWidth 20
HorizontalDistance 30
BoxTextDistance 3
TextLineDistance 1
VerticalDistance 1
TextIconDistance 3
End

The format of the file should be obvious from the example.

hbrowser

This file contains the appearance settings you set through hyper-browser's customization dialog, with the same format as above.

metatext

This file contains two lines:
 

Editor jot
Viewer xless -auto

The first line specifies which program to invoke when the user decides to edit the metatext frame; in this case the program is jot. The second line specifies which program to invoke to look at textual descriptions of a metatext frame; in this case the program is xless with an argument -auto.

object

This file is also commonly referred to as the tools file. It defines generic tools that may be used within an object's specifications file. It is described in detail on Object Manager's page.

rapasswords

The rapasswords file stores the following information about each user: login name, encrypted password, and file access level. This information is stored one line per account, where the fields are separated by colons. For example, the account file with three accounts could contain:

    peter:qwZ9JWBYMpS/M:n:
    dan:qwDq11qMqxuw2:y:
    guest:qwGiniA4POTqY:n:
 
 


Last updated July 17th, 1999 by Pavol Federl