Issue 2236 - Worked around JsDoc bug with inline annotations

lib/utils.js

 /*
  * This file is part of Adblock Plus <https://adblockplus.org/>,
  * Copyright (C) 2006-2015 Eyeo GmbH
  *
  * Adblock Plus is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 3 as
  * published by the Free Software Foundation.
  *
  * Adblock Plus is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
@@ skipping 197 matching lines @@
     }
     catch (e) {
       return null;
     }
   },
 
   /**
    * Posts an action to the event queue of the current thread to run it
    * asynchronously. Any additional parameters to this function are passed
    * as parameters to the callback.
+   * @param {function} callback
+   * @param {object} thisPtr
    */
-  runAsync: function(/**Function*/ callback, /**Object*/ thisPtr)
+  runAsync: function(callback, thisPtr)
   {
     let params = Array.prototype.slice.call(arguments, 2);
     let runnable = {
       run: function()
       {
         callback.apply(thisPtr, params);
       }
     };
     Services.tm.currentThread.dispatch(runnable, Ci.nsIEventTarget.DISPATCH_NORMAL);
   },
@@ skipping 163 matching lines @@
    */
   getParams: function()
   {
     let ret = sidebarParams;
     sidebarParams = null;
     return ret;
   },
 
   /**
    * Verifies RSA signature. The public key and signature should be base64-encoded.
+   * @param {string} key
+   * @param {string} signature
+   * @param {string} data
+   * @return {boolean}
    */
-  verifySignature: function(/**String*/ key, /**String*/ signature, /**String*/ data) /**Boolean*/
+  verifySignature: function(key, signature, data)
   {
     if (!Utils.crypto)
       return false;
 
     // Maybe we did the same check recently, look it up in the cache
     if (!("_cache" in Utils.verifySignature))
       Utils.verifySignature._cache = new Cache(5);
     let cache = Utils.verifySignature._cache;
     let cacheKey = key + " " + signature + " " + data;
     if (cacheKey in cache.data)
@@ skipping 368 matching lines @@
     Cu.reportError(e);
     // Expected, ctypes isn't supported in Gecko 1.9.2
     return null;
   }
 });
 
 if ("@mozilla.org/messenger/headerparser;1" in Cc)
   XPCOMUtils.defineLazyServiceGetter(Utils, "headerParser", "@mozilla.org/messenger/headerparser;1", "nsIMsgHeaderParser");
 else
   Utils.headerParser = null;