plan9.ini(8) iwlwifi essid/bssid misleading

[plan9front.git] / sys / man / 1 / ircrc

diff --git a/sys/man/1/ircrc b/sys/man/1/ircrc
index be7f4fa0ecd4b030110af69dd801e59bec74c246..eaa8763d7d70e4e31ce12393ef716893fb8772a2 100644 (file)
--- a/sys/man/1/ircrc
+++ b/sys/man/1/ircrc
@@ -8,6 +8,10 @@ ircrc \- internet relay chat client
 .I port
 ]
 [
+.B -P
+.I server password
+]
+[
 .B -r
 .I realname
 ]
@@ -20,33 +24,62 @@ ircrc \- internet relay chat client
 .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
@@ -99,10 +132,12 @@ Send the raw IRC 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
@@ -115,8 +150,8 @@ command.
 .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
@@ -133,6 +168,12 @@ as a different user:
 .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
@@ -140,23 +181,9 @@ as a different user:
 .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.*/ .
-This occurs when using
-.I ircrc.
+If the connection is lost,
+.I ircrc
+waits for input before exiting.