diff --git a/admin/upgrade.txt b/admin/upgrade.txt
index 54a71441bc0..ed48743162c 100644
--- a/admin/upgrade.txt
+++ b/admin/upgrade.txt
@@ -4,8 +4,6 @@ This files describes API changes in /admin/*.
 
 * Admin settings have been refined to better support right-to-left languages. In RTL,
   most fields should not have their direction flipped, a URL, a path to a file, ...
-  are always displayed LTR. Most of the admin_setting classes will now prefer LTR.
-  If you must not force left-to-right, here are a few options:
-  * Call admin_setting::set_force_ltr(false) on your setting;
-  * Use the php class admin_setting_localisedtext for text inputs;
-  * Use the php class admin_setting_localisedtextarea for larger text inputs.
+  are always displayed LTR. The admin setting will now best guess if they should be
+  RTLized based on their PARAM_* type. To override that guess, use
+  admin_setting::set_force_ltr(true/false).
diff --git a/lib/adminlib.php b/lib/adminlib.php
index e2c0234ae09..d8cbf40b03a 100644
--- a/lib/adminlib.php
+++ b/lib/adminlib.php
@@ -1909,9 +1909,6 @@ abstract class admin_setting {
     /**
      * Get whether this should be displayed in LTR mode.
      *
-     * For more information on this setting, please check the documentation
-     * provided with {@link admin_setting_localisedtext}.
-     *
      * @return bool|null
      */
     public function get_force_ltr() {
@@ -1921,9 +1918,6 @@ abstract class admin_setting {
     /**
      * Set whether to force LTR or not.
      *
-     * For more information on this option, please read the documentation
-     * provided with the class {@link admin_setting_localisedtext}.
-     *
      * @param bool $value True when forced, false when not force, null when unknown.
      */
     public function set_force_ltr($value) {
@@ -2123,9 +2117,6 @@ class admin_setting_heading extends admin_setting {
  * This type of field should be used for config settings which are using
  * English words and are not localised (passwords, database name, list of values, ...).
  *
- * For localised strings such as a person's name, text to display to the users, etc...
- * please refer to {@link admin_setting_localisedtext}.
- *
  * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  */
 class admin_setting_configtext extends admin_setting {