X-Git-Url: https://git.netwichtig.de/gitweb/?a=blobdiff_plain;f=include%2Fchannels.h;h=76b60466887fe0ab6ac1b686a2cc7a386d2b4e5c;hb=90639721625b5da867effc7dd4adec003c1bd3b4;hp=4c430af32afd8392a420d8bbb7f6b8d8b0f7ba8f;hpb=988568f3d1cc2247fa3adbadd8daa0ee175fcb1d;p=user%2Fhenk%2Fcode%2Finspircd.git

diff --git a/include/channels.h b/include/channels.h
index 4c430af32..76b604668 100644
--- a/include/channels.h
+++ b/include/channels.h
@@ -24,6 +24,8 @@
 #include <string>
 #include <map>
 
+/** RFC1459 channel modes
+ */
 enum ChannelModes {
 	CM_TOPICLOCK = 't'-65,
 	CM_NOEXTERNAL = 'n'-65,
@@ -51,25 +53,18 @@ class HostItem : public classbase
 	virtual ~HostItem() { /* stub */ }
 };
 
-// banlist is inherited from HostList mainly for readability
-// reasons only
-
 /** A subclass of HostItem designed to hold channel bans (+b)
  */
 class BanItem : public HostItem
 {
 };
 
-// same with this...
-
 /** A subclass of HostItem designed to hold channel exempts (+e)
  */
 class ExemptItem : public HostItem
 {
 };
 
-// and this...
-
 /** A subclass of HostItem designed to hold channel invites (+I)
  */
 class InviteItem : public HostItem
@@ -88,12 +83,15 @@ typedef std::vector<ExemptItem>	ExemptList;
  */
 typedef std::vector<InviteItem>	InviteList;
 
-class userrec;
-
 /** A list of users on a channel
  */
 typedef std::map<userrec*,userrec*> CUList;
 
+/** Shorthand for CUList::iterator
+ */
+typedef CUList::iterator CUListIter;
+typedef CUList::const_iterator CUListConstIter;
+
 /** A list of custom modes parameters on a channel
  */
 typedef std::map<char,char*> CustomModeList;
@@ -108,10 +106,13 @@ class chanrec : public Extensible
 	/** The channels name.
 	 */
 	char name[CHANMAX]; /* channel name */
-	/** Custom modes for the channel.
-	 * Plugins may use this field in any way they see fit.
+	/** Modes for the channel.
+	 * This is not a null terminated string! It is a hash where
+	 * each item in it represents if a mode is set. For example
+	 * for mode +A, index 0. Use modechar-65 to calculate which
+	 * field to check.
 	 */
-	char custom_modes[64];     /* modes handled by modules */
+	char modes[64];
 
 	/** User lists
 	 * There are four user lists, one for 
@@ -174,11 +175,11 @@ class chanrec : public Extensible
 	 */
 	void SetCustomModeParam(char mode,char* parameter,bool mode_on);
  
-	/** Returns true if a custom mode is set on a channel
+	/** Returns true if a mode is set on a channel
 	  * @param mode The mode character you wish to query
 	  * @return True if the custom mode is set, false if otherwise
 	  */
-	bool IsCustomModeSet(char mode);
+	bool IsModeSet(char mode);
 
 	/** Returns the parameter for a custom mode on a channel.
 	  * @param mode The mode character you wish to query
@@ -222,7 +223,7 @@ class chanrec : public Extensible
 	void DelHalfoppedUser(userrec* user);
 	void DelVoicedUser(userrec* user);
 
-	/** Obrain the internal reference list
+	/** Obtain the internal reference list
 	 * The internal reference list contains a list of userrec*.
 	 * These are used for rapid comparison to determine
 	 * channel membership for PRIVMSG, NOTICE, QUIT, PART etc.
@@ -236,12 +237,16 @@ class chanrec : public Extensible
 	CUList* GetHalfoppedUsers();
 	CUList* GetVoicedUsers();
 
+	/** Returns true if the user given is on the given channel.
+	 */
 	bool HasUser(userrec* user);
 
 	/** Creates a channel record and initialises it with default values
 	 */
 	chanrec();
 
+	/** Destructor for chanrec
+	 */
 	virtual ~chanrec() { /* stub */ }
 };
 
@@ -271,7 +276,12 @@ class ucrec : public classbase
 	 */
 	chanrec *channel;
 
+	/** Constructor for ucrec
+	 */
 	ucrec() : uc_modes(0), channel(NULL) { /* stub */ }
+
+	/** Destructor for ucrec
+	 */
 	virtual ~ucrec() { /* stub */ }
 };
 
@@ -281,4 +291,3 @@ void kick_channel(userrec *src,userrec *user, chanrec *Ptr, char* reason);
 void server_kick_channel(userrec* user, chanrec* Ptr, char* reason, bool triggerevents);
 
 #endif
-