packages icon
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.