DevTools: Add JSDoc for static methods, fix JSDoc types and induced errors

Source/devtools/front_end/common/utilities.js

 /*
  * Copyright (C) 2007 Apple Inc.  All rights reserved.
  * Copyright (C) 2012 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  *
  * 1.  Redistributions of source code must retain the above copyright
  *     notice, this list of conditions and the following disclaimer.
@@ skipping 844 matching lines @@
 /**
  * @param {string} format
  * @param {...*} var_arg
  * @return {string}
  */
 String.sprintf = function(format, var_arg)
 {
     return String.vsprintf(format, Array.prototype.slice.call(arguments, 1));
 }
 
+/**
+ * @param {string} format
+ * @param {!Object.<string, function(string, ...):*>} formatters
+ * @return {!Array.<!Object>}
+ */
 String.tokenizeFormatString = function(format, formatters)
 {
     var tokens = [];
     var substitutionIndex = 0;
 
     function addStringToken(str)
     {
         tokens.push({ type: "string", value: str });
     }
 
@@ skipping 94 matching lines @@
 /**
  * @param {string} format
  * @param {!Array.<*>} substitutions
  * @return {string}
  */
 String.vsprintf = function(format, substitutions)
 {
     return String.format(format, substitutions, String.standardFormatters, "", function(a, b) { return a + b; }).formattedResult;
 }
 
+/**
+ * @param {string} format
+ * @param {?Array.<string>} substitutions
+ * @param {!Object.<string, function(string, ...):string>} formatters
+ * @param {!T} initialValue
+ * @param {function(?, ?): T|undefined} append

[aandrey, 2014/06/17 11:33:54]

function(T, string)

[apavlov, 2014/06/17 12:46:03]

Done.

+ * @return {!{formattedResult: T, unusedSubstitutions: ?Array.<string>}};
+ * @template T
+ */
 String.format = function(format, substitutions, formatters, initialValue, append)
 {
     if (!format || !substitutions || !substitutions.length)
         return { formattedResult: append(initialValue, format), unusedSubstitutions: substitutions };
 
     function prettyFunctionName()
     {
         return "String.format(\"" + format + "\", \"" + substitutions.join("\", \"") + "\")";
     }
 
@@ skipping 742 matching lines @@
             this._outgoingCallback();
     }
 }
 
 /**
  * @param {*} value
  */
 function suppressUnused(value)
 {
 }