-
Notifications
You must be signed in to change notification settings - Fork 51
Commands
A line starting with a slash (/) is a command to Circe, and not
sent as a message to the server. The word immediately following the
slash is called the command word, or command for short. Following is a
description of all the commands Circe knows so far.
Say text to the current target. This is useful to prevent a
misinterpretation of a slash at the beginning of a line.
Tell the current channel that you are doing action. This is
usually displayed to others as follows (where padawan is your
nick):
/me smiles at the people in the channel.
- padawan smiles at the people in the channel.
This command can be confusing, as correct sentences using it require thinking of yourself in the third person. It is not uncommon among IRCers to talk about themselves as "me", either.
A different kind of command, this is called using M-x circe-reconnect. It reconnects the current IRC session, for example
when your network connection died.
Join channel, optionally supplying a key. Some channels have a
keyword set so that only those in the know can join it. This is rare,
though.
Leave the current channel. You can give a reason, too.
Get a list of people on the current channel, or possibly on channel.
This can also be invoked with C-c C-n.
This command retrieves or sets the topic of the current channel. The topic is a (more or less) long line of text, usually announcing important URLs or events. It's often a good idea to read it. Many channels disallow changing the topic unless you have special privileges.
Replace the current input line with a command to set the topic as it
is at the moment. This is useful if you want to change the topic
slightly. It is bound to C-c C-t by default.
As has been said before, the IRC server are connected as a tree. This
means that when two IRC servers lose the connection, there remain two
disconnected parts of the tree. This is called a netsplit. When the
servers connect again, it's called a netmerge. So far, so bad, but
the typical netsplit will cause about half the channel to apparently
quit IRC (they will see you, and all that stay on your ``side'' of the
split, quit as well). Shortly thereafter, the net merges, and all the
people who just quitted will rejoin the channel automatically. This
causes an annoying amount of text which disturbs channel talks.
When Circe detects a netsplit, she does not report every person
leaving, but instead records that they split away. When the net merges
again, she notes that as well. All you will see about this is a notice
that the net is splitting or merging. The command WL, for Who Left,
will tell you which users left the channel due to the split, and are
still missing.
Send nick a message containing text. This is equivalent to opening
(or switching to) a query buffer for this person, and typing text at
the prompt.
Open a query buffer for user nick.
This command sets you away, which means you're not available for
talking at the moment. The reason is told to everyone who sends
messages to you, or checks your whois information.
The GAWAY variant does the same, but on all servers you are
connected to.
This command removes any away status. It is equivalent to AWAY
without any arguments.
A completely useless command which makes you leave IRC. Since this is
such a completely incomprehensible thing to do, it is very useful to
give a reason why you did that.
GQUIT does the same, but on all servers you are on.
Idiots exist everywhere. IRC is everywhere. Consequently, idiots exist on IRC. When someone annoys you too much, the best thing to do is to ignore them. This can be done mentally, but Circe can help you a bit. When a user matches the pattern you pass to this command, messages from that user are never displayed. Nor are messages displayed which start out with a word matching such a pattern followed by a colon, comma or space.
Without the pattern, this command lists your current ignore list. You
can store permanent regular expressions in it by modifying the
circe-ignore-list variable in your ~/.emacs.
When you're in the mood to be annoyed again, you can remove a pattern from your ignore list again.
The net being what it is, it is possible that sometimes a connection is very slow. How fast someone is receiving your messages can be tested with this message.
The WHOIS returns some information about another user. Just try
it. WHOWAS is very similar, but works on nicks that are not on
IRC anymore, though it returns less information.
When you don't see your own nick in messages you send, it is sometimes
quite nice to be remembered who you are again. This command does a
WHOIS on yourself.
CTCP is the Client-To-Client Protocol used on IRC. If you want to test
it, try to send yourself a CTCP message. Possible commands are
VERSION and TIME, both of which don't take any arguments.
Sometimes it is desirable for some people to send IRC commands
themselves. The QUOTE command just takes its argument and passes
it unmodified to the IRC server.
This command tells the current target the version of Circe and Emacs you are using. Besides being useful in bragging contests, this also helps in debugging problems.