Add --color option for some builtins

Fixes #9716

Closes #12252

doc_src/cmds/abbr.rst

@@ -10,7 +10,7 @@ Synopsis
                     [--set-cursor[=MARKER]] ([-f | --function FUNCTION] | EXPANSION)
     abbr --erase [ [-c | --command COMMAND]... ] NAME ...
     abbr --rename [ [-c | --command COMMAND]... ] OLD_WORD NEW_WORD
-    abbr --show
+    abbr [--show] [--color WHEN]
     abbr --list
     abbr --query NAME ...
 
@@ -75,7 +75,6 @@ With **--set-cursor=MARKER**, the cursor is moved to the first occurrence of **M
 
 With **-f FUNCTION** or **--function FUNCTION**, **FUNCTION** is treated as the name of a fish function instead of a literal replacement. When the abbreviation matches, the function will be called with the matching token as an argument. If the function's exit status is 0 (success), the token will be replaced by the function's output; otherwise the token will be left unchanged. No **EXPANSION** may be given separately.
 
-
 Examples
 ########
 

doc_src/cmds/bind.rst

@@ -6,8 +6,8 @@ Synopsis
 .. synopsis::
 
     bind [(-M | --mode) MODE] [(-m | --sets-mode) NEW_MODE] [--preset | --user] [-s | --silent] KEYS COMMAND ...
-    bind [(-M | --mode) MODE] [--preset] [--user] [KEYS]
-    bind [-a | --all] [--preset] [--user]
+    bind [(-M | --mode) MODE] [--preset] [--user] [--color WHEN] [KEYS]
+    bind [-a | --all] [--preset] [--user] [--color WHEN]
     bind (-f | --function-names)
     bind (-K | --key-names)
     bind (-L | --list-modes)
@@ -104,6 +104,10 @@ The following options are available:
 **-s** or **--silent**
     Silences some of the error messages, including for unknown key names and unbound sequences.
 
+**--color** *WHEN*
+    Controls when to use syntax highlighting colors when listing bindings.
+    *WHEN* can be ``auto`` (the default, colorize if the output :doc:`is a terminal <isatty>`), ``always``, or ``never``.
+
 **-h** or **--help**
     Displays help about using this command.
 

doc_src/cmds/complete.rst

@@ -6,7 +6,7 @@ Synopsis
 
 .. synopsis::
 
-    complete ((-c | --command) | (-p | --path)) COMMAND [OPTIONS]
+    complete ((-c | --command) | (-p | --path)) COMMAND [OPTIONS] [--color WHEN]
     complete (-C | --do-complete) [--escape] STRING
 
 Description
@@ -74,6 +74,10 @@ The following options are available:
 **--escape**
     When used with ``-C``, escape special characters in completions.
 
+**--color** *WHEN*
+    Controls when to use syntax highlighting colors when printing completions.
+    *WHEN* can be ``auto`` (the default, colorize if the output :doc:`is a terminal <isatty>`), ``always``, or ``never``.
+
 **-h** or **--help**
     Displays help about using this command.
 

doc_src/cmds/functions.rst

@@ -6,8 +6,8 @@ Synopsis
 
 .. synopsis::
 
-    functions [-a | --all] [-n | --names]
-    functions [-D | --details] [-v] FUNCTION
+    functions [-a | --all] [-n | --names] [--color WHEN]
+    functions [-D | --details] [-v] [--color WHEN] FUNCTION
     functions -c OLDNAME NEWNAME
     functions -d DESCRIPTION FUNCTION
     functions [-e | -q] FUNCTION ...
@@ -60,6 +60,10 @@ The following options are available:
 **-t** or **--handlers-type** *TYPE*
     Show all event handlers matching the given *TYPE*.
 
+**--color** *WHEN*
+    Controls when to use syntax highlighting colors when printing function definitions.
+    *WHEN* can be ``auto`` (the default, colorize if the output :doc:`is a terminal <isatty>`), ``always``, or ``never``.
+
 **-h** or **--help**
     Displays help about using this command.
 

doc_src/cmds/history.rst

@@ -75,6 +75,10 @@ These flags can appear before or immediately after one of the sub-commands liste
 **-R** or **--reverse**
     Causes the history search results to be ordered oldest to newest. Which is the order used by most shells. The default is newest to oldest.
 
+**--color** *WHEN*
+    Controls when to use syntax highlighting colors for the history entries.
+    *WHEN* can be ``auto`` (the default, colorize if the output :doc:`is a terminal <isatty>`), ``always``, or ``never``.
+
 **-h** or **--help**
     Displays help for this command.
 

doc_src/cmds/type.rst

@@ -41,6 +41,10 @@ The following options are available:
 **-q** or **--query**
     Suppresses all output; this is useful when testing the exit status. For compatibility with old fish versions this is also **--quiet**.
 
+**--color** *WHEN*
+    Controls when to use syntax highlighting colors when printing function definitions.
+    *WHEN* can be ``auto`` (the default, colorize if the output :doc:`is a terminal <isatty>`), ``always``, or ``never``.
+
 **-h** or **--help**
     Displays help about using this command.