X-Git-Url: https://git.heureux-cyclage.org/?a=blobdiff_plain;f=resources%2Fmediawiki.page%2Fmediawiki.page.gallery.js;h=147a869d872b1fca494d786c1404e63a2f8d15a1;hb=4b2e1c65e16f55e2202c991864c104525274e22e;hp=ddf63a853a0bf841d09480fd11799c92ad7e99ad;hpb=59404fb12ee50a52925709a389f9c263f3e332a2;p=lhc%2Fweb%2Fwiklou.git

diff --git a/resources/mediawiki.page/mediawiki.page.gallery.js b/resources/mediawiki.page/mediawiki.page.gallery.js
index ddf63a853a..147a869d87 100644
--- a/resources/mediawiki.page/mediawiki.page.gallery.js
+++ b/resources/mediawiki.page/mediawiki.page.gallery.js
@@ -210,14 +210,24 @@
 							$innerDiv: $innerDiv,
 							$imageDiv: $imageDiv,
 							$outerDiv: $outerDiv,
-							resolved: false  /* Did the hook take action */
+							// Whether the hook took action
+							resolved: false
 						};
-						// Allow other media handlers to hook in.
-						// If your hook resizes an image, it is expected it will
-						// set resolved to true. Additionally you should load
-						// your module in position top to ensure it is registered
-						// before this runs (FIXME: there must be a better way?)
-						// See TimedMediaHandler for an example.
+
+						/**
+						 * Gallery resize.
+						 *
+						 * If your handler resizes an image, it should also set the resolved
+						 * property to true. Additionally, because this module only exposes this
+						 * logic temporarily, you should load your module in position top to
+						 * ensure it is registered before this runs (FIXME: Don't use mw.hook)
+						 *
+						 * See TimedMediaHandler for an example.
+						 *
+						 * @event mediawiki_page_gallery_resize
+						 * @member mw.hook
+						 * @param {Object} hookInfo
+						 */
 						mw.hook( 'mediawiki.page.gallery.resize' ).fire( hookInfo );
 
 						if ( !hookInfo.resolved ) {