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

First, *read* the comments in README.

NOTE: You *must* have X11R5 or newer. X11R4 is obsolete and will *not* work.

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

	xmkmf -a

## if the -a flag is not available, use instead :
##         xmkmf ; make Makefiles ; make depend

	make xaw
	make install
	make install.man

This will compile Xpaint with the default (ugly) Xaw Athena widgets.
To compile with Xaw95 and get widgets looking much better just replace
the "make xaw" step with

	make xaw95static
or
	make xaw95

This will compile and link Xpaint with the static (resp. dynamic)
Xaw95 widgets. In the latter case, you'll need to install the libXaw95
library as well (unless you already installed it earlier):

	cd xaw95-1.1.4
	make install
	ldconfig

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


			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),
 };
