mediawiki-extensions-Visual.../modules/ve/ve.debug.js

/*global console */
/**
 * VisualEditor debugging methods.
 *
 * @copyright 2011-2012 VisualEditor Team and others; see AUTHORS.txt
 * @license The MIT License (MIT); see LICENSE.txt
 */

/* Static variables */

ve.debug = true;

/* Static Methods */

/**
 * Logs data to the console.
 *
 * @static
 * @method
 * @param {Mixed} [...] Data to log
 */
ve.log = function () {
	Function.prototype.apply.call( console.log, console, arguments );
};

/**
 * Logs an object to the console.
 *
 * @static
 * @method
 * @param {Object} obj Object to log
 */
ve.dir = function () {
	Function.prototype.apply.call( console.dir, console, arguments );
};
Refactor ve.js utilities and improve documentation Refactor: * ve.indexOf Renamed from ve.inArray. This was named after the jQuery method which in turn has a longer story about why it is so unfortunately named. It doesn't return a boolean, but an index. Hence the native method being called indexOf as well. * ve.bind Renamed from ve.proxy. I considered making it use Function.prototype.bind if available. As it performs better than $.proxy (which doesn't use to the native bind if available). However since bind needs to be bound itself in order to use it detached, it turns out with the "call()" and "bind()" it is slower than the $.proxy shim: http://jsperf.com/function-bind-shim-perf It would've been like this: ve.bind = Function.prototype.bind ? Function.prototype.call.bind( Function.prototype.bind ) : $.proxy; But instead sticking to ve.bind = $.proxy; * ve.extendObject Documented the parts of jQuery.extend that we use. This makes it easier to replace in the future. Documentation: * Added function documentation blocks. * Added annotations to functions that we will be able to remove in the future in favour of the native methods. With "@until + when/how". In this case "ES5". Meaning, whenever we drop support for browsers that don't support ES5. Although in the developer community ES5 is still fairly fresh, browsers have been aware for it long enough that thee moment we're able to drop it may be sooner than we think. The only blocker so far is IE8. The rest of the browsers have had it long enough that the traffic we need to support of non-IE supports it. Misc.: * Removed 'node: true' from .jshintrc since Parsoid is no longer in this repo and thus no more nodejs files. - This unraveled two lint errors: Usage of 'module' and 'console'. (both were considered 'safe globals' due to nodejs, but not in browser code). * Replaced usage (before renaming): - $.inArray -> ve.inArray - Function.prototype.bind -> ve.proxy - Array.isArray -> ve.isArray - [].indexOf -> ve.inArray - $.fn.bind/live/delegate/unbind/die/delegate -> $.fn.on/off Change-Id: Idcf1fa6a685b6ed3d7c99ffe17bd57a7bc586a2c 2012-08-11 08:14:56 +00:00			`/global console /`
Changed to use MIT license per agreement with the VisualEditor team This license change is aimed at maximizing the reusability of this code in other projects. VisualEditor is more than just an awesome editor for MediaWiki, it's the new editor for the entire internet. Added license and author files, plus mentions of the license to all VisualEditor PHP, JavaScript and CSS files. Parser files have not been modified but are effectively re-licensed since there's no overriding license information. 3rd party libraries are not changed, but are all already MIT licensed. Change-Id: I895b256325db7c8689756edab34523de4418b0f2 2012-07-19 00:11:26 +00:00			`/**`
			`* VisualEditor debugging methods.`
Removed some whitespace And added a license to some files that didn't have it yet Change-Id: I3a7e60374d1198d369a0475b8f65f7415012a337 2012-07-19 21:25:16 +00:00			`*`
Changed to use MIT license per agreement with the VisualEditor team This license change is aimed at maximizing the reusability of this code in other projects. VisualEditor is more than just an awesome editor for MediaWiki, it's the new editor for the entire internet. Added license and author files, plus mentions of the license to all VisualEditor PHP, JavaScript and CSS files. Parser files have not been modified but are effectively re-licensed since there's no overriding license information. 3rd party libraries are not changed, but are all already MIT licensed. Change-Id: I895b256325db7c8689756edab34523de4418b0f2 2012-07-19 00:11:26 +00:00			`* @copyright 2011-2012 VisualEditor Team and others; see AUTHORS.txt`
			`* @license The MIT License (MIT); see LICENSE.txt`
			`*/`

Setup variable ve.debug to true when ve.debug.js is loaded. Change-Id: I22309ddfda8271456665eb40c4b698c160061de4 2012-10-04 01:02:31 +00:00			`/* Static variables */`

			`ve.debug = true;`

Whitespace and comments * Added documentation for ve.AnnotationSet * Replaced uses of "// Inheritance" with "// parent Constructor" * Added "// Mixin constructor" where needed * Added missing section comments like "/* Static Methods /" Cleaned up excessive newlines (matching /\n\n\n/g) * Put unnecessarily multi-line statements on a single line Change-Id: I2c9b47ba296f7dd3c9cc2985581fbcefd6d76325 2012-09-17 23:53:03 +00:00			`/* Static Methods */`

Using resource loader debug scripts to unstub ve.log Also added ve.dir and converted use of console.log to ve.log Change-Id: Ibbfd78b6ece163f54f40e997c79a01de6609c2b4 2012-06-18 20:30:14 +00:00			`/**`
			`* Logs data to the console.`
			`*`
			`* @static`
			`* @method`
			`* @param {Mixed} [...] Data to log`
			`*/`
Remainder JSHint fixes on modules/ve/* [jshint] ce/ve.ce.Surface.js: line 670, col 9, Too many var statements. ce/ve.ce.Surface.js: line 695, col 6, Missing semicolon. ce/ve.ce.Surface.js: line 726, col 22, Expected '===' and instead saw '=='. ce/ve.ce.Surface.js: line 726, col 41, Expected '===' and instead saw '=='. ce/ve.ce.Surface.js: line 733, col 13, Too many var statements. ce/ve.ce.Surface.js: line 734, col 24, Expected '===' and instead saw '=='. ce/ve.ce.Surface.js: line 1013, col 13, Too many var statements. ce/ve.ce.Surface.js: line 1019, col 17, Too many var statements. ce/ve.ce.Surface.js: line 1023, col 18, Too many ar statements. ce/ve.ce.Surface.js: line 1027, col 13, Too many var statements. dm/annotations/ve.dm.LinkAnnotation.js: line 70, col 52, Insecure '.'. dm/ve.dm.Converter.js: line 383, col 29, Empty block. dm/ve.dm.Converter.js: line 423, col 33, Empty block. Commands: * jshint . * ack '(if\|else\|function\|switch\|for\|while)\(' * Sublime Text 2: Find(): (if\|else\|function\|switch\|for\|while)\( Replace: $1 ( ack ' ' -Q # double spaces, except in certain comments Change-Id: I8e34bf2924bc8688fdf8acef08bbc4f6707e93be 2012-09-02 21:45:01 +00:00			`ve.log = function () {`
Fixing ve.log and ve.dir for IE Change-Id: Ieee1aec3e6ea45f3eecdea53e3691ebe19306a33 2012-08-21 00:14:43 +00:00			`Function.prototype.apply.call( console.log, console, arguments );`
			`};`

Using resource loader debug scripts to unstub ve.log Also added ve.dir and converted use of console.log to ve.log Change-Id: Ibbfd78b6ece163f54f40e997c79a01de6609c2b4 2012-06-18 20:30:14 +00:00			`/**`
			`* Logs an object to the console.`
			`*`
			`* @static`
			`* @method`
			`* @param {Object} obj Object to log`
			`*/`
Remainder JSHint fixes on modules/ve/* [jshint] ce/ve.ce.Surface.js: line 670, col 9, Too many var statements. ce/ve.ce.Surface.js: line 695, col 6, Missing semicolon. ce/ve.ce.Surface.js: line 726, col 22, Expected '===' and instead saw '=='. ce/ve.ce.Surface.js: line 726, col 41, Expected '===' and instead saw '=='. ce/ve.ce.Surface.js: line 733, col 13, Too many var statements. ce/ve.ce.Surface.js: line 734, col 24, Expected '===' and instead saw '=='. ce/ve.ce.Surface.js: line 1013, col 13, Too many var statements. ce/ve.ce.Surface.js: line 1019, col 17, Too many var statements. ce/ve.ce.Surface.js: line 1023, col 18, Too many ar statements. ce/ve.ce.Surface.js: line 1027, col 13, Too many var statements. dm/annotations/ve.dm.LinkAnnotation.js: line 70, col 52, Insecure '.'. dm/ve.dm.Converter.js: line 383, col 29, Empty block. dm/ve.dm.Converter.js: line 423, col 33, Empty block. Commands: * jshint . * ack '(if\|else\|function\|switch\|for\|while)\(' * Sublime Text 2: Find(): (if\|else\|function\|switch\|for\|while)\( Replace: $1 ( ack ' ' -Q # double spaces, except in certain comments Change-Id: I8e34bf2924bc8688fdf8acef08bbc4f6707e93be 2012-09-02 21:45:01 +00:00			`ve.dir = function () {`
Fixing ve.log and ve.dir for IE Change-Id: Ieee1aec3e6ea45f3eecdea53e3691ebe19306a33 2012-08-21 00:14:43 +00:00			`Function.prototype.apply.call( console.dir, console, arguments );`
			`};`