mediawiki.html: Add missing @return documentation

Change-Id: I63f12ee44aace6cf4f7762dd67244648b95d7301

diff --git a/resources/mediawiki/mediawiki.js b/resources/mediawiki/mediawiki.js
index d8a17f6..885fd3d 100644 (file)
--- a/resources/mediawiki/mediawiki.js
+++ b/resources/mediawiki/mediawiki.js
@@ -2218,12 +2218,15 @@ var mw = ( function ( $, undefined ) {
 
                        return {
                                /**
-                                * Escape a string for HTML. Converts special characters to HTML entities.
+                                * Escape a string for HTML.
+                                *
+                                * Converts special characters to HTML entities.
                                 *
                                 *     mw.html.escape( '< > \' & "' );
                                 *     // Returns &lt; &gt; &#039; &amp; &quot;
                                 *
                                 * @param {string} s The string to escape
+                                * @return {string} HTML
                                 */
                                escape: function ( s ) {
                                        return s.replace( /['"<>&]/g, escapeCallback );
@@ -2242,6 +2245,7 @@ var mw = ( function ( $, undefined ) {
                                 *  - this.Cdata: The value attribute is included, and an exception is
                                 *   thrown if it contains an illegal ETAGO delimiter.
                                 *   See <http://www.w3.org/TR/1999/REC-html401-19991224/appendix/notes.html#h-B.3.2>.
+                                * @return {string} HTML
                                 */
                                element: function ( name, attrs, contents ) {
                                        var v, attrName, s = '<' + name;