"Fossies" - the Fresh Open Source Software Archive 
Member "xearth-1.1/INSTALL" (7 Nov 1999, 7059 Bytes) of package /linux/misc/old/xearth-1.1.tar.gz:
As a special service "Fossies" has tried to format the requested text file into HTML format (style:
standard) with prefixed line numbers.
Alternatively you can here
view or
download the uninterpreted source code file.
1 Installation notes for xearth, version 1.1
2 Kirk Lauritz Johnson <tuna@indra.com>
3 6 November 1999
4
5
6 NOTE: If you are trying to build xearth under SunOS 4.x using
7 /bin/cc, make sure to read the section entitled "BUILDING
8 UNDER SUNOS 4.x" (below) regarding a compiler bug.
9
10
11 BUILDING USING IMAKE
12
13 To build xearth using imake:
14
15 (1) Edit "Imakefile" to add any DEFINES necessary for building on
16 your platform (see the section entitled "DEFINES" below).
17
18 (2) Run "xmkmf" to build a makefile.
19
20 (3) Run "make all" to build an executable.
21
22 If "make" complains cryptically about lines in the makefile
23 that start with "XCOMM" (you'll probably have to eyeball the
24 offending lines in the makefile to determine this), something
25 went wrong with "xmkmf" (or "imake"). You should be able to
26 fix this using something along the lines of
27
28 egrep -v ^XCOMM < Makefile > junk ; mv junk Makefile
29
30 (to strip out all lines that start with XCOMM) and then
31 running "make" again.
32
33 If the linker complains about "random", "srandom", and/or
34 "setpriority" being undefined, you probably need to add
35 "-DNO_RANDOM" and/or "-DNO_SETPRIORITY" to the right hand side
36 of the "DEFINES =" line in the Imakefile and start over. (See
37 the section entitled "DEFINES" below.)
38
39 (4) Run "make install" and "make install.man" to install the
40 executable and man page in whatever places are appropriate for
41 your system.
42
43
44 BUILDING USING MAKE
45
46 To build xearth using make:
47
48 (1) Copy the distribution makefile "Makefile.DIST" to "Makefile".
49
50 (2) Edit the makefile if necessary; you may need to:
51
52 - add any DEFINES necessary for building on your platform (see
53 the section entitled "DEFINES" below)
54
55 - change the name of the C compiler (CC) from "gcc" to whatever
56 compiler you want to use when building
57
58 - change the compiler flags (CFLAGS) -- if your X include files
59 aren't found in the usual place (/usr/include), you may have
60 to add something along the lines of "-I<path-to-X-includes>"
61 to CFLAGS
62
63 - change the loader flags (LDFLAGS) -- if your X libraries
64 aren't found in the usual places (perhaps /lib and /usr/lib),
65 you may have to add something along the lines of
66 "-L<path-to-X-libraries>" to LDFLAGS
67
68 (3) Run "make all" to build an executable.
69
70 If the linker complains about "random", "srandom", and/or
71 "setpriority" being undefined, you probably need to add
72 "-DNO_RANDOM" and/or "-DNO_SETPRIORITY" to the right hand side
73 of the "DEFINES =" line in the Makefile and start over. (See
74 the section entitled "DEFINES" below.)
75
76 (4) Install the executable ("xearth") and man page ("xearth.man")
77 in whatever the appropriate places are for your environment.
78
79
80 DEFINES
81
82 The xearth source code includes #ifdef-ed workaround/replacement
83 code for systems that don't provide the random(), srandom(),
84 and/or setpriority() library functions.
85
86 For systems that don't provide random() and srandom(), #define the
87 NO_RANDOM symbol (this can be done by adding "-DNO_RANDOM" to the
88 right hand side of the "DEFINES =" line in the Makefile or
89 Imakefile). Doing so causes xearth to use the lrand48() and
90 srand48() functions instead of random() and srandom(). (If your
91 system doesn't have lrand48() and srand48() either, you'll have to
92 go into xearth.h and change the #defines for random() and
93 srandom() to something appropriate for your system.)
94
95 For systems that don't provide setpriority, #define the
96 NO_SETPRIORITY symbol (this can be done by adding
97 "-DNO_SETPRIORITY" to the right and side of the "DEFINES =" line
98 in the Makefile or Imakefile). Doing so causes xearth to use the
99 nice() function instead of setpriority().
100
101 If you try to compile xearth and the linker complains that
102 random(), srandom(), and/or setpriority() is undefined, try
103 defining NO_RANDOM and/or NO_SETPRIORITY, as appropriate, and
104 recompiling.
105
106
107 BUILDING UNDER SUNOS 4.x
108
109 I believe something in dither.c exercises an optimizer bug in
110 SunOS 4.1.3 /bin/cc. When I compile using -O or -O2, the dither
111 code either causes a segmentation violation or (worse) runs
112 without crashing but produces incorrect output. This code works
113 fine under all the other compilers I can get my hands on,
114 however. So, if possible, don't use SunOS 4.1.3 /bin/cc to compile
115 xearth, or, if you have no other compilers, don't use optimization
116 when compiling dither.c.
117
118
119 MANIFEST
120
121 README miscellaneous info
122 INSTALL this file
123 HISTORY release history
124 BUILT-IN built-in marker data
125 Imakefile for use with "imake"
126 Makefile.DIST for use with "make"
127 xearth.man man page
128
129 GAMMA-TEST describes gamma-test.gif
130 gamma-test.gif gamma measurement image
131
132 dither.c source code
133 extarr.[ch]
134 gif.c
135 gifint.h
136 giflib.h
137 gifout.c
138 kljcpyrt.h
139 mapdata.c
140 markers.c
141 ppm.c
142 render.c
143 resources.c
144 scan.c
145 sunpos.c
146 x11.c
147 xearth.[ch]
148
149 ----------------------------------------------------------------
150
151 Copyright (C) 1989, 1990, 1993-1995, 1999 Kirk Lauritz Johnson
152
153 Parts of the source code (as marked) are:
154 Copyright (C) 1989, 1990, 1991 by Jim Frost
155 Copyright (C) 1992 by Jamie Zawinski <jwz@lucid.com>
156
157 Permission to use, copy, modify and freely distribute xearth for
158 non-commercial and not-for-profit purposes is hereby granted without
159 fee, provided that both the above copyright notice and this permission
160 notice appear in all copies and in supporting documentation.
161
162 Unisys Corporation holds worldwide patent rights on the Lempel Zev
163 Welch (LZW) compression technique employed in the CompuServe GIF image
164 file format as well as in other formats. Unisys has made it clear,
165 however, that it does not require licensing or fees to be paid for
166 freely distributed, non-commercial applications (such as xearth) that
167 employ LZW/GIF technology. Those wishing further information about
168 licensing the LZW patent should contact Unisys directly at
169 (lzw_info@unisys.com) or by writing to
170
171 Unisys Corporation
172 Welch Licensing Department
173 M/S-C1SW19
174 P.O. Box 500
175 Blue Bell, PA 19424
176
177 The author makes no representations about the suitability of this
178 software for any purpose. It is provided "as is" without express or
179 implied warranty.
180
181 THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
182 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
183 EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR
184 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
185 USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
186 OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
187 PERFORMANCE OF THIS SOFTWARE.