Yet more doc tweaks:
authorNick Jenkins <nickj@users.mediawiki.org>
Fri, 20 Apr 2007 08:55:14 +0000 (08:55 +0000)
committerNick Jenkins <nickj@users.mediawiki.org>
Fri, 20 Apr 2007 08:55:14 +0000 (08:55 +0000)
* Add @addtogroup tags to various classes, to try and group conceptually-related classes together.
* Add brief descriptions to various Special pages, thanks to Phil Boswell.
* Moving some docs to be right above the classes they represent, so that they are picked up.

93 files changed:
includes/AjaxDispatcher.php
includes/AjaxFunctions.php
includes/AjaxResponse.php
includes/CacheDependency.php
includes/CoreParserFunctions.php
includes/Database.php
includes/DatabaseOracle.php
includes/DatabasePostgres.php
includes/Exception.php
includes/Export.php
includes/FileStore.php
includes/ImageQueryPage.php
includes/PageHistory.php
includes/PageQueryPage.php
includes/Pager.php
includes/Parser.php
includes/ParserCache.php
includes/ParserOptions.php
includes/ParserOutput.php
includes/Profiler.php
includes/ProfilerSimple.php
includes/ProfilerSimpleUDP.php
includes/QueryPage.php
includes/Sanitizer.php
includes/SearchEngine.php
includes/SearchMySQL.php
includes/SearchMySQL4.php
includes/SearchOracle.php
includes/SearchPostgres.php
includes/SearchUpdate.php
includes/SpecialAllpages.php
includes/SpecialAncientpages.php
includes/SpecialCategories.php
includes/SpecialConfirmemail.php
includes/SpecialFewestrevisions.php
includes/SpecialImagelist.php
includes/SpecialImport.php
includes/SpecialIpblocklist.php
includes/SpecialMostcategories.php
includes/SpecialMostimages.php
includes/SpecialMostlinked.php
includes/SpecialMostlinkedcategories.php
includes/SpecialNewpages.php
includes/SpecialPage.php
includes/SpecialPopularpages.php
includes/SpecialPrefixindex.php
includes/SpecialProtectedpages.php
includes/SpecialRandompage.php
includes/SpecialResetpass.php
includes/SpecialRevisiondelete.php
includes/SpecialSearch.php
includes/SpecialUncategorizedcategories.php
includes/SpecialUnusedimages.php
includes/SpecialUnusedtemplates.php
includes/SpecialUnwatchedpages.php
includes/SpecialUpload.php
includes/SpecialUploadMogile.php
includes/SpecialUserlogin.php
includes/SpecialWantedcategories.php
includes/SpecialWantedpages.php
includes/SpecialWhatlinkshere.php
includes/SpecialWithoutinterwiki.php
includes/User.php
includes/WikiError.php
includes/api/ApiBase.php
includes/api/ApiFeedWatchlist.php
includes/api/ApiFormatBase.php
includes/api/ApiFormatJson.php
includes/api/ApiFormatJson_json.php
includes/api/ApiFormatPhp.php
includes/api/ApiFormatWddx.php
includes/api/ApiFormatXml.php
includes/api/ApiFormatYaml.php
includes/api/ApiFormatYaml_spyc.php
includes/api/ApiHelp.php
includes/api/ApiLogin.php
includes/api/ApiMain.php
includes/api/ApiOpenSearch.php
includes/api/ApiPageSet.php
includes/api/ApiQuery.php
includes/api/ApiQueryAllpages.php
includes/api/ApiQueryBacklinks.php
includes/api/ApiQueryBase.php
includes/api/ApiQueryInfo.php
includes/api/ApiQueryLogEvents.php
includes/api/ApiQueryRecentChanges.php
includes/api/ApiQueryRevisions.php
includes/api/ApiQuerySiteinfo.php
includes/api/ApiQueryUserContributions.php
includes/api/ApiQueryWatchlist.php
includes/api/ApiResult.php
includes/memcached-client.php
includes/templates/Userlogin.php

index bb4709b..570931c 100644 (file)
@@ -11,6 +11,7 @@ require_once( 'AjaxFunctions.php' );
 
 /**
  * @todo Document - e.g. Provide top-level description of this class.
+ * @addtogroup Ajax
  */
 class AjaxDispatcher {
        var $mode;
index 5f906a3..98b674f 100644 (file)
@@ -1,5 +1,10 @@
 <?php
 
+/** 
+ * @package MediaWiki
+ * @addtogroup Ajax
+ */
+
 if( !defined( 'MEDIAWIKI' ) )
         die( 1 );
 
index a814e57..cb4af1b 100644 (file)
@@ -5,6 +5,7 @@ if( !defined( 'MEDIAWIKI' ) ) {
 
 /**
  * @todo document
+ * @addtogroup Ajax
  */
 class AjaxResponse {
        var $mCacheDuration;
index 5d849f5..bb5c543 100644 (file)
@@ -4,6 +4,7 @@
  * This class stores an arbitrary value along with its dependencies. 
  * Users should typically only use DependencyWrapper::getFromCache(), rather
  * than instantiating one of these objects directly.
+ * @addtogroup Cache
  */
 class DependencyWrapper {
        var $value;
@@ -95,6 +96,9 @@ class DependencyWrapper {
        }
 }
 
+/**
+ * @addtogroup Cache
+ */
 abstract class CacheDependency {
        /**
         * Returns true if the dependency is expired, false otherwise
@@ -107,6 +111,9 @@ abstract class CacheDependency {
        function loadDependencyValues() {}
 }
 
+/**
+ * @addtogroup Cache
+ */
 class FileDependency extends CacheDependency {
        var $filename, $timestamp;
 
@@ -163,6 +170,9 @@ class FileDependency extends CacheDependency {
        }
 }
 
+/**
+ * @addtogroup Cache
+ */
 class TitleDependency extends CacheDependency {
        var $titleObj;
        var $ns, $dbk;
@@ -219,6 +229,9 @@ class TitleDependency extends CacheDependency {
        }
 }
 
+/**
+ * @addtogroup Cache
+ */
 class TitleListDependency extends CacheDependency {
        var $linkBatch;
        var $timestamps;
@@ -299,6 +312,9 @@ class TitleListDependency extends CacheDependency {
        }
 }
 
+/**
+ * @addtogroup Cache
+ */
 class GlobalDependency extends CacheDependency {
        var $name, $value;
        
@@ -312,6 +328,9 @@ class GlobalDependency extends CacheDependency {
        }
 }
 
+/**
+ * @addtogroup Cache
+ */
 class ConstantDependency extends CacheDependency {
        var $name, $value;
 
index bb8a735..72ceb45 100644 (file)
@@ -2,8 +2,8 @@
 
 /**
  * Various core parser functions, registered in Parser::firstCallInit()
+ * @addtogroup Parser
  */
-
 class CoreParserFunctions {
        static function intFunction( $parser, $part1 = '' /*, ... */ ) {
                if ( strval( $part1 ) !== '' ) {
index 7d5ddfe..f2042c7 100644 (file)
@@ -17,6 +17,7 @@ define( 'DEADLOCK_DELAY_MAX', 1500000 );
 
 /**
  * Utility class.
+ * @addtogroup Database
  */
 class DBObject {
        public $mData;
@@ -36,6 +37,7 @@ class DBObject {
 
 /**
  * Utility class.
+ * @addtogroup Database
  */
 class MySQLField {
        private $name, $tablename, $default, $max_length, $nullable,
@@ -92,6 +94,7 @@ class MySQLField {
 
 /**
  * Database error base class
+ * @addtogroup Database
  */
 class DBError extends MWException {
        public $db;
@@ -107,6 +110,9 @@ class DBError extends MWException {
        }
 }
 
+/**
+ * @addtogroup Database
+ */
 class DBConnectionError extends DBError {
        public $error;
        
@@ -224,6 +230,9 @@ border=\"0\" ALT=\"Google\"></A>
        }
 }
 
+/**
+ * @addtogroup Database
+ */
 class DBQueryError extends DBError {
        public $error, $errno, $sql, $fname;
        
@@ -277,12 +286,16 @@ class DBQueryError extends DBError {
        }
 }
 
+/**
+ * @addtogroup Database
+ */
 class DBUnexpectedError extends DBError {}
 
 /******************************************************************************/
 
 /**
  * Database abstraction object
+ * @addtogroup Database
  */
 class Database {
 
@@ -2181,6 +2194,7 @@ class Database {
  * Database abstraction object for mySQL
  * Inherit all methods and properties of Database::Database()
  *
+ * @addtogroup Database
  * @see Database
  */
 class DatabaseMysql extends Database {
@@ -2190,7 +2204,7 @@ class DatabaseMysql extends Database {
 
 /**
  * Result wrapper for grabbing data queried by someone else
- *
+ * @addtogroup Database
  */
 class ResultWrapper {
        var $db, $result;
index 9c6bb71..2b720df 100644 (file)
@@ -2,6 +2,7 @@
 
 /**
  * This is the Oracle database abstraction layer.
+ * @addtogroup Database
  */
 class ORABlob {
        var $mData;
@@ -19,6 +20,7 @@ class ORABlob {
  * The oci8 extension is fairly weak and doesn't support oci_num_rows, among 
  * other things.  We use a wrapper class to handle that and other 
  * Oracle-specific bits, like converting column names back to lowercase.
+ * @addtogroup Database
  */
 class ORAResult {
        private $rows;
@@ -82,8 +84,11 @@ class ORAResult {
                }
                return $ret;
        }
-};
+}
 
+/**
+ * @addtogroup Database
+ */
 class DatabaseOracle extends Database {
        var $mInsertId = NULL;
        var $mLastResult = NULL;
@@ -384,7 +389,7 @@ class DatabaseOracle extends Database {
        }
 
        /**
-        * ORacle does not have a "USE INDEX" clause, so return an empty string
+        * Oracle does not have a "USE INDEX" clause, so return an empty string
         */
        function useIndexClause($index) {
                return '';
index f2b982d..7158e2d 100644 (file)
@@ -7,8 +7,8 @@
  * than MySQL ones, some of them should be moved to parent
  * Database class.
  *
+ * @addtogroup Database
  */
-
 class PostgresField {
        private $name, $tablename, $type, $nullable, $max_length;
 
@@ -63,6 +63,9 @@ END;
        }
 }
 
+/**
+ * @addtogroup Database
+ */
 class DatabasePostgres extends Database {
        var $mInsertId = NULL;
        var $mLastResult = NULL;
index ad7ec14..81cf12f 100644 (file)
@@ -1,5 +1,8 @@
 <?php
 
+/**
+ * @addtogroup Exception
+ */
 class MWException extends Exception
 {
        function useOutputPage() {
@@ -125,6 +128,7 @@ class MWException extends Exception
 /**
  * Exception class which takes an HTML error message, and does not
  * produce a backtrace. Replacement for OutputPage::fatalError().
+ * @addtogroup Exception
  */
 class FatalError extends MWException {
        function getHTML() {
@@ -136,6 +140,9 @@ class FatalError extends MWException {
        }
 }
 
+/**
+ * @addtogroup Exception
+ */
 class ErrorPageError extends MWException {
        public $title, $msg;
        
index 1582d0d..9307795 100644 (file)
@@ -281,6 +281,9 @@ class WikiExporter {
        }
 }
 
+/**
+ * @addtogroup Dump
+ */
 class XmlDumpWriter {
 
        /**
@@ -463,6 +466,7 @@ class XmlDumpWriter {
 
 /**
  * Base class for output stream; prints to stdout or buffer or whereever.
+ * @addtogroup Dump
  */
 class DumpOutput {
        function writeOpenStream( $string ) {
@@ -496,6 +500,7 @@ class DumpOutput {
 
 /**
  * Stream outputter to send data to a file.
+ * @addtogroup Dump
  */
 class DumpFileOutput extends DumpOutput {
        var $handle;
@@ -513,6 +518,7 @@ class DumpFileOutput extends DumpOutput {
  * Stream outputter to send data to a file via some filter program.
  * Even if compression is available in a library, using a separate
  * program can allow us to make use of a multi-processor system.
+ * @addtogroup Dump
  */
 class DumpPipeOutput extends DumpFileOutput {
        function DumpPipeOutput( $command, $file = null ) {
@@ -525,6 +531,7 @@ class DumpPipeOutput extends DumpFileOutput {
 
 /**
  * Sends dump output via the gzip compressor.
+ * @addtogroup Dump
  */
 class DumpGZipOutput extends DumpPipeOutput {
        function DumpGZipOutput( $file ) {
@@ -534,6 +541,7 @@ class DumpGZipOutput extends DumpPipeOutput {
 
 /**
  * Sends dump output via the bgzip2 compressor.
+ * @addtogroup Dump
  */
 class DumpBZip2Output extends DumpPipeOutput {
        function DumpBZip2Output( $file ) {
@@ -543,6 +551,7 @@ class DumpBZip2Output extends DumpPipeOutput {
 
 /**
  * Sends dump output via the p7zip compressor.
+ * @addtogroup Dump
  */
 class Dump7ZipOutput extends DumpPipeOutput {
        function Dump7ZipOutput( $file ) {
@@ -560,6 +569,7 @@ class Dump7ZipOutput extends DumpPipeOutput {
  * Dump output filter class.
  * This just does output filtering and streaming; XML formatting is done
  * higher up, so be careful in what you do.
+ * @addtogroup Dump
  */
 class DumpFilter {
        function DumpFilter( &$sink ) {
@@ -605,6 +615,7 @@ class DumpFilter {
 
 /**
  * Simple dump output filter to exclude all talk pages.
+ * @addtogroup Dump
  */
 class DumpNotalkFilter extends DumpFilter {
        function pass( $page ) {
@@ -614,6 +625,7 @@ class DumpNotalkFilter extends DumpFilter {
 
 /**
  * Dump output filter to include or exclude pages in a given set of namespaces.
+ * @addtogroup Dump
  */
 class DumpNamespaceFilter extends DumpFilter {
        var $invert = false;
@@ -668,6 +680,7 @@ class DumpNamespaceFilter extends DumpFilter {
 
 /**
  * Dump output filter to include only the last revision in each page sequence.
+ * @addtogroup Dump
  */
 class DumpLatestFilter extends DumpFilter {
        var $page, $pageString, $rev, $revString;
@@ -699,6 +712,7 @@ class DumpLatestFilter extends DumpFilter {
 
 /**
  * Base class for output stream; prints to stdout or buffer or whereever.
+ * @addtogroup Dump
  */
 class DumpMultiWriter {
        function DumpMultiWriter( $sinks ) {
index e901703..dcec71c 100644 (file)
@@ -371,6 +371,9 @@ class FSTransaction {
        }
 }
 
+/**
+ * @addtogroup Exception
+ */
 class FSException extends MWException { }
 
 ?>
index 65a50a4..c49b487 100644 (file)
@@ -5,6 +5,7 @@
  * suited for reports generating images
  *
  * @package MediaWiki
+ * @addtogroup SpecialPage
  * @author Rob Church <robchur@gmail.com>
  */
 class ImageQueryPage extends QueryPage {
@@ -63,4 +64,4 @@ class ImageQueryPage extends QueryPage {
 
 }
 
-?>
\ No newline at end of file
+?>
index 938eed0..b1cf41f 100644 (file)
@@ -14,7 +14,6 @@
  * history.
  *
  */
-
 class PageHistory {
        const DIR_PREV = 0;
        const DIR_NEXT = 1;
@@ -523,6 +522,9 @@ class PageHistory {
 }
 
 
+/**
+ * @addtogroup Pager
+ */
 class PageHistoryPager extends ReverseChronologicalPager {
        public $mLastRow = false, $mPageHistory;
        
index 17ed57f..5b82ebf 100644 (file)
@@ -4,6 +4,7 @@
  * Variant of QueryPage which formats the result as a simple link to the page
  *
  * @package MediaWiki
+ * @addtogroup SpecialPage
  */
 class PageQueryPage extends QueryPage {
 
@@ -22,4 +23,4 @@ class PageQueryPage extends QueryPage {
        }
 }
 
-?>
\ No newline at end of file
+?>
index c135e21..9c2b083 100644 (file)
@@ -2,6 +2,7 @@
 
 /**
  * Basic pager interface.
+ * @addtogroup Pager
  */
 interface Pager {
        function getNavigationBar();
@@ -46,6 +47,8 @@ interface Pager {
  *  please see the examples in PageHistory.php and SpecialIpblocklist.php. You just need 
  *  to override formatRow(), getQueryInfo() and getIndexField(). Don't forget to call the 
  *  parent constructor if you override it.
+ *
+ * @addtogroup Pager
  */
 abstract class IndexPager implements Pager {
        public $mRequest;
@@ -389,7 +392,8 @@ abstract class IndexPager implements Pager {
 
 /**
  * IndexPager with an alphabetic list and a formatted navigation bar
-*/
+ * @addtogroup Pager
+ */
 abstract class AlphabeticPager extends IndexPager {
        public $mDefaultDirection = false;
        
@@ -423,6 +427,7 @@ abstract class AlphabeticPager extends IndexPager {
 
 /**
  * IndexPager with a formatted navigation bar
+ * @addtogroup Pager
  */
 abstract class ReverseChronologicalPager extends IndexPager {
        public $mDefaultDirection = true;
@@ -455,6 +460,7 @@ abstract class ReverseChronologicalPager extends IndexPager {
 
 /**
  * Table-based display with a user-selectable sort order
+ * @addtogroup Pager
  */
 abstract class TablePager extends IndexPager {
        var $mSort;
index efaf303..89ab091 100644 (file)
@@ -86,6 +86,7 @@ define( 'MW_COLON_STATE_COMMENTDASHDASH', 7 );
  *  * only within ParserOptions
  * </pre>
  *
+ * @addtogroup Parser
  */
 class Parser
 {
@@ -4721,6 +4722,7 @@ class Parser
 
 /**
  * @todo document, briefly.
+ * @addtogroup Parser
  */
 class OnlyIncludeReplacer {
        var $output = '';
@@ -4736,6 +4738,7 @@ class OnlyIncludeReplacer {
 
 /**
  * @todo document, briefly.
+ * @addtogroup Parser
  */
 class StripState {
        var $general, $nowiki;
index 752aa54..ad95979 100644 (file)
@@ -2,9 +2,6 @@
 /**
  *
  * @addtogroup Cache
- */
-
-/**
  * @todo document
  */
 class ParserCache {
index f165343..e335720 100644 (file)
@@ -3,6 +3,7 @@
 /**
  * Set options of the Parser
  * @todo document
+ * @addtogroup Parser
  */
 class ParserOptions
 {
index fa2c1b6..03f1819 100644 (file)
@@ -1,6 +1,7 @@
 <?php
 /**
  * @todo document
+ * @addtogroup Parser
  */
 class ParserOutput
 {
index 8307690..da3a82e 100644 (file)
@@ -40,6 +40,7 @@ if (!function_exists('memory_get_usage')) {
 
 /**
  * @todo document
+ * @addtogroup Profiler
  */
 class Profiler {
        var $mStack = array (), $mWorkStack = array (), $mCollated = array ();
index a52af25..f43c7df 100644 (file)
@@ -5,6 +5,7 @@ require_once(dirname(__FILE__).'/Profiler.php');
 /**
  * Simple profiler base class.
  * @todo document methods (?)
+ * @addtogroup Profiler
  */
 class ProfilerSimple extends Profiler {
        var $mMinimumTime = 0;
index a8ca97f..500f1cb 100644 (file)
@@ -6,6 +6,7 @@ require_once(dirname(__FILE__).'/ProfilerSimple.php');
 /**
  * ProfilerSimpleUDP class, that sends out messages for 'udpprofile' daemon
  * (the one from mediawiki/trunk/udpprofile SVN )
+ * @addtogroup Profiler
  */
 class ProfilerSimpleUDP extends ProfilerSimple {
        function getFunctionReport() {
index 27c6927..143c8be 100644 (file)
@@ -52,7 +52,7 @@ if ( !$wgDisableCounters )
  * This is a class for doing query pages; since they're almost all the same,
  * we factor out some of the functionality into a superclass, and let
  * subclasses derive from it.
- *
+ * @addtogroup SpecialPage
  */
 class QueryPage {
        /**
@@ -525,4 +525,4 @@ class QueryPage {
        }
 }
 
-?>
\ No newline at end of file
+?>
index 96f89dc..ebb0dcc 100644 (file)
@@ -315,6 +315,10 @@ $wgHtmlEntities = array(
        'zwj'      => 8205,
        'zwnj'     => 8204 );
 
+/**
+ * XHTML sanitizer for MediaWiki
+ * @addtogroup Parser
+ */
 class Sanitizer {
        /**
         * Cleans up HTML, removes dangerous tags and attributes, and
index dc10279..2ef5914 100644 (file)
@@ -3,9 +3,6 @@
  * Contain a class for special pages
  * @addtogroup Search
  */
-
-/**
- */
 class SearchEngine {
        var $limit = 10;
        var $offset = 0;
@@ -236,6 +233,10 @@ class SearchEngine {
     }
 }
 
+
+/**
+ * @addtogroup Search
+ */
 class SearchResultSet {
        /**
         * Fetch an array of regular expression fragments for matching
@@ -310,6 +311,10 @@ class SearchResultSet {
        }
 }
 
+
+/**
+ * @addtogroup Search
+ */
 class SearchResult {
        function SearchResult( $row ) {
                $this->mTitle = Title::makeTitle( $row->page_namespace, $row->page_title );
@@ -332,6 +337,7 @@ class SearchResult {
 }
 
 /**
+ * @addtogroup Search
  */
 class SearchEngineDummy {
        function search( $term ) {
index 87878b6..0e02a68 100644 (file)
@@ -22,7 +22,6 @@
  * Specific bits for MySQL 3 and 4 variants are in child classes.
  * @addtogroup Search
  */
-
 class SearchMySQL extends SearchEngine {
        /**
         * Perform a full text search query and return a result set.
@@ -176,6 +175,9 @@ class SearchMySQL extends SearchEngine {
        }
 }
 
+/**
+ * @addtogroup Search
+ */
 class MySQLSearchResultSet extends SearchResultSet {
        function MySQLSearchResultSet( $resultSet, $terms ) {
                $this->mResultSet = $resultSet;
index dbd88ec..97ce385 100644 (file)
  * Search engine hook for MySQL 4+
  * @addtogroup Search
  */
-
-/**
- * @addtogroup Search
- */
 class SearchMySQL4 extends SearchMySQL {
        var $strictMatching = true;
 
index 8f13729..c9a675e 100644 (file)
@@ -21,7 +21,6 @@
  * Search engine hook base class for Oracle (ConText).
  * @addtogroup Search
  */
-
 class SearchOracle extends SearchEngine {
        function __construct($db) {
                $this->db = $db;
@@ -208,6 +207,9 @@ class SearchOracle extends SearchEngine {
        }
 }
 
+/**
+ * @addtogroup Search
+ */
 class OracleSearchResultSet extends SearchResultSet {
        function __construct($resultSet, $terms) {
                $this->mResultSet = $resultSet;
index 390fcd1..421d966 100644 (file)
@@ -21,7 +21,6 @@
  * Search engine hook base class for Postgres
  * @addtogroup Search
  */
-
 class SearchPostgres extends SearchEngine {
 
        function SearchPostgres( $db ) {
@@ -182,7 +181,9 @@ class SearchPostgres extends SearchEngine {
 
 } ## end of the SearchPostgres class
 
-
+/**
+ * @addtogroup Search
+ */
 class PostgresSearchResult extends SearchResult {
        function PostgresSearchResult( $row ) {
                $this->mTitle = Title::makeTitle( $row->page_namespace, $row->page_title );
@@ -193,6 +194,9 @@ class PostgresSearchResult extends SearchResult {
        }
 }
 
+/**
+ * @addtogroup Search
+ */
 class PostgresSearchResultSet extends SearchResultSet {
        function PostgresSearchResultSet( $resultSet, $terms ) {
                $this->mResultSet = $resultSet;
index e79c1d0..724197c 100644 (file)
@@ -1,10 +1,7 @@
 <?php
 /**
  * See deferred.txt
- */
-
-/**
- *
+ * @addtogroup Search
  */
 class SearchUpdate {
 
@@ -109,6 +106,7 @@ class SearchUpdate {
 
 /**
  * Placeholder class
+ * @addtogroup Search
  */
 class SearchUpdateMyISAM extends SearchUpdate {
        # Inherits everything
index 9b89145..03e164b 100644 (file)
@@ -36,6 +36,10 @@ function wfSpecialAllpages( $par=NULL, $specialPage ) {
        }
 }
 
+/**
+ * Implements Special:Allpages
+ * @addtogroup SpecialPage
+ */
 class SpecialAllpages {
        var $maxPerPage=960;
        var $topLevelMax=50;
index 4b52b6a..c0bbb7b 100644 (file)
@@ -5,7 +5,7 @@
  */
 
 /**
- * @todo document, briefly.
+ * Implements Special:Ancientpages
  * @addtogroup SpecialPage
  */
 class AncientPagesPage extends QueryPage {
index 1cebdcc..45e1ae6 100644 (file)
@@ -16,6 +16,10 @@ function wfSpecialCategories() {
                );
 }
 
+/**
+ * @addtogroup SpecialPage
+ * @addtogroup Pager
+ */
 class CategoryPager extends AlphabeticPager {
        function getQueryInfo() {
                return array(
index e1feb8a..58e5589 100644 (file)
@@ -1,13 +1,5 @@
 <?php
 
-/**
- * Special page allows users to request email confirmation message, and handles
- * processing of the confirmation code when the link in the email is followed
- *
- * @addtogroup SpecialPage
- * @author Rob Church <robchur@gmail.com>
- */
 /**
  * Main execution point
  *
@@ -18,6 +10,13 @@ function wfSpecialConfirmemail( $par ) {
        $form->execute( $par );
 }
 
+/**
+ * Special page allows users to request email confirmation message, and handles
+ * processing of the confirmation code when the link in the email is followed
+ *
+ * @addtogroup SpecialPage
+ * @author Rob Church <robchur@gmail.com>
+ */
 class EmailConfirmation extends SpecialPage {
        
        /**
index 160f371..849438f 100644 (file)
@@ -1,14 +1,12 @@
 <?php
 
 /**
- *
  * Special page for listing the articles with the fewest revisions.  
  * 
  * @package MediaWiki
- * @subpackage Special pages
+ * @addtogroup SpecialPage
  * @author Martin Drashkov 
  */
-
 class FewestrevisionsPage extends QueryPage {
 
        function getName() {
@@ -64,4 +62,4 @@ function wfSpecialFewestrevisions() {
        $frp->doQuery( $offset, $limit );
 }
 
-?>
\ No newline at end of file
+?>
index 390fb54..92b9ae1 100644 (file)
@@ -23,6 +23,10 @@ function wfSpecialImagelist() {
                . $nav );
 }
 
+/**
+ * @addtogroup SpecialPage
+ * @addtogroup Pager
+ */
 class ImageListPager extends TablePager {
        var $mFieldNames = null;
        var $mMessages = array();
index b6d4b0d..22c3537 100644 (file)
@@ -160,6 +160,7 @@ function wfSpecialImport( $page = '' ) {
 
 /**
  * Reporting callback
+ * @addtogroup SpecialPage
  */
 class ImportReporter {
        function __construct( $importer, $upload, $interwiki ) {
@@ -383,7 +384,7 @@ class WikiRevision {
 }
 
 /**
- *
+ * implements Special:Import
  * @addtogroup SpecialPage
  */
 class WikiImporter {
@@ -792,6 +793,7 @@ class WikiImporter {
 
 /**
  * @todo document (e.g. one-sentence class description).
+ * @addtogroup SpecialPage
  */
 class ImportStringSource {
        function ImportStringSource( $string ) {
@@ -815,6 +817,7 @@ class ImportStringSource {
 
 /**
  * @todo document (e.g. one-sentence class description).
+ * @addtogroup SpecialPage
  */
 class ImportStreamSource {
        function ImportStreamSource( $handle ) {
index e5c285c..8cb5729 100644 (file)
@@ -45,7 +45,7 @@ function wfSpecialIpblocklist() {
 }
 
 /**
- * @todo document
+ * implements Special:ipblocklist GUI
  * @addtogroup SpecialPage
  */
 class IPUnblockForm {
@@ -321,6 +321,7 @@ class IPUnblockForm {
 
 /**
  * @todo document
+ * @addtogroup Pager
  */
 class IPBlocklistPager extends ReverseChronologicalPager {
        public $mForm, $mConds;
index e761942..df2b9ad 100644 (file)
@@ -8,6 +8,7 @@
  */
 
 /**
+ * implements Special:Mostcategories
  * @addtogroup SpecialPage
  */
 class MostcategoriesPage extends QueryPage {
index 6b01d7d..9d16f38 100644 (file)
@@ -8,6 +8,7 @@
  */
 
 /**
+ * implements Special:Mostimages
  * @addtogroup SpecialPage
  */
 class MostimagesPage extends ImageQueryPage {
index 2ba9015..ab089cf 100644 (file)
@@ -1,7 +1,8 @@
 <?php
 
 /**
- * A special page to show pages ordered by the number of pages linking to them
+ * A special page to show pages ordered by the number of pages linking to them.
+ * Implements Special:Mostlinked
  *
  * @addtogroup SpecialPage
  *
  * @copyright Â© 2006 Rob Church
  * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later
  */
-
-/**
- * @addtogroup SpecialPage
- */
 class MostlinkedPage extends QueryPage {
 
        function getName() { return 'Mostlinked'; }
index 536a48a..725e5b3 100644 (file)
@@ -8,10 +8,6 @@
  * @copyright Copyright Â© 2005, Ã†var Arnfjörð Bjarmason
  * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later
  */
-
-/**
- * @addtogroup SpecialPage
- */
 class MostlinkedCategoriesPage extends QueryPage {
 
        function getName() { return 'Mostlinkedcategories'; }
index f20f9df..48037a7 100644 (file)
@@ -5,7 +5,7 @@
  */
 
 /**
- *
+ * implements Special:Newpages
  * @addtogroup SpecialPage
  */
 class NewPagesPage extends QueryPage {
index 4bcdf8a..faf4517 100644 (file)
@@ -26,7 +26,8 @@
 
 /**
  * Parent special page class, also static functions for handling the special
- * page list
+ * page list.
+ * @addtogroup SpecialPage
  */
 class SpecialPage
 {
@@ -692,6 +693,7 @@ class SpecialPage
 
 /**
  * Shortcut to construct a special page which is unlisted by default
+ * @addtogroup SpecialPage
  */
 class UnlistedSpecialPage extends SpecialPage
 {
@@ -702,6 +704,7 @@ class UnlistedSpecialPage extends SpecialPage
 
 /**
  * Shortcut to construct an includable special  page
+ * @addtogroup SpecialPage
  */
 class IncludableSpecialPage extends SpecialPage
 {
@@ -710,6 +713,9 @@ class IncludableSpecialPage extends SpecialPage
        }
 }
 
+/**
+ * @addtogroup SpecialPage
+ */
 class SpecialRedirectToSpecial extends UnlistedSpecialPage {
        var $redirName, $redirSubpage;
 
@@ -729,6 +735,9 @@ class SpecialRedirectToSpecial extends UnlistedSpecialPage {
        }
 }
 
+/**
+ * @addtogroup SpecialPage
+ */
 class SpecialMypage extends UnlistedSpecialPage {
        function __construct() {
                parent::__construct( 'Mypage' );
@@ -745,6 +754,9 @@ class SpecialMypage extends UnlistedSpecialPage {
        }
 }
 
+/**
+ * @addtogroup SpecialPage
+ */
 class SpecialMytalk extends UnlistedSpecialPage {
        function __construct() {
                parent::__construct( 'Mytalk' );
@@ -761,6 +773,9 @@ class SpecialMytalk extends UnlistedSpecialPage {
        }
 }
 
+/**
+ * @addtogroup SpecialPage
+ */
 class SpecialMycontributions extends UnlistedSpecialPage {
        function __construct() {
                parent::__construct(  'Mycontributions' );
index e0e4a47..d5d6aee 100644 (file)
@@ -5,7 +5,7 @@
  */
 
 /**
- *
+ * implements Special:Popularpages
  * @addtogroup SpecialPage
  */
 class PopularPagesPage extends QueryPage {
index fc14d7a..b7c51d4 100644 (file)
@@ -41,6 +41,10 @@ function wfSpecialPrefixIndex( $par=NULL, $specialPage ) {
        }
 }
 
+/**
+ * implements Special:Prefixindex 
+ * @addtogroup SpecialPage
+ */
 class SpecialPrefixindex extends SpecialAllpages {
        var $maxPerPage=960;
        var $topLevelMax=50;
index b214822..91b138f 100644 (file)
@@ -186,6 +186,7 @@ class ProtectedPagesForm {
 
 /**
  * @todo document
+ * @addtogroup Pager
  */
 class ProtectedPagesPager extends ReverseChronologicalPager {
        public $mForm, $mConds;
index bf39ca6..e6c4abe 100644 (file)
@@ -31,6 +31,11 @@ function wfSpecialRandompage( $par = null ) {
 }
 
 
+/**
+ * Special page to direct the user to a random page
+ *
+ * @addtogroup SpecialPage
+ */
 class RandomPage {
        private $namespace = NS_MAIN;  // namespace to select pages from
        private $redirect = false;     // select redirects instead of normal pages?
index e16a2fb..3ae79f8 100644 (file)
@@ -5,6 +5,9 @@ function wfSpecialResetpass( $par ) {
        $form->execute( $par );
 }
 
+/**
+ * @addtogroup SpecialPage
+ */
 class PasswordResetForm extends SpecialPage {
        function __construct( $name=null, $reset=null ) {
                if( $name !== null ) {
index fb5e9ec..5c70d5a 100644 (file)
@@ -35,6 +35,10 @@ function wfSpecialRevisiondelete( $par = null ) {
        }
 }
 
+/**
+ * Implements the GUI for Revision Deletion.
+ * @addtogroup SpecialPage
+ */
 class RevisionDeleteForm {
        /**
         * @param Title $page
@@ -170,7 +174,10 @@ class RevisionDeleteForm {
        }
 }
 
-
+/**
+ * Implements the actions for Revision Deletion.
+ * @addtogroup SpecialPage
+ */
 class RevisionDeleter {
        function __construct( $db ) {
                $this->db = $db;
index e96c875..fdaa854 100644 (file)
@@ -42,7 +42,7 @@ function wfSpecialSearch( $par = '' ) {
 }
 
 /**
- * @todo document
+ * implements Special:Search - Run text & title search and display the output
  * @addtogroup SpecialPage
  */
 class SpecialSearch {
index 4d4941f..e02c9bb 100644 (file)
@@ -10,7 +10,7 @@
 require_once( "SpecialUncategorizedpages.php" );
 
 /**
- *
+ * implements Special:Uncategorizedcategories
  * @addtogroup SpecialPage
  */
 class UncategorizedCategoriesPage extends UncategorizedPagesPage {
index b4fb403..6b99192 100644 (file)
@@ -5,6 +5,7 @@
  */
 
 /**
+ * implements Special:Unusedimages
  * @addtogroup SpecialPage
  */
 class UnusedimagesPage extends ImageQueryPage {
index 033066d..8b72e8a 100644 (file)
@@ -1,6 +1,7 @@
 <?php
 
 /**
+ * implements Special:Unusedtemplates
  * @author Rob Church <robchur@gmail.com>
  * @copyright Â© 2006 Rob Church
  * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later
index 6d067f3..fed0b59 100644 (file)
@@ -1,17 +1,13 @@
 <?php
 /**
- * A special page that displays a list of pages that are not on anyones watchlist
+ * A special page that displays a list of pages that are not on anyones watchlist.
+ * Implements Special:Unwatchedpages
  *
  * @addtogroup SpecialPage
- *
  * @author Ã†var Arnfjörð Bjarmason <avarab@gmail.com>
  * @copyright Copyright Â© 2005, Ã†var Arnfjörð Bjarmason
  * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later
  */
-
-/**
- * @addtogroup SpecialPage
- */
 class UnwatchedpagesPage extends QueryPage {
 
        function getName() { return 'Unwatchedpages'; }
index af4070a..2d6e6ba 100644 (file)
@@ -15,7 +15,7 @@ function wfSpecialUpload() {
 }
 
 /**
- *
+ * implements Special:Upload
  * @addtogroup SpecialPage
  */
 class UploadForm {
index fb4ae53..9450d22 100644 (file)
@@ -18,6 +18,9 @@ function wfSpecialUploadMogile() {
        $form->execute();
 }
 
+/**
+ * @addtogroup SpecialPage
+ */
 class UploadFormMogile extends UploadForm {
        /**
         * Move the uploaded file from its temporary location to the final
index a5f2521..ff3abc5 100644 (file)
@@ -19,10 +19,9 @@ function wfSpecialUserlogin() {
 }
 
 /**
- * @todo document, briefly.
+ * implements Special:Login
  * @addtogroup SpecialPage
  */
-
 class LoginForm {
 
        const SUCCESS = 0;
index eab44d6..27a9f17 100644 (file)
@@ -1,6 +1,6 @@
 <?php
 /**
- * A querypage to list the most wanted categories
+ * A querypage to list the most wanted categories - implements Special:Wantedcategories
  *
  * @addtogroup SpecialPage
  *
@@ -8,10 +8,6 @@
  * @copyright Copyright Â© 2005, Ã†var Arnfjörð Bjarmason
  * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later
  */
-
-/**
- * @addtogroup SpecialPage
- */
 class WantedCategoriesPage extends QueryPage {
 
        function getName() { return 'Wantedcategories'; }
index 06e959e..8b70020 100644 (file)
@@ -5,7 +5,7 @@
  */
 
 /**
- *
+ * implements Special:Wantedpages
  * @addtogroup SpecialPage
  */
 class WantedPagesPage extends QueryPage {
index f077cca..dff036a 100644 (file)
@@ -14,6 +14,10 @@ function wfSpecialWhatlinkshere($par = NULL) {
        $page->execute();
 }
 
+/**
+ * implements Special:Whatlinkshere
+ * @addtogroup SpecialPage
+ */
 class WhatLinksHerePage {
        var $request, $par;
        var $limit, $from, $back, $target, $namespace;
index 1567b29..e5341d5 100644 (file)
@@ -4,6 +4,7 @@
  * Special page lists pages without language links
  *
  * @package MediaWiki
+ * @addtogroup SpecialPage
  * @author Rob Church <robchur@gmail.com>
  */
 class WithoutInterwikiPage extends PageQueryPage {
@@ -52,4 +53,4 @@ function wfSpecialWithoutinterwiki() {
        $wip->doQuery( $offset, $limit );
 }
 
-?>
\ No newline at end of file
+?>
index 56d4ccc..d0c2db6 100644 (file)
@@ -17,6 +17,7 @@ define( 'EDIT_TOKEN_SUFFIX', '\\' );
 
 /**
  * Thrown by User::setPassword() on error
+ * @addtogroup Exception
  */
 class PasswordError extends MWException {
        // NOP
index 1b3f7f0..064db61 100644 (file)
@@ -24,6 +24,7 @@
 /**
  * Since PHP4 doesn't have exceptions, here's some error objects
  * loosely modeled on the standard PEAR_Error model...
+ * @addtogroup Exception
  */
 class WikiError {
        /**
@@ -64,6 +65,7 @@ class WikiError {
 
 /**
  * Localized error message object
+ * @addtogroup Exception
  */
 class WikiErrorMsg extends WikiError {
        /**
@@ -79,6 +81,7 @@ class WikiErrorMsg extends WikiError {
 
 /**
  * @todo document
+ * @addtogroup Exception
  */
 class WikiXmlError extends WikiError {
        /**
index a29e336..a8b1939 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 5, 2006
  *
@@ -26,6 +25,7 @@
 
 /**
  * @todo Document - e.g. Provide top-level description of this class.
+ * @addtogroup API
  */
 abstract class ApiBase {
 
@@ -533,4 +533,4 @@ abstract class ApiBase {
                return __CLASS__ . ': $Id$';
        }
 }
-?>
\ No newline at end of file
+?>
index 335df32..97d1f79 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Oct 13, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ("ApiBase.php");
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiFeedWatchlist extends ApiBase {
 
        public function __construct($main, $action) {
index 1ed71a6..0824338 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 19, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 abstract class ApiFormatBase extends ApiBase {
 
        private $mIsHtml, $mFormat;
@@ -176,6 +178,7 @@ for more information.
 
 /**
  * This printer is used to wrap an instance of the Feed class 
+ * @addtogroup API
  */
 class ApiFormatFeedWrapper extends ApiFormatBase {
 
index 06dc99b..99979d2 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 19, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiFormatBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiFormatJson extends ApiFormatBase {
 
        private $mIsRaw;
@@ -66,4 +68,4 @@ class ApiFormatJson extends ApiFormatBase {
                return __CLASS__ . ': $Id$';
        }
 }
-?>
\ No newline at end of file
+?>
index c15cdd8..2cd8793 100644 (file)
@@ -45,7 +45,7 @@
 * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
 * DAMAGE.
 *
-* @addtogroup     Services_JSON
+* @addtogroup  API
 * @author      Michal Migurski <mike-json@teczno.com>
 * @author      Matt Knapp <mdknapp[at]gmail[dot]com>
 * @author      Brett Stimmerman <brettstimmerman[at]gmail[dot]com>
@@ -91,26 +91,28 @@ define('SERVICES_JSON_LOOSE_TYPE', 16);
 define('SERVICES_JSON_SUPPRESS_ERRORS', 32);
 
 /**
-* Converts to and from JSON format.
-*
-* Brief example of use:
-*
-* <code>
-* // create a new instance of Services_JSON
-* $json = new Services_JSON();
-*
-* // convert a complexe value to JSON notation, and send it to the browser
-* $value = array('foo', 'bar', array(1, 2, 'baz'), array(3, array(4)));
-* $output = $json->encode($value);
-*
-* print($output);
-* // prints: ["foo","bar",[1,2,"baz"],[3,[4]]]
-*
-* // accept incoming POST data, assumed to be in JSON notation
-* $input = file_get_contents('php://input', 1000000);
-* $value = $json->decode($input);
-* </code>
-*/
+ * Converts to and from JSON format.
+ *
+ * Brief example of use:
+ *
+ * <code>
+ * // create a new instance of Services_JSON
+ * $json = new Services_JSON();
+ *
+ * // convert a complexe value to JSON notation, and send it to the browser
+ * $value = array('foo', 'bar', array(1, 2, 'baz'), array(3, array(4)));
+ * $output = $json->encode($value);
+ *
+ * print($output);
+ * // prints: ["foo","bar",[1,2,"baz"],[3,[4]]]
+ *
+ * // accept incoming POST data, assumed to be in JSON notation
+ * $input = file_get_contents('php://input', 1000000);
+ * $value = $json->decode($input);
+ * </code>
+ *
+ * @addtogroup API
+ */
 class Services_JSON
 {
    /**
@@ -812,6 +814,9 @@ class Services_JSON
 
 if (class_exists('PEAR_Error')) {
 
+    /**
+     * @addtogroup API
+     */
     class Services_JSON_Error extends PEAR_Error
     {
         function Services_JSON_Error($message = 'unknown error', $code = null,
@@ -825,6 +830,7 @@ if (class_exists('PEAR_Error')) {
 
     /**
      * @todo Ultimately, this class shall be descended from PEAR_Error
+     * @addtogroup API
      */
     class Services_JSON_Error
     {
index f635f4c..20480b6 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Oct 22, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiFormatBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiFormatPhp extends ApiFormatBase {
 
        public function __construct($main, $format) {
@@ -51,4 +53,4 @@ class ApiFormatPhp extends ApiFormatBase {
                return __CLASS__ . ': $Id$';
        }
 }
-?>
\ No newline at end of file
+?>
index 71f13d4..ad902b6 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Oct 22, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiFormatBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiFormatWddx extends ApiFormatBase {
 
        public function __construct($main, $format) {
@@ -86,4 +88,4 @@ class ApiFormatWddx extends ApiFormatBase {
                return __CLASS__ . ': $Id$';
        }
 }
-?>
\ No newline at end of file
+?>
index 5d4e776..0c81c2f 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 19, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiFormatBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiFormatXml extends ApiFormatBase {
 
        private $mRootElemName = 'api';
@@ -142,4 +144,4 @@ class ApiFormatXml extends ApiFormatBase {
                return __CLASS__ . ': $Id$';
        }
 }
-?>
\ No newline at end of file
+?>
index 006e973..5fc89b9 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 19, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiFormatBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiFormatYaml extends ApiFormatBase {
 
        public function __construct($main, $format) {
@@ -51,4 +53,4 @@ class ApiFormatYaml extends ApiFormatBase {
                return __CLASS__ . ': $Id$';
        }
 }
-?>
\ No newline at end of file
+?>
index 91155aa..a67bbb2 100644 (file)
@@ -6,12 +6,11 @@
    * @see http://spyc.sourceforge.net/
    * @copyright Copyright 2005-2006 Chris Wanstrath
    * @license http://www.opensource.org/licenses/mit-license.php MIT License
-   * @addtogroup Spyc
    */
 
   /** 
    * A node, used by Spyc for parsing YAML.
-   * @addtogroup Spyc
+   * @addtogroup API
    */
   class YAMLNode {
     /**#@+
@@ -59,7 +58,7 @@
    *   $parser = new Spyc;
    *   $array  = $parser->load($file);
    * </code>
-   * @addtogroup Spyc
+   * @addtogroup API
    */
   class Spyc {
     
index 07108ce..570c787 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 6, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiHelp extends ApiBase {
 
        public function __construct($main, $action) {
@@ -52,4 +54,4 @@ class ApiHelp extends ApiBase {
                return __CLASS__ . ': $Id$';
        }
 }
-?>
\ No newline at end of file
+?>
index 954cd19..9a8c70e 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 19, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiLogin extends ApiBase {
 
        public function __construct($main, $action) {
index 214cfc7..c4d5a83 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 4, 2006
  *
@@ -31,6 +30,7 @@ if (!defined('MEDIAWIKI')) {
 
 /**
  * This is the main API class, used for both external and internal processing. 
+ * @addtogroup API
  */
 class ApiMain extends ApiBase {
 
@@ -347,6 +347,7 @@ class ApiMain extends ApiBase {
 
 /**
  * This exception will be thrown when dieUsage is called to stop module execution.
+ * @addtogroup API
  */
 class UsageException extends Exception {
 
index 3bbcf4e..48d6b13 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Oct 13, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ("ApiBase.php");
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiOpenSearch extends ApiBase {
 
        public function __construct($main, $action) {
@@ -106,4 +108,4 @@ class ApiOpenSearch extends ApiBase {
                return __CLASS__ . ': $Id$';
        }
 }
-?>
\ No newline at end of file
+?>
index 1b55567..a99ec21 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 24, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiQueryBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiPageSet extends ApiQueryBase {
 
        private $mAllPages; // [ns][dbkey] => page_id or 0 when missing
index 72859d8..a42dec2 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 7, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiQuery extends ApiBase {
 
        private $mPropModuleNames, $mListModuleNames, $mMetaModuleNames;
index df137d3..02f5e11 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 25, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiQueryBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiQueryAllpages extends ApiQueryGeneratorBase {
 
        public function __construct($query, $moduleName) {
index a799c7d..677ead4 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Oct 16, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ("ApiQueryBase.php");
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiQueryBacklinks extends ApiQueryGeneratorBase {
 
        private $rootTitle, $contRedirs, $contLevel, $contTitle, $contID;
@@ -355,4 +357,4 @@ class ApiQueryBacklinks extends ApiQueryGeneratorBase {
                return __CLASS__ . ': $Id$';
        }
 }
-?>
\ No newline at end of file
+?>
index cc9a4fe..bc8c483 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 7, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 abstract class ApiQueryBase extends ApiBase {
 
        private $mQueryModule, $tables, $where, $fields, $options;
@@ -341,6 +343,9 @@ abstract class ApiQueryBase extends ApiBase {
        }
 }
 
+/**
+ * @addtogroup API
+ */
 abstract class ApiQueryGeneratorBase extends ApiQueryBase {
 
        private $mIsGenerator;
index 07928b5..3014fec 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 25, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiQueryBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiQueryInfo extends ApiQueryBase {
 
        public function __construct($query, $moduleName) {
index 73e0c84..3142c9e 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Oct 16, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiQueryBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiQueryLogEvents extends ApiQueryBase {
 
        public function __construct($query, $moduleName) {
index b1cf410..cec0fb5 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Oct 19, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiQueryBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiQueryRecentChanges extends ApiQueryBase {
 
        public function __construct($query, $moduleName) {
@@ -184,4 +186,4 @@ class ApiQueryRecentChanges extends ApiQueryBase {
                return __CLASS__ . ': $Id$';
        }
 }
-?>
\ No newline at end of file
+?>
index d2c0436..c07b938 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 7, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiQueryBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiQueryRevisions extends ApiQueryBase {
 
        public function __construct($query, $moduleName) {
index ea9601f..f174782 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 25, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiQueryBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiQuerySiteinfo extends ApiQueryBase {
 
        public function __construct($query, $moduleName) {
@@ -113,4 +115,4 @@ class ApiQuerySiteinfo extends ApiQueryBase {
                return __CLASS__ . ': $Id$';
        }
 }
-?>
\ No newline at end of file
+?>
index d518e88..6f99b9d 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Oct 16, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiQueryBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiQueryContributions extends ApiQueryBase {
 
        public function __construct($query, $moduleName) {
index e2557e9..99e7151 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 25, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiQueryBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiQueryWatchlist extends ApiQueryGeneratorBase {
 
        public function __construct($query, $moduleName) {
index b56d7ac..65f17e8 100644 (file)
@@ -1,6 +1,5 @@
 <?php
 
-
 /*
  * Created on Sep 4, 2006
  *
@@ -29,6 +28,9 @@ if (!defined('MEDIAWIKI')) {
        require_once ('ApiBase.php');
 }
 
+/**
+ * @addtogroup API
+ */
 class ApiResult extends ApiBase {
 
        private $mData, $mIsRawMode;
@@ -154,4 +156,4 @@ class ApiResult extends ApiBase {
                return __CLASS__ . ': $Id$';
        }
 }
-?>
\ No newline at end of file
+?>
index 2c5cc6b..b42f467 100644 (file)
@@ -91,7 +91,7 @@ define("COMPRESSION_SAVINGS", 0.20);
  * memcached client class implemented using (p)fsockopen()
  *
  * @author  Ryan T. Dean <rtdean@cytherianage.net>
- * @package memcached-client
+ * @addtogroup cache
  */
 class memcached
 {
index a0c3ec1..ccddfa6 100644 (file)
@@ -92,6 +92,9 @@ class UserloginTemplate extends QuickTemplate {
        }
 }
 
+/**
+ * @addtogroup Templates
+ */
 class UsercreateTemplate extends QuickTemplate {
        function execute() {
                if( $this->data['message'] ) {