From: Jacob Nevins <jacobn@chiark.greenend.org.uk>
Date: Sat, 30 Nov 2013 20:01:26 +0000 (+0000)
Subject: Document the 'bold black' hazard of bold-as-font.
X-Git-Tag: 0.64~109
X-Git-Url: https://asedeno.scripts.mit.edu/gitweb/?a=commitdiff_plain;h=24fef3758a758f61fab28659e1113cb766d5558e;p=PuTTY.git

Document the 'bold black' hazard of bold-as-font.

[originally from svn r10101]
---

diff --git a/doc/config.but b/doc/config.but
index 42da1356..e297170b 100644
--- a/doc/config.but
+++ b/doc/config.but
@@ -1539,7 +1539,7 @@ If you do not see \cq{colors#256} in the output, you may need to
 change your terminal setting. On modern Linux machines, you could
 try \cq{xterm-256color}.
 
-\S{config-boldcolour} \q{Indicate bolded text by changing}
+\S{config-boldcolour} \q{Indicate bolded text by changing...}
 
 \cfg{winhelp-topic}{colours.bold}
 
@@ -1556,6 +1556,10 @@ box, bold and non-bold text will be displayed in the same colour, and
 instead the font will change to indicate the difference. If you select
 \q{Both}, the font and the colour will both change.
 
+Some applications rely on \q{\i{bold black}} being distinguishable
+from a black background; if you choose \q{The font}, their text may
+become invisible.
+
 \S{config-logpalette} \q{Attempt to use \i{logical palettes}}
 
 \cfg{winhelp-topic}{colours.logpal}
@@ -1600,10 +1604,10 @@ and \I{default background}background, and the precise shades of all the
 \I{ANSI colours}ANSI configurable colours (black, red, green, yellow, blue,
 magenta, cyan, and white). You can also modify the precise shades used for
 the \i{bold} versions of these colours; these are used to display bold text
-if you have selected \q{Bolded text is a different colour}, and can also be
-used if the server asks specifically to use them. (Note that \q{Default
-Bold Background} is \e{not} the background colour used for bold text;
-it is only used if the server specifically asks for a bold
+if you have chosen to indicate that by colour (see \k{config-boldcolour}),
+and can also be used if the server asks specifically to use them. (Note
+that \q{Default Bold Background} is \e{not} the background colour used for
+bold text; it is only used if the server specifically asks for a bold
 background.)
 
 \H{config-connection} The Connection panel
diff --git a/doc/index.but b/doc/index.but
index beb8fcda..9fb81421 100644
--- a/doc/index.but
+++ b/doc/index.but
@@ -485,6 +485,10 @@ saved sessions from
 \IM{default foreground} foreground colour, default
 \IM{default foreground} colour, foreground, default
 
+\IM{bold black} bold black
+\IM{bold black} black, bold
+\IM{bold black} bright black
+
 \IM{TERM} \cw{TERM} environment variable
 
 \IM{logical palettes} logical palettes