docu cleanup; marked contenthandler stuff as @since 1.WD

[lhc/web/wiklou.git] / includes / diff / DifferenceEngine.php

diff --git a/includes/diff/DifferenceEngine.php b/includes/diff/DifferenceEngine.php
index 2fb203e..5e03480 100644 (file)
--- a/includes/diff/DifferenceEngine.php
+++ b/includes/diff/DifferenceEngine.php
@@ -261,7 +261,7 @@ class DifferenceEngine extends ContextSource {
                                $samePage = false;
                        }
 
-                       if ( $samePage && $this->mNewPage->userCan( 'edit', $user ) ) {
+                       if ( $samePage && $this->mNewPage->quickUserCan( 'edit', $user ) ) {
                                if ( $this->mNewRev->isCurrent() && $this->mNewPage->userCan( 'rollback', $user ) ) {
                                        $out->preventClickjacking();
                                        $rollback = '   ' . Linker::generateRollback( $this->mNewRev );
@@ -403,7 +403,7 @@ class DifferenceEngine extends ContextSource {
 
                if ( $this->mMarkPatrolledLink === null ) {
                        // Prepare a change patrol link, if applicable
-                       if ( $wgUseRCPatrol && $this->mNewPage->userCan( 'patrol', $this->getUser() ) ) {
+                       if ( $wgUseRCPatrol && $this->mNewPage->quickUserCan( 'patrol', $this->getUser() ) ) {
                                // If we've been given an explicit change identifier, use it; saves time
                                if ( $this->mRcidMarkPatrolled ) {
                                        $rcid = $this->mRcidMarkPatrolled;
@@ -677,6 +677,8 @@ class DifferenceEngine extends ContextSource {
      *
      * @param $old Content: old content
      * @param $new Content: new content
+     *
+     * @since 1.WD
      */
     function generateContentDiffBody( Content $old, Content $new ) {
         #XXX: generate a warning if $old or $new are not instances of TextContent?
@@ -694,10 +696,10 @@ class DifferenceEngine extends ContextSource {
      *
      * @param $otext String: old text, must be already segmented
      * @param $ntext String: new text, must be already segmented
-     * @deprecated since 1.20, use generateContentDiffBody() instead!
+     * @deprecated since 1.WD, use generateContentDiffBody() instead!
      */
     function generateDiffBody( $otext, $ntext ) {
-        wfDeprecated( __METHOD__, "1.20" );
+        wfDeprecated( __METHOD__, "1.WD" );
 
         return $this->generateTextDiffBody( $otext, $ntext );
     }
@@ -709,6 +711,7 @@ class DifferenceEngine extends ContextSource {
      *
         * @param $otext String: old text, must be already segmented
         * @param $ntext String: new text, must be already segmented
+        * @return bool|string
         */
        function generateTextDiffBody( $otext, $ntext ) {
                global $wgExternalDiffEngine, $wgContLang;
@@ -784,6 +787,7 @@ class DifferenceEngine extends ContextSource {
        /**
         * Generate a debug comment indicating diff generating time,
         * server node, and generator backend.
+        * @return string
         */
        protected function debug( $generator = "internal" ) {
                global $wgShowHostnames;
@@ -805,6 +809,7 @@ class DifferenceEngine extends ContextSource {
 
        /**
         * Replace line numbers with the text in the user's language
+        * @return mixed
         */
        function localiseLineNumbers( $text ) {
                return preg_replace_callback( '/<!--LINE (\d+)-->/',
@@ -901,7 +906,7 @@ class DifferenceEngine extends ContextSource {
                                $editQuery['oldid'] = $rev->getID();
                        }
 
-                       $msg = $this->msg( $title->userCan( 'edit', $user ) ? 'editold' : 'viewsourceold' )->escaped();
+                       $msg = $this->msg( $title->quickUserCan( 'edit', $user ) ? 'editold' : 'viewsourceold' )->escaped();
                        $header .= ' (' . Linker::linkKnown( $title, $msg, array(), $editQuery ) . ')';
                        if ( $rev->isDeleted( Revision::DELETED_TEXT ) ) {
                                $header = Html::rawElement( 'span', array( 'class' => 'history-deleted' ), $header );
@@ -962,10 +967,10 @@ class DifferenceEngine extends ContextSource {
 
        /**
         * Use specified text instead of loading from the database
-     * @deprecated since 1.20
+     * @deprecated since 1.WD
         */
        function setText( $oldText, $newText ) { #FIXME: no longer use this, use setContent()!
-        wfDeprecated( __METHOD__, "1.20" );
+        wfDeprecated( __METHOD__, "1.WD" );
 
         $oldContent = ContentHandler::makeContent( $oldText, $this->getTitle() );
         $newContent = ContentHandler::makeContent( $newText, $this->getTitle() );
@@ -975,7 +980,7 @@ class DifferenceEngine extends ContextSource {
 
     /**
      * Use specified text instead of loading from the database
-     * @since 1.20
+     * @since 1.WD
      */
     function setContent( Content $oldContent, Content $newContent ) {
         $this->mOldContent = $oldContent;