r21402 MediaWiki - Code Review archive

Repository:MediaWiki
Revision:r21401‎ | r21402 | r21403 >
Date:08:55, 20 April 2007
Author:nickj
Status:old
Tags:
Comment:
Yet more doc tweaks:
* 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.
Modified paths:
  • /trunk/phase3/includes/AjaxDispatcher.php (modified) (history)
  • /trunk/phase3/includes/AjaxFunctions.php (modified) (history)
  • /trunk/phase3/includes/AjaxResponse.php (modified) (history)
  • /trunk/phase3/includes/CacheDependency.php (modified) (history)
  • /trunk/phase3/includes/CoreParserFunctions.php (modified) (history)
  • /trunk/phase3/includes/Database.php (modified) (history)
  • /trunk/phase3/includes/DatabaseOracle.php (modified) (history)
  • /trunk/phase3/includes/DatabasePostgres.php (modified) (history)
  • /trunk/phase3/includes/Exception.php (modified) (history)
  • /trunk/phase3/includes/Export.php (modified) (history)
  • /trunk/phase3/includes/FileStore.php (modified) (history)
  • /trunk/phase3/includes/ImageQueryPage.php (modified) (history)
  • /trunk/phase3/includes/PageHistory.php (modified) (history)
  • /trunk/phase3/includes/PageQueryPage.php (modified) (history)
  • /trunk/phase3/includes/Pager.php (modified) (history)
  • /trunk/phase3/includes/Parser.php (modified) (history)
  • /trunk/phase3/includes/ParserCache.php (modified) (history)
  • /trunk/phase3/includes/ParserOptions.php (modified) (history)
  • /trunk/phase3/includes/ParserOutput.php (modified) (history)
  • /trunk/phase3/includes/Profiler.php (modified) (history)
  • /trunk/phase3/includes/ProfilerSimple.php (modified) (history)
  • /trunk/phase3/includes/ProfilerSimpleUDP.php (modified) (history)
  • /trunk/phase3/includes/QueryPage.php (modified) (history)
  • /trunk/phase3/includes/Sanitizer.php (modified) (history)
  • /trunk/phase3/includes/SearchEngine.php (modified) (history)
  • /trunk/phase3/includes/SearchMySQL.php (modified) (history)
  • /trunk/phase3/includes/SearchMySQL4.php (modified) (history)
  • /trunk/phase3/includes/SearchOracle.php (modified) (history)
  • /trunk/phase3/includes/SearchPostgres.php (modified) (history)
  • /trunk/phase3/includes/SearchUpdate.php (modified) (history)
  • /trunk/phase3/includes/SpecialAllpages.php (modified) (history)
  • /trunk/phase3/includes/SpecialAncientpages.php (modified) (history)
  • /trunk/phase3/includes/SpecialCategories.php (modified) (history)
  • /trunk/phase3/includes/SpecialConfirmemail.php (modified) (history)
  • /trunk/phase3/includes/SpecialFewestrevisions.php (modified) (history)
  • /trunk/phase3/includes/SpecialImagelist.php (modified) (history)
  • /trunk/phase3/includes/SpecialImport.php (modified) (history)
  • /trunk/phase3/includes/SpecialIpblocklist.php (modified) (history)
  • /trunk/phase3/includes/SpecialMostcategories.php (modified) (history)
  • /trunk/phase3/includes/SpecialMostimages.php (modified) (history)
  • /trunk/phase3/includes/SpecialMostlinked.php (modified) (history)
  • /trunk/phase3/includes/SpecialMostlinkedcategories.php (modified) (history)
  • /trunk/phase3/includes/SpecialNewpages.php (modified) (history)
  • /trunk/phase3/includes/SpecialPage.php (modified) (history)
  • /trunk/phase3/includes/SpecialPopularpages.php (modified) (history)
  • /trunk/phase3/includes/SpecialPrefixindex.php (modified) (history)
  • /trunk/phase3/includes/SpecialProtectedpages.php (modified) (history)
  • /trunk/phase3/includes/SpecialRandompage.php (modified) (history)
  • /trunk/phase3/includes/SpecialResetpass.php (modified) (history)
  • /trunk/phase3/includes/SpecialRevisiondelete.php (modified) (history)
  • /trunk/phase3/includes/SpecialSearch.php (modified) (history)
  • /trunk/phase3/includes/SpecialUncategorizedcategories.php (modified) (history)
  • /trunk/phase3/includes/SpecialUnusedimages.php (modified) (history)
  • /trunk/phase3/includes/SpecialUnusedtemplates.php (modified) (history)
  • /trunk/phase3/includes/SpecialUnwatchedpages.php (modified) (history)
  • /trunk/phase3/includes/SpecialUpload.php (modified) (history)
  • /trunk/phase3/includes/SpecialUploadMogile.php (modified) (history)
  • /trunk/phase3/includes/SpecialUserlogin.php (modified) (history)
  • /trunk/phase3/includes/SpecialWantedcategories.php (modified) (history)
  • /trunk/phase3/includes/SpecialWantedpages.php (modified) (history)
  • /trunk/phase3/includes/SpecialWhatlinkshere.php (modified) (history)
  • /trunk/phase3/includes/SpecialWithoutinterwiki.php (modified) (history)
  • /trunk/phase3/includes/User.php (modified) (history)
  • /trunk/phase3/includes/WikiError.php (modified) (history)
  • /trunk/phase3/includes/api/ApiBase.php (modified) (history)
  • /trunk/phase3/includes/api/ApiFeedWatchlist.php (modified) (history)
  • /trunk/phase3/includes/api/ApiFormatBase.php (modified) (history)
  • /trunk/phase3/includes/api/ApiFormatJson.php (modified) (history)
  • /trunk/phase3/includes/api/ApiFormatJson_json.php (modified) (history)
  • /trunk/phase3/includes/api/ApiFormatPhp.php (modified) (history)
  • /trunk/phase3/includes/api/ApiFormatWddx.php (modified) (history)
  • /trunk/phase3/includes/api/ApiFormatXml.php (modified) (history)
  • /trunk/phase3/includes/api/ApiFormatYaml.php (modified) (history)
  • /trunk/phase3/includes/api/ApiFormatYaml_spyc.php (modified) (history)
  • /trunk/phase3/includes/api/ApiHelp.php (modified) (history)
  • /trunk/phase3/includes/api/ApiLogin.php (modified) (history)
  • /trunk/phase3/includes/api/ApiMain.php (modified) (history)
  • /trunk/phase3/includes/api/ApiOpenSearch.php (modified) (history)
  • /trunk/phase3/includes/api/ApiPageSet.php (modified) (history)
  • /trunk/phase3/includes/api/ApiQuery.php (modified) (history)
  • /trunk/phase3/includes/api/ApiQueryAllpages.php (modified) (history)
  • /trunk/phase3/includes/api/ApiQueryBacklinks.php (modified) (history)
  • /trunk/phase3/includes/api/ApiQueryBase.php (modified) (history)
  • /trunk/phase3/includes/api/ApiQueryInfo.php (modified) (history)
  • /trunk/phase3/includes/api/ApiQueryLogEvents.php (modified) (history)
  • /trunk/phase3/includes/api/ApiQueryRecentChanges.php (modified) (history)
  • /trunk/phase3/includes/api/ApiQueryRevisions.php (modified) (history)
  • /trunk/phase3/includes/api/ApiQuerySiteinfo.php (modified) (history)
  • /trunk/phase3/includes/api/ApiQueryUserContributions.php (modified) (history)
  • /trunk/phase3/includes/api/ApiQueryWatchlist.php (modified) (history)
  • /trunk/phase3/includes/api/ApiResult.php (modified) (history)
  • /trunk/phase3/includes/memcached-client.php (modified) (history)
  • /trunk/phase3/includes/templates/Userlogin.php (modified) (history)

Diff [purge]

Index: trunk/phase3/includes/DatabasePostgres.php
@@ -7,8 +7,8 @@
88 * than MySQL ones, some of them should be moved to parent
99 * Database class.
1010 *
 11+ * @addtogroup Database
1112 */
12 -
1313 class PostgresField {
1414 private $name, $tablename, $type, $nullable, $max_length;
1515
@@ -63,6 +63,9 @@
6464 }
6565 }
6666
 67+/**
 68+ * @addtogroup Database
 69+ */
6770 class DatabasePostgres extends Database {
6871 var $mInsertId = NULL;
6972 var $mLastResult = NULL;
Index: trunk/phase3/includes/SpecialWhatlinkshere.php
@@ -14,6 +14,10 @@
1515 $page->execute();
1616 }
1717
 18+/**
 19+ * implements Special:Whatlinkshere
 20+ * @addtogroup SpecialPage
 21+ */
1822 class WhatLinksHerePage {
1923 var $request, $par;
2024 var $limit, $from, $back, $target, $namespace;
Index: trunk/phase3/includes/SpecialImport.php
@@ -160,6 +160,7 @@
161161
162162 /**
163163 * Reporting callback
 164+ * @addtogroup SpecialPage
164165 */
165166 class ImportReporter {
166167 function __construct( $importer, $upload, $interwiki ) {
@@ -383,7 +384,7 @@
384385 }
385386
386387 /**
387 - *
 388+ * implements Special:Import
388389 * @addtogroup SpecialPage
389390 */
390391 class WikiImporter {
@@ -792,6 +793,7 @@
793794
794795 /**
795796 * @todo document (e.g. one-sentence class description).
 797+ * @addtogroup SpecialPage
796798 */
797799 class ImportStringSource {
798800 function ImportStringSource( $string ) {
@@ -815,6 +817,7 @@
816818
817819 /**
818820 * @todo document (e.g. one-sentence class description).
 821+ * @addtogroup SpecialPage
819822 */
820823 class ImportStreamSource {
821824 function ImportStreamSource( $handle ) {
Index: trunk/phase3/includes/SpecialCategories.php
@@ -16,6 +16,10 @@
1717 );
1818 }
1919
 20+/**
 21+ * @addtogroup SpecialPage
 22+ * @addtogroup Pager
 23+ */
2024 class CategoryPager extends AlphabeticPager {
2125 function getQueryInfo() {
2226 return array(
Index: trunk/phase3/includes/SpecialMostcategories.php
@@ -8,6 +8,7 @@
99 */
1010
1111 /**
 12+ * implements Special:Mostcategories
1213 * @addtogroup SpecialPage
1314 */
1415 class MostcategoriesPage extends QueryPage {
Index: trunk/phase3/includes/SpecialWantedcategories.php
@@ -1,6 +1,6 @@
22 <?php
33 /**
4 - * A querypage to list the most wanted categories
 4+ * A querypage to list the most wanted categories - implements Special:Wantedcategories
55 *
66 * @addtogroup SpecialPage
77 *
@@ -8,10 +8,6 @@
99 * @copyright Copyright © 2005, Ævar Arnfjörð Bjarmason
1010 * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later
1111 */
12 -
13 -/**
14 - * @addtogroup SpecialPage
15 - */
1612 class WantedCategoriesPage extends QueryPage {
1713
1814 function getName() { return 'Wantedcategories'; }
Index: trunk/phase3/includes/DatabaseOracle.php
@@ -2,6 +2,7 @@
33
44 /**
55 * This is the Oracle database abstraction layer.
 6+ * @addtogroup Database
67 */
78 class ORABlob {
89 var $mData;
@@ -19,6 +20,7 @@
2021 * The oci8 extension is fairly weak and doesn't support oci_num_rows, among
2122 * other things. We use a wrapper class to handle that and other
2223 * Oracle-specific bits, like converting column names back to lowercase.
 24+ * @addtogroup Database
2325 */
2426 class ORAResult {
2527 private $rows;
@@ -82,8 +84,11 @@
8385 }
8486 return $ret;
8587 }
86 -};
 88+}
8789
 90+/**
 91+ * @addtogroup Database
 92+ */
8893 class DatabaseOracle extends Database {
8994 var $mInsertId = NULL;
9095 var $mLastResult = NULL;
@@ -384,7 +389,7 @@
385390 }
386391
387392 /**
388 - * ORacle does not have a "USE INDEX" clause, so return an empty string
 393+ * Oracle does not have a "USE INDEX" clause, so return an empty string
389394 */
390395 function useIndexClause($index) {
391396 return '';
Index: trunk/phase3/includes/SearchEngine.php
@@ -3,9 +3,6 @@
44 * Contain a class for special pages
55 * @addtogroup Search
66 */
7 -
8 -/**
9 - */
107 class SearchEngine {
118 var $limit = 10;
129 var $offset = 0;
@@ -236,6 +233,10 @@
237234 }
238235 }
239236
 237+
 238+/**
 239+ * @addtogroup Search
 240+ */
240241 class SearchResultSet {
241242 /**
242243 * Fetch an array of regular expression fragments for matching
@@ -310,6 +311,10 @@
311312 }
312313 }
313314
 315+
 316+/**
 317+ * @addtogroup Search
 318+ */
314319 class SearchResult {
315320 function SearchResult( $row ) {
316321 $this->mTitle = Title::makeTitle( $row->page_namespace, $row->page_title );
@@ -332,6 +337,7 @@
333338 }
334339
335340 /**
 341+ * @addtogroup Search
336342 */
337343 class SearchEngineDummy {
338344 function search( $term ) {
Index: trunk/phase3/includes/ImageQueryPage.php
@@ -5,6 +5,7 @@
66 * suited for reports generating images
77 *
88 * @package MediaWiki
 9+ * @addtogroup SpecialPage
910 * @author Rob Church <robchur@gmail.com>
1011 */
1112 class ImageQueryPage extends QueryPage {
@@ -63,4 +64,4 @@
6465
6566 }
6667
67 -?>
\ No newline at end of file
 68+?>
Index: trunk/phase3/includes/SpecialConfirmemail.php
@@ -1,14 +1,6 @@
22 <?php
33
44 /**
5 - * Special page allows users to request email confirmation message, and handles
6 - * processing of the confirmation code when the link in the email is followed
7 - *
8 - * @addtogroup SpecialPage
9 - * @author Rob Church <robchur@gmail.com>
10 - */
11 -
12 -/**
135 * Main execution point
146 *
157 * @param $par Parameters passed to the page
@@ -18,6 +10,13 @@
1911 $form->execute( $par );
2012 }
2113
 14+/**
 15+ * Special page allows users to request email confirmation message, and handles
 16+ * processing of the confirmation code when the link in the email is followed
 17+ *
 18+ * @addtogroup SpecialPage
 19+ * @author Rob Church <robchur@gmail.com>
 20+ */
2221 class EmailConfirmation extends SpecialPage {
2322
2423 /**
Index: trunk/phase3/includes/WikiError.php
@@ -24,6 +24,7 @@
2525 /**
2626 * Since PHP4 doesn't have exceptions, here's some error objects
2727 * loosely modeled on the standard PEAR_Error model...
 28+ * @addtogroup Exception
2829 */
2930 class WikiError {
3031 /**
@@ -64,6 +65,7 @@
6566
6667 /**
6768 * Localized error message object
 69+ * @addtogroup Exception
6870 */
6971 class WikiErrorMsg extends WikiError {
7072 /**
@@ -79,6 +81,7 @@
8082
8183 /**
8284 * @todo document
 85+ * @addtogroup Exception
8386 */
8487 class WikiXmlError extends WikiError {
8588 /**
Index: trunk/phase3/includes/SpecialIpblocklist.php
@@ -45,7 +45,7 @@
4646 }
4747
4848 /**
49 - * @todo document
 49+ * implements Special:ipblocklist GUI
5050 * @addtogroup SpecialPage
5151 */
5252 class IPUnblockForm {
@@ -321,6 +321,7 @@
322322
323323 /**
324324 * @todo document
 325+ * @addtogroup Pager
325326 */
326327 class IPBlocklistPager extends ReverseChronologicalPager {
327328 public $mForm, $mConds;
Index: trunk/phase3/includes/SpecialMostlinkedcategories.php
@@ -8,10 +8,6 @@
99 * @copyright Copyright © 2005, Ævar Arnfjörð Bjarmason
1010 * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later
1111 */
12 -
13 -/**
14 - * @addtogroup SpecialPage
15 - */
1612 class MostlinkedCategoriesPage extends QueryPage {
1713
1814 function getName() { return 'Mostlinkedcategories'; }
Index: trunk/phase3/includes/SpecialRevisiondelete.php
@@ -35,6 +35,10 @@
3636 }
3737 }
3838
 39+/**
 40+ * Implements the GUI for Revision Deletion.
 41+ * @addtogroup SpecialPage
 42+ */
3943 class RevisionDeleteForm {
4044 /**
4145 * @param Title $page
@@ -170,7 +174,10 @@
171175 }
172176 }
173177
174 -
 178+/**
 179+ * Implements the actions for Revision Deletion.
 180+ * @addtogroup SpecialPage
 181+ */
175182 class RevisionDeleter {
176183 function __construct( $db ) {
177184 $this->db = $db;
Index: trunk/phase3/includes/memcached-client.php
@@ -91,7 +91,7 @@
9292 * memcached client class implemented using (p)fsockopen()
9393 *
9494 * @author Ryan T. Dean <rtdean@cytherianage.net>
95 - * @package memcached-client
 95+ * @addtogroup cache
9696 */
9797 class memcached
9898 {
Index: trunk/phase3/includes/SpecialAllpages.php
@@ -36,6 +36,10 @@
3737 }
3838 }
3939
 40+/**
 41+ * Implements Special:Allpages
 42+ * @addtogroup SpecialPage
 43+ */
4044 class SpecialAllpages {
4145 var $maxPerPage=960;
4246 var $topLevelMax=50;
Index: trunk/phase3/includes/FileStore.php
@@ -371,6 +371,9 @@
372372 }
373373 }
374374
 375+/**
 376+ * @addtogroup Exception
 377+ */
375378 class FSException extends MWException { }
376379
377380 ?>
Index: trunk/phase3/includes/QueryPage.php
@@ -52,7 +52,7 @@
5353 * This is a class for doing query pages; since they're almost all the same,
5454 * we factor out some of the functionality into a superclass, and let
5555 * subclasses derive from it.
56 - *
 56+ * @addtogroup SpecialPage
5757 */
5858 class QueryPage {
5959 /**
@@ -525,4 +525,4 @@
526526 }
527527 }
528528
529 -?>
\ No newline at end of file
 529+?>
Index: trunk/phase3/includes/Database.php
@@ -17,6 +17,7 @@
1818
1919 /**
2020 * Utility class.
 21+ * @addtogroup Database
2122 */
2223 class DBObject {
2324 public $mData;
@@ -36,6 +37,7 @@
3738
3839 /**
3940 * Utility class.
 41+ * @addtogroup Database
4042 */
4143 class MySQLField {
4244 private $name, $tablename, $default, $max_length, $nullable,
@@ -92,6 +94,7 @@
9395
9496 /**
9597 * Database error base class
 98+ * @addtogroup Database
9699 */
97100 class DBError extends MWException {
98101 public $db;
@@ -107,6 +110,9 @@
108111 }
109112 }
110113
 114+/**
 115+ * @addtogroup Database
 116+ */
111117 class DBConnectionError extends DBError {
112118 public $error;
113119
@@ -224,6 +230,9 @@
225231 }
226232 }
227233
 234+/**
 235+ * @addtogroup Database
 236+ */
228237 class DBQueryError extends DBError {
229238 public $error, $errno, $sql, $fname;
230239
@@ -277,12 +286,16 @@
278287 }
279288 }
280289
 290+/**
 291+ * @addtogroup Database
 292+ */
281293 class DBUnexpectedError extends DBError {}
282294
283295 /******************************************************************************/
284296
285297 /**
286298 * Database abstraction object
 299+ * @addtogroup Database
287300 */
288301 class Database {
289302
@@ -2181,6 +2194,7 @@
21822195 * Database abstraction object for mySQL
21832196 * Inherit all methods and properties of Database::Database()
21842197 *
 2198+ * @addtogroup Database
21852199 * @see Database
21862200 */
21872201 class DatabaseMysql extends Database {
@@ -2190,7 +2204,7 @@
21912205
21922206 /**
21932207 * Result wrapper for grabbing data queried by someone else
2194 - *
 2208+ * @addtogroup Database
21952209 */
21962210 class ResultWrapper {
21972211 var $db, $result;
Index: trunk/phase3/includes/ProfilerSimpleUDP.php
@@ -6,6 +6,7 @@
77 /**
88 * ProfilerSimpleUDP class, that sends out messages for 'udpprofile' daemon
99 * (the one from mediawiki/trunk/udpprofile SVN )
 10+ * @addtogroup Profiler
1011 */
1112 class ProfilerSimpleUDP extends ProfilerSimple {
1213 function getFunctionReport() {
Index: trunk/phase3/includes/SearchUpdate.php
@@ -1,11 +1,8 @@
22 <?php
33 /**
44 * See deferred.txt
 5+ * @addtogroup Search
56 */
6 -
7 -/**
8 - *
9 - */
107 class SearchUpdate {
118
129 /* private */ var $mId = 0, $mNamespace, $mTitle, $mText;
@@ -109,6 +106,7 @@
110107
111108 /**
112109 * Placeholder class
 110+ * @addtogroup Search
113111 */
114112 class SearchUpdateMyISAM extends SearchUpdate {
115113 # Inherits everything
Index: trunk/phase3/includes/SpecialUpload.php
@@ -15,7 +15,7 @@
1616 }
1717
1818 /**
19 - *
 19+ * implements Special:Upload
2020 * @addtogroup SpecialPage
2121 */
2222 class UploadForm {
Index: trunk/phase3/includes/SpecialPrefixindex.php
@@ -41,6 +41,10 @@
4242 }
4343 }
4444
 45+/**
 46+ * implements Special:Prefixindex
 47+ * @addtogroup SpecialPage
 48+ */
4549 class SpecialPrefixindex extends SpecialAllpages {
4650 var $maxPerPage=960;
4751 var $topLevelMax=50;
Index: trunk/phase3/includes/AjaxDispatcher.php
@@ -11,6 +11,7 @@
1212
1313 /**
1414 * @todo Document - e.g. Provide top-level description of this class.
 15+ * @addtogroup Ajax
1516 */
1617 class AjaxDispatcher {
1718 var $mode;
Index: trunk/phase3/includes/SearchOracle.php
@@ -21,7 +21,6 @@
2222 * Search engine hook base class for Oracle (ConText).
2323 * @addtogroup Search
2424 */
25 -
2625 class SearchOracle extends SearchEngine {
2726 function __construct($db) {
2827 $this->db = $db;
@@ -208,6 +207,9 @@
209208 }
210209 }
211210
 211+/**
 212+ * @addtogroup Search
 213+ */
212214 class OracleSearchResultSet extends SearchResultSet {
213215 function __construct($resultSet, $terms) {
214216 $this->mResultSet = $resultSet;
Index: trunk/phase3/includes/Parser.php
@@ -86,6 +86,7 @@
8787 * * only within ParserOptions
8888 * </pre>
8989 *
 90+ * @addtogroup Parser
9091 */
9192 class Parser
9293 {
@@ -4721,6 +4722,7 @@
47224723
47234724 /**
47244725 * @todo document, briefly.
 4726+ * @addtogroup Parser
47254727 */
47264728 class OnlyIncludeReplacer {
47274729 var $output = '';
@@ -4736,6 +4738,7 @@
47374739
47384740 /**
47394741 * @todo document, briefly.
 4742+ * @addtogroup Parser
47404743 */
47414744 class StripState {
47424745 var $general, $nowiki;
Index: trunk/phase3/includes/Exception.php
@@ -1,5 +1,8 @@
22 <?php
33
 4+/**
 5+ * @addtogroup Exception
 6+ */
47 class MWException extends Exception
58 {
69 function useOutputPage() {
@@ -125,6 +128,7 @@
126129 /**
127130 * Exception class which takes an HTML error message, and does not
128131 * produce a backtrace. Replacement for OutputPage::fatalError().
 132+ * @addtogroup Exception
129133 */
130134 class FatalError extends MWException {
131135 function getHTML() {
@@ -136,6 +140,9 @@
137141 }
138142 }
139143
 144+/**
 145+ * @addtogroup Exception
 146+ */
140147 class ErrorPageError extends MWException {
141148 public $title, $msg;
142149
Index: trunk/phase3/includes/SpecialProtectedpages.php
@@ -186,6 +186,7 @@
187187
188188 /**
189189 * @todo document
 190+ * @addtogroup Pager
190191 */
191192 class ProtectedPagesPager extends ReverseChronologicalPager {
192193 public $mForm, $mConds;
Index: trunk/phase3/includes/SpecialRandompage.php
@@ -31,6 +31,11 @@
3232 }
3333
3434
 35+/**
 36+ * Special page to direct the user to a random page
 37+ *
 38+ * @addtogroup SpecialPage
 39+ */
3540 class RandomPage {
3641 private $namespace = NS_MAIN; // namespace to select pages from
3742 private $redirect = false; // select redirects instead of normal pages?
Index: trunk/phase3/includes/SearchMySQL4.php
@@ -21,10 +21,6 @@
2222 * Search engine hook for MySQL 4+
2323 * @addtogroup Search
2424 */
25 -
26 -/**
27 - * @addtogroup Search
28 - */
2925 class SearchMySQL4 extends SearchMySQL {
3026 var $strictMatching = true;
3127
Index: trunk/phase3/includes/Export.php
@@ -281,6 +281,9 @@
282282 }
283283 }
284284
 285+/**
 286+ * @addtogroup Dump
 287+ */
285288 class XmlDumpWriter {
286289
287290 /**
@@ -463,6 +466,7 @@
464467
465468 /**
466469 * Base class for output stream; prints to stdout or buffer or whereever.
 470+ * @addtogroup Dump
467471 */
468472 class DumpOutput {
469473 function writeOpenStream( $string ) {
@@ -496,6 +500,7 @@
497501
498502 /**
499503 * Stream outputter to send data to a file.
 504+ * @addtogroup Dump
500505 */
501506 class DumpFileOutput extends DumpOutput {
502507 var $handle;
@@ -513,6 +518,7 @@
514519 * Stream outputter to send data to a file via some filter program.
515520 * Even if compression is available in a library, using a separate
516521 * program can allow us to make use of a multi-processor system.
 522+ * @addtogroup Dump
517523 */
518524 class DumpPipeOutput extends DumpFileOutput {
519525 function DumpPipeOutput( $command, $file = null ) {
@@ -525,6 +531,7 @@
526532
527533 /**
528534 * Sends dump output via the gzip compressor.
 535+ * @addtogroup Dump
529536 */
530537 class DumpGZipOutput extends DumpPipeOutput {
531538 function DumpGZipOutput( $file ) {
@@ -534,6 +541,7 @@
535542
536543 /**
537544 * Sends dump output via the bgzip2 compressor.
 545+ * @addtogroup Dump
538546 */
539547 class DumpBZip2Output extends DumpPipeOutput {
540548 function DumpBZip2Output( $file ) {
@@ -543,6 +551,7 @@
544552
545553 /**
546554 * Sends dump output via the p7zip compressor.
 555+ * @addtogroup Dump
547556 */
548557 class Dump7ZipOutput extends DumpPipeOutput {
549558 function Dump7ZipOutput( $file ) {
@@ -560,6 +569,7 @@
561570 * Dump output filter class.
562571 * This just does output filtering and streaming; XML formatting is done
563572 * higher up, so be careful in what you do.
 573+ * @addtogroup Dump
564574 */
565575 class DumpFilter {
566576 function DumpFilter( &$sink ) {
@@ -605,6 +615,7 @@
606616
607617 /**
608618 * Simple dump output filter to exclude all talk pages.
 619+ * @addtogroup Dump
609620 */
610621 class DumpNotalkFilter extends DumpFilter {
611622 function pass( $page ) {
@@ -614,6 +625,7 @@
615626
616627 /**
617628 * Dump output filter to include or exclude pages in a given set of namespaces.
 629+ * @addtogroup Dump
618630 */
619631 class DumpNamespaceFilter extends DumpFilter {
620632 var $invert = false;
@@ -668,6 +680,7 @@
669681
670682 /**
671683 * Dump output filter to include only the last revision in each page sequence.
 684+ * @addtogroup Dump
672685 */
673686 class DumpLatestFilter extends DumpFilter {
674687 var $page, $pageString, $rev, $revString;
@@ -699,6 +712,7 @@
700713
701714 /**
702715 * Base class for output stream; prints to stdout or buffer or whereever.
 716+ * @addtogroup Dump
703717 */
704718 class DumpMultiWriter {
705719 function DumpMultiWriter( $sinks ) {
Index: trunk/phase3/includes/SpecialUploadMogile.php
@@ -18,6 +18,9 @@
1919 $form->execute();
2020 }
2121
 22+/**
 23+ * @addtogroup SpecialPage
 24+ */
2225 class UploadFormMogile extends UploadForm {
2326 /**
2427 * Move the uploaded file from its temporary location to the final
Index: trunk/phase3/includes/SearchPostgres.php
@@ -21,7 +21,6 @@
2222 * Search engine hook base class for Postgres
2323 * @addtogroup Search
2424 */
25 -
2625 class SearchPostgres extends SearchEngine {
2726
2827 function SearchPostgres( $db ) {
@@ -182,7 +181,9 @@
183182
184183 } ## end of the SearchPostgres class
185184
186 -
 185+/**
 186+ * @addtogroup Search
 187+ */
187188 class PostgresSearchResult extends SearchResult {
188189 function PostgresSearchResult( $row ) {
189190 $this->mTitle = Title::makeTitle( $row->page_namespace, $row->page_title );
@@ -193,6 +194,9 @@
194195 }
195196 }
196197
 198+/**
 199+ * @addtogroup Search
 200+ */
197201 class PostgresSearchResultSet extends SearchResultSet {
198202 function PostgresSearchResultSet( $resultSet, $terms ) {
199203 $this->mResultSet = $resultSet;
Index: trunk/phase3/includes/CoreParserFunctions.php
@@ -2,8 +2,8 @@
33
44 /**
55 * Various core parser functions, registered in Parser::firstCallInit()
 6+ * @addtogroup Parser
67 */
7 -
88 class CoreParserFunctions {
99 static function intFunction( $parser, $part1 = '' /*, ... */ ) {
1010 if ( strval( $part1 ) !== '' ) {
Index: trunk/phase3/includes/PageHistory.php
@@ -14,7 +14,6 @@
1515 * history.
1616 *
1717 */
18 -
1918 class PageHistory {
2019 const DIR_PREV = 0;
2120 const DIR_NEXT = 1;
@@ -523,6 +522,9 @@
524523 }
525524
526525
 526+/**
 527+ * @addtogroup Pager
 528+ */
527529 class PageHistoryPager extends ReverseChronologicalPager {
528530 public $mLastRow = false, $mPageHistory;
529531
Index: trunk/phase3/includes/PageQueryPage.php
@@ -4,6 +4,7 @@
55 * Variant of QueryPage which formats the result as a simple link to the page
66 *
77 * @package MediaWiki
 8+ * @addtogroup SpecialPage
89 */
910 class PageQueryPage extends QueryPage {
1011
@@ -22,4 +23,4 @@
2324 }
2425 }
2526
26 -?>
\ No newline at end of file
 27+?>
Index: trunk/phase3/includes/SpecialWantedpages.php
@@ -5,7 +5,7 @@
66 */
77
88 /**
9 - *
 9+ * implements Special:Wantedpages
1010 * @addtogroup SpecialPage
1111 */
1212 class WantedPagesPage extends QueryPage {
Index: trunk/phase3/includes/SpecialUserlogin.php
@@ -19,10 +19,9 @@
2020 }
2121
2222 /**
23 - * @todo document, briefly.
 23+ * implements Special:Login
2424 * @addtogroup SpecialPage
2525 */
26 -
2726 class LoginForm {
2827
2928 const SUCCESS = 0;
Index: trunk/phase3/includes/AjaxFunctions.php
@@ -1,5 +1,10 @@
22 <?php
33
 4+/**
 5+ * @package MediaWiki
 6+ * @addtogroup Ajax
 7+ */
 8+
49 if( !defined( 'MEDIAWIKI' ) )
510 die( 1 );
611
Index: trunk/phase3/includes/SpecialPage.php
@@ -26,7 +26,8 @@
2727
2828 /**
2929 * Parent special page class, also static functions for handling the special
30 - * page list
 30+ * page list.
 31+ * @addtogroup SpecialPage
3132 */
3233 class SpecialPage
3334 {
@@ -692,6 +693,7 @@
693694
694695 /**
695696 * Shortcut to construct a special page which is unlisted by default
 697+ * @addtogroup SpecialPage
696698 */
697699 class UnlistedSpecialPage extends SpecialPage
698700 {
@@ -702,6 +704,7 @@
703705
704706 /**
705707 * Shortcut to construct an includable special page
 708+ * @addtogroup SpecialPage
706709 */
707710 class IncludableSpecialPage extends SpecialPage
708711 {
@@ -710,6 +713,9 @@
711714 }
712715 }
713716
 717+/**
 718+ * @addtogroup SpecialPage
 719+ */
714720 class SpecialRedirectToSpecial extends UnlistedSpecialPage {
715721 var $redirName, $redirSubpage;
716722
@@ -729,6 +735,9 @@
730736 }
731737 }
732738
 739+/**
 740+ * @addtogroup SpecialPage
 741+ */
733742 class SpecialMypage extends UnlistedSpecialPage {
734743 function __construct() {
735744 parent::__construct( 'Mypage' );
@@ -745,6 +754,9 @@
746755 }
747756 }
748757
 758+/**
 759+ * @addtogroup SpecialPage
 760+ */
749761 class SpecialMytalk extends UnlistedSpecialPage {
750762 function __construct() {
751763 parent::__construct( 'Mytalk' );
@@ -761,6 +773,9 @@
762774 }
763775 }
764776
 777+/**
 778+ * @addtogroup SpecialPage
 779+ */
765780 class SpecialMycontributions extends UnlistedSpecialPage {
766781 function __construct() {
767782 parent::__construct( 'Mycontributions' );
Index: trunk/phase3/includes/ParserCache.php
@@ -2,9 +2,6 @@
33 /**
44 *
55 * @addtogroup Cache
6 - */
7 -
8 -/**
96 * @todo document
107 */
118 class ParserCache {
Index: trunk/phase3/includes/SpecialUnusedimages.php
@@ -5,6 +5,7 @@
66 */
77
88 /**
 9+ * implements Special:Unusedimages
910 * @addtogroup SpecialPage
1011 */
1112 class UnusedimagesPage extends ImageQueryPage {
Index: trunk/phase3/includes/SpecialWithoutinterwiki.php
@@ -4,6 +4,7 @@
55 * Special page lists pages without language links
66 *
77 * @package MediaWiki
 8+ * @addtogroup SpecialPage
89 * @author Rob Church <robchur@gmail.com>
910 */
1011 class WithoutInterwikiPage extends PageQueryPage {
@@ -52,4 +53,4 @@
5354 $wip->doQuery( $offset, $limit );
5455 }
5556
56 -?>
\ No newline at end of file
 57+?>
Index: trunk/phase3/includes/SearchMySQL.php
@@ -22,7 +22,6 @@
2323 * Specific bits for MySQL 3 and 4 variants are in child classes.
2424 * @addtogroup Search
2525 */
26 -
2726 class SearchMySQL extends SearchEngine {
2827 /**
2928 * Perform a full text search query and return a result set.
@@ -176,6 +175,9 @@
177176 }
178177 }
179178
 179+/**
 180+ * @addtogroup Search
 181+ */
180182 class MySQLSearchResultSet extends SearchResultSet {
181183 function MySQLSearchResultSet( $resultSet, $terms ) {
182184 $this->mResultSet = $resultSet;
Index: trunk/phase3/includes/SpecialFewestrevisions.php
@@ -1,14 +1,12 @@
22 <?php
33
44 /**
5 - *
65 * Special page for listing the articles with the fewest revisions.
76 *
87 * @package MediaWiki
9 - * @subpackage Special pages
 8+ * @addtogroup SpecialPage
109 * @author Martin Drashkov
1110 */
12 -
1311 class FewestrevisionsPage extends QueryPage {
1412
1513 function getName() {
@@ -64,4 +62,4 @@
6563 $frp->doQuery( $offset, $limit );
6664 }
6765
68 -?>
\ No newline at end of file
 66+?>
Index: trunk/phase3/includes/SpecialAncientpages.php
@@ -5,7 +5,7 @@
66 */
77
88 /**
9 - * @todo document, briefly.
 9+ * Implements Special:Ancientpages
1010 * @addtogroup SpecialPage
1111 */
1212 class AncientPagesPage extends QueryPage {
Index: trunk/phase3/includes/CacheDependency.php
@@ -4,6 +4,7 @@
55 * This class stores an arbitrary value along with its dependencies.
66 * Users should typically only use DependencyWrapper::getFromCache(), rather
77 * than instantiating one of these objects directly.
 8+ * @addtogroup Cache
89 */
910 class DependencyWrapper {
1011 var $value;
@@ -95,6 +96,9 @@
9697 }
9798 }
9899
 100+/**
 101+ * @addtogroup Cache
 102+ */
99103 abstract class CacheDependency {
100104 /**
101105 * Returns true if the dependency is expired, false otherwise
@@ -107,6 +111,9 @@
108112 function loadDependencyValues() {}
109113 }
110114
 115+/**
 116+ * @addtogroup Cache
 117+ */
111118 class FileDependency extends CacheDependency {
112119 var $filename, $timestamp;
113120
@@ -163,6 +170,9 @@
164171 }
165172 }
166173
 174+/**
 175+ * @addtogroup Cache
 176+ */
167177 class TitleDependency extends CacheDependency {
168178 var $titleObj;
169179 var $ns, $dbk;
@@ -219,6 +229,9 @@
220230 }
221231 }
222232
 233+/**
 234+ * @addtogroup Cache
 235+ */
223236 class TitleListDependency extends CacheDependency {
224237 var $linkBatch;
225238 var $timestamps;
@@ -299,6 +312,9 @@
300313 }
301314 }
302315
 316+/**
 317+ * @addtogroup Cache
 318+ */
303319 class GlobalDependency extends CacheDependency {
304320 var $name, $value;
305321
@@ -312,6 +328,9 @@
313329 }
314330 }
315331
 332+/**
 333+ * @addtogroup Cache
 334+ */
316335 class ConstantDependency extends CacheDependency {
317336 var $name, $value;
318337
Index: trunk/phase3/includes/SpecialUnwatchedpages.php
@@ -1,17 +1,13 @@
22 <?php
33 /**
4 - * A special page that displays a list of pages that are not on anyones watchlist
 4+ * A special page that displays a list of pages that are not on anyones watchlist.
 5+ * Implements Special:Unwatchedpages
56 *
67 * @addtogroup SpecialPage
7 - *
88 * @author Ævar Arnfjörð Bjarmason <avarab@gmail.com>
99 * @copyright Copyright © 2005, Ævar Arnfjörð Bjarmason
1010 * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later
1111 */
12 -
13 -/**
14 - * @addtogroup SpecialPage
15 - */
1612 class UnwatchedpagesPage extends QueryPage {
1713
1814 function getName() { return 'Unwatchedpages'; }
Index: trunk/phase3/includes/ParserOptions.php
@@ -3,6 +3,7 @@
44 /**
55 * Set options of the Parser
66 * @todo document
 7+ * @addtogroup Parser
78 */
89 class ParserOptions
910 {
Index: trunk/phase3/includes/SpecialMostimages.php
@@ -8,6 +8,7 @@
99 */
1010
1111 /**
 12+ * implements Special:Mostimages
1213 * @addtogroup SpecialPage
1314 */
1415 class MostimagesPage extends ImageQueryPage {
Index: trunk/phase3/includes/Profiler.php
@@ -40,6 +40,7 @@
4141
4242 /**
4343 * @todo document
 44+ * @addtogroup Profiler
4445 */
4546 class Profiler {
4647 var $mStack = array (), $mWorkStack = array (), $mCollated = array ();
Index: trunk/phase3/includes/api/ApiQuery.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 7, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiQuery extends ApiBase {
3436
3537 private $mPropModuleNames, $mListModuleNames, $mMetaModuleNames;
Index: trunk/phase3/includes/api/ApiQuerySiteinfo.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 25, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiQueryBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiQuerySiteinfo extends ApiQueryBase {
3436
3537 public function __construct($query, $moduleName) {
@@ -113,4 +115,4 @@
114116 return __CLASS__ . ': $Id$';
115117 }
116118 }
117 -?>
\ No newline at end of file
 119+?>
Index: trunk/phase3/includes/api/ApiQueryRevisions.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 7, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiQueryBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiQueryRevisions extends ApiQueryBase {
3436
3537 public function __construct($query, $moduleName) {
Index: trunk/phase3/includes/api/ApiLogin.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 19, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiLogin extends ApiBase {
3436
3537 public function __construct($main, $action) {
Index: trunk/phase3/includes/api/ApiFormatYaml_spyc.php
@@ -6,12 +6,11 @@
77 * @see http://spyc.sourceforge.net/
88 * @copyright Copyright 2005-2006 Chris Wanstrath
99 * @license http://www.opensource.org/licenses/mit-license.php MIT License
10 - * @addtogroup Spyc
1110 */
1211
1312 /**
1413 * A node, used by Spyc for parsing YAML.
15 - * @addtogroup Spyc
 14+ * @addtogroup API
1615 */
1716 class YAMLNode {
1817 /**#@+
@@ -59,7 +58,7 @@
6059 * $parser = new Spyc;
6160 * $array = $parser->load($file);
6261 * </code>
63 - * @addtogroup Spyc
 62+ * @addtogroup API
6463 */
6564 class Spyc {
6665
Index: trunk/phase3/includes/api/ApiFormatXml.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 19, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiFormatBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiFormatXml extends ApiFormatBase {
3436
3537 private $mRootElemName = 'api';
@@ -142,4 +144,4 @@
143145 return __CLASS__ . ': $Id$';
144146 }
145147 }
146 -?>
\ No newline at end of file
 148+?>
Index: trunk/phase3/includes/api/ApiBase.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 5, 2006
76 *
@@ -26,6 +25,7 @@
2726
2827 /**
2928 * @todo Document - e.g. Provide top-level description of this class.
 29+ * @addtogroup API
3030 */
3131 abstract class ApiBase {
3232
@@ -533,4 +533,4 @@
534534 return __CLASS__ . ': $Id$';
535535 }
536536 }
537 -?>
\ No newline at end of file
 537+?>
Index: trunk/phase3/includes/api/ApiFormatYaml.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 19, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiFormatBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiFormatYaml extends ApiFormatBase {
3436
3537 public function __construct($main, $format) {
@@ -51,4 +53,4 @@
5254 return __CLASS__ . ': $Id$';
5355 }
5456 }
55 -?>
\ No newline at end of file
 57+?>
Index: trunk/phase3/includes/api/ApiFormatJson_json.php
@@ -45,7 +45,7 @@
4646 * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
4747 * DAMAGE.
4848 *
49 -* @addtogroup Services_JSON
 49+* @addtogroup API
5050 * @author Michal Migurski <mike-json@teczno.com>
5151 * @author Matt Knapp <mdknapp[at]gmail[dot]com>
5252 * @author Brett Stimmerman <brettstimmerman[at]gmail[dot]com>
@@ -91,26 +91,28 @@
9292 define('SERVICES_JSON_SUPPRESS_ERRORS', 32);
9393
9494 /**
95 -* Converts to and from JSON format.
96 -*
97 -* Brief example of use:
98 -*
99 -* <code>
100 -* // create a new instance of Services_JSON
101 -* $json = new Services_JSON();
102 -*
103 -* // convert a complexe value to JSON notation, and send it to the browser
104 -* $value = array('foo', 'bar', array(1, 2, 'baz'), array(3, array(4)));
105 -* $output = $json->encode($value);
106 -*
107 -* print($output);
108 -* // prints: ["foo","bar",[1,2,"baz"],[3,[4]]]
109 -*
110 -* // accept incoming POST data, assumed to be in JSON notation
111 -* $input = file_get_contents('php://input', 1000000);
112 -* $value = $json->decode($input);
113 -* </code>
114 -*/
 95+ * Converts to and from JSON format.
 96+ *
 97+ * Brief example of use:
 98+ *
 99+ * <code>
 100+ * // create a new instance of Services_JSON
 101+ * $json = new Services_JSON();
 102+ *
 103+ * // convert a complexe value to JSON notation, and send it to the browser
 104+ * $value = array('foo', 'bar', array(1, 2, 'baz'), array(3, array(4)));
 105+ * $output = $json->encode($value);
 106+ *
 107+ * print($output);
 108+ * // prints: ["foo","bar",[1,2,"baz"],[3,[4]]]
 109+ *
 110+ * // accept incoming POST data, assumed to be in JSON notation
 111+ * $input = file_get_contents('php://input', 1000000);
 112+ * $value = $json->decode($input);
 113+ * </code>
 114+ *
 115+ * @addtogroup API
 116+ */
115117 class Services_JSON
116118 {
117119 /**
@@ -812,6 +814,9 @@
813815
814816 if (class_exists('PEAR_Error')) {
815817
 818+ /**
 819+ * @addtogroup API
 820+ */
816821 class Services_JSON_Error extends PEAR_Error
817822 {
818823 function Services_JSON_Error($message = 'unknown error', $code = null,
@@ -825,6 +830,7 @@
826831
827832 /**
828833 * @todo Ultimately, this class shall be descended from PEAR_Error
 834+ * @addtogroup API
829835 */
830836 class Services_JSON_Error
831837 {
Index: trunk/phase3/includes/api/ApiQueryAllpages.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 25, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiQueryBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiQueryAllpages extends ApiQueryGeneratorBase {
3436
3537 public function __construct($query, $moduleName) {
Index: trunk/phase3/includes/api/ApiResult.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 4, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiResult extends ApiBase {
3436
3537 private $mData, $mIsRawMode;
@@ -154,4 +156,4 @@
155157 return __CLASS__ . ': $Id$';
156158 }
157159 }
158 -?>
\ No newline at end of file
 160+?>
Index: trunk/phase3/includes/api/ApiFormatWddx.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Oct 22, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiFormatBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiFormatWddx extends ApiFormatBase {
3436
3537 public function __construct($main, $format) {
@@ -86,4 +88,4 @@
8789 return __CLASS__ . ': $Id$';
8890 }
8991 }
90 -?>
\ No newline at end of file
 92+?>
Index: trunk/phase3/includes/api/ApiQueryInfo.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 25, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiQueryBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiQueryInfo extends ApiQueryBase {
3436
3537 public function __construct($query, $moduleName) {
Index: trunk/phase3/includes/api/ApiFormatJson.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 19, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiFormatBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiFormatJson extends ApiFormatBase {
3436
3537 private $mIsRaw;
@@ -66,4 +68,4 @@
6769 return __CLASS__ . ': $Id$';
6870 }
6971 }
70 -?>
\ No newline at end of file
 72+?>
Index: trunk/phase3/includes/api/ApiFormatBase.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 19, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 abstract class ApiFormatBase extends ApiBase {
3436
3537 private $mIsHtml, $mFormat;
@@ -176,6 +178,7 @@
177179
178180 /**
179181 * This printer is used to wrap an instance of the Feed class
 182+ * @addtogroup API
180183 */
181184 class ApiFormatFeedWrapper extends ApiFormatBase {
182185
Index: trunk/phase3/includes/api/ApiMain.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 4, 2006
76 *
@@ -31,6 +30,7 @@
3231
3332 /**
3433 * This is the main API class, used for both external and internal processing.
 34+ * @addtogroup API
3535 */
3636 class ApiMain extends ApiBase {
3737
@@ -347,6 +347,7 @@
348348
349349 /**
350350 * This exception will be thrown when dieUsage is called to stop module execution.
 351+ * @addtogroup API
351352 */
352353 class UsageException extends Exception {
353354
Index: trunk/phase3/includes/api/ApiFeedWatchlist.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Oct 13, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ("ApiBase.php");
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiFeedWatchlist extends ApiBase {
3436
3537 public function __construct($main, $action) {
Index: trunk/phase3/includes/api/ApiQueryUserContributions.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Oct 16, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiQueryBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiQueryContributions extends ApiQueryBase {
3436
3537 public function __construct($query, $moduleName) {
Index: trunk/phase3/includes/api/ApiQueryBacklinks.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Oct 16, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ("ApiQueryBase.php");
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiQueryBacklinks extends ApiQueryGeneratorBase {
3436
3537 private $rootTitle, $contRedirs, $contLevel, $contTitle, $contID;
@@ -355,4 +357,4 @@
356358 return __CLASS__ . ': $Id$';
357359 }
358360 }
359 -?>
\ No newline at end of file
 361+?>
Index: trunk/phase3/includes/api/ApiOpenSearch.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Oct 13, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ("ApiBase.php");
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiOpenSearch extends ApiBase {
3436
3537 public function __construct($main, $action) {
@@ -106,4 +108,4 @@
107109 return __CLASS__ . ': $Id$';
108110 }
109111 }
110 -?>
\ No newline at end of file
 112+?>
Index: trunk/phase3/includes/api/ApiQueryWatchlist.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 25, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiQueryBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiQueryWatchlist extends ApiQueryGeneratorBase {
3436
3537 public function __construct($query, $moduleName) {
Index: trunk/phase3/includes/api/ApiHelp.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 6, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiHelp extends ApiBase {
3436
3537 public function __construct($main, $action) {
@@ -52,4 +54,4 @@
5355 return __CLASS__ . ': $Id$';
5456 }
5557 }
56 -?>
\ No newline at end of file
 58+?>
Index: trunk/phase3/includes/api/ApiPageSet.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 24, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiQueryBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiPageSet extends ApiQueryBase {
3436
3537 private $mAllPages; // [ns][dbkey] => page_id or 0 when missing
Index: trunk/phase3/includes/api/ApiQueryLogEvents.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Oct 16, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiQueryBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiQueryLogEvents extends ApiQueryBase {
3436
3537 public function __construct($query, $moduleName) {
Index: trunk/phase3/includes/api/ApiQueryRecentChanges.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Oct 19, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiQueryBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiQueryRecentChanges extends ApiQueryBase {
3436
3537 public function __construct($query, $moduleName) {
@@ -184,4 +186,4 @@
185187 return __CLASS__ . ': $Id$';
186188 }
187189 }
188 -?>
\ No newline at end of file
 190+?>
Index: trunk/phase3/includes/api/ApiQueryBase.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Sep 7, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 abstract class ApiQueryBase extends ApiBase {
3436
3537 private $mQueryModule, $tables, $where, $fields, $options;
@@ -341,6 +343,9 @@
342344 }
343345 }
344346
 347+/**
 348+ * @addtogroup API
 349+ */
345350 abstract class ApiQueryGeneratorBase extends ApiQueryBase {
346351
347352 private $mIsGenerator;
Index: trunk/phase3/includes/api/ApiFormatPhp.php
@@ -1,6 +1,5 @@
22 <?php
33
4 -
54 /*
65 * Created on Oct 22, 2006
76 *
@@ -29,6 +28,9 @@
3029 require_once ('ApiFormatBase.php');
3130 }
3231
 32+/**
 33+ * @addtogroup API
 34+ */
3335 class ApiFormatPhp extends ApiFormatBase {
3436
3537 public function __construct($main, $format) {
@@ -51,4 +53,4 @@
5254 return __CLASS__ . ': $Id$';
5355 }
5456 }
55 -?>
\ No newline at end of file
 57+?>
Index: trunk/phase3/includes/AjaxResponse.php
@@ -5,6 +5,7 @@
66
77 /**
88 * @todo document
 9+ * @addtogroup Ajax
910 */
1011 class AjaxResponse {
1112 var $mCacheDuration;
Index: trunk/phase3/includes/SpecialNewpages.php
@@ -5,7 +5,7 @@
66 */
77
88 /**
9 - *
 9+ * implements Special:Newpages
1010 * @addtogroup SpecialPage
1111 */
1212 class NewPagesPage extends QueryPage {
Index: trunk/phase3/includes/SpecialResetpass.php
@@ -5,6 +5,9 @@
66 $form->execute( $par );
77 }
88
 9+/**
 10+ * @addtogroup SpecialPage
 11+ */
912 class PasswordResetForm extends SpecialPage {
1013 function __construct( $name=null, $reset=null ) {
1114 if( $name !== null ) {
Index: trunk/phase3/includes/ProfilerSimple.php
@@ -5,6 +5,7 @@
66 /**
77 * Simple profiler base class.
88 * @todo document methods (?)
 9+ * @addtogroup Profiler
910 */
1011 class ProfilerSimple extends Profiler {
1112 var $mMinimumTime = 0;
Index: trunk/phase3/includes/Pager.php
@@ -2,6 +2,7 @@
33
44 /**
55 * Basic pager interface.
 6+ * @addtogroup Pager
67 */
78 interface Pager {
89 function getNavigationBar();
@@ -46,6 +47,8 @@
4748 * please see the examples in PageHistory.php and SpecialIpblocklist.php. You just need
4849 * to override formatRow(), getQueryInfo() and getIndexField(). Don't forget to call the
4950 * parent constructor if you override it.
 51+ *
 52+ * @addtogroup Pager
5053 */
5154 abstract class IndexPager implements Pager {
5255 public $mRequest;
@@ -389,7 +392,8 @@
390393
391394 /**
392395 * IndexPager with an alphabetic list and a formatted navigation bar
393 -*/
 396+ * @addtogroup Pager
 397+ */
394398 abstract class AlphabeticPager extends IndexPager {
395399 public $mDefaultDirection = false;
396400
@@ -423,6 +427,7 @@
424428
425429 /**
426430 * IndexPager with a formatted navigation bar
 431+ * @addtogroup Pager
427432 */
428433 abstract class ReverseChronologicalPager extends IndexPager {
429434 public $mDefaultDirection = true;
@@ -455,6 +460,7 @@
456461
457462 /**
458463 * Table-based display with a user-selectable sort order
 464+ * @addtogroup Pager
459465 */
460466 abstract class TablePager extends IndexPager {
461467 var $mSort;
Index: trunk/phase3/includes/SpecialPopularpages.php
@@ -5,7 +5,7 @@
66 */
77
88 /**
9 - *
 9+ * implements Special:Popularpages
1010 * @addtogroup SpecialPage
1111 */
1212 class PopularPagesPage extends QueryPage {
Index: trunk/phase3/includes/SpecialSearch.php
@@ -42,7 +42,7 @@
4343 }
4444
4545 /**
46 - * @todo document
 46+ * implements Special:Search - Run text & title search and display the output
4747 * @addtogroup SpecialPage
4848 */
4949 class SpecialSearch {
Index: trunk/phase3/includes/Sanitizer.php
@@ -315,6 +315,10 @@
316316 'zwj' => 8205,
317317 'zwnj' => 8204 );
318318
 319+/**
 320+ * XHTML sanitizer for MediaWiki
 321+ * @addtogroup Parser
 322+ */
319323 class Sanitizer {
320324 /**
321325 * Cleans up HTML, removes dangerous tags and attributes, and
Index: trunk/phase3/includes/templates/Userlogin.php
@@ -92,6 +92,9 @@
9393 }
9494 }
9595
 96+/**
 97+ * @addtogroup Templates
 98+ */
9699 class UsercreateTemplate extends QuickTemplate {
97100 function execute() {
98101 if( $this->data['message'] ) {
Index: trunk/phase3/includes/SpecialMostlinked.php
@@ -1,7 +1,8 @@
22 <?php
33
44 /**
5 - * A special page to show pages ordered by the number of pages linking to them
 5+ * A special page to show pages ordered by the number of pages linking to them.
 6+ * Implements Special:Mostlinked
67 *
78 * @addtogroup SpecialPage
89 *
@@ -11,10 +12,6 @@
1213 * @copyright © 2006 Rob Church
1314 * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later
1415 */
15 -
16 -/**
17 - * @addtogroup SpecialPage
18 - */
1916 class MostlinkedPage extends QueryPage {
2017
2118 function getName() { return 'Mostlinked'; }
Index: trunk/phase3/includes/SpecialUncategorizedcategories.php
@@ -10,7 +10,7 @@
1111 require_once( "SpecialUncategorizedpages.php" );
1212
1313 /**
14 - *
 14+ * implements Special:Uncategorizedcategories
1515 * @addtogroup SpecialPage
1616 */
1717 class UncategorizedCategoriesPage extends UncategorizedPagesPage {
Index: trunk/phase3/includes/ParserOutput.php
@@ -1,6 +1,7 @@
22 <?php
33 /**
44 * @todo document
 5+ * @addtogroup Parser
56 */
67 class ParserOutput
78 {
Index: trunk/phase3/includes/User.php
@@ -17,6 +17,7 @@
1818
1919 /**
2020 * Thrown by User::setPassword() on error
 21+ * @addtogroup Exception
2122 */
2223 class PasswordError extends MWException {
2324 // NOP
Index: trunk/phase3/includes/SpecialImagelist.php
@@ -23,6 +23,10 @@
2424 . $nav );
2525 }
2626
 27+/**
 28+ * @addtogroup SpecialPage
 29+ * @addtogroup Pager
 30+ */
2731 class ImageListPager extends TablePager {
2832 var $mFieldNames = null;
2933 var $mMessages = array();
Index: trunk/phase3/includes/SpecialUnusedtemplates.php
@@ -1,6 +1,7 @@
22 <?php
33
44 /**
 5+ * implements Special:Unusedtemplates
56 * @author Rob Church <robchur@gmail.com>
67 * @copyright © 2006 Rob Church
78 * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later