From: Timo Tijhof <krinklemail@gmail.com>
Date: Wed, 26 Mar 2014 21:18:05 +0000 (-0700)
Subject: Minor fixes for existing jsduck documentation in resources/mediawiki/*
X-Git-Tag: 1.31.0-rc.0~16471^2
X-Git-Url: http://git.cyclocoop.org//%27%40script%40/%27?a=commitdiff_plain;h=80298d572d9e8b4a9c662e299b3791a11fd76385;p=lhc%2Fweb%2Fwiklou.git

Minor fixes for existing jsduck documentation in resources/mediawiki/*

mw.loader.store:
* Turn url into a link.

mediawiki.language:
* Turn url into a link.
* Fix whitespace.

mediawiki.Title:
* Fix broken <pre> rendering.

mediawiki.Uri:
* Add protocol to url, otherwise <> won't link it.
* Remove bogus dependency listing.
* Turn url into a link.

Change-Id: Ie8e2d1869843bcf594763250c7a9bf94bf874298
---

diff --git a/resources/mediawiki.language/mediawiki.language.numbers.js b/resources/mediawiki.language/mediawiki.language.numbers.js
index 4282a3ddb1..56fa0daf93 100644
--- a/resources/mediawiki.language/mediawiki.language.numbers.js
+++ b/resources/mediawiki.language/mediawiki.language.numbers.js
@@ -13,7 +13,7 @@
 	 *
 	 * Example: Fill the string to length 10 with '+' characters on the right.
 	 *
-	 *     pad('blah', 10, '+', true); // => 'blah++++++'
+	 *     pad( 'blah', 10, '+', true ); // => 'blah++++++'
 	 *
 	 * @private
 	 * @param {string} text The string to pad
@@ -59,7 +59,7 @@
 	 * consideration to local customs.
 	 *
 	 * Adapted from dojo/number library with thanks
-	 * http://dojotoolkit.org/reference-guide/1.8/dojo/number.html
+	 * <http://dojotoolkit.org/reference-guide/1.8/dojo/number.html>
 	 *
 	 * @private
 	 * @param {number} value the number to be formatted, ignores sign
diff --git a/resources/mediawiki/mediawiki.Title.js b/resources/mediawiki/mediawiki.Title.js
index 8a7aec23f4..b7b818f9ff 100644
--- a/resources/mediawiki/mediawiki.Title.js
+++ b/resources/mediawiki/mediawiki.Title.js
@@ -386,8 +386,11 @@
 
 		/**
 		 * Example to declare existing titles:
+		 *
 		 *     Title.exist.set( ['User:John_Doe', ...] );
-		 * Eample to declare titles nonexistent:
+		 *
+		 * Example to declare titles nonexistent:
+		 *
 		 *     Title.exist.set( ['File:Foo_bar.jpg', ...], false );
 		 *
 		 * @static
diff --git a/resources/mediawiki/mediawiki.Uri.js b/resources/mediawiki/mediawiki.Uri.js
index a750106e77..5566312859 100644
--- a/resources/mediawiki/mediawiki.Uri.js
+++ b/resources/mediawiki/mediawiki.Uri.js
@@ -1,5 +1,5 @@
 /**
- * Library for simple URI parsing and manipulation. Dependencies: mw, jQuery.
+ * Library for simple URI parsing and manipulation.
  *
  * Intended to be minimal, but featureful; do not expect full RFC 3986 compliance. The use cases we
  * have in mind are constructing 'next page' or 'previous page' URLs, detecting whether we need to
@@ -44,8 +44,8 @@
  * (N.b., 'password' is technically not allowed for HTTP URIs, but it is possible with other kinds
  * of URIs.)
  *
- * Parsing based on parseUri 1.2.2 (c) Steven Levithan <stevenlevithan.com>, MIT License.
- * http://stevenlevithan.com/demo/parseuri/js/
+ * Parsing based on parseUri 1.2.2 (c) Steven Levithan <http://stevenlevithan.com>, MIT License.
+ * <http://stevenlevithan.com/demo/parseuri/js/>
  *
  * @class mw.Uri
  */
diff --git a/resources/mediawiki/mediawiki.js b/resources/mediawiki/mediawiki.js
index 1080df3e6c..1117e051ba 100644
--- a/resources/mediawiki/mediawiki.js
+++ b/resources/mediawiki/mediawiki.js
@@ -1989,7 +1989,7 @@ var mw = ( function ( $, undefined ) {
 					 * The try / catch block is used for JSON & localStorage feature detection.
 					 * See the in-line documentation for Modernizr's localStorage feature detection
 					 * code for a full account of why we need a try / catch:
-					 * https://github.com/Modernizr/Modernizr/blob/v2.7.1/modernizr.js#L771-L796
+					 * <https://github.com/Modernizr/Modernizr/blob/v2.7.1/modernizr.js#L771-L796>.
 					 */
 					init: function () {
 						var raw, data;