@function foo.bar
@param {Object} options
param description

  @option {function(String)} foo(newName) 
  option description
  
    @this {{}} An object
    a

    @param {String} newName newName description.

    @return {Boolean} true if successful. 
    return description
  
  @option {{}} bar
  
    @option {String} first
    
    @option {String} second

@return {String} something