DevTools: [JsDocValidator] Be smarter about function name and JSDoc detection

Source/devtools/front_end/sdk/InspectorBackend.js

 /*
  * Copyright (C) 2011 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:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 32 matching lines @@
 
 InspectorBackendClass.prototype = {
 
     _initProtocolAgentsConstructor: function()
     {
         window.Protocol = {};
 
         /**
          * @constructor
          * @param {!Object.<string, !Object>} agentsMap
+         * @this {InspectorBackendClass}

[sergeyv, 2014/06/05 17:13:36]

this annotation is wrong.  this function is a constructor, and  type of "this"
is Protocol.Agents 

[apavlov, 2014/06/05 18:41:42]

Oops, my bad! The validator should not require @this here at all!

          */
         window.Protocol.Agents = function(agentsMap) {
             this._agentsMap = agentsMap;
         };
     },
 
     /**
      * @param {string} domain
      */
     _addAgentGetterMethodToProtocolAgentsPrototype: function(domain)
@@ skipping 805 matching lines @@
     }
 
 }
 
 InspectorBackendClass.Options = {
     dumpInspectorTimeStats: false,
     dumpInspectorProtocolMessages: false
 }
 
 InspectorBackend = new InspectorBackendClass();