=head1 AKICK

The F<AKICK> command allows you to maintain channel
ban lists.  Users on the F<AKICK> list will be
automatically kickbanned when they join the channel,
removing any matching ban exceptions first. Users
with the +r flag are exempt.

You may also specify a hostmask (nick!user@host)
for the F<AKICK> list.

Removing an entry from the F<AKICK> list will not
remove any channel bans placed by it.

The reason is used when kicking and is visible in
F<AKICK LIST>. If the reason contains a '|' character,
everything after it does not appear in kick reasons
but does appear in F<AKICK LIST>.

=for Syntax: AKICK X<#channel> ADD|DEL|LIST X<nickname|hostmask> S<reason>

=head2 Examples

   /msg &nick& AKICK #foo ADD bar you are annoying | private op info
   /msg &nick& AKICK #foo ADD *!*foo@bar.com
   /msg &nick& AKICK #foo DEL bar
   /msg &nick& AKICK #foo LIST


=head1 BAN

The F<BAN> command allows you to ban a user or hostmask from
a channel.

=for Syntax: BAN X<#channel> X<nickname|hostmask>

=head2 Examples

   /msg &nick& BAN #chat carnell
   /msg &nick& BAN #chat *!*@*.ipt.aol.com


=head1 CLEAR BANS

Clear bans will remove all bans found in a specific
channel. If your ircd supports other lists associated
with a channel (e.g. ban exceptions), you can clear
these by specifying the mode letters. Specify an
asterisk to clear all lists.

=for Syntax: CLEAR X<#channel> BANS S<types>

=head2 Examples

   /msg &nick& CLEAR #support BANS

Clears #support ban list.

   /msg &nick& CLEAR #support BANS eI

Removes all ban and invite exceptions on #support
(if your ircd supports them).

   /msg &nick& CLEAR #support BANS *

Clears all lists of #support.

   /msg &nick& CLEAR #support BANS +

Shows the possible letters.


=head1 CLEAR USERS

Clear users will kick all users out of the channel,
except you. The channel will be cycled (recreated)
if you are not on it.

If a reason is specified, it will be included in the
kick message.

=for Syntax: CLEAR X<#channel> USERS S<reason>

=head2 Examples

   /msg &nick& CLEAR #ChatZone USERS


=head1 CLOSE

F<CLOSE> prevents a channel from being used. Anyone
who enters is immediately kickbanned. The channel
cannot be dropped and foundership cannot be
transferred.

Enabling F<CLOSE> will immediately kick all
users from the channel.

Use F<CLOSE OFF> to reopen a channel. While closed,
channels will still expire.

=for Syntax: CLOSE X<#channel> ON|OFF S<reason>

=head2 Examples

   /msg &nick& CLOSE #lamers ON spamming
   /msg &nick& CLOSE #spiderslair OFF


=head1 COUNT

This will give a count of how many entries are in each of
the channel's xOP lists and how many entries on the access
list do not match a xOP value (except the founder).

The second line shows how many access entries have each flag.

=for Syntax: COUNT X<#channel>

=head2 Examples

   /msg &nick& COUNT #oscn


=head1 OP|DEOP|VOICE|DEVOICE|HALFOP|DEHALFOP

This command performs status mode changes on a channel.

If you perform an operation on another user, they will be
notified that you did it.

If the last parameter is omitted the action is performed
on the person requesting the command.

=for Syntax: $CMD X<#channel> S<nickname>

=head2 Examples

   /msg &nick& $CMD #foo bar
   /msg &nick& $CMD #foo


=head1 DROP

F<DROP> allows you to "unregister" a registered channel.

Once you F<DROP> a channel all of the data associated
with it (access lists, etc) are removed and cannot
be restored.

=for Syntax: DROP X<#channel>

=head2 Examples

   /msg &nick& DROP #foo


=head1 FFLAGS

The F<FFLAGS> command allows an oper to force a flags
change on a channel. The syntax is the same as L<FLAGS>,
except that the target and flags changes must be given.
Viewing any channel's access list is done with L<FLAGS>.

=for Syntax: FFLAGS X<#channel> X<nickname|hostmask> X<template>

=for Syntax: FFLAGS X<#channel> X<nickname|hostmask> X<flag_changes>

=head2 Examples

   /msg &nick& FFLAGS #foo foo AOP


=head1 FLAGS

The F<FLAGS> command allows for the granting/removal of channel
privileges on a more specific, non-generalized level. It
supports both nicknames and hostmasks as targets.

When only the channel argument is given, a listing of
permissions granted to users will be displayed.

=for Syntax: FLAGS X<#channel>

Otherwise, an access entry is modified. A modification may be
specified by a template name (changes the access to the
template) or a flags change (starts with + or -). See the
L<TEMPLATE> help entry for more information about templates.

If you are not the founder, you may only manipulate flags you
have yourself, and may not edit users that have flags you
don't have. For this purpose, +v grants +V, +h grants +H,
+o grants +O and +r grants +b.

If you do not have +f you may still remove your own access
with -*.

=for Syntax: FLAGS X<#channel> S<nickname|hostmask template>

=for Syntax: FLAGS X<#channel> S<nickname|hostmask flag_changes>

Permissions:

   +v - Enables use of the voice/devoice commands.
   +V - Enables automatic voice.
   +h - Enables use of the halfop/dehalfop commands.
   +H - Enables automatic halfop.
   +o - Enables use of the op/deop commands.
   +O - Enables automatic op.
   +s - Enables use of the set command.
   +i - Enables use of the invite and getkey commands.
   +r - Enables use of the kick, ban, and kickban commands.
   +R - Enables use of the recover and clear commands.
   +f - Enables modification of channel access lists.
   +t - Enables use of the topic and topicappend commands.
   +A - Enables viewing of channel access lists.
   +F - Grants full founder access.
   +b - Enables automatic kickban.

The special permission +* adds all permissions except +b and +F.
The special permission -* removes all permissions including +b and +F.

=head2 Examples

   /msg &nick& FLAGS #foo
   /msg &nick& FLAGS #foo foo!*@bar.com VOP
   /msg &nick& FLAGS #foo foo!*@bar.com -V+oO
   /msg &nick& FLAGS #foo foo!*@bar.com -*
   /msg &nick& FLAGS #foo foo +oOtsi
   /msg &nick& FLAGS #foo TroubleUser!*@*.troubleisp.net +b


=head1 FORCEXOP

F<FORCEXOP> resets all channel access levels to
xOP compatible values. That is, after the
operation, the founder will have all permissions
and autoop and everyone else on with flags
will be on one of the xOP lists. This command
is useful if the definitions for which flags
each xOP level gives change and the founder
wishes to use xOP commands only.

Only the founder can execute this command.

=for Syntax: FORCEXOP X<#channel>

See also: L<SOP>, L<AOP>, L<HOP>, L<VOP>


=head1 FTRANSFER

F<FTRANSFER> forcefully transfers foundership
of a channel.

=for Syntax: FTRANSFER X<#channel> X<founder>

=head2 Examples

   /msg &nick& FTRANSFER #casual vodkaswirl


=head1 GETKEY

F<GETKEY> returns the key (+k, password to be allowed in)
of the specified channel: /join #channel key

=for Syntax: GETKEY X<#channel>

=head2 Examples

   /msg &nick& GETKEY #foo


=head1 HOLD

F<HOLD> prevents a channel from expiring for inactivity.
Held channels will still expire when there are no
eligible successors.

=for Syntax: HOLD X<#channel> ON|OFF

=head2 Examples

   /msg &nick& HOLD #mychan ON


=head1 INFO

F<INFO> displays channel information such as
registration time, flags, and other details.

=for Syntax: INFO X<#channel>

=head2 Examples

   /msg &nick& INFO #foo


=head1 INVITE

F<INVITE> requests services to invite you to the
specified channel. This is useful if you use
the +i channel mode.

=for Syntax: INVITE X<#channel>

=head2 Examples

   /msg &nick& INVITE #foo


=head1 KICK

The F<KICK> command allows for the removal of a user from
a channel. The user can immediately rejoin.

Your nick will be added to the kick reason.

=for Syntax: KICK X<#channel> X<nick> S<reason>

=head2 Examples

   /msg &nick& KICK #foo abuser
   /msg &nick& KICK #foo abuser please stop


=head1 KICKBAN

The F<KICKBAN> command allows for the removal of a user from
a channel while placing a ban on the user.

Any matching ban exceptions will be removed.

=for Syntax: KICKBAN X<#channel> X<nick> S<reason>

=head2 Examples

   /msg &nick& KICKBAN #foo abuser
   /msg &nick& KICKBAN #foo abuser go away


=head1 LIST

F<LIST> shows channels that match a given
pattern. Wildcards are allowed.

=for Syntax: LIST X<pattern>

=head2 Examples

   /msg &nick& LIST #*foo*
   /msg &nick& LIST #x*


=head1 MARK

F<MARK> allows operators to attach a note to a channel.
For example, an operator could mark the channel of a
spammer so that others know it has previously been
warned.

MARK information will be displayed in INFO output.

=for Syntax: MARK X<#channel> ON|OFF X<reason>

=head2 Examples

   /msg &nick& MARK #lobby ON Takeover: returned to bill


=head1 QUIET

The F<QUIET> command allows you to mute a user or hostmask in
a channel.

=for Syntax: QUIET X<#channel> X<nickname|hostmask>

=head2 Examples

   /msg &nick& QUIET #chat AfterDeath
   /msg &nick& QUIET #chat *!*@*.ipt.aol.com


=head1 RECOVER

F<RECOVER> allows you to regain control of your
channel in the event of a takeover.

More precisely, everyone will be deopped,
limit and key will be cleared, all bans
matching you are removed, a ban exception
matching you is added (in case of bans Ermyth
can't see), the channel is set invite-only
and moderated and you are invited.

If you are on channel, you will be opped and
no ban exception will be added.

=for Syntax: RECOVER X<#channel>

=head2 Examples

   /msg &nick& RECOVER #foo


=head1 REGISTER

F<REGISTER> allows you to register a channel
so that you have better control. Registration
allows you to maintain a channel access list
and other functions that are normally
provided by IRC bots.

=for Syntax: REGISTER X<#channel>

=head2 Examples

   /msg &nick& REGISTER #mychan


=head1 SET EMAIL

F<SET EMAIL> allows you to change or set the email
address associated with a channel. This is shown
to all users in INFO.

=for Syntax: SET X<#channel> EMAIL X<email>

Using the command in this way results in an email
address being associated with the channel.

=head2 Examples

   /msg &nick& SET #chat EMAIL some@email.address

=for Syntax: SET X<#channel> EMAIL NONE

Using the command in this way results in an email
address being removed from the channel.

=head2 Examples

   /msg &nick& SET #chat EMAIL none


=head1 SET ENTRYMSG

F<SET ENTRYMSG> allows you to change or set
a message sent to all users joining the
channel. Specify a X<message> or C<NONE> to
clear the message.

=for Syntax: SET X<#channel> ENTRYMSG X<message>

=head2 Examples

   /msg &nick& SET #support ENTRYMSG Welcome to #support. Please do not paste more than 5 lines.


=head1 SET FANTASY

F<SET FANTASY> allows you to enable or disable &nick&
fantasy commands (!op, !deop, etc.) on your channel.

=for Syntax: SET X<#channel> FANTASY ON|OFF

=head2 Examples

   /msg &nick& SET #chatspike FANTASY ON


=head1 SET FOUNDER

F<SET FOUNDER> allows you to set a new founder
of the channel. The new founder has to
execute the same command to confirm the
transfer.

=for Syntax: SET X<#channel> FOUNDER X<newnick>

If the new founder has not yet confirmed the
transfer, you can cancel it by specifying
your own nick as the new founder.

=for Syntax: SET X<#channel> FOUNDER X<yournick>

=head2 Examples

   /msg &nick& SET #foo FOUNDER bar


=head1 SET GUARD

F<SET GUARD> allows you to have &nick& join your channel.
Fantasy commands will only work if this is enabled.

=for Syntax: SET X<#channel> GUARD ON|OFF

=head2 Examples

   /msg &nick& SET #mychan GUARD ON


=head1 SET KEEPTOPIC

F<SET KEEPTOPIC> enables restoration of the old
topic after the channel has become empty. In
some cases, it may revert topic changes
after netsplits or services outages, so it
is not recommended to turn this on if your
channel tends to never empty.

=for Syntax: SET X<#channel> KEEPTOPIC ON|OFF

=head2 Examples

   /msg &nick& SET #foo KEEPTOPIC ON


=head1 SET MLOCK

F<MLOCK> (or "mode lock") allows you to enforce a set
of modes on a channel.  This can prevent abuse in cases
such as +kl. It can also make it harder to fight evil
bots, be careful. Locked modes can be seen by anyone
recreating the channel (this includes keys).

=for Syntax: SET X<#channel> MLOCK X<modes>

=head2 Examples

 (some may use modes your ircd does not support)
   /msg &nick& SET #foo MLOCK +nt-lk
   /msg &nick& SET #foo MLOCK +inst-kl
   /msg &nick& SET #c MLOCK +ntk c
   /msg &nick& SET #foo MLOCK +ntcjf-kl 2:30 #overflow
   /msg &nick& SET #overflow MLOCK +mntF-kljf
   /msg &nick& SET #foo1 MLOCK +ntlL 40 #foo2
   /msg &nick& SET #foo MLOCK OFF


=head1 SET PROPERTY

F<SET PROPERTY> manipulates metadata
associated with a channel.

To delete a metadata entry, specify
the name and leave the value blank.

=for Syntax: SET X<#channel> PROPERTY X<name> S<value>

=head2 Examples

   /msg &nick& SET #ermyth PROPERTY URL http://ermyth.xinutec.org/
   /msg &nick& SET #meat PROPERTY VEGETABLES


=head1 SET SECURE

F<SET SECURE> prevents anyone that's not on the
channel's access lists from gaining operator
or halfop status on the channel.  This is
useful if you're paranoid.

=for Syntax: SET X<#channel> SECURE ON|OFF

=head2 Examples

   /msg &nick& SET #foo SECURE ON


=head1 SET STAFFONLY

F<SET STAFFONLY> designates a channel as staff-only.
Users who are not staff (no chan:joinstaffonly priv) are
kickbanned from the channel, removing any ban exceptions
matching them first.

=for Syntax: SET X<#channel> STAFFONLY ON|OFF

=head2 Examples

   /msg &nick& SET #snoop STAFFONLY ON


=head1 SET TOPICLOCK

F<SET TOPICLOCK> causes &nick& to revert
topic changes by users without the +t flag.
Topic changes during netsplits or services
outages will always be reverted.

F<TOPICLOCK> requires L<KEEPTOPIC> and will
automatically enable it; disabling L<KEEPTOPIC>
will disable F<TOPICLOCK> also.

=for Syntax: SET X<#channel> TOPICLOCK ON|OFF

=head2 Examples

   /msg &nick& SET #foo TOPICLOCK ON


=head1 SET URL

F<SET URL> allows you to change or set the URL
associated with a channel. This is shown
to all users joining the channel. Specify
an X<url> or C<NONE> to clear the URL.

=for Syntax: SET X<#channel> URL X<url>

=head2 Examples

   /msg &nick& SET #chat URL http://slashdot.org


=head1 SET VERBOSE

C<SET VERBOSE ON> sends a notice to the channel when someone
makes changes to the access lists.

C<SET VERBOSE OPS> sends a notice to the channel operators when
someone makes changes to the access lists.

Fantasy commands are always executed as if F<SET VERBOSE ON> is
in effect.

=for Syntax: SET X<#channel> VERBOSE ON|OPS|OFF

=head2 Examples

   /msg &nick& SET #foo VERBOSE ON


=head1 STATUS

F<STATUS> returns information about your current
state. It will show information about your
nickname, IRC operator, and SRA status.

If the a channel parameter is specified, your
access to the given channel is returned.

=for Syntax: STATUS S<#channel>

=head2 Examples

   /msg &nick& STATUS
   /msg &nick& STATUS #foo


=head1 TAXONOMY

The taxonomy command lists metadata information associated
with registered channels.

=head2 Examples

   /msg &nick& TAXONOMY #mychan


=head1 TEMPLATE

The F<TEMPLATE> command allows definition of sets of flags,
simplifying the use of the FLAGS command.

Without arguments, network wide templates are shown.
These include at least L<SOP>/L<AOP>/L<HOP>/L<VOP>.

=for Syntax: TEMPLATE

When given only the channel argument, a listing of
templates for the channel will be displayed.

=for Syntax: TEMPLATE X<#channel>

Otherwise, a template is modified. A modification may be
specified by a template name (copies the template) or a
flags change (starts with + or -, optionally preceded by
an !). Templates cannot be the empty set (making a
template empty deletes it).

If the ! form is used, all access entries which exactly
match the template are changed accordingly, with the
exception that it is not possible to remove the
founder's +f access.

There is a limit on the length of all templates on a
channel.

If you are not the founder, similar restrictions apply
as in L<FLAGS>.

=for Syntax: TEMPLATE X<#channel> S<template oldtemplate>

=for Syntax: TEMPLATE X<#channel> S<template flag_changes>

=for Syntax: TEMPLATE X<#channel> S<template !flag_changes>

=head2 Examples

   /msg &nick& TEMPLATE #foo
   /msg &nick& TEMPLATE #foo user VOP
   /msg &nick& TEMPLATE #foo user !+A
   /msg &nick& TEMPLATE #foo co-founder +*-OH
   /msg &nick& TEMPLATE #foo op -*+vVhoti
   /msg &nick& TEMPLATE #foo obsoletetemplate -*


=head1 TOPIC

The F<TOPIC> command allows for the changing of a topic on a channel.

=for Syntax: TOPIC X<#channel> X<topic>

=head2 Examples

   /msg &nick& TOPIC #foo bar


=head1 TOPICAPPEND

The F<TOPICAPPEND> command allows for the addition to a topic on a channel.

=for Syntax: TOPICAPPEND X<#channel> X<topic>

=head2 Examples

   /msg &nick& TOPICAPPEND #foo bar


=head1 TOPICPREPEND

The F<TOPICPREPEND> command allows for the addition to a topic on a channel.

=for Syntax: TOPICPREPEND X<#channel> X<topic>

=head2 Examples

   /msg &nick& TOPICPREPEND #foo bar


=head1 UNBAN

The F<UNBAN> command allows you to unban a user or hostmask
from a channel. If no nickname or hostmask is specified,
you are unbanned.

=for Syntax: UNBAN X<#channel> S<nickname|hostmask>

=head2 Examples

   /msg &nick& UNBAN #chat pfish
   /msg &nick& UNBAN #chat *!*@*.ucdavis.edu


=head1 UNQUIET

The F<UNQUIET> command allows you to unmute a user or hostmask
in a channel. If no nickname or hostmask is specified,
you are unquieted.

=for Syntax: UNQUIET X<#channel> S<nickname|hostmask>

=head2 Examples

   /msg &nick& UNQUIET #chat Diablo-D3
   /msg &nick& UNQUIET #chat *!*@*.trilug.org


=head1 USERINFO

The F<USERINFO> command allows the definition of info lines
to be shown to the channel when a user joins.

When only the channel argument is given, a listing of
users with info lines will be displayed.

=for Syntax: USERINFO X<#channel>

Otherwise, an info line is modified or deleted.

=for Syntax: USERINFO X<#channel> X<nickname> S<newinfo>

The given nickname must be on the channel access list
and you must have permission to modify the entry (+f
plus the entry's flags).

=head2 Examples

   /msg &nick& USERINFO #foo
   /msg &nick& USERINFO #foo foouser
   /msg &nick& USERINFO #foo foouser An info line.


=head1 WHY

The F<WHY> command shows the access entries an online
user matches.

=for Syntax: WHY X<#channel> X<nickname>

=head2 Examples

   /msg &nick& WHY #mychan jilles^


=head1 VOP|HOP|AOP|SOP

The xOP commands allow you to maintain channel
access lists. Channel access lists can contain
registered accounts or hostmasks (nick!user@host).

The exact meanings of the access levels may differ
per network, use C</msg &nick& L<TEMPLATE>> to check. As
a hint, VOP stands for VOice People, HOP stands for
HalfOP, AOP stands for AutoOP, SOP stands for
SuperOP.

Not all channel access entries can be edited
with these commands, see the L<FLAGS> and L<FORCEXOP>
help entries for details. Note that use of
L<FORCEXOP> can destroy a lot of information.
The L<TEMPLATE> system can provide most of the
ease of use of these commands without the
restrictions.

The privileges required to execute these commands are
the same as those required for the corresponding
L<FLAGS> commands.

=for Syntax: $CMD X<#channel> ADD|DEL|LIST X<nickname|hostmask>

=head2 Examples

   /msg &nick& $CMD #foo ADD bar
   /msg &nick& $CMD #foo ADD foo!*@bar.com
   /msg &nick& $CMD #foo DEL bar
   /msg &nick& $CMD #foo LIST