### cnice-0.6 README file

    README for cnice version 0.6

    Installation:
    Edit the overly simple Makefile and type make.  make install as root.

    General Info:
    cnice is a c program to examine and modify colors in the default colormap.
    The program opens the display but it uses stdin and stdout for interaction.
    It can be used to:

        o display the colormap entries (text mode), marking free and allocated
          cells and the total free ones.

        o modify color names so that the preferred color will be allocatable.
          The algorithm used makes sure that color cell allocation happens when
          it is really necessary - and possible. The criteria for this can
          be set up by command line option.

        o x applications suffer from color-syndrome. For example when the xterm
          background/foreground color is set to some non-allocatable color,
          it gives up and assigns white to both, making the text unreadable.
          With cnice x applications can be invoked so that cnice pre-parses the
          command line and modifies the colors to make sure that they are
          allocatable.

        o cnice can parse resource database strings to modify the colors.
          The resulting database stings will not contain "tough" colors. Some
          widget sets (namely Motif) will need also shading colors - these
          colors can optionally be added to the database. Note that the resource
          database does not have information whether the resource is a color,
          so in order to find a color resource name a good guess is made.
          (background, foreground, color strings are recognized).

    This program is meant to be an aid for those who have a pseudo color
    display and have some application where the presence of the nearest
    color is more important than the presence of the exact color.

    The program not for purists - it just tries to solve a real-life problem.

    Copyright:
    Freely distributable. Please read the file COPYING. (GNU)

    Have fun,

    Send suggestions to:
    Gaspar Sinai <gsinai@gol.com>

    Tokyo, 1 November, 1996.