If making mass changes to tweak to its preferences, probably better to do it for the tool we actually generate docs with. :)
require_once( 'AjaxFunctions.php' );
-/**
- * @todo Document - e.g. Provide top-level description of this class.
- */
class AjaxDispatcher {
var $mode;
var $func_name;
die( 1 );
}
-/**
- * @todo document
- */
+/** @todo document */
class AjaxResponse {
var $mCacheDuration;
var $mVary;
*
*/
class Article {
- /**
+ /**@{{
* @private
*/
var $mComment; //!<
var $mTouched; //!<
var $mUser; //!<
var $mUserText; //!<
- /** end private properties */
+ /**@}}*/
/**
* Constructor and clear the article
*
* @param Revision $rev
*
- * @todo This is a shitty interface function. Kill it and replace the
+ * @fixme This is a shitty interface function. Kill it and replace the
* other shitty functions like editUpdates and such so it's not needed
* anymore.
*/
<?php
+/*
+The "Categoryfinder" class takes a list of articles, creates an internal representation of all their parent
+categories (as well as parents of parents etc.). From this representation, it determines which of these articles
+are in one or all of a given subset of categories.
+
+Example use :
+
+ # Determines wether the article with the page_id 12345 is in both
+ # "Category 1" and "Category 2" or their subcategories, respectively
+
+ $cf = new Categoryfinder ;
+ $cf->seed (
+ array ( 12345 ) ,
+ array ( "Category 1","Category 2" ) ,
+ "AND"
+ ) ;
+ $a = $cf->run() ;
+ print implode ( "," , $a ) ;
+
+*/
+
-/**
- * The "Categoryfinder" class takes a list of articles, creates an internal representation of all their parent
- * categories (as well as parents of parents etc.). From this representation, it determines which of these articles
- * are in one or all of a given subset of categories.
- *
- * Example use :
- *
- * # Determines wether the article with the page_id 12345 is in both
- * # "Category 1" and "Category 2" or their subcategories, respectively
- *
- * $cf = new Categoryfinder ;
- * $cf->seed (
- * array ( 12345 ) ,
- * array ( "Category 1","Category 2" ) ,
- * "AND"
- * ) ;
- * $a = $cf->run() ;
- * print implode ( "," , $a ) ;
- *
- *
- */
class Categoryfinder {
var $articles = array () ; # The original article IDs passed to the seed function
<?php
+/**
+ * Contain class to show various lists of change:
+ * - what's link here
+ * - related changes
+ * - recent changes
+ */
/**
* @todo document
} ;
/**
- * Class to show various lists of changes:
- * - what links here
- * - related changes
- * - recent changes
*/
class ChangesList {
# Called by history lists and recent changes
* Utility classes
*****************************************************************************/
-/**
- * Utility class.
- */
class DBObject {
public $mData;
}
};
-/**
- * Utility class.
- */
class MySQLField {
private $name, $tablename, $default, $max_length, $nullable,
$is_pk, $is_unique, $is_key, $type;
# Other functions
#------------------------------------------------------------------------------
- /**
- * Constructor.
+ /**@{{
* @param string $server database server host
* @param string $user database user name
* @param string $password database user password
* @param string $dbname database name
+ */
+
+ /**
* @param failFunction
* @param $flags
* @param $tablePrefix String: database table prefixes. By default use the prefix gave in LocalSettings.php
wfProfileOut( __METHOD__ );
return $success;
}
+ /**@}}*/
/**
* Closes a database connection.
}
/**
- * Fetch a number of table names into an zero-indexed numerical array
+ * @desc: Fetch a number of table names into an zero-indexed numerical array
* This is handy when you need to construct SQL for joins
*
* Example:
/**
* This is the Oracle database abstraction layer.
*/
+
class ORABlob {
var $mData;
function getData() {
return $this->mData;
}
-}
+};
-/**
+/*
* 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.
<?php
-
/**
* Date formatter, recognises dates in plain text and formats them accoding to user preferences.
+ *
+ * @addtogroup Parser
+ */
+
+/**
* @todo preferences, OutputPage
* @addtogroup Parser
*/
/** Sets the mime type definition file to use by MimeMagic.php.
* @global string $wgMimeTypeFile
*/
-$wgMimeTypeFile= "includes/mime.types";
#$wgMimeTypeFile= "/etc/mime.types";
+$wgMimeTypeFile= "includes/mime.types";
#$wgMimeTypeFile= NULL; #use built-in defaults only.
/** Sets the mime type info file to use by MimeMagic.php.
<?php
/**
* See diff.doc
- * @todo indicate where diff.doc can be found.
* @addtogroup DifferenceEngine
*/
}
/**
- * @todo document, bad name.
+ * FIXME: bad name.
+ * @todo document
* @private
* @addtogroup DifferenceEngine
*/
<?php
-
/**
+ * Support for detecting/validating DjVu image files and getting
+ * some basic file metadata (resolution etc)
+ *
+ * File format docs are available in source package for DjVuLibre:
+ * http://djvulibre.djvuzone.org/
+ *
*
* Copyright (C) 2006 Brion Vibber <brion@pobox.com>
* http://www.mediawiki.org/
*
*/
-/**
- * Support for detecting/validating DjVu image files and getting
- * some basic file metadata (resolution etc)
- *
- * File format docs are available in source package for DjVuLibre:
- * http://djvulibre.djvuzone.org/
- */
class DjVuImage {
function __construct( $filename ) {
$this->mFilename = $filename;
<?php
/**
- * Contains the EditPage class
+ * Contain the EditPage class
*/
/**
- * The edit page/HTML interface (split from Article)
+ * Splitting edit page/HTML interface from Article...
* The actual database and text munging is still in Article,
* but it should get easier to call those from alternate
* interfaces.
+ *
*/
+
class EditPage {
var $mArticle;
var $mTitle;
* http://www.gnu.org/copyleft/gpl.html
*
* @link http://exif.org/Exif2-2.PDF The Exif 2.2 specification
+ * @bug 1555, 1947
*/
/**
- * @todo document (e.g. one-sentence class-overview description)
* @addtogroup Metadata
*/
class Exif {
}
/**
- * @todo document (e.g. one-sentence class-overview description)
* @addtogroup Metadata
*/
class FormatExif {
<?php
-
+# Basic support for outputting syndication feeds in RSS, other formats
+#
# Copyright (C) 2004 Brion Vibber <brion@pobox.com>
# http://www.mediawiki.org/
#
# http://www.gnu.org/copyleft/gpl.html
/**
- * Basic support for outputting syndication feeds in RSS, other formats.
* Contain a feed class as well as classes to build rss / atom ... feeds
* Available feeds are defined in Defines.php
*/
+
/**
- * @todo document (needs one-sentence top-level class description + function descriptions).
+ * @todo document
*/
class FeedItem {
/**#@+
}
/**
- * @todo document (needs one-sentence top-level class description).
+ * @todo document
*/
class ChannelFeed extends FeedItem {
/**#@+
/**
* Generate a RSS feed
+ * @todo document
*/
class RSSFeed extends ChannelFeed {
/**
* Generate an Atom feed
+ * @todo document
*/
class AtomFeed extends ChannelFeed {
/**
<?php
-/**
- * @todo document (needs one-sentence top-level class description).
- */
class FileStore {
const DELETE_ORIGINAL = 1;
* suffer an uncaught error the lock will be released when the
* connection is closed.
*
- * @todo Probably only works on MySQL. Abstract to the Database class?
+ * @fixme Probably only works on MySQL. Abstract to the Database class?
*/
static function lock() {
global $wgDBtype;
* @throws FSException if file can't be deleted
* @return FSTransaction
*
- * @todo Might be worth preliminary permissions check
+ * @fixme Might be worth preliminary permissions check
*/
static function deleteFile( $path ) {
if( file_exists( $path ) ) {
* Returns message in the requested format
* @param string $key Key of the message
* @param array $options Processing rules:
- * <i>parse</i>: parses wikitext to html
- * <i>parseinline</i>: parses wikitext to html and removes the surrounding p's added by parser or tidy
- * <i>escape</i>: filters message trough htmlspecialchars
- * <i>replaceafter</i>: parameters are substituted after parsing or escaping
- * <i>parsemag</i>: transform the message using magic phrases
+ * <i>parse<i>: parses wikitext to html
+ * <i>parseinline<i>: parses wikitext to html and removes the surrounding p's added by parser or tidy
+ * <i>escape<i>: filters message trough htmlspecialchars
+ * <i>replaceafter<i>: parameters are substituted after parsing or escaping
+ * <i>parsemag<i>: transform the message using magic phrases
*/
function wfMsgExt( $key, $options ) {
global $wgOut, $wgParser;
* Just like exit() but makes a note of it.
* Commits open transactions except if the error parameter is set
*
- * @deprecated Please return control to the caller or throw an exception
+ * @obsolete Please return control to the caller or throw an exception
*/
function wfAbruptExit( $error = false ){
global $wgLoadBalancer;
}
/**
- * @deprecated Please return control the caller or throw an exception
+ * @obsolete Please return control the caller or throw an exception
*/
function wfErrorExit() {
wfAbruptExit( true );
/**
* An Exif timestamp (YYYY:MM:DD HH:MM:SS)
*
- * @link http://exif.org/Exif2-2.PDF The Exif 2.2 spec, see page 28 for the
+ * @url http://exif.org/Exif2-2.PDF The Exif 2.2 spec, see page 28 for the
* DateTime tag and page 36 for the DateTimeOriginal and
* DateTimeDigitized tags.
*/
}
}
-/**
- * @todo document (e.g. one-sentence top-level class description).
- */
class HTMLCacheUpdateJob extends Job {
var $table, $start, $end;
/**
* Pure virtual parent
- * @todo document (needs a one-sentence top-level class description, that answers the question: "what is a HistoryBlob?")
*/
class HistoryBlob
{
/**
* The real object
- * @todo document (needs one-sentence top-level class description + function descriptions).
*/
class ConcatenatedGzipHistoryBlob extends HistoryBlob
{
/**
- * @todo document (needs one-sentence top-level class description + some function descriptions).
*/
class HistoryBlobStub {
var $mOldId, $mHash, $mRef;
$this->mOldId = $id;
}
- /**
- * Sets the location (old_id) of the referring object
- */
+ /**
+ * Sets the location (old_id) of the referring object
+ */
function setReferrer( $id ) {
$this->mRef = $id;
}
- /**
- * Gets the location of the referring object
- */
+ /**
+ * Gets the location of the referring object
+ */
function getReferrer() {
return $this->mRef;
}
*
* Serialized HistoryBlobCurStub objects will be inserted into the text table
* on conversion if $wgFastSchemaUpgrades is set to true.
+ *
*/
class HistoryBlobCurStub {
var $mCurId;
<?php
/*
+ * Collection of public static functions to play with IP address
+ * and IP blocks.
+ *
* @Author "Ashar Voultoiz" <hashar@altern.org>
* @License GPL v2 or later
*/
// This might be useful for regexps used elsewhere, matches any IPv6 or IPv6 address or network
define( 'IP_ADDRESS_STRING', RE_IP_ADD . '(\/' . RE_IP_PREFIX . '|)|' . RE_IPV6_ADD . '(\/' . RE_IPV6_PREFIX . '|)');
-/**
- * A collection of public static functions to play with IP address
- * and IP blocks.
- */
class IP {
/**
* Given a string, determine if it as valid IP
die( "This file is part of MediaWiki, it is not a valid entry point\n" );
}
-/**
- * @todo document (e.g. one-sentence top-level class description).
- */
abstract class Job {
var $command,
$title,
}
}
-
-/**
- * @todo document (e.g. one-sentence top-level class description).
- */
class RefreshLinksJob extends Job {
function __construct( $title, $params = '', $id = 0 ) {
parent::__construct( 'refreshLinks', $title, $params, $id );
<?php
/**
* A License class for use on Special:Upload
- *
+ *
* @addtogroup SpecialPage
*
* @author Ævar Arnfjörð Bjarmason <avarab@gmail.com>
function getHtml() { return $this->html; }
}
-/**
- * A License class for use on Special:Upload (represents a single type of license).
- */
class License {
/**
* @var string
<?php
/**
* Cache for article titles (prefixed DB keys) and ids linked from one source
- *
+ * @addtogroup Cache
+ */
+
+/**
* @addtogroup Cache
*/
class LinkCache {
<?php
/**
- * See docs/deferred.txt
- *
- * @todo document (e.g. one-sentence top-level class description).
+ * See deferred.txt
+ */
+
+/**
+ * @todo document
*/
class LinksUpdate {
- /**
+ /**@{{
* @private
*/
var $mId, //!< Page ID of the article linked from
$mDb, //!< Database connection reference
$mOptions, //!< SELECT options to be used (array)
$mRecursive; //!< Whether to queue jobs for recursive updates
- /** end private attributes */
+ /**@}}*/
/**
* Constructor
}
/**
- * @todo handle missing log types
+ * @fixme: handle missing log types
* @static
*/
function logHeader( $type ) {
$this->returnToMain( false );
}
- /** @deprecated */
+ /** @obsolete */
public function errorpage( $title, $msg ) {
throw new ErrorPageError( $title, $msg );
}
$this->returnToMain( true, $mainPage );
}
- /** @deprecated */
+ /** @obsolete */
public function databaseError( $fname, $sql, $error, $errno ) {
throw new MWException( "OutputPage::databaseError is obsolete\n" );
}
$this->returnToMain( false );
}
- /** @deprecated */
+ /** @obsolete */
public function fatalError( $message ) {
throw new FatalError( $message );
}
- /** @deprecated */
+ /** @obsolete */
public function unexpectedValueError( $name, $val ) {
throw new FatalError( wfMsg( 'unexpected', $name, $val ) );
}
- /** @deprecated */
+ /** @obsolete */
public function fileCopyError( $old, $new ) {
throw new FatalError( wfMsg( 'filecopyerror', $old, $new ) );
}
- /** @deprecated */
+ /** @obsolete */
public function fileRenameError( $old, $new ) {
throw new FatalError( wfMsg( 'filerenameerror', $old, $new ) );
}
- /** @deprecated */
+ /** @obsolete */
public function fileDeleteError( $name ) {
throw new FatalError( wfMsg( 'filedeleteerror', $name ) );
}
- /** @deprecated */
+ /** @obsolete */
public function fileNotFoundError( $name ) {
throw new FatalError( wfMsg( 'filenotfound', $name ) );
}
define( 'MW_COLON_STATE_COMMENTDASHDASH', 7 );
/**
- * PHP Parser - Processes wiki markup (which uses a more user-friendly
- * syntax, such as "[[link]]" for making links), and provides a one-way
- * transformation of that wiki markup it into XHTML output / markup
- * (which in turn the browser understands, and can display).
+ * PHP Parser
+ *
+ * Processes wiki markup
*
* <pre>
* There are four main entry points into the Parser class:
* @param string
* @return string
* @static
- * @todo This can merge genuinely required bits in the path or query string,
+ * @fixme This can merge genuinely required bits in the path or query string,
* breaking legit URLs. A proper fix would treat the various parts of
* the URL differently; as a workaround, just use the output for
* statistical records, not for actual linking/output.
}
-/**
- * @todo document, briefly.
- */
class OnlyIncludeReplacer {
var $output = '';
}
}
-/**
- * @todo document, briefly.
- */
class StripState {
var $general, $nowiki;
*/
/**
- * @todo document
+ *
*/
class ParserCache {
/**
<?php
-
-require_once(dirname(__FILE__).'/Profiler.php');
+/**
+ * Simple profiler base class
+ */
/**
- * Simple profiler base class.
- * @todo document methods (?)
+ * @todo document
*/
+require_once(dirname(__FILE__).'/Profiler.php');
+
class ProfilerSimple extends Profiler {
var $mMinimumTime = 0;
var $mProfileID = false;
<?php
+/* ProfilerSimpleUDP class, that sends out messages for 'udpprofile' daemon
+ (the one from mediawiki/trunk/udpprofile SVN )
+*/
require_once(dirname(__FILE__).'/Profiler.php');
require_once(dirname(__FILE__).'/ProfilerSimple.php');
-/**
- * ProfilerSimpleUDP class, that sends out messages for 'udpprofile' daemon
- * (the one from mediawiki/trunk/udpprofile SVN )
- */
class ProfilerSimpleUDP extends ProfilerSimple {
function getFunctionReport() {
global $wgUDPProfilerHost;
* @addtogroup SpecialPage
*/
-/**
- * @todo document, briefly.
- */
class ProtectionForm {
var $mRestrictions = array();
var $mReason = '';
* name attributes
* @link http://www.w3.org/TR/html401/struct/links.html#h-12.2.3 Anchors with the id attribute
*
+ * @bug 4461
+ *
* @static
*
* @param string $id
}
/**
- * @todo document with one-sentence top-level class description.
+ *
*/
class SkinTemplate extends Skin {
/**#@+
*/
/**
- * @todo document, briefly.
+ *
* @addtogroup SpecialPage
*/
class AncientPagesPage extends QueryPage {
}
/**
- * Form object for the Special:Blockip page.
+ * Form object
*
* @addtogroup SpecialPage
*/
* @addtogroup SpecialPage
*/
-require_once('UserMailer.php');
-
/**
- * @todo document
+ *
*/
+require_once('UserMailer.php');
+
function wfSpecialEmailuser( $par ) {
global $wgUser, $wgOut, $wgRequest, $wgEnableEmail, $wgEnableUserEmail;
}
-/**
- * @todo document (e.g. one-sentence class description).
- */
class ImportStringSource {
function ImportStringSource( $string ) {
$this->mString = $string;
}
}
-/**
- * @todo document (e.g. one-sentence class description).
- */
class ImportStreamSource {
function ImportStreamSource( $handle ) {
$this->mHandle = $handle;
}
/**
- * @todo document
+ *
* @addtogroup SpecialPage
*/
class IPUnblockForm {
}
}
-/**
- * @todo document
- */
class IPBlocklistPager extends ReverseChronologicalPager {
public $mForm, $mConds;
*/
/**
- * Special:Listredirects - Lists all the redirects on the wiki.
* @addtogroup SpecialPage
*/
+
class ListredirectsPage extends QueryPage {
function getName() { return( 'Listredirects' ); }
}
/**
- * @todo document - e.g. a one-sentence top-level class description.
+ *
* @addtogroup SpecialPage
*/
class DBLockForm {
}
/**
- * @todo document (needs one-sentence top-level class description)
+ *
* @addtogroup SpecialPage
*/
class LogReader {
}
/**
- * @todo document (needs one-sentence top-level class description)
+ *
* @addtogroup SpecialPage
*/
class LogViewer {
*/
/**
- * Searches the database for files of the requested MIME type, comparing this with the
- * 'img_major_mime' and 'img_minor_mime' fields in the image table.
* @addtogroup SpecialPage
*/
class MIMEsearchPage extends QueryPage {
}
/**
- * Output the HTML search form, and constructs the MIMEsearchPage object.
+ * constructor
*/
function wfSpecialMIMEsearch( $par = null ) {
global $wgRequest, $wgTitle, $wgOut;
}
/**
- * HTML form for Special:Movepage
+ *
* @addtogroup SpecialPage
*/
class MovePageForm {
*/
/**
- * @todo document
+ *
* @addtogroup SpecialPage
*/
class ProtectedPagesForm {
}
/**
- * @todo document
+ *
+ *
*/
class ProtectedPagesPager extends ReverseChronologicalPager {
public $mForm, $mConds;
*
* @addtogroup Special pages
* @author Rob Church <robchur@gmail.com>
- * @license GNU General Public Licence 2.0 or later
+ * @licence GNU General Public Licence 2.0 or later
*/
/**
}
/**
- * @todo document (just needs one-sentence top-level class description)
+ *
* @addtogroup SpecialPage
*/
class PageArchive {
* if not a file page.
*
* @return ResultWrapper
- * @todo Does this belong in Image for fuller encapsulation?
+ * @fixme Does this belong in Image for fuller encapsulation?
*/
function listFiles() {
if( $this->title->getNamespace() == NS_IMAGE ) {
}
/**
- * The HTML form for Special:Undelete, which allows users with the appropriate
- * permissions to view and restore deleted content.
+ *
* @addtogroup SpecialPage
*/
class UndeleteForm {
}
/**
- * @todo document, briefly.
+ *
* @addtogroup SpecialPage
*/
*
* @addtogroup SpecialPage
*
+ * @bug 2019, 4531
+ *
* @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
/**
* Retrieve the revision number of a Subversion working directory.
*
+ * @bug 7335
+ *
* @param string $dir
* @return mixed revision number as int, or false if not a SVN checkout
*/
/**
* Can $wgUser read this page?
* @return boolean
- * @todo fold these checks into userCan()
+ * @fixme fold these checks into userCan()
*/
public function userCanRead() {
global $wgUser;
* Cascading protection: Return true if cascading restrictions apply to this page, false if not.
*
* @return bool If the page is subject to cascading restrictions.
- * @access public
+ * @access public.
*/
function isCascadeProtected() {
list( $sources, $restrictions ) = $this->getCascadeProtectionSources( false );
* members directly, which is what Linker::formatComment was doing previously.
*
* @param string $fragment text
- * @access public
- * @todo clarify whether access is supposed to be public (was marked as "kind of public")
+ * @access kind of public
*/
function setFragment( $fragment ) {
$this->mFragment = str_replace( '_', ' ', substr( $fragment, 1 ) );
* addresses like this, if we allowed accounts like this to be created
* new users could get the old edits of these anonymous users.
*
+ * @bug 3631
+ *
* @static
* @param string $name Nickname of a user
* @return bool
* rejected valid addresses. Actually just check if there is '@' somewhere
* in the given address.
*
- * @todo Check for RFC 2822 compilance (bug 959)
+ * @todo Check for RFC 2822 compilance
+ * @bug 959
*
* @param string $addr email address
* @static
/**
* Return a random password. Sourced from mt_rand, so it's not particularly secure.
- * @todo hash random numbers to improve security, like generateToken()
+ * @todo: hash random numbers to improve security, like generateToken()
*
* @return string
* @static
/**
* Add the user to the given group.
* This takes immediate effect.
- * @param string $group
+ * @string $group
*/
function addGroup( $group ) {
$this->load();
/**
* Remove the user from the given group.
* This takes immediate effect.
- * @param string $group
+ * @string $group
*/
function removeGroup( $group ) {
$this->load();
/**
* Save object settings into database
- * @todo Only rarely do all these fields need to be set!
+ * @fixme Only rarely do all these fields need to be set!
*/
function saveSettings() {
$this->load();
return '"' . $phrase . '"';
}
-/**
- * Stores a single person's name and email address.
- * These are passed in via the constructor, and will be returned in SMTP
- * header format when requested.
- */
class MailAddress {
/**
* @param mixed $address String with an email address, or a User object
*
*/
class EmailNotification {
- /**
- * @private member variables:
+ /**@{{
+ * @private
*/
var $to, $subject, $body, $replyto, $from;
var $user, $title, $timestamp, $summary, $minorEdit, $oldid;
+ /**@}}*/
+
/**
* @todo document
* @param $title Title object
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
# http://www.gnu.org/copyleft/gpl.html
-
-/**
- * Some entry points may use this file without first enabling the
- * autoloader.
- */
-if ( !function_exists( '__autoload' ) ) {
- require_once( dirname(__FILE__) . '/normal/UtfNormal.php' );
-}
-
/**
* The WebRequest class encapsulates getting at data passed in the
* URL or via a POSTed form, handling remove of "magic quotes" slashes,
* input.
*
*/
+
+/**
+ * Some entry points may use this file without first enabling the
+ * autoloader.
+ */
+if ( !function_exists( '__autoload' ) ) {
+ require_once( dirname(__FILE__) . '/normal/UtfNormal.php' );
+}
+
class WebRequest {
function __construct() {
$this->checkMagicQuotes();
* http://www.gnu.org/copyleft/gpl.html
*/
-/**
- * @todo Document - e.g. Provide top-level description of this class.
- */
abstract class ApiBase {
// These constants allow modules to specify exactly how to treat incomming parameters.
* @addtogroup Spyc
*/
class YAMLNode {
- /**
+ /**#@+
* @access public
* @var string
*/
var $parent;
var $id;
+ /**#@+*/
/**
* @access public
* @var mixed
/**** Private Properties ****/
- /**
+ /**#@+
* @access private
* @var mixed
*/
var $_isInline;
var $_dumpIndent;
var $_dumpWordWrap;
+ /**#@+*/
/**** Private Methods ****/