Improve ProductLicenseTranslations documentation

yast · May 29, 2018 · 77bd48c · 77bd48c
1 parent b6dca68
commit 77bd48c
Showing 1 changed file with 11 additions and 3 deletions.
diff --git a/src/lib/y2packager/widgets/product_license_translations.rb b/src/lib/y2packager/widgets/product_license_translations.rb
@@ -85,6 +85,7 @@ def product_license
       # Available license translations
       #
       # When running on textmode, only the preselected/given language is considered.
+      # see #default_language for further details.
       #
       # @return [Array<String>] Locale codes of the available translations
       # @see #default_language
@@ -96,6 +97,7 @@ def available_locales
       # License translation language
       #
       # When running on textmode, it returns the preselected/default language.
+      # see #default_language for further details.
       #
       # @return [String] License content language
       # @see #default_language
@@ -108,9 +110,15 @@ def content_language
 
       # Default language
       #
-      # During 1st stage, it returns the preselected language (from install.inf). On an installed
-      # system, it prefers the given language. Finally, if the license translation is not available,
-      # the fallback language is returned.
+      # For some languages (like Japanese, Chinese or Korean) YaST needs to use a fbiterm in order
+      # to display symbols correctly when running on textmode.  However, if none of those languages
+      # is selected on boot, this special terminal won't be used.
+      #
+      # So during 1st stage and when running in textmode, it returns the preselected language (from
+      # install.inf).
+      #
+      # On an installed system, it prefers the given language. Finally, if the license translation
+      # is not available, the fallback language is returned.
       #
       # @return [String] Language code
       def default_language