docs: function(userAgent) {
              var userAgentWrapper = UserAgent.getUserAgentInfo(userAgent);
  
              // ----------------------------------------- reset /apply properties
  
              this._resetProperties();
  
              var properties = this._getProperties(userAgentWrapper);
              this._import(properties);
  
              /* BACKWARD-COMPATIBILITY-BEGIN (GitHub #1397) */
              this.__ensureDeprecatedProperties();
              /* BACKWARD-COMPATIBILITY-END (GitHub #1397) */
  
              // ---------------------------------------------------------- return
  
              return userAgentWrapper;
          }