summaryrefslogtreecommitdiff
path: root/docs/help
diff options
context:
space:
mode:
Diffstat (limited to 'docs/help')
-rw-r--r--docs/help/in/action.in2
-rw-r--r--docs/help/in/map.in13
-rw-r--r--docs/help/in/me.in19
-rw-r--r--docs/help/in/mircdcc.in27
-rw-r--r--docs/help/in/mode.in151
-rw-r--r--docs/help/in/motd.in22
-rw-r--r--docs/help/in/msg.in23
7 files changed, 158 insertions, 99 deletions
diff --git a/docs/help/in/action.in b/docs/help/in/action.in
index 23b1a5d6..9a2912c6 100644
--- a/docs/help/in/action.in
+++ b/docs/help/in/action.in
@@ -7,7 +7,7 @@
-<server tag>: The server tag you want to send the action emote to.
- A target nickname or channel and the message.
+ A target nickname or channel and the message to emote.
%9Description:%9
diff --git a/docs/help/in/map.in b/docs/help/in/map.in
index 7ddf696e..81994cf2 100644
--- a/docs/help/in/map.in
+++ b/docs/help/in/map.in
@@ -1,7 +1,16 @@
+%9Syntax:%9
+
@SYNTAX:map@
-Works only in some IRC networks and is often restricted to IRC operators.
+%9Description:%9
+
+ Displays the network map of an IRC network; this command is usally
+ reserved for IRC operators and does not work on all servers.
+
+%9Examples:%9
+
+ /MAP
-Shows a graphical map of the IRC network, often with user counts.
+%9See also:%9 DIE, LINKS, LUSERS
diff --git a/docs/help/in/me.in b/docs/help/in/me.in
index b918ec71..0da1e5ca 100644
--- a/docs/help/in/me.in
+++ b/docs/help/in/me.in
@@ -1,8 +1,21 @@
+%9Syntax:%9
+
@SYNTAX:me@
-Sends a CTCP ACTION to the current channel or query.
-For example: /me sits back.
+%9Parameters:%9
+
+ The message to emote.
+
+%9Description:%9
+
+ Sends an action emote to the active nickname or channel.
+
+%9Examples:%9
+
+ /ME is hungry!
+ /ME had an awesome day @ work
+ /ME is happy it's Friday
-See also: ACTION, CTCP
+%9See also:%9 ACTION, CTCP
diff --git a/docs/help/in/mircdcc.in b/docs/help/in/mircdcc.in
index d3402e0a..3282d68c 100644
--- a/docs/help/in/mircdcc.in
+++ b/docs/help/in/mircdcc.in
@@ -1,11 +1,28 @@
+%9Syntax:%9
+
@SYNTAX:mircdcc@
-Selects whether to send mIRC style CTCPs in DCC chat
-session.
+%9Parameters:%9
+
+ ON: Enables mIRC compatibility mode.
+ OFF: Disables mIRC compatibility mode.
+
+%9Description:%9
+
+ After establishing a DCC CHAT connection that you initiated, you might
+ encounter some protocol issues if the target is using mIRC.
+
+ If you or your target sees some unexpected output or behaviour inside a DCC
+ CHAT session, use this command to enable mIRC compatibility mode.
+
+ When receiving a connection from an mIRC user, the compatibility mode will
+ automatically be enabled.
+
+%9Examples:%9
-If a mIRC user sends first a CTCP, mIRC style CTCPs is
-automatically selected for that DCC Chat session.
+ /MIRCDCC ON
+ /MIRCDCC OFF
-See also: SET MIRC
+%9See also:%9 ACTION, DCC, CTCP
diff --git a/docs/help/in/mode.in b/docs/help/in/mode.in
index 9642d95e..d4cf2d25 100644
--- a/docs/help/in/mode.in
+++ b/docs/help/in/mode.in
@@ -1,82 +1,77 @@
-@SYNTAX:mode@
-
-Common channel modes are:
-
- i - Invite only - People can't join to channel without being
- /INVITEd, or being in invite list (+I, see below).
- m - Moderated - People who don't have voices (+v) can't send
- messages to channel
- p - Private - People who aren't joined to channel can't see it
- for example with /WHOISing people who are in channel.
- s - Secret - Like private, but the channel isn't displayed in
- /LIST's output.
- n - No external msgs - Without this mode, anyone can send messages
- to channel without even being joined.
- t - Topic can be changed only by channel operators.
-
- k <key> - Channel password (aka. key) - The channel can't be joined
- without specifying the channel key (see section 6.2).
-
- l <count> - User limit - No more than <count> people can join to
- channel. This can be overridden with /INVITE with some
- servers.
-
- This is usually used for protecting channel from join
- flooding, like some bot allows max. 5 users to join in
- one minute or so.
-
- b - Set/remove ban. For example MODE #channel +b *!*@*.org bans
- everyone from .org domain.
-
- If someone from .org domain was already in channel before the
- ban was set, he/she cannot send any messages to channel (doesn't
- work with all servers).
-
- Bans can also be overridden with /INVITE, although many stupid
- IRC clients automatically kick the user out because they see
- the ban and think that because of it the user shouldn't be in
- the channel (doesn't work with all servers).
-
- e - Ban exceptions. You could for example ban everyone from
- *!*@*.org but set ban exception to *!*@*.host.org - does not work
- with all servers.
+%9Syntax:%9
- I - Invite list. If channel is invite only (+i), people in this
- list can join it without being /INVITEd - does not work with all
- servers.
-
- This is excellent for in-country channels that don't want
- foreigners (spammers!) to join the channel, for example setting
- channel's mode to +i and +I *!*@*.fi allows only finnish people
- to join the channel. In addition to this, there's usually a bot
- in the channels and sending /MSG bot invite command to it
- /INVITEs you to the channel.
-
- On IRCnet, the ':' feature in channel names can also be used for
- a similar effect, see section 6.2.
-
- o <nick> - Grant or revoke channel operator status from nick
- v <nick> - Grant or revoke voice status from nick, only people with
- +v (or +o) can talk to channel when it's moderated (+m).
-
-You can send multiple mode changes with one mode command:
-
-/MODE #channel +nto-o+v nick1 nick2 nick3
-
-This would set channel's mode to +nt, give ops to nick1, take ops
-from nick2 and give voices to nick3.
-
-You can set only a limited number of modes that require an argument
-in one command. In IRCnet it's 3, in EFnet it's 4 and in many others
-it's 6. If it's not known, Irssi defaults to 3. Irssi will also
-automatically split them, so you can use /MODE +oooooo n1 n2 ...
-command to op 6 people and Irssi will split it to two commands in
-IRCnet/EFnet.
-
-Many networks have additional modes and/or change the meaning of existing
-modes. Check the documentation for the network or the server software in
-use for details.
+@SYNTAX:mode@
-See also: OP, DEOP, VOICE, DEVOICE, BAN, UNBAN
+%9Parameters:%9
+
+ The target nickname or channel and the modes with their parameters to set or
+ remove.
+
+ If the target nickname or channel is omitted, the active nickname or channel
+ will be used.
+
+%9Description:%9
+
+ Modifies the user or channel modes for which you are privileged to modify.
+
+ You can specify multiple modes in one command and prepend them by using the
+ "+" sign to set or "-" sign to unset; modes that require a parameter will be
+ retrieved from the argument list.
+
+ Some common channel modes are:
+
+ b <mask>: Adds or removes a ban; a ban will prevent a user who
+ matches the given mask from joining the channel unless
+ he or she is invited or in the excempt list.
+ e <mask>: Adds or removes a ban exception; users who match a mask
+ on the excempt list are able to join a channel even if
+ they also match an entry on the banlist.
+ i: When enabled, users need to be invited into the channel
+ or have a matching entry in the invite list.
+ I <mask>: Adds or removes an invite; users who match a mask on
+ the invite list are able to join even if the channel is
+ set to invite only.
+ k <key>: Adds or removes a channel key, aka a password; users
+ will not be able to join the channel without providing
+ the key.
+ l <count>: Adds, removes or updates the maximum amount of users
+ that may join the channel.
+ m: When enabled, users who are not opped or voiced cannot
+ send messages to the channel.
+ n: When enabled, users who are not on the channel cannnot
+ send messages to it.
+ p: When enabled, the channel will not be displayed in your
+ WHOIS output.
+ s: When enabled, the channel will not be displayed in the
+ LIST output.
+ t: When enabled, users who are not opped or voices cannot
+ modify the channel topic.
+ o <nickname>: Adds or removes the operator status from a nickname.
+ v <nickname>: Adds or removes the voice status from a nickname.
+
+ Some common user modes are:
+
+ i: When enabled, other users will not be able to see you
+ on a WHO output unless they are in the channel
+ themselves.
+ w: When enabled, you will receive WALLOP messages from IRC
+ operators.
+ s: When enabled, you will receive special notices or debug
+ messages from the server.
+
+ Many networks have additional user and channel modes; we highly recommend
+ you to read the documentation of the networks you frequently connect to and
+ maximize your IRC experience.
+
+%9Examples:%9
+
+ /MODE #irssi +o mike
+ /MODE #irssi -o+iI mike mike!*@*.irssi.org
+ /MODE +b mike!*@*.irssi.org
+ /MODE -o mike
+ /MODE +impsnkl secret_hideout 100
+ /MODE mike +iw
+
+%9See also:%9 BAN, DEOP, DEVOICE, UNBAN, OP, VOICE
diff --git a/docs/help/in/motd.in b/docs/help/in/motd.in
index 8d66d04b..5a69d59e 100644
--- a/docs/help/in/motd.in
+++ b/docs/help/in/motd.in
@@ -1,7 +1,23 @@
+
+%9Syntax:%9
+
@SYNTAX:motd@
-Shows the motd of the current or specified server. This contains
-usually some useful info on the server, administrator and
-the rules.
+%9Parameters:%9
+
+ The server or the server the target nickname is on; if no parameter is
+ given, the active server will be used.
+
+%9Description:%9
+
+ Displays the "Message of the Day" of an IRC server.
+
+%9Examples:%9
+
+ /MOTD
+ /MOTD orwel.freenode.org
+ /MOTD bob
+
+%9See also:%9 ADMIN, INFO, LINKS, MAP
diff --git a/docs/help/in/msg.in b/docs/help/in/msg.in
index f58ba41a..dc70f1f3 100644
--- a/docs/help/in/msg.in
+++ b/docs/help/in/msg.in
@@ -1,15 +1,24 @@
+%9Syntax:%9
+
@SYNTAX:msg@
-Sends a message to a nick or a channel. Usually this
-is used for sending private messages to other persons.
+%9Parameters:%9
+
+ -<server tag>: The server tag the targets are on.
+ -channel: Indicates that the target is a channel.
+ -nick: Indicates that the target is a nickname.
+
+ The target nickname or channel and the message to send.
+
+%9Description:%9
-Examples:
+ Sends a message to a nickname or channel.
-/MSG friend Hi, what's up?
+%9Examples:%9
-/MSG #irssi Hello, is the new gtk-version out already?
-(This format is rarely needed.)
+ /MSG mike Hi, what's up?
+ /MSG #irssi I am awesome :)
-See also: CTCP
+%9See also:%9 ACTION, DCC, JOIN