diff --git a/javascript/i18n/phonenumbers/asyoutypeformatter.js b/javascript/i18n/phonenumbers/asyoutypeformatter.js
index 16cfcf05c..861152861 100644
--- a/javascript/i18n/phonenumbers/asyoutypeformatter.js
+++ b/javascript/i18n/phonenumbers/asyoutypeformatter.js
@@ -754,8 +754,8 @@ i18n.phonenumbers.AsYouTypeFormatter.prototype.attemptToFormatAccruedDigits_ =
  * Combines the national number with any prefix (IDD/+ and country code or
  * national prefix) that was collected. A space will be inserted between them if
  * the current formatting template indicates this to be suitable.
- * @param {string} nationalNumber
- * @return {string}
+ * @param {string} nationalNumber The number to be appended.
+ * @return {string} The combined number.
  * @private
  */
 i18n.phonenumbers.AsYouTypeFormatter.prototype.appendNationalNumber_ =
@@ -873,9 +873,8 @@ i18n.phonenumbers.AsYouTypeFormatter.prototype.inputAccruedNationalNumber_ =
 
 
 /**
- * Returns true if the current country is a NANPA country and the national
- * number begins with the national prefix.
- * @return {boolean}
+ * @return {boolean} true if the current country is a NANPA country and the
+ *     national number begins with the national prefix.
  * @private
  */
 i18n.phonenumbers.AsYouTypeFormatter.prototype.
diff --git a/javascript/i18n/phonenumbers/phonenumberutil.js b/javascript/i18n/phonenumbers/phonenumberutil.js
index 8574939c3..0d238b425 100644
--- a/javascript/i18n/phonenumbers/phonenumberutil.js
+++ b/javascript/i18n/phonenumbers/phonenumberutil.js
@@ -1288,8 +1288,10 @@ i18n.phonenumbers.PhoneNumberUtil.normalizeHelper_ =
  * Helper function to check if the national prefix formatting rule has the first
  * group only, i.e., does not start with the national prefix.
  *
- * @param {string} nationalPrefixFormattingRule
- * @return {boolean}
+ * @param {string} nationalPrefixFormattingRule The formatting rule for the
+ *     national prefix.
+ * @return {boolean} true if the national prefix formatting rule has the first
+ *     group only.
  */
 i18n.phonenumbers.PhoneNumberUtil.prototype.formattingRuleHasFirstGroupOnly =
     function(nationalPrefixFormattingRule) {