Change-Id: I47fa96a976f55a1a93cb75397285edb8c7f4cd8a
30 files changed:
* @return bool
*/
private function getX( $key ) {
* @return bool
*/
private function getX( $key ) {
class AtomFeed extends ChannelFeed {
/**
* @todo document
class AtomFeed extends ChannelFeed {
/**
* @todo document
+ * @param string|int $ts
* @return string
*/
function formatTime( $ts ) {
* @return string
*/
function formatTime( $ts ) {
/**
* Fork a number of worker processes.
*
/**
* Fork a number of worker processes.
*
* @return string
*/
protected function forkWorkers( $numProcs ) {
* @return string
*/
protected function forkWorkers( $numProcs ) {
/* @{ */
/**
* Whether the option exists.
/* @{ */
/**
* Whether the option exists.
* @return bool
*/
public function offsetExists( $name ) {
* @return bool
*/
public function offsetExists( $name ) {
/**
* Retrieve an option value.
/**
* Retrieve an option value.
* @return mixed
*/
public function offsetGet( $name ) {
* @return mixed
*/
public function offsetGet( $name ) {
/**
* Set an option to given value.
/**
* Set an option to given value.
+ * @param string $name
+ * @param mixed $value
*/
public function offsetSet( $name, $value ) {
$this->setValue( $name, $value );
*/
public function offsetSet( $name, $value ) {
$this->setValue( $name, $value );
*/
public function offsetUnset( $name ) {
$this->delete( $name );
*/
public function offsetUnset( $name ) {
$this->delete( $name );
* frame parameters supplied by the Parser.
* @param array $frameParams The frame parameters
* @param string $query An optional query string to add to description page links
* frame parameters supplied by the Parser.
* @param array $frameParams The frame parameters
* @param string $query An optional query string to add to description page links
+ * @param Parser|null $parser
* @return array
*/
private static function getImageLinkMTOParams( $frameParams, $query = '', $parser = null ) {
* @return array
*/
private static function getImageLinkMTOParams( $frameParams, $query = '', $parser = null ) {
* Constructor for OutputPage. This should not be called directly.
* Instead a new RequestContext should be created and it will implicitly create
* a OutputPage tied to that context.
* Constructor for OutputPage. This should not be called directly.
* Instead a new RequestContext should be created and it will implicitly create
* a OutputPage tied to that context.
+ * @param IContextSource|null $context
*/
function __construct( IContextSource $context = null ) {
if ( $context === null ) {
*/
function __construct( IContextSource $context = null ) {
if ( $context === null ) {
/**
* Set the URL to be used for the <link rel=canonical>. This should be used
* in preference to addLink(), to avoid duplicate link tags.
/**
* Set the URL to be used for the <link rel=canonical>. This should be used
* in preference to addLink(), to avoid duplicate link tags.
*/
function setCanonicalUrl( $url ) {
$this->mCanonicalUrl = $url;
*/
function setCanonicalUrl( $url ) {
$this->mCanonicalUrl = $url;
/**
* This is called if a write operation is possible from the generated HTML
/**
* This is called if a write operation is possible from the generated HTML
*/
function preventClickjacking( $enable = true ) {
$this->preventClickjacking = $enable;
*/
function preventClickjacking( $enable = true ) {
$this->preventClickjacking = $enable;
/**
* Performs file verification, dies on error.
/**
* Performs file verification, dies on error.
+ * @param array $verification
*/
protected function checkVerification( array $verification ) {
// @todo Move them to ApiBase's message map
*/
protected function checkVerification( array $verification ) {
// @todo Move them to ApiBase's message map
return new $this->contentClass( '' );
}
return new $this->contentClass( '' );
}
- /** JSON is English **/
+ /**
+ * Returns the english language, because JSON is english, and should be handled as such.
+ *
+ * @param Title $title
+ * @param Content|null $content
+ *
+ * @return Language Return of wfGetLangObj( 'en' )
+ *
+ * @see ContentHandler::getPageLanguage()
+ */
public function getPageLanguage( Title $title, Content $content = null ) {
return wfGetLangObj( 'en' );
}
public function getPageLanguage( Title $title, Content $content = null ) {
return wfGetLangObj( 'en' );
}
- /** JSON is English **/
+ /**
+ * Returns the english language, because JSON is english, and should be handled as such.
+ *
+ * @param Title $title
+ * @param Content|null $content
+ *
+ * @return Language Return of wfGetLangObj( 'en' )
+ *
+ * @see ContentHandler::getPageLanguage()
+ */
public function getPageViewLanguage( Title $title, Content $content = null ) {
return wfGetLangObj( 'en' );
}
public function getPageViewLanguage( Title $title, Content $content = null ) {
return wfGetLangObj( 'en' );
}
* @return string
*/
private function formatError( $err ) {
* @return string
*/
private function formatError( $err ) {
/**
* Begin a transaction, committing any previously open transaction
/**
* Begin a transaction, committing any previously open transaction
*/
protected function doBegin( $fname = __METHOD__ ) {
sqlsrv_begin_transaction( $this->mConn );
*/
protected function doBegin( $fname = __METHOD__ ) {
sqlsrv_begin_transaction( $this->mConn );
*/
protected function doCommit( $fname = __METHOD__ ) {
sqlsrv_commit( $this->mConn );
*/
protected function doCommit( $fname = __METHOD__ ) {
sqlsrv_commit( $this->mConn );
/**
* Rollback a transaction.
* No-op on non-transactional databases.
/**
* Rollback a transaction.
* No-op on non-transactional databases.
*/
protected function doRollback( $fname = __METHOD__ ) {
sqlsrv_rollback( $this->mConn );
*/
protected function doRollback( $fname = __METHOD__ ) {
sqlsrv_rollback( $this->mConn );
/**
* Return aggregated value function call
/**
* Return aggregated value function call
+ * @param array $valuedata
+ * @param string $valuename
+ * @return array
*/
public function aggregateValue( $valuedata, $valuename = 'value' ) {
return $valuedata;
*/
public function aggregateValue( $valuedata, $valuename = 'value' ) {
return $valuedata;
* Clean text for indexing. Only really suitable for indexing in databases.
* If you're using a real search engine, you'll probably want to override
* this behavior and do something nicer with the original wikitext.
* Clean text for indexing. Only really suitable for indexing in databases.
* If you're using a real search engine, you'll probably want to override
* this behavior and do something nicer with the original wikitext.
*/
public static function updateText( $text ) {
global $wgContLang;
*/
public static function updateText( $text ) {
global $wgContLang;
* Get a string representation of a title suitable for
* including in a search index
*
* Get a string representation of a title suitable for
* including in a search index
*
+ * @param SearchEngine $search
* @return string A stripped-down title string ready for the search index
*/
private function indexTitle( SearchEngine $search ) {
* @return string A stripped-down title string ready for the search index
*/
private function indexTitle( SearchEngine $search ) {
/**
* Use specified text instead of loading from the database
/**
* Use specified text instead of loading from the database
+ * @param Content $oldContent
+ * @param Content $newContent
* @since 1.21
*/
public function setContent( Content $oldContent, Content $newContent ) {
* @since 1.21
*/
public function setContent( Content $oldContent, Content $newContent ) {
/**
* Set the language in which the diff text is written
* (Defaults to page content language).
/**
* Set the language in which the diff text is written
* (Defaults to page content language).
+ * @param Language|string $lang
* @since 1.19
*/
public function setTextLanguage( $lang ) {
* @since 1.19
*/
public function setTextLanguage( $lang ) {
/**
* Send a header, if we haven't already sent them. We shouldn't,
* but sometimes we might in a weird case like Export
/**
* Send a header, if we haven't already sent them. We shouldn't,
* but sometimes we might in a weird case like Export
+ * @param string $header
*/
private static function header( $header ) {
if ( !headers_sent() ) {
*/
private static function header( $header ) {
if ( !headers_sent() ) {
/**
* Check if the backend medium supports a field of extra features
*
/**
* Check if the backend medium supports a field of extra features
*
- * @return int Bitfield of FileBackend::ATTR_* flags
+ * @param int $bitfield Bitfield of FileBackend::ATTR_* flags
* @return bool
* @since 1.23
*/
* @return bool
* @since 1.23
*/
* Delete files in the deleted directory if they are not referenced in the filearchive table
*
* STUB
* Delete files in the deleted directory if they are not referenced in the filearchive table
*
* STUB
+ * @param array $storageKeys
*/
public function cleanupDeletedBatch( array $storageKeys ) {
$this->assertWritableRepo();
*/
public function cleanupDeletedBatch( array $storageKeys ) {
$this->assertWritableRepo();
/**
* Create a repo class based on an info structure
/**
* Create a repo class based on an info structure
*/
protected function newRepo( $info ) {
$class = $info['class'];
*/
protected function newRepo( $info ) {
$class = $info['class'];
* Hook into transform() to allow migration of thumbnail files
* STUB
* Overridden by LocalFile
* Hook into transform() to allow migration of thumbnail files
* STUB
* Overridden by LocalFile
+ * @param string $thumbName
*/
function migrateThumbFile( $thumbName ) {
}
*/
function migrateThumbFile( $thumbName ) {
}
/**
* Load file metadata from the DB
/**
* Load file metadata from the DB
*/
function loadFromDB( $flags = 0 ) {
# Polymorphic function name to distinguish foreign and local fetches
*/
function loadFromDB( $flags = 0 ) {
# Polymorphic function name to distinguish foreign and local fetches
/**
* Delete cached transformed files for the current version only.
/**
* Delete cached transformed files for the current version only.
+ * @param array $options
*/
function purgeThumbnails( $options = array() ) {
global $wgUseSquid;
*/
function purgeThumbnails( $options = array() ) {
global $wgUseSquid;
*/
function addId( $fa_id ) {
$this->ids[] = $fa_id;
*/
function addId( $fa_id ) {
$this->ids[] = $fa_id;
/**
* Add a whole lot of files by ID
/**
* Add a whole lot of files by ID
*/
function addIds( $ids ) {
$this->ids = array_merge( $this->ids, $ids );
*/
function addIds( $ids ) {
$this->ids = array_merge( $this->ids, $ids );
/**
* Cleanup a partially moved array of triplets by deleting the target
* files. Called if something went wrong half way.
/**
* Cleanup a partially moved array of triplets by deleting the target
* files. Called if something went wrong half way.
+ * @param array $triplets
*/
function cleanupTarget( $triplets ) {
// Create dest pairs from the triplets
*/
function cleanupTarget( $triplets ) {
// Create dest pairs from the triplets
/**
* Cleanup a fully moved array of triplets by deleting the source files.
* Called at the end of the move process if everything else went ok.
/**
* Cleanup a fully moved array of triplets by deleting the source files.
* Called at the end of the move process if everything else went ok.
+ * @param array $triplets
*/
function cleanupSource( $triplets ) {
// Create source file names from the triplets
*/
function cleanupSource( $triplets ) {
// Create source file names from the triplets
*
* You should not call this directly, but instead use
* ImageGalleryBase::factory().
*
* You should not call this directly, but instead use
* ImageGalleryBase::factory().
*/
function __construct( $mode = 'traditional' ) {
global $wgGalleryOptions;
*/
function __construct( $mode = 'traditional' ) {
global $wgGalleryOptions;
*/
function setHideBadImages( $flag = true ) {
$this->mHideBadImages = $flag;
*/
function setHideBadImages( $flag = true ) {
$this->mHideBadImages = $flag;
/**
* Do not support per-row on packed. It really doesn't work
* since the images have varying widths.
/**
* Do not support per-row on packed. It really doesn't work
* since the images have varying widths.
*/
public function setPerRow( $num ) {
return;
*/
public function setPerRow( $num ) {
return;
+ * @param string $value
+ * @return string
* @since 1.20
*/
public function getDiv( $value ) {
* @since 1.20
*/
public function getDiv( $value ) {
+ * @param string $value
+ * @return string
* @since 1.20
*/
public function getRaw( $value ) {
* @since 1.20
*/
public function getRaw( $value ) {
+ * @param string $value
+ * @return string
* @since 1.20
*/
public function getDiv( $value ) {
* @since 1.20
*/
public function getDiv( $value ) {
+ * @param string $value
+ * @return string
* @since 1.20
*/
public function getRaw( $value ) {
* @since 1.20
*/
public function getRaw( $value ) {
+ * @param string $value
+ * @return string
* @since 1.20
*/
public function getDiv( $value ) {
* @since 1.20
*/
public function getDiv( $value ) {
+ * @param string $value
+ * @return string
* @since 1.20
*/
public function getRaw( $value ) {
* @since 1.20
*/
public function getRaw( $value ) {
/**
* Get a Redis object with a connection suitable for fetching the specified key
/**
* Get a Redis object with a connection suitable for fetching the specified key
* @return array (server, RedisConnRef) or (false, false)
*/
protected function getConnection( $key ) {
* @return array (server, RedisConnRef) or (false, false)
*/
protected function getConnection( $key ) {
+ * @param DatabaseBase $db
* @param string $exptime
* @return bool
*/
* @param string $exptime
* @return bool
*/
/**
* Extra key that should be present in the parser cache key.
/**
* Extra key that should be present in the parser cache key.
*/
public function addExtraKey( $key ) {
$this->mExtraKey .= '!' . $key;
*/
public function addExtraKey( $key ) {
$this->mExtraKey .= '!' . $key;
/**
* Fairly generic flag setter thingy.
/**
* Fairly generic flag setter thingy.
*/
public function setFlag( $flag ) {
$this->mFlags[$flag] = true;
*/
public function setFlag( $flag ) {
$this->mFlags[$flag] = true;
/**
* Callback to get a formatted line for the call tree
/**
* Callback to get a formatted line for the call tree
* @return string
*/
protected function getCallTreeLine( $entry ) {
* @return string
*/
protected function getCallTreeLine( $entry ) {
/**
* Dummy calls to wfProfileIn/wfProfileOut to calculate its overhead
/**
* Dummy calls to wfProfileIn/wfProfileOut to calculate its overhead
+ * @param int $profileCount
*/
protected static function calculateOverhead( $profileCount ) {
wfProfileIn( '-overhead-total' );
*/
protected static function calculateOverhead( $profileCount ) {
wfProfileIn( '-overhead-total' );
/**
* @param string $term
/**
* @param string $term
+ * @param int $resultsShown
+ * @param int $totalNum
* @return string
*/
protected function shortDialog( $term, $resultsShown, $totalNum ) {
* @return string
*/
protected function shortDialog( $term, $resultsShown, $totalNum ) {