RGB(1)              X Version 11 (Release 4)               RGB(1)


     NAME
          rgb - convert a rgb spec file to ndbm files

     SYNOPSIS
          rgb

     DESCRIPTION
          rgb reads the standard input and writes ndbm files
          /usr/lib/X11/rgb.pag and /usr/lib/X11/rgb.dir.  These files
          are suitable for use by the X server.

          The expected use of rgb is to support custom modification of
          /usr/lib/X11/rgb.txt. Typically, it is used by invoking:

                  rgb  <  [path]rgb.txt

          NOTE: You must have permission enabling you to write the
          files in /usr/lib/X11.  Typically, this means running as the
          Super-User.

     RGB.TXT FORMAT
          The rgb.txt file is a list of color specifications, one
          specification per line.  A specification is

                  RedValue   GreenValue   BlueValue   Color_name

          Values are separated by whitespace.  For the purposes of
          this man page, whitespace means any series of spaces and/or
          tabs.  The Color_name starts from the first non-whitespace
          character following the third value and extends to the
          newline, including trailing whitespace, which is
          significant.  Imbedded whitespace is allowed.  For example,

                25  25 112             midnight blue
                64 224 208             turquoise

          describes colors "midnight blue" and "turquoise" assuming
          there is no trailing whitespace after those strings.  The
          space in "midnight blue" is significant.

          The results of feeding rgb invalid data are not defined.

     SEE ALSO
          X(1), ndbm(3B), su(1)

     BUGS
          About the only help you get in case of an error is:
                  syntax error on line <x>

          rgb always writes to /usr/lib/X11.


     Page 1                                          (printed 7/20/06)