alicqrc5

Overview

alicq condfiguration file is used to customize alicq during startup. Any configuration file can be specified with -config option when running alicq. If -config option is not given, default configuration file is searched depending on current platgorm:

Unix

~/.alicq/alicqrc

primary configuration

~/.alicqrc

for backward compatibility

Windows

%USERPROFILE/alicq/alicq.cfg

/alicq/alicq.cfg

where workingdir is a folder with alicq run file.

File format

Alicq startup file is just a Tcl script, which is sourced by main program. It looks like configuration file, but it is possible to use any Tcl command in it. For example, if you want to keep ICQ password in other file, you may write something like:

	source ~/.alicq/password

where ~/.alicq/password contains string

icq password mypassword

or

icq password [eval_password_by_any_way]

Common startup file usually contains following entities:

calls of module loading commands

calls of module configuration commands

resources specifications

arbitrary Tcl code user wants to evaluate in Alicq interpreter on startup

Module loading command has following syntax: module module-name

	module tree

Alicq looks for modules through a list of catalogues:

Module configuration commands

Each module can have number of configurable parameters. These parameters can be specified in configuration file using following syntax:

module-name configurable-parameter value

	icq uin 47298730
	icq roster use 1
	tree hide empty no
	tree hide offline yes

List of supported configurable parameters can be retrieved with command

alicq-info [ module-name ]

Files

$HOME/.alicq/alicqrc

Default startup file for Unix version of Alicq.

$HOME/.alicqrc

Startup file of older versions of Alicq. Used for backward compatibility.