Commands.txt: Import descriptions from "rbose/command_help"

Import command description texts from the "rbose/command_help" branch,
which have been written by DNS <dns@rbose.org> -- thanks a lot!

diff --git a/doc/Commands.txt b/doc/Commands.txt
index c879092930b1995286cd54c913cdfc82b0637af0..c6e063785a8fb32f73574c25ebb7e7115b5b7acd 100644 (file)
--- a/doc/Commands.txt
+++ b/doc/Commands.txt
@@ -46,16 +46,35 @@ Connection Handling Commands
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 - CAP
+       See doc/Capabilities.txt
 
 - CHARCONV
+       See doc/Protocol.txt
 
 - NICK
+       NICK <nick>
+       .
+       Change your nickname to <nick>.
 
 - PASS
+       PASS <password> <version> <flags> [<options>]
+       .
+       Set a connection <password>. This command must be sent before the
+       NICK/USER registration combination.
+       .
+       See doc/Protocol.txt for more info.
 
 - PING
+       PING <server1> [<server2>]
+       .
+       Tests the presence of a connection. A PING message results in a PONG
+       reply. If <server2> is specified, the message gets passed on to it.
 
 - PONG
+       PONG <server1> [<server2>]
+       .
+       This command is a reply to the PING command and works in much the
+       same way.
 
 - QUIT
        QUIT [<quit-message>]
@@ -66,14 +85,28 @@ Connection Handling Commands
        channels that you are a member of when leaving.
 
 - USER
+       USER <user> <modes> <realname>
+       .
+       This command is used at the beginning of a connection to specify the
+       <user>name, hostname, <realname> and initial user <modes> of the
+       connecting client.
+       .
+       <realname> may contain spaces, and thus must be prefixed with a colon.
 
 - WEBIRC
+       See doc/Protocol.txt
 
 
 General Commands
 ~~~~~~~~~~~~~~~~
 
 - AWAY
+       AWAY [<message>]
+       .
+       Provides the server with a message to automatically send in reply to a
+       PRIVMSG directed at the user, but not to a channel they are on.
+       .
+       If <message> is omitted, the away status is removed.
 
 - HELP
        HELP [<command>]
@@ -93,10 +126,29 @@ General Commands
 
 
 - MODE
+       MODE <nickname> <flags> (user)
+       MODE <channel> <flags> [<args>]
+       .
+       The MODE command is dual-purpose. It can be used to set both (user) and
+       <channel> modes.
+       .
+       See doc/Modes.txt for more information.
 
 - NOTICE
+       NOTICE <target> <notice>
+       .
+       Send <notice> to <target> (nick or channel).
+       .
+       This command works similarly to PRIVMSG, except automatic replies must
+       never be sent in reply to NOTICE messages.
 
 - PRIVMSG
+       PRIVMSG <target> <message>
+       .
+       Send <message> to <target> (nick or channel).
+       .
+       Common IRC clients use MSG as PRIVMSG alias.
+       (Some clients use "QUERY <nick> [<message>]" to open a private chat.)
 
 
 Status and Informational Commands
@@ -109,72 +161,239 @@ Status and Informational Commands
        If no server name has been given, the local server will respond.
 
 - INFO
+       INFO [<server>]
+       .
+       Show the version, birth & online time of the current IRC server.
+       If <server> has been given, it shows the INFO of the specific <server>.
 
 - ISON
+       ISON <nicknames>
+       .
+       Queries the server to see if the clients in the space-separated list
+       <nicknames> are currently on the network.
+       .
+       The server returns only the <nicknames> that are on the network in a
+       space-separated list. If none of the clients are on the network the
+       server returns an empty list.
 
 - LINKS
+       LINKS [<remote server> [<server mask>]]
+       .
+       Lists all server links matching <server mask>, if given,
+       on <remote server>, or the current server if omitted.
 
 - LUSERS
+       LUSERS [<mask> [<server>]]
+       .
+       Return statistics about the size of the network. If called with no
+       arguments, the statistics will reflect the entire network.
+       .
+       If <mask> is given, it will return only statistics reflecting the
+       masked subset of the network.
+       If <server> is given, the command will be forwarded to <server>
+       for evaluation.
 
 - MOTD
+       MOTD [<server>]
+       .
+       Show "Message Of The Day" of the current server or specified <server>.
 
 - NAMES
+       NAMES [<channels> [<server>]]
+       .
+       Returns a list of who is on the comma-separated list of <channels>,
+       by channel name.
+       .
+       If <channels> is omitted, all users are shown, grouped by channel name
+       with all users who are not on a channel being shown as part of channel
+       "*".
+       If <server> is specified, the command is sent to <server> for
+       evaluation.
 
 - STATS
+       STATS <flag> [<server>]
+       .
+       Returns statistics about the current server, or of a specified <server>.
+       .
+       STATS flags:
+       .
+       g = G-Lines (Network-wide bans)
+       k = K-Lines (Server-local bans)
+       l = Link status (Parent server and own link)
+       m = IRC command status (usage count)
+       u = Server uptime
 
 - TIME
+       TIME [<server>]
+       .
+       Show the local time of the current server, or of a specified <server>.
 
 - TRACE
+       TRACE [<server>]
+       .
+       Trace a path across the IRC network of the current server, or if given
+       of a specific <server>, in a similar method to traceroute.
 
 - USERHOST
+       USERHOST <nicknames>
+       .
+       Show the user-host of <nicknames> (seperated by space).
+       "-" means <nick> is away,
+       "+" means <nick> is available,
+       "*" indicates your connection.
 
 - VERSION
+       VERSION [<server>]
+       .
+       Show the ngIRCd version of the current server, or specified <server>.
 
 - WHO
+       WHO [<target> ["o"]]
+       .
+       Returns a list of users who match <target> (nick, hostmask or channel).
+       .
+       If the flag "o" is given, the server will only return information about
+       IRC Operators.
 
 - WHOIS
+       WHOIS [<server>] <nicknames>
+       .
+       Returns information about the comma-separated list of <nicknames>.
+       .
+       If <server> is given, the command is forwarded to it for processing.
 
 - WHOWAS
+       WHOWAS <nickname> [<count> [<server>]]
+       .
+       Used to return information about <nicknames> that are no longer in use
+       (due to client disconnection, or nickname changes).
+       .
+       If given, the server will return information from the last <count> times
+       the nickname has been used.
+       If <server> is given, the command is forwarded to it for processing.
 
 
 Channel Commands
 ~~~~~~~~~~~~~~~~
 
 - INVITE
+       INVITE <nick> <channel>
+       .
+       Invites <nick> to <channel>.
+       <channel> does not have to exist, but if it does, only members of the
+       channel are allowed to invite other clients.
+       .
+       If the <channel> mode "+i" is set, only <channel> operators may invite
+       other clients.
 
 - JOIN
+       JOIN <channels> [<channel-keys>]
+       .
+       Makes the client join the <channels> (comma-separated list), specifying
+       the passwords, if needed, in the comma-separated <channel-keys> list.
+       A <channel-key> is only needed, if the <channel> mode "+k" is set.
+       .
+       If the channel(s) do not exist, then they will be created.
 
 - KICK
+       KICK <channel> <nick> [<kick-message>]
+       .
+       Remove <nick> from <channel>, optional with a <kick-message>.
+       .
+       Only <channel> operators are able to KICK.
 
 - LIST
+       LIST [<channels> [<server>]]
+       .
+       List all visible <channels> (comma-seperated list) on the current
+       server.
+       If <server> is given, the command will be forwarded to <server> for
+       evaluation.
 
 - PART
+       PART <channels> [<part-message>]
+       .
+       Leave <channels> (comma-separated list), optional with a
+       <part-message>.
 
 - TOPIC
+       TOPIC <channel> <topic>
+       .
+       Set a <topic> for <channel>.
+       .
+       Only <channel> operators are able to set a <topic>.
 
 
 Administrative Commands
 ~~~~~~~~~~~~~~~~~~~~~~~
 
 - CONNECT
+       CONNECT <target server> [<port> [<remote server> [<mypwd> <peerpwd>]]]
+       .
+       Instructs the current server, or <remote server> if specified,
+       to connect to <target server>.
+       .
+       To connect <remote server> you need to have remote oper status.
+       If <port> is omitted, it uses the server port of the configuration.
+       If <mypwd> and <peerpwd> is given, it uses those passwords instead
+       of the ones in the configuration.
 
 - DIE
+       DIE
+       .
+       Instructs the server to shut down.
 
 - DISCONNECT
+       DISCONNECT [<remote server>]
+       .
+       Disconnects the current server, or <remote server> if specified.
+       To disconnect a <remote server> you need to have remote oper status.
 
 - GLINE
+       GLINE <nick!user@hostmask> <seconds> :<reason>
+       .
+       This command provides timed G-Lines (Network-wide bans).
+       If a client matches a G-Line, it cannot connect to any server on
+       the IRC network. If you put 0 as <seconds>, it makes the G-Line
+       permanent.
+       .
+       To remove a G-Line, type "GLINE <nick!user@hostmask>".
+       To list the G-Lines, type "STATS g".
 
 - KILL
+       KILL <nick> <reason>
+       .
+       Forcibly removes <nick> from the IRC network with a <reason>.
 
 - KLINE
+       KLINE <nick!user@hostmask> <seconds> :<reason>
+       .
+       This command provides timed K-Lines (Server-local bans).
+       If a client matches a K-Line, it cannot connect to the issued server.
+       If you put 0 as <seconds>, it makes the K-Line permanent.
+       .
+       To remove a K-Line, type "KLINE <nick!user@hostmask>".
+       To list the K-Lines, type "STATS k".
 
 - OPER
+       OPER <user> <password>
+       .
+       Authenticates <user> as an IRC operator on the current server/network.
 
 - REHASH
+       REHASH
+       .
+       Causes the server to re-read and re-process its configuration file(s).
 
 - RESTART
+       RESTART
+       .
+       Restart the server.
 
 - WALLOPS
+       WALLOPS <message>
+       .
+       Sends <message> to all users with user mode "+w".
 
 
 IRC Service Commands
@@ -193,6 +412,12 @@ Server Protocol Commands
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
 - CHANINFO
+       CHANINFO <channel> +<modes> [[<key> <limit>] <topic>]
+       .
+       CHANINFO is used by servers to inform each other about a channel:
+       its modes, channel key, user limits and its topic.
+       .
+       See doc/Protocol.txt for more information.
 
 - ERROR
        ERROR [<message> [<> [...]]]
@@ -204,12 +429,22 @@ Server Protocol Commands
        This command is silently ignored on non-server and non-service links.
 
 - METADATA
+       METADATA <target> <key> <value>
+       .
+       The METADATA command is used on server-links to update "metadata"
+       information of clients, like the hostname, the info text ("real name"),
+       or the user name.
+       .
+       See doc/Protocol.txt for more information.
 
 - NJOIN
 
 - SERVER
 
 - SQUIT
+       SQUIT <server>
+       .
+       Disconnects an IRC Server from the network.
 
 
 Dummy Commands