Added some XTerm instructions for bold
[stack/conf/irssi-colors-solarized.git] / README.mkd
index cca1825..170917b 100644 (file)
@@ -65,8 +65,8 @@ Solarized orange.
 So in order for irssi to display the Solarized palette, you have to set your
 Terminal emulator's color settings to the Solarized palette. The [Solarized
 repository] includes theme settings for some popular terminal emulators as
 So in order for irssi to display the Solarized palette, you have to set your
 Terminal emulator's color settings to the Solarized palette. The [Solarized
 repository] includes theme settings for some popular terminal emulators as
-well as Xdefaults; or you can download them from the official [Solarized
-homepage]. If you use the irssi themes *without* having changed your
+well as Xdefaults; or you can download them from the official [Solarized]
+homepage. If you use the irssi themes *without* having changed your
 emulator's palette, you will get a strange selection of colors that may be
 hard to read.
 
 emulator's palette, you will get a strange selection of colors that may be
 hard to read.
 
@@ -138,13 +138,14 @@ the number of colors visible is minimized when possible. Colors were selected
 based on the characteristics of the text characters to be displayed:
 
 - Visibility generally follows importance, with an attempt to let unimportant
 based on the characteristics of the text characters to be displayed:
 
 - Visibility generally follows importance, with an attempt to let unimportant
-  text fade into the background (which is not always possible when supporting
-  both dark and light backgrounds)
+  text fade into the background (which is not always possible when
+  simultaneously supporting dark and light backgrounds)
 - Loud colors are chosen to call attention to noteworthy messages
 
 ### Supported Scripts ###
 
 The following third-party scripts are supported:
 - Loud colors are chosen to call attention to noteworthy messages
 
 ### Supported Scripts ###
 
 The following third-party scripts are supported:
+
 - [adv\_windowlist.pl](http://anti.teamidiot.de/static/nei/*/Code/Irssi/)
 - [usercount.pl](http://scripts.irssi.org/html/usercount.pl.html)
 - [trackbar.pl](http://scripts.irssi.org/html/trackbar.pl.html)
 - [adv\_windowlist.pl](http://anti.teamidiot.de/static/nei/*/Code/Irssi/)
 - [usercount.pl](http://scripts.irssi.org/html/usercount.pl.html)
 - [trackbar.pl](http://scripts.irssi.org/html/trackbar.pl.html)
@@ -199,14 +200,23 @@ Installation
         - For Apple's Terminal.app on OS X, this means that Text Settings must
           have the `Use bright colors for bold text` checkbox *selected*.
 
         - For Apple's Terminal.app on OS X, this means that Text Settings must
           have the `Use bright colors for bold text` checkbox *selected*.
 
-    2.  It's recommended to turn off the display of bold typeface for bold text.  For
-        example,
-        - For iTerm on OS X, this means that Text Preferences should have the
+    2.  It's recommended to turn off the display of bold typeface for bold
+        text.  For example,
+        - For iTerm2 on OS X, this means that Text Preferences should have the
           `Draw bold text in bold font` checkbox *unselected*.
         - For Apple's Terminal.app on OS X, this means that Text Settings
           should have the `Use bold fonts` checkbox *unselected*.
           `Draw bold text in bold font` checkbox *unselected*.
         - For Apple's Terminal.app on OS X, this means that Text Settings
           should have the `Use bold fonts` checkbox *unselected*.
+        - For XTerm, this may mean setting the `font` and `boldFont` to be the
+          same in your .Xresources or .Xdefaults, e.g.:
+
+            xterm*font: fixed
+            xterm*boldFont: fixed
+
+    Example: for iTerm2, these are the correct settings:
+
+    ![iTerm bold settings](https://github.com/huyz/irssi-colors-solarized/raw/master/img/screen-iTerm2-bold-options.png)
 
 
-2.  Obtain solarized-universal.theme
+2.  Obtain `solarized-universal.theme`
 
     a) Option A: Download `solarized-universal.theme` from [irssi-only repository]
        and place it in your `~/.irssi` directory
 
     a) Option A: Download `solarized-universal.theme` from [irssi-only repository]
        and place it in your `~/.irssi` directory