--issue=523108

chrome/renderer/render_view.h

Index: chrome/renderer/render_view.h
===================================================================
--- chrome/renderer/render_view.h	(revision 36525)
+++ chrome/renderer/render_view.h	(working copy)
@@ -436,9 +436,15 @@
 
   PageTranslator* page_translator() const { return page_translator_.get(); }
 
-  // Returns the ISO 639_1 language code of the current page
-  // (ex: en, fr, zh...).  Returns 'unknown' if the language could not be
-  // determined.
+  // Returns the ISO 639 language code of the current page (e.g. en, fr, zh).
+  // If ISO 639-1 code is not available for the language, ISO 639-2 3-letter code
+  // will be returned (e.g. kha for Khasi and und for undtermined). For traditional
+  // Chinse, 'zh-TW' will be returned while for simplified Chinse, 'zh' will be
+  // returned.
+  // TODO(jungshik): Make it return 'he' (the correct ISO 639 code for Hebrew)
+  // instead of the obsolete 'iw'. Perhaps, it's also better to return 'zh-Hans'
+  // (or 'zh-CN') for Simplified Chinese instead of 'zh' to be aligned with
+  // 'zh-TW' for Traditional Chinse.
   std::string DetectLanguage();
 
  protected: