.I port
]
[
+.B -P
+.I server password
+]
+[
.B -r
.I realname
]
.I nick
]
[
+.B -T
+] [
.I server
]
.SH DESCRIPTION
.I Ircrc
is an IRC client.
-Messages are sent from stdin and received from stdout.
+Messages are sent from standard input and
+received from standard output.
The default server is
.BR irc.freenode.net .
+The arguments
+.B bitlbee
+and
+.B oftc
+are expanded to
+.B im.bitlbee.org
+and
+.BR irc.oftc.net ,
+respectively.
The options are:
.TP
.BI -p " port
Change the default port
.RB ( 6667 ).
.TP
+.BI -P " server password
+Specify a password for the remote server.
+.TP
.BI -r " realname
Change the default name
.RB ( <nil> ).
.TP
.BI -t " target
-Set the target channel.
+Set and join the target channel.
+If multiple channels are specified,
+only the last one will be set as
+.IR target .
+Messages are sent to
+.I target
+unless they are commands.
.TP
.BI -n " nick
Change the default nickname
.RB ( $user ).
+.TP
+.BI -T
+.br
+Use tls through
+.IR tlssrv (8).
.SS Commands
.I Ircrc
-understands the following commands:
+commands begin with a slash.
+Unrecognized commands result in an error message
+and send nothing to the server.
+The commands are:
.TP
.BI /! " cmd
Send the output of the shell command
to the server.
.TP
.BI /t " target
-Set the current target.
-Messages are sent to
+Set
+.IR target .
+If
.I target
-unless they are commands.
+is more than one channel,
+any messages are sent to all of them.
.TP
.B /u
.B USERS
.B /x
.B QUIT
command.
+Control-D also sends this command.
.PP
-Anything else is sent as a message to the current target.
See RFC 1459 and RFC 2812 for detailed information about
IRC commands.
.SH EXAMPLES
.EX
% ircrc -r glenda -n glenda irc.oftc.net
.EE
+.PP
+Join two channels on login:
+.IP
+.EX
+% ircrc -t '#cat-v,#plan9'
+.EE
.SH SOURCE
.B /rc/bin/ircrc
.SH SEE ALSO
.br
.B http://tools.ietf.org/html/rfc2812
.SH BUGS
-.I Ircrc
-cannot join channels upon login (the
-.B -t
-flag only sets the target, it doesn't join the channel).
-.PP
-.I Ircrc
-does not filter out the
-.B ^B
-character that is sent by nickserv when asking for
-identification.
.PP
Some fonts do not support the nickname delimiters.
.PP
-.I Ircrc
-does not output messages received from the server when
-.B /net/tcp/[0-9]/status
-does not match the regular expression
-.BR /^Established.*/ .
+If the connection is lost,
+.I ircrc
+waits for input before exiting.