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

git-svn-id: http://svn.tartarus.org/sgt/putty@10101 cda61777-01e9-0310-a592-d414129be87e

diff --git a/doc/config.but b/doc/config.but
index 42da1356ba91d91f01432bedf310571ddbbcef53..e297170b0edb566cdd08a6a236b3b2d67ce83b01 100644 (file)
--- 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 beb8fcda4505ca93237c0908396b6da101d942ba..9fb81421d5381ead08d59be64c8b794cbec2142a 100644 (file)
--- 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