Warn when less params documented than detected from code.

        [:dup_param, "Method has two parameters with the same name"],

        [:dup_member, "Class has two members with the same name"],

        [:req_after_opt, "Required parameter comes after optional"],

        [:param_count, "Less parameters documented than detected from code"],

        [:subproperty, "@param foo.bar where foo param doesn't exist"],

        [:sing_static, "Singleton class member marked as @static"],

        [:type_syntax, "Syntax error in {type definition}"],

require "jsduck/doc/subproperties"

require "jsduck/render/subproperties"

require "jsduck/docs_code_comparer"

require "jsduck/logger"

module JsDuck::Tag

  class Param < Tag

    end

    def merge(h, docs, code)

      h[:params] = merge_params(docs, code)

      h[:params] = merge_params(docs, code, h[:files].first)

    end

    def format(m, formatter)

    private

    def merge_params(docs, code)

    def merge_params(docs, code, file)

      explicit = docs[:params] || []

      implicit = JsDuck::DocsCodeComparer.matches?(docs, code) ? (code[:params] || []) : []

      ex_len = explicit.length

      im_len = implicit.length

      # Warn when less parameters documented than found from code.

      if ex_len < im_len && ex_len > 0

        JsDuck::Logger.warn(:param_count, "Detected #{im_len} params, but only #{ex_len} documented.", file[:filename], file[:linenr])

      end

      # Override implicit parameters with explicit ones

      # But if explicit ones exist, don't append the implicit ones.

      params = []

      (explicit.length > 0 ? explicit.length : implicit.length).times do |i|

      (ex_len > 0 ? ex_len : im_len).times do |i|

        im = implicit[i] || {}

        ex = explicit[i] || {}

        params << {