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:
$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. |
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).
There are 5 files in the config directory.
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.
This file contains the appearance settings you set through hyper-browser's customization dialog, with the same format as above.
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.
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.
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: