File: 01-INSTALL

package info (click to toggle)
xcolorsel 1.1a-22
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 720 kB
  • sloc: ansic: 5,732; makefile: 78; sh: 9
file content (88 lines) | stat: -rw-r--r-- 4,768 bytes parent folder | download | duplicates (11)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
This file is part of  Xcolorsel, 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 ;-))
Further patches  were done  under X11R6.  Thus it should work  under X11R5 and
X11R6 with out problems.

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-3.1.
However it should easily  run on any X11R5/R6  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 xcolorsel directory.
    Actually you should do a "make depend" to add all dependencies afterwards.

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 Xcolorsel-color.ad as
    suggested  by  the  comments  in it.  The  changes  are  only  for  better
    appearance of xcolorsel. There is no real need to change this file.

4 - Compile  everything  with  a simple "make".  (If you are  using linux with
    Xfree86-3.1 (or higher)  and libc4.5.26 (or higher) you can omit this step
    as there is already a Xcolorsel binary supplied (compiled with gcc-2.5.8).
    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.

    Note: some  distributions that are not  primarily intended for linux users
    do not include a precompiled binary.

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.

Warning! If you use a Sun,  set a CC to gcc before  trying to compile anything.
Either putting  this into the Imakefile  or a make CC=gcc should be sufficient.

Exceptions / Comments:

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

- If  make install  fails,  you don't  trust me,  or have  to use  the generic
  makefile,  put xcolorsel in  any directory in your executable search path  (I
  prefer /usr/bin/X11), xcolorsel.man  as xcolorsel.1 in /usr/man/man1 (or maybe
  as xcolorsel.l in /usr/man/manl). Place Xcolorsel-color.ad and Xcolorsel.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) Xcolorsel.help in /usr/lib/X11)

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

- The  Xcolorsel-color  app-default is choosen when the *Customization resource
  is set to -color.  It contains (UGLY!!)  color definitions and then includes
  the definitions from Xcolorsel.
  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 Xcolorsel-color.ad and Xcolorsel.ad are compiled
  into  the  executable  and  are used  when no  app-default  can be loaded. The
  definitions from  Xcolorsel-color.ad are used  only when -color  is given as a
  parameter to xcolorsel.  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
  xcslicon  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  Xcolorsel  (or any  other Xapplication)  you will have to  copy them into
  /usr/include/X11/bitmaps.  Also note the BUGS section in xcolorsel's man-page
  or Xcolorsel.help.

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