Docs update (#1673)

* Updating docs for getRegionCodeForNumber to clarify that it does not work for short codes or invalid numbers.

cpp/src/phonenumbers/phonenumberutil.h

@@ -452,7 +452,8 @@ class PhoneNumberUtil : public Singleton<PhoneNumberUtil> {
       const string& region_code) const;
 
   // Returns the region where a phone number is from. This could be used for
-  // geo-coding at the region level.
+  // geocoding at the region level. Only guarantees correct results for valid,
+  // full numbers (not short-codes, or invalid numbers).
   void GetRegionCodeForNumber(const PhoneNumber& number,
                               string* region_code) const;
 

java/libphonenumber/src/com/google/i18n/phonenumbers/PhoneNumberUtil.java

@@ -2286,7 +2286,8 @@ public class PhoneNumberUtil {
 
   /**
    * Returns the region where a phone number is from. This could be used for geocoding at the region
-   * level.
+   * level. Only guarantees correct results for valid, full numbers (not short-codes, or invalid
+   * numbers).
    *
    * @param number  the phone number whose origin we want to know
    * @return  the region where the phone number is from, or null if no region matches this calling

javascript/i18n/phonenumbers/phonenumberutil.js

@@ -3025,7 +3025,8 @@ i18n.phonenumbers.PhoneNumberUtil.prototype.isValidNumberForRegion =
 
 /**
  * Returns the region where a phone number is from. This could be used for
- * geocoding at the region level.
+ * geocoding at the region level. Only guarantees correct results for valid,
+ * full numbers (not short-codes, or invalid numbers).
  *
  * @param {i18n.phonenumbers.PhoneNumber} number the phone number whose origin
  *     we want to know.

pending_code_changes.txt

@@ -1 +1,3 @@
-
+Code changes:
+ - Doc updates for getRegionCodeForNumber to clarify that it does not
+  work for short-codes or invalid numbers.