aboutsummaryrefslogtreecommitdiffstats
path: root/includes/diff/Hook/DiffViewHeaderHook.php
diff options
context:
space:
mode:
authorapaskulin <apaskulin@wikimedia.org>2020-03-16 16:31:05 -0700
committerTim Starling <tstarling@wikimedia.org>2020-04-21 09:10:08 +1000
commitc44488f72549331733ef261b90058fd73d7badde (patch)
tree91ac013c191dbab31525b506083ccb0b37ce3a57 /includes/diff/Hook/DiffViewHeaderHook.php
parentf5aaf75ad15813bfeb93dcb4e5fbaaa52b23c7fe (diff)
downloadmediawikicore-c44488f72549331733ef261b90058fd73d7badde.tar.gz
mediawikicore-c44488f72549331733ef261b90058fd73d7badde.zip
docs: Hook interface doc comment review
Edited doc comments for hook interfaces to improve consistency and add type hints. Bug: T246855 Change-Id: I38fa802463cd6f39bf5946dbbeb1b3ebaea604b2
Diffstat (limited to 'includes/diff/Hook/DiffViewHeaderHook.php')
-rw-r--r--includes/diff/Hook/DiffViewHeaderHook.php11
1 files changed, 7 insertions, 4 deletions
diff --git a/includes/diff/Hook/DiffViewHeaderHook.php b/includes/diff/Hook/DiffViewHeaderHook.php
index 580a6106f120..66e87b84cbb6 100644
--- a/includes/diff/Hook/DiffViewHeaderHook.php
+++ b/includes/diff/Hook/DiffViewHeaderHook.php
@@ -2,19 +2,22 @@
namespace MediaWiki\Diff\Hook;
+use DifferenceEngine;
+use Revision;
+
/**
* @stable for implementation
* @ingroup Hooks
*/
interface DiffViewHeaderHook {
/**
- * Called before diff display
+ * This hook is called before diff display.
*
* @since 1.35
*
- * @param ?mixed $diff DifferenceEngine object that's calling
- * @param ?mixed $oldRev Revision object of the "old" revision (may be null/invalid)
- * @param ?mixed $newRev Revision object of the "new" revision
+ * @param DifferenceEngine $diff
+ * @param Revision|null $oldRev Old revision (may be null/invalid)
+ * @param Revision $newRev New revision
* @return bool|void True or no return value to continue or false to abort
*/
public function onDiffViewHeader( $diff, $oldRev, $newRev );