The program will search for its configuration files in the following directories (in order) :
~/.gnirc
/usr/lib/gnirc
/usr/local/lib/gnirc
Gnirc uses several configuration files :
"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
"ircrcx"
( gtk configuration file)
Gtk applications uses a special file to customize their visual appearence ( intead of the well known  /.Xresources).
"menus"
This contains the definition of the menus and 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
The toolbar identifier. It must be unique among toolbars. ( it's not used in this release which accept only one toolbar)
The string displayed in the button or "" for none
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
).
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
Undocumented
"servers"
Undocumented