about summary refs log tree commit diff
path: root/Doc
diff options
context:
space:
mode:
authorPeter Stephenson <pws@users.sourceforge.net>2008-05-09 17:33:49 +0000
committerPeter Stephenson <pws@users.sourceforge.net>2008-05-09 17:33:49 +0000
commitc811a18d44c4720572504065bc1b83371b8998b2 (patch)
tree201687655489fbbfd782e4807ce5bcf7d775c97e /Doc
parentf7246fb559da77ac718b610132cdfb6ea07dc686 (diff)
downloadzsh-c811a18d44c4720572504065bc1b83371b8998b2.tar.gz
zsh-c811a18d44c4720572504065bc1b83371b8998b2.tar.xz
zsh-c811a18d44c4720572504065bc1b83371b8998b2.zip
24986: prompt escapes for colours
Diffstat (limited to 'Doc')
-rw-r--r--Doc/Zsh/prompt.yo14
-rw-r--r--Doc/Zsh/zle.yo7
2 files changed, 18 insertions, 3 deletions
diff --git a/Doc/Zsh/prompt.yo b/Doc/Zsh/prompt.yo
index 29761140e..8aaa4d4f4 100644
--- a/Doc/Zsh/prompt.yo
+++ b/Doc/Zsh/prompt.yo
@@ -183,6 +183,20 @@ Start (stop) underline mode.
 item(tt(%S) LPAR()tt(%s)RPAR())(
 Start (stop) standout mode.
 )
+item(tt(%F) LPAR()tt(%f)RPAR())(
+Start (stop) using a different foreground colour, if supported
+by the terminal.  The colour may be specified two ways: either
+as a numeric argument, as normal, or by a sequence in braces
+following the tt(%F), for example tt(%F{red}).  In the latter case
+the values allowed are as described for the tt(fg) tt(zle_highlight)
+attribute;
+ifzman(see em(Character Highlighting) in zmanref(zshzle))\
+ifnzman(noderef(Character Highlighting)).
+)
+item(tt(%K) LPAR()tt(%k)RPAR())(
+Start (stop) using a different bacKground colour.  The syntax is
+identical to that for tt(%F) and tt(%f).
+)
 item(tt(%{)...tt(%}))(
 Include a string as a literal escape sequence.
 The string within the braces should not change the cursor
diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo
index b7b4676a7..9f2eec388 100644
--- a/Doc/Zsh/zle.yo
+++ b/Doc/Zsh/zle.yo
@@ -2182,9 +2182,10 @@ Not all terminals support this and, of those that do, not all provide
 facilities to test the support, hence the user should decide based on the
 terminal type.  Most terminals support the colours tt(black), tt(red),
 tt(green), tt(yellow), tt(blue), tt(magenta), tt(cyan) and tt(white),
-which can be set by name.  Abbreviations are allowed; tt(b) or tt(bl)
-selects black.  Some terminals may generate additional colours if the
-tt(bold) attribute is also present.
+which can be set by name.  In addition. tt(default) may be used to
+set the terminal's default foreground colour.  Abbreviations are allowed;
+tt(b) or tt(bl) selects black.  Some terminals may generate additional
+colours if the tt(bold) attribute is also present.
 
 On recent terminals and on systems with an up-to-date terminal database the
 number of colours supported may be tested by with the command `tt(echotc