]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/channels.h
Merge pull request #1018 from SaberUK/insp20+hidekills
[user/henk/code/inspircd.git] / include / channels.h
index 59f4d1cf35530b35eb46ab98fbe79a1e717b3739..dda53f69da0b0be756bbcd9d5de59d76aaca4c50 100644 (file)
@@ -1,18 +1,27 @@
-/*       +------------------------------------+
- *       | Inspire Internet Relay Chat Daemon |
- *       +------------------------------------+
+/*
+ * InspIRCd -- Internet Relay Chat Daemon
  *
- *  InspIRCd: (C) 2002-2009 InspIRCd Development Team
- * See: http://wiki.inspircd.org/Credits
+ *   Copyright (C) 2009 Daniel De Graaf <danieldg@inspircd.org>
+ *   Copyright (C) 2007 Robin Burchell <robin+git@viroteck.net>
+ *   Copyright (C) 2007 Dennis Friis <peavey@inspircd.org>
+ *   Copyright (C) 2003-2007 Craig Edwards <craigedwards@brainbox.cc>
  *
- * This program is free but copyrighted software; see
- *            the file COPYING for details.
+ * This file is part of InspIRCd.  InspIRCd is free software: you can
+ * redistribute it and/or modify it under the terms of the GNU General Public
+ * License as published by the Free Software Foundation, version 2.
  *
- * ---------------------------------------------------
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+ * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
+ * details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-#ifndef __CHANNELS_H__
-#define __CHANNELS_H__
+
+#ifndef CHANNELS_H
+#define CHANNELS_H
 
 #include "membership.h"
 #include "mode.h"
@@ -47,7 +56,7 @@ class BanItem : public HostItem
  * This class represents a channel, and contains its name, modes, topic, topic set time,
  * etc, and an instance of the BanList type.
  */
-class CoreExport Channel : public Extensible
+class CoreExport Channel : public Extensible, public InviteBase
 {
        /** Connect a Channel to a User
         */
@@ -113,7 +122,7 @@ class CoreExport Channel : public Extensible
 
        /** Sets or unsets a custom mode in the channels info
         * @param mode The mode character to set or unset
-        * @param mode_on True if you want to set the mode or false if you want to remove it
+        * @param value True if you want to set the mode or false if you want to remove it
         */
        void SetMode(ModeHandler* mode, bool value);
        void SetMode(char mode,bool mode_on);
@@ -138,7 +147,7 @@ class CoreExport Channel : public Extensible
          * @param mode The mode character you wish to query
          *
          * For example if "+L #foo" is set, and you pass this method
-         * 'L', it will return '#foo'. If the mode is not set on the
+         * 'L', it will return '\#foo'. If the mode is not set on the
          * channel, or the mode has no parameters associated with it,
          * it will return an empty string.
          *
@@ -190,7 +199,7 @@ class CoreExport Channel : public Extensible
        const UserMembList* GetUsers();
 
        /** Returns true if the user given is on the given channel.
-        * @param The user to look for
+        * @param user The user to look for
         * @return True if the user is on this channel
         */
        bool HasUser(User* user);
@@ -252,7 +261,7 @@ class CoreExport Channel : public Extensible
         * Internally, this calls WriteAllExcept().
         * @param user User whos details to prefix the line with, and to omit from receipt of the message
         * @param serversource If this parameter is true, use the local server name as the source of the text, otherwise,
-        * use the nick!user@host of the user.
+        * use the nick!user\@host of the user.
         * @param status The status of the users to write to, e.g. '@' or '%'. Use a value of 0 to write to everyone
         * @param text A printf-style format string which builds the output line without prefix
         * @param ... Zero or more POD type
@@ -262,7 +271,7 @@ class CoreExport Channel : public Extensible
        /** Write to all users on a channel except a list of users, using va_args for text
         * @param user User whos details to prefix the line with, and to omit from receipt of the message
         * @param serversource If this parameter is true, use the local server name as the source of the text, otherwise,
-        * use the nick!user@host of the user.
+        * use the nick!user\@host of the user.
         * @param status The status of the users to write to, e.g. '@' or '%'. Use a value of 0 to write to everyone
         * @param except_list A list of users NOT to send the text to
         * @param text A printf-style format string which builds the output line without prefix
@@ -274,7 +283,7 @@ class CoreExport Channel : public Extensible
         * Internally, this calls WriteAllExcept().
         * @param user User whos details to prefix the line with, and to omit from receipt of the message
         * @param serversource If this parameter is true, use the local server name as the source of the text, otherwise,
-        * use the nick!user@host of the user.
+        * use the nick!user\@host of the user.
         * @param status The status of the users to write to, e.g. '@' or '%'. Use a value of 0 to write to everyone
         * @param text A std::string containing the output line without prefix
         */
@@ -283,7 +292,7 @@ class CoreExport Channel : public Extensible
        /** Write to all users on a channel except a list of users, using std::string for text
         * @param user User whos details to prefix the line with, and to omit from receipt of the message
         * @param serversource If this parameter is true, use the local server name as the source of the text, otherwise,
-        * use the nick!user@host of the user.
+        * use the nick!user\@host of the user.
         * @param status The status of the users to write to, e.g. '@' or '%'. Use a value of 0 to write to everyone
         * @param except_list A list of users NOT to send the text to
         * @param text A std::string containing the output line without prefix
@@ -362,8 +371,9 @@ class CoreExport Channel : public Extensible
         * @param user The user to associate the privilage with
         * @param prefix The prefix character to associate
         * @param adding True if adding the prefix, false when removing
+        * @return True if a change was made
         */
-       void SetPrefix(User* user, char prefix, bool adding);
+       bool SetPrefix(User* user, char prefix, bool adding);
 
        /** Check if a user is banned on this channel
         * @param user A user to check against the banlist