Release notes for ContentGetParserOutput hook
[lhc/web/wiklou.git] / includes / Import.php
index b18e257..f6e9032 100644 (file)
@@ -40,7 +40,7 @@ class WikiImporter {
 
        /**
         * Creates an ImportXMLReader drawing from the source provided
-        * @param $source
+        * @param string $source
         */
        function __construct( $source ) {
                $this->reader = new XMLReader();
@@ -88,7 +88,7 @@ class WikiImporter {
 
        /**
         * Set debug mode...
-        * @param $debug bool
+        * @param bool $debug
         */
        function setDebug( $debug ) {
                $this->mDebug = $debug;
@@ -96,7 +96,7 @@ class WikiImporter {
 
        /**
         * Set 'no updates' mode. In this mode, the link tables will not be updated by the importer
-        * @param $noupdates bool
+        * @param bool $noupdates
         */
        function setNoUpdates( $noupdates ) {
                $this->mNoUpdates = $noupdates;
@@ -105,8 +105,8 @@ class WikiImporter {
        /**
         * Set a callback that displays notice messages
         *
-        * @param $callback callback
-        * @return callback
+        * @param callable $callback
+        * @return callable
         */
        public function setNoticeCallback( $callback ) {
                return wfSetVar( $this->mNoticeCallback, $callback );
@@ -114,8 +114,8 @@ class WikiImporter {
 
        /**
         * Sets the action to perform as each new page in the stream is reached.
-        * @param $callback callback
-        * @return callback
+        * @param callable $callback
+        * @return callable
         */
        public function setPageCallback( $callback ) {
                $previous = $this->mPageCallback;
@@ -129,8 +129,8 @@ class WikiImporter {
         * with the original title form (in case it's been overridden into a
         * local namespace), and a count of revisions.
         *
-        * @param $callback callback
-        * @return callback
+        * @param callable $callback
+        * @return callable
         */
        public function setPageOutCallback( $callback ) {
                $previous = $this->mPageOutCallback;
@@ -140,8 +140,8 @@ class WikiImporter {
 
        /**
         * Sets the action to perform as each page revision is reached.
-        * @param $callback callback
-        * @return callback
+        * @param callable $callback
+        * @return callable
         */
        public function setRevisionCallback( $callback ) {
                $previous = $this->mRevisionCallback;
@@ -151,8 +151,8 @@ class WikiImporter {
 
        /**
         * Sets the action to perform as each file upload version is reached.
-        * @param $callback callback
-        * @return callback
+        * @param callable $callback
+        * @return callable
         */
        public function setUploadCallback( $callback ) {
                $previous = $this->mUploadCallback;
@@ -162,8 +162,8 @@ class WikiImporter {
 
        /**
         * Sets the action to perform as each log item reached.
-        * @param $callback callback
-        * @return callback
+        * @param callable $callback
+        * @return callable
         */
        public function setLogItemCallback( $callback ) {
                $previous = $this->mLogItemCallback;
@@ -173,8 +173,8 @@ class WikiImporter {
 
        /**
         * Sets the action to perform when site info is encountered
-        * @param $callback callback
-        * @return callback
+        * @param callable $callback
+        * @return callable
         */
        public function setSiteInfoCallback( $callback ) {
                $previous = $this->mSiteInfoCallback;
@@ -184,7 +184,7 @@ class WikiImporter {
 
        /**
         * Set a target namespace to override the defaults
-        * @param $namespace
+        * @param null|int $namespace
         * @return bool
         */
        public function setTargetNamespace( $namespace ) {
@@ -201,8 +201,8 @@ class WikiImporter {
 
        /**
         * Set a target root page under which all pages are imported
-        * @param $rootpage
-        * @return status object
+        * @param null|string $rootpage
+        * @return Status
         */
        public function setTargetRootPage( $rootpage ) {
                $status = Status::newGood();
@@ -233,14 +233,14 @@ class WikiImporter {
        }
 
        /**
-        * @param $dir
+        * @param string $dir
         */
        public function setImageBasePath( $dir ) {
                $this->mImageBasePath = $dir;
        }
 
        /**
-        * @param $import
+        * @param bool $import
         */
        public function setImportUploads( $import ) {
                $this->mImportUploads = $import;
@@ -248,7 +248,7 @@ class WikiImporter {
 
        /**
         * Default per-revision callback, performs the import.
-        * @param $revision WikiRevision
+        * @param WikiRevision $revision
         * @return bool
         */
        public function importRevision( $revision ) {
@@ -278,7 +278,7 @@ class WikiImporter {
 
        /**
         * Default per-revision callback, performs the import.
-        * @param $rev WikiRevision
+        * @param WikiRevision $rev
         * @return bool
         */
        public function importLogItem( $rev ) {
@@ -288,7 +288,7 @@ class WikiImporter {
 
        /**
         * Dummy for now...
-        * @param $revision
+        * @param WikiRevision $revision
         * @return bool
         */
        public function importUpload( $revision ) {
@@ -298,11 +298,11 @@ class WikiImporter {
 
        /**
         * Mostly for hook use
-        * @param $title
-        * @param $origTitle
-        * @param $revCount
-        * @param $sRevCount
-        * @param $pageInfo
+        * @param Title $title
+        * @param string $origTitle
+        * @param int $revCount
+        * @param int $sRevCount
+        * @param array $pageInfo
         * @return
         */
        public function finishImportPage( $title, $origTitle, $revCount, $sRevCount, $pageInfo ) {
@@ -312,7 +312,7 @@ class WikiImporter {
 
        /**
         * Alternate per-revision callback, for debugging.
-        * @param $revision WikiRevision
+        * @param WikiRevision $revision
         */
        public function debugRevisionHandler( &$revision ) {
                $this->debug( "Got revision:" );
@@ -329,7 +329,7 @@ class WikiImporter {
 
        /**
         * Notify the callback function when a new "<page>" is reached.
-        * @param $title Title
+        * @param Title $title
         */
        function pageCallback( $title ) {
                if ( isset( $this->mPageCallback ) ) {
@@ -339,11 +339,11 @@ class WikiImporter {
 
        /**
         * Notify the callback function when a "</page>" is closed.
-        * @param $title Title
-        * @param $origTitle Title
-        * @param $revCount Integer
-        * @param int $sucCount number of revisions for which callback returned true
-        * @param array $pageInfo associative array of page information
+        * @param Title $title
+        * @param Title $origTitle
+        * @param int $revCount
+        * @param int $sucCount Number of revisions for which callback returned true
+        * @param array $pageInfo Associative array of page information
         */
        private function pageOutCallback( $title, $origTitle, $revCount, $sucCount, $pageInfo ) {
                if ( isset( $this->mPageOutCallback ) ) {
@@ -354,7 +354,7 @@ class WikiImporter {
 
        /**
         * Notify the callback function of a revision
-        * @param $revision WikiRevision object
+        * @param WikiRevision $revision
         * @return bool|mixed
         */
        private function revisionCallback( $revision ) {
@@ -368,7 +368,7 @@ class WikiImporter {
 
        /**
         * Notify the callback function of a new log item
-        * @param $revision WikiRevision object
+        * @param WikiRevision $revision
         * @return bool|mixed
         */
        private function logItemCallback( $revision ) {
@@ -551,7 +551,7 @@ class WikiImporter {
        }
 
        /**
-        * @param $logInfo
+        * @param array $logInfo
         * @return bool|mixed
         */
        private function processLogItem( $logInfo ) {
@@ -634,7 +634,7 @@ class WikiImporter {
        }
 
        /**
-        * @param $pageInfo array
+        * @param array $pageInfo
         */
        private function handleRevision( &$pageInfo ) {
                $this->debug( "Enter revision handler" );
@@ -673,8 +673,8 @@ class WikiImporter {
        }
 
        /**
-        * @param $pageInfo
-        * @param $revisionInfo
+        * @param array $pageInfo
+        * @param array $revisionInfo
         * @return bool|mixed
         */
        private function processRevision( $pageInfo, $revisionInfo ) {
@@ -719,7 +719,7 @@ class WikiImporter {
        }
 
        /**
-        * @param $pageInfo
+        * @param array $pageInfo
         * @return mixed
         */
        private function handleUpload( &$pageInfo ) {
@@ -774,7 +774,7 @@ class WikiImporter {
        }
 
        /**
-        * @param $contents
+        * @param string $contents
         * @return string
         */
        private function dumpTemp( $contents ) {
@@ -784,8 +784,8 @@ class WikiImporter {
        }
 
        /**
-        * @param $pageInfo
-        * @param $uploadInfo
+        * @param array $pageInfo
+        * @param array $uploadInfo
         * @return mixed
         */
        private function processUpload( $pageInfo, $uploadInfo ) {
@@ -846,8 +846,8 @@ class WikiImporter {
        }
 
        /**
-        * @param $text string
-        * @return Array or false
+        * @param string $text
+        * @return array|bool
         */
        private function processTitle( $text ) {
                global $wgCommandLineMode;
@@ -900,7 +900,7 @@ class UploadSourceAdapter {
        private $mPosition;
 
        /**
-        * @param $source
+        * @param string $source
         * @return string
         */
        static function registerSource( $source ) {
@@ -912,10 +912,10 @@ class UploadSourceAdapter {
        }
 
        /**
-        * @param $path
-        * @param $mode
-        * @param $options
-        * @param $opened_path
+        * @param string $path
+        * @param string $mode
+        * @param array $options
+        * @param string $opened_path
         * @return bool
         */
        function stream_open( $path, $mode, $options, &$opened_path ) {
@@ -932,7 +932,7 @@ class UploadSourceAdapter {
        }
 
        /**
-        * @param $count
+        * @param int $count
         * @return string
         */
        function stream_read( $count ) {
@@ -961,7 +961,7 @@ class UploadSourceAdapter {
        }
 
        /**
-        * @param $data
+        * @param string $data
         * @return bool
         */
        function stream_write( $data ) {
@@ -1062,7 +1062,7 @@ class WikiRevision {
        private $mNoUpdates = false;
 
        /**
-        * @param $title
+        * @param Title $title
         * @throws MWException
         */
        function setTitle( $title ) {
@@ -1076,14 +1076,14 @@ class WikiRevision {
        }
 
        /**
-        * @param $id
+        * @param int $id
         */
        function setID( $id ) {
                $this->id = $id;
        }
 
        /**
-        * @param $ts
+        * @param string $ts
         */
        function setTimestamp( $ts ) {
                # 2003-08-05T18:30:02Z
@@ -1091,64 +1091,64 @@ class WikiRevision {
        }
 
        /**
-        * @param $user
+        * @param string $user
         */
        function setUsername( $user ) {
                $this->user_text = $user;
        }
 
        /**
-        * @param $ip
+        * @param string $ip
         */
        function setUserIP( $ip ) {
                $this->user_text = $ip;
        }
 
        /**
-        * @param $model
+        * @param string $model
         */
        function setModel( $model ) {
                $this->model = $model;
        }
 
        /**
-        * @param $format
+        * @param string $format
         */
        function setFormat( $format ) {
                $this->format = $format;
        }
 
        /**
-        * @param $text
+        * @param string $text
         */
        function setText( $text ) {
                $this->text = $text;
        }
 
        /**
-        * @param $text
+        * @param string $text
         */
        function setComment( $text ) {
                $this->comment = $text;
        }
 
        /**
-        * @param $minor
+        * @param bool $minor
         */
        function setMinor( $minor ) {
                $this->minor = (bool)$minor;
        }
 
        /**
-        * @param $src
+        * @param mixed $src
         */
        function setSrc( $src ) {
                $this->src = $src;
        }
 
        /**
-        * @param $src
-        * @param $isTemp
+        * @param string $src
+        * @param bool $isTemp
         */
        function setFileSrc( $src, $isTemp ) {
                $this->fileSrc = $src;
@@ -1156,56 +1156,56 @@ class WikiRevision {
        }
 
        /**
-        * @param $sha1base36
+        * @param string $sha1base36
         */
        function setSha1Base36( $sha1base36 ) {
                $this->sha1base36 = $sha1base36;
        }
 
        /**
-        * @param $filename
+        * @param string $filename
         */
        function setFilename( $filename ) {
                $this->filename = $filename;
        }
 
        /**
-        * @param $archiveName
+        * @param string $archiveName
         */
        function setArchiveName( $archiveName ) {
                $this->archiveName = $archiveName;
        }
 
        /**
-        * @param $size
+        * @param int $size
         */
        function setSize( $size ) {
                $this->size = intval( $size );
        }
 
        /**
-        * @param $type
+        * @param string $type
         */
        function setType( $type ) {
                $this->type = $type;
        }
 
        /**
-        * @param $action
+        * @param string $action
         */
        function setAction( $action ) {
                $this->action = $action;
        }
 
        /**
-        * @param $params
+        * @param array $params
         */
        function setParams( $params ) {
                $this->params = $params;
        }
 
        /**
-        * @param $noupdates
+        * @param bool $noupdates
         */
        public function setNoUpdates( $noupdates ) {
                $this->mNoUpdates = $noupdates;
@@ -1268,7 +1268,7 @@ class WikiRevision {
        }
 
        /**
-        * @return String
+        * @return string
         */
        function getModel() {
                if ( is_null( $this->model ) ) {
@@ -1279,7 +1279,7 @@ class WikiRevision {
        }
 
        /**
-        * @return String
+        * @return string
         */
        function getFormat() {
                if ( is_null( $this->model ) ) {
@@ -1311,7 +1311,7 @@ class WikiRevision {
        }
 
        /**
-        * @return bool|String
+        * @return bool|string
         */
        function getSha1() {
                if ( $this->sha1base36 ) {
@@ -1648,7 +1648,7 @@ class ImportStreamSource {
        }
 
        /**
-        * @param $filename string
+        * @param string $filename
         * @return Status
         */
        static function newFromFile( $filename ) {
@@ -1662,7 +1662,7 @@ class ImportStreamSource {
        }
 
        /**
-        * @param $fieldname string
+        * @param string $fieldname
         * @return Status
         */
        static function newFromUpload( $fieldname = "xmlimport" ) {
@@ -1694,8 +1694,8 @@ class ImportStreamSource {
        }
 
        /**
-        * @param $url
-        * @param $method string
+        * @param string $url
+        * @param string $method
         * @return Status
         */
        static function newFromURL( $url, $method = 'GET' ) {
@@ -1717,11 +1717,11 @@ class ImportStreamSource {
        }
 
        /**
-        * @param $interwiki
-        * @param $page
-        * @param $history bool
-        * @param $templates bool
-        * @param $pageLinkDepth int
+        * @param string $interwiki
+        * @param string $page
+        * @param bool $history
+        * @param bool $templates
+        * @param int $pageLinkDepth
         * @return Status
         */
        public static function newFromInterwiki( $interwiki, $page, $history = false, $templates = false, $pageLinkDepth = 0 ) {