secstore(1): add DIAGNOSTICS section

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

diff --git a/sys/man/1/ircrc b/sys/man/1/ircrc
index 828a8f0c1b89587066010ee8495fe6ffc8697d97..5b2e8554a239e37f4757b428732c1a3cc315fec3 100644 (file)
--- a/sys/man/1/ircrc
+++ b/sys/man/1/ircrc
@@ -20,20 +20,22 @@ 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 .
-.I Ircrc
-expands
+The arguments
 .B bitlbee
 and
 .B oftc
-to
+are expanded to
 .B im.bitlbee.org
 and
 .BR irc.oftc.net ,
@@ -49,15 +51,28 @@ Change the default name
 .RB ( <nil> ).
 .TP
 .BI -t " target
-Set and join the target channel
-(multiple channels may be separated by commas).
+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
@@ -110,11 +125,11 @@ 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.
-If the current target is more than one channel,
+is more than one channel,
 any messages are sent to all of them.
 .TP
 .B /u
@@ -128,8 +143,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
@@ -147,9 +162,7 @@ as a different user:
 % ircrc -r glenda -n glenda irc.oftc.net
 .EE
 .PP
-Join two channels on login
-(remember to set the target to a single channel,
-otherwise messages are sent to both):
+Join two channels on login:
 .IP
 .EX
 % ircrc -t '#cat-v,#plan9'
@@ -162,12 +175,8 @@ otherwise messages are sent to both):
 .B http://tools.ietf.org/html/rfc2812
 .SH BUGS
 .PP
-.I Ircrc
-calls the inexistent
-.IR auth/userpasswd .
-.PP
-Some of
-.BR irc.freenode.net 's
-welcome messages contain control characters.
-.PP
 Some fonts do not support the nickname delimiters.
+.PP
+If the connection is lost,
+.I ircrc
+waits for input before exiting.