4 X Resources

Contents of this section

4.1 General Application Resources

The following application resources are available in rTc, most have command line equivilents.

userFile (Type String)

The users description file, the default is set during compilation as SITE_USERS_FILE, but as distributed this is .rtcrc.

systemFile (Type String)

The second source of menu descriptions, this file is read first, then the userFile. The default is controlled by SITE_SYSTEM_FILE during compiling, but as distributed this is /usr/local/lib/rtc/system.rtcrc.

This resource is only used if WANT_SYSTEM_FILE is set during compiling.

maximumSize (Type Boolean)

Setting this to True (the default) makes rTc resize so that it fills the whole width of the screen.

reminderFile (Type String)

The file to use for saving reminders, this must be writable by the user running rTc. The default is set during building, but as distributed .rtc-reminders is used.

This resource is only used if WANT_CLOCK is set during compilation.

singleScreen (Type Boolean)

If False (the default) rTc will run a copy of itself on every available screen. This is only usefull if you have a multi-screened display (ie. me).

Multi-screen support is only added if WANT_MULTI_SCREEN is set during compilation.

userType (Type String)

Either Beginner or Expert, this is used to simplify the user interface in the panels (if set to beginner). If set to beginner, it overrides the setting of msgLevel setting it to Error. The default is Beginner.

msgStyle (Type String)

One of StatusArea, Dialogs or Console; this changes the method by which messages are presented to the user. If StatusArea (the default), a small-single-line (scrollable) status area is added below the menu-bar, for Dialogs each message is shown in its own dialog, and Console send the message to stdout.

msgLevel (Type String)

One of Errors, Warnings, Information or Diagnostics (with each increasing the number of messages generated).

helpFilePath (Type String)

A colon separated list of directories to search for a help file. Each directory must include the trailing `/". The default is specified during compilarion and will be site specific.

This is only used if WANT_HELP is set during building.

iconFilePath (Type String)

A colon separated list of directories to search for any icon file. Each directory must include the trailing "/". The default is specified during compilation and will be site specific.

messageBeep (Type Boolean)

If True (default False) then rTc will generate a beep everytime a message is output.

messageBeepVolume (Type int)

The volume for the beep used when messages are output, default 50.

messageBeepDuration (Type int)

The duration of the message beep (in milliseconds) default 25).

executeBeep (Type Boolean)

If True (default False) then rTc will generate a beep everytime a command is executed.

executeBeepVolume (Type int)

The volume for the beep used when commands are executed, default 20.

executeBeepDuration (Type int)

The duration of the message beep (in milliseconds) default 10).

Note: Both helpFilePath and iconFilePath have a common behaviour; each will only use the first match it finds.

4.2 Advanced X-Resources

Fonts

To maintain a common look through the whole program, the fonts used have been grouped under the following charsets:-

menu-buttons

All buttons in the menus.

message

general purpose dialog messages.

option-info

used for the copyright and configuration dialogs.

panel-button

used for the buttons at the bottom of the panel (Execute, Done, Default).

panel-prompt

used for each prompt in a panel.

Next Chapter, Previous Chapter

Table of contents of this chapter, General table of contents

Top of the document, Beginning of this Chapter