Provided by: alicq_0.8.9-1_all bug

NAME

            alicqrc - Alicq configuration file

DESCRIPTION

       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:

        basedir/modules
              where  basedir       is  a directory where current configuration
              file is read from.

        workingdir/modules
              where workingdir is a directory where alicq  run  file  is  read
              from.

        workingdir/../share/alicq/modules
              where  workingdir  is  a  directory where alicq run file is read
              from.

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.

SEE ALSO

       alicq(1)

       Alicq home page (http://alicq.sourceforge.net/)

AUTHORS

       Alicq was written by Ihar Viarheichyk <iverg@mail.ru>.

       This    manual    page    was    written    by    Dmitry     Borodaenko
       <angdraug@debian.org>,  based  on Alicq README and slightly reworked by
       Vitus Wagner <vitus@ice.ru> and Ihar Viarheichyk <iverg@mail.ru>.

       This is free documentation; you can redistribute it  and/or  modify  it
       under  the  terms of the GNU General Public License as published by the
       Free Software Foundation; either version 2 of the License, or (at  your
       option) any later version.

                                  April 2004                        alicqrc(5)