This file is a part of Xpalette, a multipurpose viewer for X11 rgb.txt files.
                    Copyright (C) 1993, 1994 Michael Weller

Please  note that this  software was developed  in ANSI-C (using GNU-cc) under
X11R5. It  won't compile  under "standard" K&R C  and I don't  know if it will
compile  under X11R4 or earlier  (if your  computer vendor can't provide X11R5
and an ANSI-C compiler kick his ass and order real workstations next time ;-))

Also note  that it is distributed  under the GNU-Copyright.  See 00-Readme and
01-COPYING for details.

The color compare code assumes that long integers are of 32 bit size.  If this
doesn't hold on your machine color searching will probably not work correctly.

The native  environment  for  this tool  is linux  together with  Xfree86-2.0.
However it should easily run on any X11R5 with ANSI-C. Installation is as easy
as it could be:

1 - Make a makefile for your system out of the Imakefile. This is usually done
    by calling "xmkmf" out of the xpalette directory.

2 - A few options can be set/changed  in config.h. So have a  look at it.  You
    won't need to change anything herein usually.

3 - If  you use the Xaw3d Widgets  you may like to change Xpalette-color.ad as
    suggested  by  the  comments  in it.  The  changes  are  only  for  better
    appearance of xpalette. There is no real need to change this file.

4 - Compile  everything  with  a simple "make".  (If you are  using linux with
    Xfree86-2.0 (or higher)  and libc4.4.4 (or higher)  you can omit this step
    as there is already a Xpalette binary supplied (compiled with gcc-2.4.5).
    If you are doing something special and  want only partial recompiles after
    you changed something, or want ensure clean recompiles without make clean,
    make depend after xmkmf but before the other makes will be handy.

5 - If you have superuser access a  "make install" will put every  file in the
    appropriate  directories.  An  additional  "make  install.man"  will  also
    install the provided online manual page.

Exceptions / Comments:

- If  you  don't  have  xmkmf,  imake,  etc. and  can't  use  Imakefile,  then
  cp makefile.generic to Makefile  and give  it a try.  Note that  there is no
  make install at all in this generic makefile.

- If  make install  fails,  you don't  trust me,  or have  to use  the generic
  makefile.  Put xpalette in  any directory in your executable search path  (I
  prefer /usr/bin/X11), xpalette.man  as xpalette.1 in /usr/man/man1 (or maybe
  as xpalette.l in /usr/man/manl). Place Xpalette-color.ad and Xpalette.ad w/o
  the   ".ad"   extension    in   your    app-defaults   directory    (usually
  /usr/lib/X11/app-defaults  and  (if you want  to have  the online help  in a
  window too) Xpalette.help in /usr/lib/X11)

- If  Xpalette  has problems  finding  its helpfile  set the Xpalette.helpFile
  resource in Xpalette.ad or #define HELPFILE in config.h

- The  Xpalette-color  app-default is choosen when the *Customization resource
  is set to -color.  It contains (UGLY!!)  color definitions and then includes
  the definitions from Xpalette.
  Usually  *Customization  is set in /usr/lib/X11/xinit/.Xresources, s.t. that
  all applications of all users know if this server supports color or not.

- The resource definitions from Xpalette-color.ad and Xpalette.ad are compiled
  into  the executable  and are used  when no  app-default  can be loaded. The
  definitions  in  Xpalette-color.ad are used  only when -color  is given as a
  parameter to xpalette.  So there is no  need to use/install  the application
  default files  or use an own .Xdefaults at all  (maybe helpful if you aren't
  root!) 

- The  icon/cursor  definitions in biglens & biglensMask, lens & lensMask, and
  xpalicon  are only needed at compile time,  s.t. there is no need to install
  them anywhere.  Of course if you want to use/set them via the resource files
  of  Xpalette  (or any  other Xapplication)  you will have to  copy them into
  /usr/include/X11/bitmaps.  Also note the BUGS section in xpalette's man-page
  or Xpalette.help.

- rgb.txt is a silly example rgb.txt file that can of course be displayed with
  Xpalette.
