xterm-256color.txt

   1 TITLE:          256 color xterm
   2
   3 DATE:           2003-10-03
   4
   5 LFS VERSION:    any
   6
   7 AUTHOR:         Randy Hron <rwhron at earthlink dot net>
   8
   9 SYNOPSIS:       How to build a 256 color capable xterm.
  10
  11 DESCRIPTION:
  12
  13         This hint assumes you've already installed XFree86
  14         and want an xterm that supports more than 16 colors.
  15
  16 PREREQUISITES:  XFree86
  17
  18 CHANGELOG:
  19 Mon Sep 15 20:55:36 EDT 2003  Updated for XFree86-4.3.0.1.
  20 Other than the tarballs to extract in step 2, this applies
  21 to earlier versions of XFree86 4.x.  (Back when there were
  22 only 3 tarballs for XFree86, xterm was in the first tarball).
  23
  24 Fri Oct  3 22:09:52 EDT 2003  Reference vim-6.2.  Use
  25 xterm-color as TERM.  Make test programs executable.  Tested
  26 with 4.3.99.12.
  27
  28
  29 LICENSE:                GNU Free Documentation License
  30
  31 HINT:
  32         XFree86 builds a 16 color capable xterm by default.
  33 If you want to run vim or other color capable programs, you may
  34 want an xterm that does more colors.
  35
  36
  37 1. How many colors do I have?
  38 You can check how many colors your xterm knows with the command:
  39
  40 strings /usr/X11R6/bin/xterm | grep ^color[0-9] | sort -tr +1 -n
  41
  42 This command has to be executed as root, since xterm is setuid
  43 and is not readable by normal users.  It may print something like:
  44
  45 color0
  46 color1
  47 ..
  48 color14
  49 color15
  50
  51 If that is all you get, you have a 16 color xterm.  If the list keeps
  52 going to color255, you already have a 256 color xterm.
  53
  54 2. Building a 256 color xterm
  55 If you already removed your xc tree, don't despair.  You can recompile
  56 xterm without compiling the World.  If you don't still have the xc tree
  57 extracted, just extract X430src-1.tgz and X430src-2.tgz.  xterm is in
  58 the second tarball.
  59
  60 cd xc/programs/xterm &&
  61 rm -f *.o
  62 xmkmf &&
  63 sed 's/_WIDE_CHARS/_WIDE_CHARS -DOPT_256_COLORS -DDFT_TERM_TYPE=xterm-color/' \
  64         Makefile > Makefile~ &&
  65 mv Makefile~ Makefile &&
  66 make &&
  67 strings xterm | grep ^color[0-9] | sort -tr +1 -n
  68
  69 This time you should see a list of colors that counts to color255
  70
  71 color0
  72 color1
  73 ..
  74 color254
  75 color255
  76
  77 4) Install the new xterm
  78 make install
  79
  80 5) Update your TERM variable
  81 Use xterm-color as your TERM type.  You may want
  82 something like this in your /etc/bashrc:
  83
  84 case `tty` in
  85         */pty*|*/pts/*)
  86         export TERM=xterm-color
  87         ;;
  88 esac
  89
  90 6) Xdefaults
  91 Different X apps/window managers may use either .Xresources or .Xdefaults
  92 to change their default behavior.  Here are some things in my .Xdefaults
  93 to make colors more enjoyable:
  94
  95 ! Pick your favorites from /usr/X11R6/lib/X11/rgb.txt
  96 ! Be sure to use the "OneWord" value for a color, and not
  97 ! the "two words" value.
  98 ! xterm*background:       black
  99 ! xterm*foreground:       green
 100 *loginShell:            true
 101
 102 ! Use color for underline attribute
 103 *VT100*colorULMode: on
 104 *VT100*underLine: off
 105
 106 ! Use color for the bold attribute
 107 *VT100*colorBDMode: on
 108
 109 ! Love scrollback
 110 *VT100*saveLines: 5000
 111 *VT100*scrollBar: true
 112
 113 ! Use -color app-defaults in /usr/X11R6/lib/X11/app-defaults
 114 *customization: -color
 115
 116 Make your new ~/.Xdefaults take effect without restarting X with:
 117 xrdb -merge ~/.Xdefaults
 118
 119
 120 7) Vim
 121 To have syntax highlighting in vim, have this in your ~/.vimrc:
 122
 123 syntax on
 124
 125 8) Log all the way out and come back in.
 126 You can do a combination of xrdb and sourcing your .bash_profile,
 127 but your window manager will still think your TERM is xterm and
 128 not xterm-color.  To eliminate confusion, just log out to xdm
 129 or the login prompt and come back in.
 130
 131 9) Checking colors
 132 There are several nifty xterm tests in xc/programs/xterm/vttests.
 133 The fastest one for testing colors is 256colors2.pl.  Just run:
 134
 135 chmod +x *.pl
 136 /256colors2.pl
 137
 138 10) Testing vim colors
 139 Vim has a colortest program that you run with vim:
 140
 141 vim /usr/share/vim/vim62/syntax/colortest.vim
 142
 143 >From inside vim, type:
 144 :source %
 145
 146 I counted about 23 colors in this test, but it's nice seeing
 147 the words associated with the colors.
 148
 149 11) Have fun.  Let me know if something here is inaccurate or
 150 could be better.
 151
 152 12) Thanks to Gerard and everyone at Linux From Scratch.
 153