More function documentation
authorSam Reed <reedy@users.mediawiki.org>
Sat, 19 Feb 2011 21:56:54 +0000 (21:56 +0000)
committerSam Reed <reedy@users.mediawiki.org>
Sat, 19 Feb 2011 21:56:54 +0000 (21:56 +0000)
includes/job/DoubleRedirectJob.php
includes/job/JobQueue.php
includes/revisiondelete/RevisionDelete.php
includes/revisiondelete/RevisionDeleteAbstracts.php

index 3b4b018..dd63a85 100644 (file)
  */
 class DoubleRedirectJob extends Job {
        var $reason, $redirTitle, $destTitleText;
+
+       /**
+        * @var User
+        */
        static $user;
 
        /** 
@@ -53,6 +57,7 @@ class DoubleRedirectJob extends Job {
                }
                Job::batchInsert( $jobs );
        }
+
        function __construct( $title, $params = false, $id = 0 ) {
                parent::__construct( 'fixDoubleRedirect', $title, $params, $id );
                $this->reason = $params['reason'];
index 60b35ca..2570284 100644 (file)
@@ -16,8 +16,13 @@ if ( !defined( 'MEDIAWIKI' ) ) {
  * @ingroup JobQueue
  */
 abstract class Job {
+
+       /**
+        * @var Title
+        */
+       var $title;
+
        var $command,
-               $title,
                $params,
                $id,
                $removeDuplicates,
index 00afb05..5a2b043 100644 (file)
@@ -10,6 +10,10 @@ class RevDel_RevisionList extends RevDel_List {
        var $authorIdField = 'rev_user';
        var $authorNameField = 'rev_user_text';
 
+       /**
+        * @param $db DatabaseBase
+        * @return mixed
+        */
        public function doQuery( $db ) {
                $ids = array_map( 'intval', $this->ids );
                return $db->select( array('revision','page'), '*',
@@ -186,6 +190,10 @@ class RevDel_ArchiveList extends RevDel_RevisionList {
        var $authorIdField = 'ar_user';
        var $authorNameField = 'ar_user_text';
 
+       /**
+        * @param $db DatabaseBase
+        * @return mixed
+        */
        public function doQuery( $db ) {
                $timestamps = array();
                foreach ( $this->ids as $id ) {
@@ -348,6 +356,10 @@ class RevDel_FileList extends RevDel_List {
  * Item class for an oldimage table row
  */
 class RevDel_FileItem extends RevDel_Item {
+
+       /**
+        * @var File
+        */
        var $file;
 
        public function __construct( $list, $row ) {
index 073c25b..d57b879 100644 (file)
@@ -4,7 +4,13 @@
  * Abstract base class for a list of deletable items
  */
 abstract class RevDel_List {
-       var $special, $title, $ids, $res, $current;
+
+       /**
+        * @var Title
+        */
+       var $title;
+
+       var $special, $ids, $res, $current;
        var $type = null; // override this
        var $idField = null; // override this
        var $dateField = false; // override this
@@ -329,7 +335,7 @@ abstract class RevDel_List {
 
        /**
         * Do the DB query to iterate through the objects.
-        * @param $db Database object to use for the query
+        * @param $db DatabaseBase object to use for the query
         */
        abstract public function doQuery( $db );