This file needs to be updated as time permits. And perhaps areas
 from problems common to specific machines.


--------------------------------------------------------------------------
Problem:

You are using gcc and Solaris 2.6 and get the following
error when compile stuff(xanim included):

        /usr/include/sys/model.h:32: #error "No DATAMODEL_NATIVE specified"

Solution:

You need to use a gcc that has been compiled/installed specifically
for Solaris 2.6.

--------------------------------------------------------------------------
Problem:

You are using Imake and XFree and the compiler can't find
the X11 include files and you have installed the X11 include
files.

Solution:

The Imake setup with XFree has recently been broken. The fix
is to edit the file:

/usr/X11R6/lib/X11/config/X11.tmpl

and change the following line from:

INCDIR = $(INCROOT)/* header files */

to be:

INCDIR = $(INCROOT)/X11/* header files */

and then redo "xmkmf" and "make xanim"

XFree needs to fix this in their next release.

-------------
Problem

The compiler reports:

   In file included from xa_audio.c:224:
   xa_audio.h:42: stropts.h: No such file or directory
   xa_audio.h:46: sun/audioio.h: No such file or directory

Solution
By default, the XAnim makefiles are configured for SunOS audio.

If you are using another platform(like linux, Solaris, HP, SGI, etc)
then you need to edit the Makefile and select the XA_AUDIO* defines
for your particular machine.

-------------
Problem

When adding the XAnim decompression modules the 
Compiler(linker actually) reports something similiar to:

  ld: elf error: file xa2.0_iv32_sparcELF.o: unknown type, unable 
  to process using elf(3E) libraries


Probable Reasons

The decompress modules are probably still compressed. Verify
their size with size listed in the readme files. If necessary,
rename  "mv lib lib.Z" and then "uncompress lib.Z".

-------------
Problem:

     Compiler reports following symbols as undefined
     >   ld: Undefined symbol
     >      _XtStrings
     >      _XtShellStrings

Possible Reason:  

   Your LD_LIBRARY_PATH doesn't match the XLIBDIR that is in the Makefile. 
   This is because you're using the /usr/openwin/X11/includes, and some
   unrelated X11 library release(usually /usr/lib/X11).

-------------
Problem

SGI Compiler core dumps. (A long standing feature of theirs :)

Solution:

Uncomment out the following define in the Makefile:

XA_SGI1 = -old_ld -32

-------------
Problem
Compiler can't find  -lX11, -lXext, etc


Probable Reason:

This are the X11 libraries, libX11.*, libXext.*  and most likely
the XLIBDIR defines wasn't set correctly in the Makefile.

Verify that XLIBDIR is set to the directory in which those files
are located.

-------------
Problem:

     Compiler reports following symbols as undefined
     > .XShmDetach
     > .XShmPutImage
     > .XShmAttach
     > .XShmCreateImage
     > .XShmQueryExtension
     > compile FAILED.

Probable Reason: 

   Your machine doesn't support X11 Shared Memory Extension.
     
   These are all X11 Shared memory extensions and NOT all machines
   supports them.  So, you'll want to edit Imakefile or Makefile and
   comment out the following line:

   XA_SHARED = -DXSHM

   If you're using Imakfile you need to "xmkmf" and "make xanim"
   or if you're using Makefile.unx, just "make xanim".

-------------
Problem:  

    Compiler reports the following on HP machines:

     anyfilename: too much defining - use -H option
     anyfilename: no space

    The solution is uncomment out the following line in the Makefile

     XA_HPUX_DEFS = -Wp,-H200000

    and then recompile

---------------------------------------------------------------------------