[PATCH] Update man pages to match change to Functions/Misc/colors

[Jim <linux.tech.guy@xxxxxxxxx>]

Hi all,

AFAICT ANSI defines "7" as reverse mode. Changes to the colors function now

uses reverse mode instead of standout mode. Upto and including version 5.8.1

standout was defined here as 03 which is italic. In 5.9 italic was added as 03 and

standout was moved to 07 but was also commented out. Also no-italic was

added as 23 and no-standout was moved to 27 and commented out.

The attached patch updates the man pages and would reflect the change.

The one thing that looks strange about the change is prompt %S and %s, previously

standout mode, will now mean reverse mode.

What I don't know is if C code behind things like:

zle_highlight=(region:standout special:standout
suffix:bold isearch:underline paste:standout)

would now support

zle_highlight=(region:reverse special:reverse
suffix:bold isearch:underline paste:reverse)

There may also be legacy scripts to consider.

The attached patch is submitted for your consideration.

Regards,

Jim Murphy

diff --git a/Doc/Zsh/compctl.yo b/Doc/Zsh/compctl.yo
index d06b31d25..967863838 100644
--- a/Doc/Zsh/compctl.yo
+++ b/Doc/Zsh/compctl.yo
@@ -471,7 +471,7 @@ be shown if there was at least one match added for the explanation
 string.
 
 The sequences tt(%B), tt(%b), tt(%S), tt(%s), tt(%U), and tt(%u) specify
-output attributes (bold, standout, and underline), tt(%F), tt(%f), tt(%K),
+output attributes (bold, reverse, and underline), tt(%F), tt(%f), tt(%K),
 tt(%k) specify foreground and background colours, and tt(%{)var(...)tt(%}) can
 be used to include literal escape sequences as in prompts.
 )
diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
index 3f708eb5a..e232447c6 100644
--- a/Doc/Zsh/compsys.yo
+++ b/Doc/Zsh/compsys.yo
@@ -2025,7 +2025,7 @@ width, padded to the  right with spaces, while the lowercase form will
 be replaced by a variable width string.  As in other prompt strings, the
 escape sequences `tt(%S)', `tt(%s)', `tt(%B)', `tt(%b)', `tt(%U)',
 `tt(%u)' for entering and leaving the display modes
-standout, bold and underline, and `tt(%F)', `tt(%f)', `tt(%K)', `tt(%k)' for
+reverse, bold and underline, and `tt(%F)', `tt(%f)', `tt(%K)', `tt(%k)' for
 changing the foreground background colour, are also available, as is the form
 `tt(%{)...tt(%})' for enclosing escape sequences which display with zero
 (or, with a numeric argument, some other) width.
diff --git a/Doc/Zsh/contrib.yo b/Doc/Zsh/contrib.yo
index f43ac2257..7fce0ac5e 100644
--- a/Doc/Zsh/contrib.yo
+++ b/Doc/Zsh/contrib.yo
@@ -4292,11 +4292,11 @@ tt(colors) more than once.
 The eight base colors are: tt(black), tt(red), tt(green), tt(yellow),
 tt(blue), tt(magenta), tt(cyan), and tt(white).  Each of these has codes for
 foreground and background.  In addition there are seven intensity attributes:
-tt(bold), tt(faint), tt(standout), tt(underline), tt(blink), tt(reverse),
+tt(bold), tt(faint),  tt(underline), tt(blink), tt(reverse),
 and tt(conceal).  Finally, there are seven codes used to negate attributes:
 tt(none) (reset all attributes to the defaults), tt(normal)
-(neither bold nor faint), tt(no-standout), tt(no-underline), tt(no-blink),
-tt(no-reverse), and tt(no-conceal).
+(neither bold nor faint), tt(no-reverse), tt(no-underline), tt(no-blink),
+and tt(no-conceal).
 
 Some terminals do not support all combinations of colors and intensities.
 
diff --git a/Doc/Zsh/mod_complist.yo b/Doc/Zsh/mod_complist.yo
index 463486ff9..c16437934 100644
--- a/Doc/Zsh/mod_complist.yo
+++ b/Doc/Zsh/mod_complist.yo
@@ -254,7 +254,7 @@ matches to insert into the command line can be selected from this
 list.  In the list one match is highlighted using the value for tt(ma)
 from the tt(ZLS_COLORS) or tt(ZLS_COLOURS) parameter.  The default
 value for this is `tt(7)' which forces the selected match to be
-highlighted using standout mode on a vt100-compatible terminal.  If
+highlighted using reverse mode on a vt100-compatible terminal.  If
 neither tt(ZLS_COLORS) nor tt(ZLS_COLOURS) is set, the same terminal
 control sequence as for the `tt(%S)' escape in prompts is used.
 
diff --git a/Doc/Zsh/mod_curses.yo b/Doc/Zsh/mod_curses.yo
index e2d5690e2..d0002d135 100644
--- a/Doc/Zsh/mod_curses.yo
+++ b/Doc/Zsh/mod_curses.yo
@@ -105,7 +105,7 @@ foreground/background color pair for any successive character output.
 Each var(attribute) given on the line may be prepended by a tt(+) to set
 or a tt(-) to unset that attribute; tt(+) is assumed if absent.  The
 attributes supported are tt(blink), tt(bold), tt(dim), tt(reverse),
-tt(standout), and tt(underline).
+and tt(underline).
 
 Each var(fg_col)tt(/)var(bg_col) attribute (to be read as
 `var(fg_col) on var(bg_col)') sets the foreground and background color
diff --git a/Doc/Zsh/mod_watch.yo b/Doc/Zsh/mod_watch.yo
index d97a41d13..3afa410f5 100644
--- a/Doc/Zsh/mod_watch.yo
+++ b/Doc/Zsh/mod_watch.yo
@@ -72,7 +72,7 @@ item(tt(%K{)var(color)tt(}) LPAR()tt(%k)RPAR())(
 Start (stop) using a different background color.
 )
 item(tt(%S) LPAR()tt(%s)RPAR())(
-Start (stop) standout mode.
+Start (stop) reverse mode.  Previously known as standout mode.
 )
 item(tt(%U) LPAR()tt(%u)RPAR())(
 Start (stop) underline mode.
diff --git a/Doc/Zsh/prompt.yo b/Doc/Zsh/prompt.yo
index 909012c8e..31d9c4595 100644
--- a/Doc/Zsh/prompt.yo
+++ b/Doc/Zsh/prompt.yo
@@ -229,7 +229,7 @@ item(tt(%U) LPAR()tt(%u)RPAR())(
 Start (stop) underline mode.
 )
 item(tt(%S) LPAR()tt(%s)RPAR())(
-Start (stop) standout mode.
+Start (stop) reverse mode.  Previously known as standout mode.
 )
 item(tt(%F) LPAR()tt(%f)RPAR())(
 Start (stop) using a different foreground colour, if supported
diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo
index 495bd86a8..987d688ac 100644
--- a/Doc/Zsh/zle.yo
+++ b/Doc/Zsh/zle.yo
@@ -997,7 +997,7 @@ itemiz(A highlight specification in the same format as
 used for contexts in the parameter tt(zle_highlight), see
 ifnzman(noderef(Character Highlighting))\
 ifzman(the section `Character Highlighting' below);
-for example, tt(standout) or tt(fg=red,bold).)
+for example, tt(reverse) or tt(fg=red,bold).)
 itemiz(Optionally, a string of the form `tt(memo=)var(token)'.
 The var(token) consists of everything between the `tt(=)' and the next
 whitespace, comma, NUL, or the end of the string.
@@ -2790,11 +2790,11 @@ item(tt(faint))(
 The characters in the given context are shown with a faint font weight.
 Not all terminals distinguish faint fonts.
 )
-item(tt(standout))(
-The characters in the given context are shown in the terminal's standout
+item(tt(reverse))(
+The characters in the given context are shown in the terminal's reverse
 mode.  The actual effect is specific to the terminal; on many terminals it
 is inverse video.  On some such terminals, where the cursor does not blink
-it appears with standout mode negated, making it less than clear where
+it appears with reverse mode negated, making it less than clear where
 the cursor actually is.  On such terminals one of the other effects
 may be preferable for highlighting the region and matched search string.
 )
@@ -2856,10 +2856,10 @@ enditem()
 If tt(zle_highlight) is not set or no value applies to a particular
 context, the defaults applied are equivalent to
 
-example(zle_highlight=LPAR()region:standout special:standout
-suffix:bold isearch:underline paste:standout+RPAR())
+example(zle_highlight=LPAR()region:reverse special:reverse
+suffix:bold isearch:underline paste:reverse+RPAR())
 
-i.e. both the region and special characters are shown in standout mode.
+i.e. both the region and special characters are shown in reverse mode.
 
 Within widgets, arbitrary regions may be highlighted by setting the
 special array parameter tt(region_highlight); see