updated

git-svn-id: http://svn.irssi.org/repos/irssi/trunk@600 dbcabf3a-b0e7-0310-adc4-f8d773084564

docs/help/in/ban.in

@@ -2,6 +2,13 @@
 @SYNTAX:ban@
 
 Bans the specified nick or userhost mask.
+If nick is given as parameter, the current
+BANTYPE affects the ban mask.
+
+Example:
+    /BAN looser    - This bans the nick 'looser'
+    /BAN *!*@*.org - This bans all the users coming from any 
+                     .org domain.
 
 See also: BANTYPE, KNOCKOUT
 

docs/help/in/connect.in

@@ -5,7 +5,7 @@
    -host    the host
 
 This command makes irssi to connect to specified server.
-Current connections are kept and another one is created.
+Current connections are kept and a new one is created.
 
 See also: SERVER
 

docs/help/in/cycle.in

@@ -1,7 +1,8 @@
 
 @SYNTAX:cycle@
 
-Cycles (leaves and joins) the current channel or the specified channel.
+Cycles (leaves and joins) the current channel or the specified 
+channel.
 
 See also: JOIN, LEAVE, PART
 

docs/help/in/dcc.in

@@ -5,16 +5,20 @@ This is a command to handle different DCC-connections. DCC is mainly
 used for more reliable and faster chatting and for sending and receiving 
 files.
 
-/DCC CHAT nick
+/DCC LIST
+    - Shows all the open DCC connections.
+/DCC RESUME <nick> [<file>]
+    - Resumes a DCC SEND/GET connection.
+/DCC CHAT <nick>
     - Sends a chat connection request to remote client or accepts 
-      a chat connection, if the remote end has already sent a request.
+      a chat connection if the remote end has already sent a request.
-/DCC GET nick
+/DCC GET <nick> [<file>]
     - Gets the file offered by remote client. The file is downloaded and
       saved into the current working directory.
-/DCC SEND nick file
+/DCC SEND <nick> <file>
     - Sends a DCC SEND request to remote client. Remote end has to accept
       the request before the transmission can be started.
-/DCC CLOSE type nick
+/DCC CLOSE <type> <nick> [<file>]
     - Closes a DCC-connection. Type can be either SEND, GET or CHAT.
 
 See also: CD

docs/help/in/disconnect.in

@@ -2,6 +2,8 @@
 @SYNTAX:disconnect@
 
 Disconnects from the specified IRC-server.
+The server tags can be seen with:
+/SERVER LIST
 
 See also: CONNECT, SERVER
 

docs/help/in/invite.in

@@ -1,7 +1,10 @@
  
 @SYNTAX:invite@
 
-Invites the specified nick to the current channel.
+Invites the specified nick to the current or specified channel.
 
-See also:
+Example:
+   /INVITE buddy #mychannel
+
+See also: MODE
 

docs/help/in/ison.in

@@ -3,5 +3,5 @@
 
 Tells whether specified nicks are online.
 
-See also:
+See also: WHOIS, WHOWAS, NOTIFY
 

docs/help/in/lusers.in

@@ -3,5 +3,3 @@
 
 Shows user statistics of the current IRC network.
 
-See also:
-

docs/help/in/mode.in

@@ -1,24 +1,51 @@
 
 @SYNTAX:mode@
 
-Changes and/or views modes. You can either change
+Both channels and users have modes associated with them. For channels, 
-your own modes or channel modes (given that you're
+they determine who is a channel operator, the number of people who may
-a channel operator).
+join the channel, who may not enter the channel, and myriad other things. 
+For users, they determine whether the user is an IRC operator, whether 
+the user will receive special server notices, etc. 
 
-Examples:
+Modes are enabled when prepended with a "+", and disabled when with a "-". 
 
-/MODE * +s    
+Standard User Modes: 
-   - Makes the current channel secret
+     i    When enabled, you are "invisible" to NAMES and WHO queries from 
+          anyone not on a channel common to you. Additionally, you are also 
+          hidden from WHOIS unless you exact nickname is specified. 
+     o    When enabled, this gives you IRC operator status.
+     s    When enabled, you will receive special server notices.
+     w    When enabled, you will receive IRC operator WALLOPS, as well as 
+          notices of any remote CONNECTs or SQUITs. 
 
-/MODE #irssi -o Beel0  
+Standard Channel Modes: 
-   - Deops user Beel0 on channel #irssi
+     b    When enabled, this prevents the specified nick!user@host mask from 
+          entering the channel. 
+     i    When enabled, users may only join the channel if INVITEd. 
+     k    When enabled, users may only join the channel if they specify the 
+          proper "key".
+     l    When enabled, only the specified number of users may enter the channel. 
+     m    When enabled, only users with +o or +v may speak on the channel. 
+     n    When enabled, public messages from outside the channel are not allowed. 
+     o    When enabled, grants the specified nickname channel operator status. 
+     p    When enabled, the channel is made private. The channel name will not show 
+          up in WHO, WHOIS, NAMES, or LIST replies.
+     s    When enabled, makes the channel secret. This is the same as +p, except 
+          the channel will not show up in any WHO/WHOIS /etc. queries from a 
+          person not on the channel. Anyone who is on a +s channel is effectively 
+          invisible, as per user mode +i. 
+     t    When enabled, only channnel operators may set a topic. 
+     v    When enabled, grants the specified nickname voice status. 
 
-/MODE * +b *!*@*.org
+Examples: 
-   - Bans on the current channel all users coming 
+   /MODE your_nick +sw    - Receive operator WALLOPS and server notices 
-     from .org hosts.
+   /MODE your_nick +s+w     (both examples are equivalent). 
+   /MODE #channel +l 35   - Set a channel limit
+   /MODE #channel +o theirnick 
+                          - Make theirnick a channel operator.
+   /MODE #channel +bk-o *!*some@*.ban.com Secret_Key foobar 
+                          - Set a ban, a key, and remove chanop status 
+                            from 'foobar'. 
 
-/MODE yournick +w
+See also: BAN, VOICE, OP, DEOP, INVITE
-   - Makes you to see the wallops.
-
-See also: BAN, VOICE, OP, DEOP
 

docs/help/in/perlflush.in

@@ -1,7 +1,8 @@
 
 @SYNTAX:perlflush@
 
-Stops and removes all Perl-scripts which have been run.
+Stops and removes all Perl scripts which have been run.
+Also undefines all the commands defined by Perl scripts.
 
 See also: RUN
 

docs/help/in/quote.in

@@ -3,3 +3,6 @@
 
 Sends server raw data without parsing.
 
+Example:
+   /QUOTE PRIVMSG cras :Hey, this works!
+

docs/help/in/reconnect.in

@@ -6,5 +6,5 @@ You can reconnect to server with /RECONNECT <n>.
 /RECONNECT without any arguments will disconnect from the 
 active server and reconnect back immediately.
 
-See also: SERVER, DISCONNECT
+See also: SERVER, DISCONNECT, RMRECONNS
 

docs/help/in/set.in

@@ -14,5 +14,10 @@ when /TOGGLE behaves exactly like /SET.
 
 Remember that changes are not saved until you use /SAVE!
 
+Examples:
+   /SET autolog OFF    - Sets value for setting 'autolog'
+   /SET close          - Shows all settings whose variable name
+                         contains 'close'. Very practical.
+
 See also: TOGGLE
 

docs/help/in/squery.in

@@ -1,5 +1,10 @@
 
 @SYNTAX:squery@
 
-/SQUERY sends a query to specified service.
+   <service>   - Service name
+   <commands>  - Commands to pass to the service.
+
+/SQUERY sends a query to the specified service.
+
+See also: SERVLIST
 

docs/help/in/topic.in

@@ -1,6 +1,8 @@
 
 @SYNTAX:topic@
 
+   -delete  - Deletes the topic.
+
 Shows or/and changes the topic of the current or specified 
 channel.
 

docs/help/in/unban.in

@@ -3,5 +3,9 @@
 
 Removes the specified ban(s) from the channel.
 
+Examples:
+   /UNBAN *!*@*.fi
+   /UNBAN larry!*@* *!me@*.mydomain.net
+
 See also: BAN, KNOCKOUT
 

docs/help/in/userhost.in

@@ -3,3 +3,5 @@
 
 Shows the userhost info of the specified nick.
 
+See also: WHOIS
+

docs/help/in/who.in

@@ -5,9 +5,19 @@ Without parameters, shows all users and their user infos
 on the current channel. If you specify a channel, shows
 the all users of the given channel.
 
+If you specify an string with wildcards, you will be
+shown all users whose nick, userhost or realname matches
+the wildcard expression.
+
 If a channel is secret or private and you're not on it,
 you will be shown only those channel members, who do not 
 have the invisible (+i) mode set.
 
+Examples:
+   /WHO          - Shows users on current channel
+   /WHO #irssi   - Shows users on channel #irssi
+   /WHO timo*    - Shows users whose nick, userhost,
+                   or realname begins with string 'timo'
+
 See also: WHOIS, CHANNEL
 

docs/help/in/wquery.in

@@ -1,7 +1,8 @@
 
 @SYNTAX:wquery@
 
-Creates a query to the current window.
+Starts a query in the current window without
+opening a new window.
 
 See also: QUERY, WINDOW, SET AUTOCREATE