rcirc: Configuration
2.3 Configuration
=================
These are some variables you can change to configure ‘rcirc’ to your
liking.
‘rcirc-server-alist’
This variable contains an alist of servers to connect to by default
and the keywords parameters to use. The keyword parameters are
optional. If you don’t provide any, the defaults as documented
below will be used.
The most important parameter is the ‘:channels’ parameter. It
controls which channels you will join by default as soon as you are
connected to the server.
Here’s an example of how to set it:
(add-to-list 'rcirc-server-alist
'("otherworlders.org"
:channels ("#FUDGE" "#game-design")))
By default you will be connected to the ‘rcirc’ support channel:
‘#rcirc’ on ‘irc.freenode.net’.
‘:nick’
This overrides ‘rcirc-default-nick’.
‘:port’
This overrides ‘rcirc-default-port’.
‘:user-name’
This overrides ‘rcirc-default-user-name’.
‘:full-name’
This overrides ‘rcirc-default-full-name’.
‘:channels’
This describes which channels to join when connecting to the
server. If absent, no channels will be connected to
automatically.
‘rcirc-default-nick’
This variable is used for the default nick. It defaults to the
login name returned by ‘user-login-name’.
(setq rcirc-default-nick "kensanata")
‘rcirc-default-port’
This variable contains the default port to connect to. It is 6667
by default and rarely needs changing.
‘rcirc-default-user-name’
This variable contains the default user name to report to the
server. It defaults to the login name returned by
‘user-login-name’, just like ‘rcirc-default-nick’.
‘rcirc-default-full-name’
This variable is used to set your “real name” on IRC. It defaults
to the name returned by ‘user-full-name’. If you want to hide your
full name, you might want to set it to some pseudonym.
(setq rcirc-default-full-name "Curious Minds Want To Know")
‘rcirc-authinfo’
This variable is an alist used to automatically identify yourself
on networks. Each sublist starts with a regular expression that is
compared to the server address you’re connecting to. The second
element in the list is a symbol representing the method to use,
followed by the arguments this method requires.
Here is an example to illustrate how you would set it:
(setq rcirc-authinfo
'(("freenode" nickserv "bob" "p455w0rd")
("freenode" chanserv "bob" "#bobland" "passwd99")
("bitlbee" bitlbee "robert" "sekrit")))
And here are the valid method symbols and the arguments they
require:
‘nickserv’
Use this symbol if you need to identify yourself as follows
when connecting to a network: ‘/msg nickserv identify secret’.
The necessary arguments are the nickname you want to use this
for, and the password to use.
Before you can use this method, you will have to register your
nick and pick a password for it. Contact ‘nickserv’ and check
out the details. (Using ‘/msg nickserv help’, for example.)
‘chanserv’
Use this symbol if you need to identify yourself as follows if
you want to join a particular channel: ‘/msg chanserv identify
#underground secret’. The necessary arguments are the
nickname and channel you want to use this for, and the
password to use.
Before you can use this method, a channel contact must tell
you about the password to use. Contact ‘chanserv’ and check
out the details. (Using ‘/msg chanserv help’, for example.)
‘bitlbee’
Use this symbol if you need to identify yourself in the
Bitlbee channel as follows: ‘identify secret’. The necessary
arguments are the nickname you want to use this for, and the
password to use.
Bitlbee acts like an IRC server, but in fact it is a gateway
to a lot of other instant messaging services. You can either
install Bitlbee locally or use a public Bitlbee server.
There, you need to create an account with a password. This is
the nick and password you need to provide for the bitlbee
authentication method.
Later, you will tell Bitlbee about your accounts and passwords
on all the other instant messaging services, and Bitlbee will
log you in. All ‘rcirc’ needs to know, is the login to your
Bitlbee account. Don’t confuse the Bitlbee account with all
the other accounts.