diff --git a/doc_src/cmds/help.rst b/doc_src/cmds/help.rst
index 4c5a19804..248e9cede 100644
--- a/doc_src/cmds/help.rst
+++ b/doc_src/cmds/help.rst
@@ -21,7 +21,7 @@ The **-h** or **--help** option displays help about using this command.
 
 If the :envvar:`BROWSER` environment variable is set, it will be used to display the documentation.
 Otherwise, fish will search for a suitable browser.
-To use a different browser than as described above, one can set the :envvar:`fish_help_browser` variable.
+To use a different browser than as described above, you can set ``$fish_help_browser``
 This variable may be set as a list, where the first element is the browser command and the rest are browser options.
 
 Example
diff --git a/doc_src/cmds/switch.rst b/doc_src/cmds/switch.rst
index 5ba099abc..a52083df3 100644
--- a/doc_src/cmds/switch.rst
+++ b/doc_src/cmds/switch.rst
@@ -27,7 +27,7 @@ Note that command substitutions in a case statement will be evaluated even if it
 Example
 -------
 
-If the variable :envvar:`animal` contains the name of an animal, the following code would attempt to classify it:
+If the variable ``$animal`` contains the name of an animal, the following code would attempt to classify it:
 
 ::
 
diff --git a/doc_src/language.rst b/doc_src/language.rst
index 194e93fcb..9362680ac 100644
--- a/doc_src/language.rst
+++ b/doc_src/language.rst
@@ -1323,6 +1323,16 @@ You can change the settings of fish by changing the values of certain variables.
 
    A number of variable starting with the prefixes ``fish_color`` and ``fish_pager_color``. See :ref:`Variables for changing highlighting colors <variables-color>` for more information.
 
+.. envvar:: fish_term24bit
+
+   If this is set to 1, fish will assume the terminal understands 24-bit RGB color sequences, and won't translate them to the 256 or 16 color palette.
+   This is often detected automatically.
+
+.. envvar:: fish_term256
+
+   If this is set to 1, fish will assume the terminal understands 256 colors, and won't translate matching colors down to the 16 color palette.
+   This is usually autodetected.
+
 .. envvar:: fish_ambiguous_width
 
    controls the computed width of ambiguous-width characters. This should be set to 1 if your terminal renders these characters as single-width (typical), or 2 if double-width.