Appendix L Environment Variables

Here is a table of all environment variables which are used by Gcal:

GCAL

GCAL_OPT

Flags which are passed to the Gcal program automatically.

GCAL_COLUMNS

COLUMNS

Sets the number of columns on the screen. Takes precedence over the number of columns specified by the TERM environment variable or the system itself.

GCAL_DATE_FORMAT

Contains the date format text which defines the ordering of a displayed date. Takes precedence over the default date format text.

GCAL_LINES

LINES

Sets the number of lines on the screen. Takes precedence over the number of lines specified by the TERM environment variable or the system itself.

GCAL_SYS_DATADIR

Name of a file directory absolute to the root/$prefix file directory, where the system-administrator stores common, public access resource files (dates files).

GCAL_USR_DATADIR

Name of a file directory relative to the HOME file directory, where the user stores personal, respectively private access resource files (dates files). Takes precedence over GCAL_SYS_DATADIR.

GCALANSI

If defined or set, ANSI escape highlighting sequences are used respectively substituted by default if no other highlighting sequences are defined by command line option or found in the Termcap library.

GCALPATH

(‘:’) colon-separated list of file directories which are searched to find the .gcalrc file. Takes precedence over HOME, GCAL_USR_DATADIR and GCAL_SYS_DATADIR.

GCALPROG

Contains the file name of the executable Gcal program that is used by the Tcal program to call the Gcal program. Takes precedence over the file name gcal which is burned-in during the compilation step of the Tcal program. The GCALPROG environment variable must always be set if the Gcal program is installed under another name than the standard name gcal, otherwise Tcal is unable to execute the Gcal program automatically!

HOME

Name of the user’s home file directory. This is used to find the .gcalrc file. Takes precedence over GCAL_USR_DATADIR and GCAL_SYS_DATADIR.

LANGUAGE

The national language and other cultural-specific conventions used by Gcal at run-time. Takes precedence over LC_ALL, LC_MESSAGES and LANG.

LC_ALL

The national language and other cultural-specific conventions used by Gcal at run-time. Takes precedence over LC_MESSAGES and LANG.

LC_MESSAGES

The national language and other cultural-specific conventions used by Gcal at run-time. Takes precedence over LANG.

LANG

The national language and other cultural-specific conventions used by Gcal at run-time.

LOGNAME

The eMail address which is used if the mailing option is wanted. See Global option --mail[=address], for more details.

MAILPROG

Name of the mailer program which is used if the mailing option is wanted. Takes precedence over the file name mail which is burned-in during the compilation step of the Gcal program. See Global option --mail[=address], for more details.

MAILTO

The eMail address which is used if the mailing option is wanted. Takes precedence over USER and LOGNAME. See Global option --mail[=address], for more details.

PAGER

Name of the external pager program which is used if the paging option is wanted. See Global option --pager, for more details.

PATH

(‘:’) colon-separated list of file directories which are searched to find the external pager program. See Global option --pager, for more details.

TERM

The type of terminal on which the Gcal program is being run.

TXT2GCALPROG

Contains the file name of the executable Txt2gcal program that is used by the Gcal program to call the Txt2gcal program. Takes precedence over the file name txt2gcal which is burned-in during the compilation step of the Gcal program. The TXT2GCALPROG environment variable must always be set if the Txt2gcal program is installed under another name than the standard name txt2gcal, otherwise Gcal is unable to execute the Txt2gcal program automatically! See Text variables, for further details.

TZ

The timezone information which is added to the date text of sent eMails, created response files and created shell script files.

USER

The eMail address which is used if the mailing option is wanted. Takes precedence over LOGNAME. See Global option --mail[=address], for more details.