A short guide on how to build and install XPaint
================================================

First, *read* the comments in README.

Obviously, you need an ANSI C compiler - only gcc is supported - and you need
the following libraries to be installed, together with their associated
development packages :
  X11  libraries (libX11, libXext, libXt, libXmu, libSM, libICE, libXp)
  libXpm
  libz
  libpng
  libtiff
  libjpeg
  libXaw  or  libXaw3d   or  libXaw95

Most Unix/Linux distributions should already provide all this (except perhaps
libXaw95 which is only an alternative option).

Building xpaint
---------------

Check that all paths etc. in 'Local.config' are correct.
Be sure to add any flags needed for your machine.

Then do	'./configure' and 'make'.

In case you would like to change the Athena widget set wich is
automatically selected by 'configure', choose one of the following
options:

1)	'make xaw'              (plain old/ugly Xaw widgets)
2)	'make xaw3d'            (Xaw3d widgets)
3)	'make xaw3dg'           (Xaw3d enhanced widgets from Debian)
4)	'make xaw95'            (Xaw95 widgets)

If you just happen type 'make', the compilation will default to the 
Xaw widgets, this is maybe not what you would like best.

Installing xpaint
-----------------

As usual, type
	'make install'

and to install the man page
	'make install.man'

Use of Xaw95 widgets
--------------------

In case you would like to try the Xaw95 widgets instead of Xaw3d, just
download the tarball xaw95-1.1.4.tar.bz2 from Sourceforge, expand it
and then type

	'cd xaw95-1.1.4'
	'make install'
	'ldconfig'
	
A 'make xaw95' in xpaint's tree should then build it with the Xaw95 widgets.	

=============================================================================


			Having Trouble Building XPaint?
			     Here Is Some Help



===  General Problems

Undefined symbol strerror:
	
	Edit Local.config and define MISSING_STRERROR

Undefined symbol strcasecmp:
	
	Edit Local.config and define MISSING_STRCASECMP

===  SCO Unix:

From: Tom Kelly <tom@sco.com>

Since SCO does not ship the Athena widgets with the system, they have
to be obtained.  They are available for free from sosco.sco.com  and
various mirrors (including ftp.uu.net) in the TLS directory.  Both the
R4 and R5 widgets are available.

From: William Bader <william@nscs.fast.net>

Imake does not resolve the LibraryTargetName() macro. Fix: replace
"LibraryTargetName(rw)" with "librw.a".

====  Sun machine:

Undefined symbol:
	_get_wmShellWidgetClass
	_get_applicationShellWidgetClass

	>From: Harald Tveit Alvestrand <harald.t.alvestrand@delab.sintef.no>
	>
	>It turns out that the problem occurs with X11R4 on SunOS 4.1.2 and
	>later. SUN "fixed a bug" in the linker that made it conform to the
	>documentation (AARRGGHH), which, as a side effect, wrecked linking
	>to X11R4.
	>
	> There are only 2 solutions that I know of:
	> - Upgrade to X11R5 libraries, which don't have the problem
	> - Add the following line to the Imakefile:
	>     LDOPTIONS = $(CDEBUGFLAGS) $(CCOPTIONS) -Bstatic

================

jspath@mail.bcpl.lib.md.us (Webmaster Jim) suggested this:

I don't have the "Fixed 12" font in my XFree86 system, so I've patched
the earlier version to include a font that I like, Sony 16 (and Sony 24).
I don't recommend this for everyone, but including the following in the
distribution can help others get different startup fonts:

--- operation.c.df  Fri Apr 19 04:53:30 1996
+++ operation.c Sun Jun 16 12:10:16 1996
@@ -830,12 +830,14 @@
        fontSet, "-*-helvetica-medium-r-normal-*-*-120-*-*-p-*-*-*"),
     MI_FLAGCB("Helvetica Bold 12", MF_CHECK | MF_GROUP1,
          fontSet, "-*-helvetica-bold-r-normal-*-*-120-*-*-p-*-*-*"),
-    MI_FLAGCB("Fixed 12", MF_CHECK | MF_GROUP1,
-         fontSet, "-*-fixed-medium-r-normal-*-*-120-*-*-m-*-*-*"),
+    MI_FLAGCB("Sony 16", MF_CHECK|MF_GROUP1,
+        fontSet, "-*-fixed-medium-r-normal--16-120-100-100-c-80-iso8859-1"),
+    MI_FLAGCB("Sony 24", MF_CHECK|MF_GROUP1,
+        fontSet, "-*-fixed-medium-r-normal--24-170-100-100-c-120-iso8859-1"),
     MI_FLAGCB("Courier 12", MF_CHECK | MF_GROUP1,
          fontSet, "-*-courier-medium-r-normal-*-*-120-*-*-m-*-*-*"),
     MI_SEPERATOR(),
-#define FM_SELECT  11
+#define FM_SELECT 12
     MI_FLAGCB("select", MF_CHECK | MF_GROUP1, fontSet, NULL),
 };
