Previous Next Contents

3. Configuration files

The program will search for its configuration files in the following directories (in order) :

  1. ~/.gnirc
  2. /usr/lib/gnirc
  3. /usr/local/lib/gnirc

Gnirc uses several configuration files :

3.1 "ircrc"

This file holds some program commands that'll be executed at startup( mainly alias & set). Example :

# ircrc file
alias j join $0
alias l leave
alias w whois $0
alias p ctcp $0 PING
set show_toolbar 0
set show_user_list 0
set window_width  700
set window_height 350

3.2 "ircrcx" ( gtk configuration file)

Gtk applications uses a special file to customize their visual appearence ( intead of the well known  /.Xresources).

3.3 "menus"

This contains the definition of the menus and toolbars.

Toolbars

Syntax :

begin_toolbar <toolbar id>
       # Definition of the first button
       <item1 label> <item1 command> <item1 icon> <item1 help>
       ....
       # Definition of the last button (Nth button)
       <itemN label> <itemN command> <itemN icon> <itemN help>
end_toolbar
<toolbar id>

The toolbar identifier. It must be unique among toolbars. ( it's not used in this release which accept only one toolbar)

<item label>

The string displayed in the button or "" for none

<item icon>

The path to the button's pixmap. This can be an absolute path ( eg: /usr/share/icons/test.xpm) or a path relative to gnirc's default pixmap path : program_pixmaps_path ( eg : test.xpm).

<item help>

Tool tips displayed when the mouse "enter" the button.

Example :

# menus file
begin_toolbar personnal_toolbar
        # first button
        ""     
                popup_window       
                "cyan_up.xpm" 
                "Popup a new window for this channel"
        
        # second button
        ""     
                popdown_window       
                "cyan_down.xpm" 
                "Popdown this channel into the default window"
                
        ""  
                leave   
                "door_run.xpm" 
                "Close the current channel"
end_toolbar

Menus

Undocumented

3.4 "servers"

Undocumented


Previous Next Contents