Documentation updates.

Webperl/AppUser.pm

@@ -57,7 +57,7 @@ use constant ADMIN_TYPE   => 3; # User type for admin users.
 # ============================================================================
 #  Constructor
 
-## @cmethod Webperl::AppUser new(%args)
+## @cmethod $ new(%args)
 # Create a new Webperl::AppUser object. This will create a Webperl::AppUser object that may be
 # passed to the Auth class to provide application-specific user handling.
 #

Webperl/Application.pm

@@ -67,7 +67,7 @@ BEGIN {
 # ============================================================================
 #  Constructor
 
-## @cmethod Webperl::Application new(%args)
+## @cmethod $ new(%args)
 # Create a new Webperl::Application object. This will create a Webperl::Application
 # object that can be used to generate the pages of a web application. Supported
 # arguments are:

Webperl/Auth.pm

@@ -39,7 +39,7 @@ use Webperl::AuthMethods;
 # ============================================================================
 #  Constructor
 
-## @cmethod Auth new(%args)
+## @cmethod $ new(%args)
 # Create a new Auth object. This will create an Auth object that may be (for example)
 # passed to SessionHandler to provide user authentication. The arguments to this
 # constructor may include:

Webperl/Block.pm

@@ -16,7 +16,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-## @class Block
+## @class
 # The Block class serves as the base class for all plugin block modules in
 # the system. It provides the basic constructor required to initialise a
 # plugin properly, stub functions for the two key content generation

Webperl/Logger.pm

@@ -17,7 +17,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-## @class Logger
+## @class
 # A class to handle logging operations throughout a system. This collects
 # together the various functions needed for displaying log messages and errors
 # at various levels of verbosity, in an attempt to cut down on duplicate

Webperl/MediaWiki/Simple.pm

@@ -15,7 +15,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-## @class MediaWiki::Simple
+## @class
 # This module is a simplified wrapper around MediaWiki::API, allowing access to a
 # subset of the MediaWiki API facilities through a simple interface. It should be
 # noted that this *not* intended as a replacement for more comprehensive higher-level

Webperl/Message.pm

@@ -16,10 +16,11 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-## @class Message
+## @class
 # This is the 'base' class for the Message modules. It provides any functionality
 # that needs to be shared between the Message::* modules.
 package Webperl::Message;
+
 use strict;
 use base qw(Webperl::SystemModule);
 use Webperl::Utils qw(hash_or_hashref);

Webperl/Message/Queue.pm

@@ -19,8 +19,6 @@
 ## @class
 # This class allows messages to be added to the message queue, or retrieved from
 # it in a format suitable for passing to Message::Sender.
-#
-#
 package Webperl::Message::Queue;
 
 use strict;

Webperl/SystemModule.pm

@@ -16,7 +16,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-## @class SystemModule
+## @class
 # This is a base class for system modules, providing common
 # features - primarily a simple base constructor and error functions.
 # Subclasses will generally only need to override the constructor, usually

Webperl/Template.pm

@@ -16,7 +16,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-## @class Template
+## @class
 # A simple Template class with internationalisation support. Note that
 # this class does not cache templates or any fancy stuff like that - it
 # just provides a simple interface to generate content based on