Tidy up source files:

[user/henk/code/inspircd.git] / include / xline.h

diff --git a/include/xline.h b/include/xline.h
index 1d458ae6811e044502c1e9af7283f697620d2fa5..119e29dc12930e7429804f11e81f61e6bdd48822 100644 (file)
--- a/include/xline.h
+++ b/include/xline.h
@@ -1,18 +1,26 @@
-/*       +------------------------------------+
- *       | Inspire Internet Relay Chat Daemon |
- *       +------------------------------------+
+/*
+ * InspIRCd -- Internet Relay Chat Daemon
  *
- *  InspIRCd: (C) 2002-2010 InspIRCd Development Team
- * See: http://wiki.inspircd.org/Credits
+ *   Copyright (C) 2009 Daniel De Graaf <danieldg@inspircd.org>
+ *   Copyright (C) 2004-2007 Craig Edwards <craigedwards@brainbox.cc>
+ *   Copyright (C) 2007 Robin Burchell <robin+git@viroteck.net>
+ *   Copyright (C) 2007 Dennis Friis <peavey@inspircd.org>
  *
- * 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 __XLINE_H
-#define __XLINE_H
+
+#pragma once
 
 /** XLine is the base class for ban lines such as G lines and K lines.
  * Modules may derive from this, and their xlines will automatically be
@@ -92,13 +100,13 @@ class CoreExport XLine : public classbase
         * line. Usually a line in the form 'expiring Xline blah, set by...'
         * see the DisplayExpiry methods of GLine, ELine etc.
         */
-       virtual void DisplayExpiry() = 0;
+       virtual void DisplayExpiry();
 
        /** Returns the displayable form of the pattern for this xline,
-        * e.g. '*@foo' or '*baz*'. This must always return the full pattern
+        * e.g. '*\@foo' or '*baz*'. This must always return the full pattern
         * in a form which can be used to construct an entire derived xline,
         * even if it is stored differently internally (e.g. GLine stores the
-        * ident and host parts seperately but will still return ident@host
+        * ident and host parts seperately but will still return ident\@host
         * for its Displayable() method)
         */
        virtual const char* Displayable() = 0;
@@ -168,8 +176,6 @@ class CoreExport KLine : public XLine
 
        virtual void Apply(User* u);
 
-       virtual void DisplayExpiry();
-
        virtual const char* Displayable();
 
        virtual bool IsBurstable();
@@ -216,8 +222,6 @@ class CoreExport GLine : public XLine
 
        virtual void Apply(User* u);
 
-       virtual void DisplayExpiry();
-
        virtual const char* Displayable();
 
        /** Ident mask (ident part only)
@@ -260,8 +264,6 @@ class CoreExport ELine : public XLine
 
        virtual void Unset();
 
-       virtual void DisplayExpiry();
-
        virtual void OnAdd();
 
        virtual const char* Displayable();
@@ -305,8 +307,6 @@ class CoreExport ZLine : public XLine
 
        virtual void Apply(User* u);
 
-       virtual void DisplayExpiry();
-
        virtual const char* Displayable();
 
        /** IP mask (no ident part)
@@ -342,8 +342,6 @@ class CoreExport QLine : public XLine
 
        virtual void Apply(User* u);
 
-       virtual void DisplayExpiry();
-
        virtual const char* Displayable();
 
        /** Nickname mask
@@ -367,7 +365,6 @@ class CoreExport XLineFactory
  public:
 
        /** Create an XLine factory
-        * @param Instance creator
         * @param t Type of XLine this factory generates
         */
        XLineFactory(const std::string &t) : type(t) { }
@@ -419,7 +416,6 @@ class CoreExport XLineManager
  public:
 
        /** Constructor
-        * @param Instance A pointer to the creator object
         */
        XLineManager();
 
@@ -439,7 +435,7 @@ class CoreExport XLineManager
        /** Get all lines of a certain type to an XLineLookup (std::map<std::string, XLine*>).
         * NOTE: When this function runs any expired items are removed from the list before it
         * is returned to the caller.
-        * @param The type to look up
+        * @param type The type to look up
         * @return A list of all XLines of the given type.
         */
        XLineLookup* GetAll(const std::string &type);
@@ -522,6 +518,7 @@ class CoreExport XLineManager
        /** Handle /STATS for a given type.
         * NOTE: Any items in the list for this particular line type which have expired
         * will be expired and removed before the list is displayed.
+        * @param type The type of stats to show
         * @param numeric The numeric to give to each result line
         * @param user The username making the query
         * @param results The string_list to receive the results
@@ -529,4 +526,3 @@ class CoreExport XLineManager
        void InvokeStats(const std::string &type, int numeric, User* user, string_list &results);
 };
 
-#endif