home *** CD-ROM | disk | FTP | other *** search
/ Dream 44 / Amiga_Dream_44.iso / Linux / Apps / xanim.tgz / xanim / xanim27064 / Compile_Help.doc < prev    next >
Text File  |  1997-01-26  |  6KB  |  144 lines
  1.  
  2. --------------------------------------------------------------------------
  3.  
  4.          Compiling the Audio Revisions of XAnim(2.70.* and up)
  5.  
  6. In the following help section,  the "27064" part is variable and
  7. depends on the revision(in this case Rev 2.70.6.4). 
  8. Another example: Rev 2.88.3 would be "2883".
  9.  
  10. --------------------------------------------------------------------------
  11. Section I    Obtaining XAnim
  12. --------------------------------------------------------------------------
  13.  
  14. Obtaining the XAnim archive through ftp:
  15.     1) ftp xanim.va.pubnix.com     OR  ftp 199.170.0.28
  16.     2) Enter "anonymous" as user(don't include quotes)
  17.     3) Enter your full email address as the password.
  18.     4) "type binary"
  19.         6a) "get xanim27064.tar.Z"     For the unix compressed version
  20.                 OR
  21.         6b) "get xanim27064.tar.gz"    For the gnu zipped version
  22.     7) bye
  23.  
  24. Obtaining XAnim through mosaic or a browser:
  25.   If you obtained the xanim archive through mosaic or another www browser,
  26.   then you need to be aware of whether or not it was automatically
  27.   uncompressed as it was transferred. Different browsers do different things.
  28.  
  29.     A) If your browser uncompressed XAnim then save the file
  30.        as "xanim27064.tar" and skip the uncompress steps in
  31.        sections I) or II).
  32.     B) If your browers didn't uncompress XAnim then save the file
  33.        as "xanim27064.tar.Z".
  34.         C) If you're not sure then: 
  35.          1) save the file as "xanim27064"
  36.              2) "ls -l xanim27064"
  37.                  a) if the size is < 600K, then it's compressed and you
  38.             should "mv xanim27064 xanim27064.tar.Z".
  39.              b) else it's not compressed and you should
  40.             "mv xanim27064 xanim27064.tar". NOTE: skip the
  41.             uncompress steps below.
  42.          c) You can also compare the size to the sizes listed 
  43.                     on the XAnim WWW page in order to determine what
  44.                     you browser did.
  45.             
  46.  
  47. --------------------------------------------------------------------------
  48. Section II    Unarchiving
  49. --------------------------------------------------------------------------
  50.  
  51.     1a) uncompress xanim27064.tar.Z    For the unix compressed version
  52.                OR
  53.     1b) gunzip xanim27064.tar.gz       For the gnu zipped version
  54.     2) tar xvof xanim27064.tar
  55.     3) cd xanim27064
  56.  
  57. --------------------------------------------------------------------------
  58. Section III   Compiling
  59. --------------------------------------------------------------------------
  60.  
  61. Now that you've got it, what do you do?  
  62.  
  63. Part A) 
  64.    If you are using OpenWindows(with SunOS 4.1.3) goto Part B. 
  65.    OpenWindows with SunOS 5.x should be okay here, but not positive.
  66.    If you know that Imake is NOT setup on your system, goto Part B.
  67.    If you're not sure about Imake, try it anyways and on any failure
  68.    goto Part B and skip any initial steps you've already done.
  69.    
  70.     1) Read the "cinepak.readme" and "indeo.readme" files.
  71.     2) Read and edit the Imakefile. Visit each section and
  72.           a) Modify section III based on info in the "cinepak.readme",
  73.              "indeo.readme" and "creative.readme"  files.
  74.           b) indicate which XA_AUDIO_DEFS/LIBS/etc is correct for you
  75.          machine and OS.
  76.           c) follow any other directions for your machine, OS or Windowing.
  77.              environment.
  78.     3) xmkmf
  79.     4) make xanim
  80.     5) NOTE: you should use "make xaclean" instead of "make clean" if you
  81.        wanted to preserve the cinepak/indeo decompression modules.
  82.        I haven't found a way to override Imake's clean yet.
  83.  
  84.     If steps 2) or 3) failed, then your system most likely isn't setup up
  85.     properly for Imake(xmkmf). Either talk to your System Administrator 
  86.     or goto Part B.
  87.  
  88.  
  89. Part B)
  90.     IF  Part A ABOVE FAILED, OR Imake ISN'T PROPERLY SETUP OR YOU'RE USING
  91.     Sun OpenWindows INSTEAD OF X11
  92.  
  93.     1) Read the "cinepak.readme" and "indeo.readme" files.
  94.     2) cp Makefile.unx Makefile
  95.     3) Edit the Makefile and: 
  96.           a) Modify section III based on info in the "cinepak.readme",
  97.              "indeo.readme" and "creative.readme"  files.
  98.           b) indicate which XA_AUDIO_DEFS/LIBS/etc is correct for you
  99.          machine and OS.
  100.       c) Indicate where the X11 includes are on your machine(INCLUDE)
  101.       d) Indicate where the X11 libs are on your machine(LIBS)
  102.           e) Look for machine or OS specific notes, etc.
  103.     3) On Suns you need to have your LD_LIBRARY_PATH match the XLIBDIR
  104.        define inside the Makefile. If it doesn't, you might end up mismatching
  105.        different revs of X11 includes and libraries, causing all sorts of
  106.        failures(usually undefined symbols). NOTE: This also has to match
  107.        when you try executing XAnim, or it may not be able to find the 
  108.        proper libraries.
  109.  
  110.     To find out what you LD_LIBRARY_PATH is set to: 
  111.  
  112.             "env | grep LD"
  113.  
  114.     The following examples are for OpenWindows(XLIBDIR = /usr/openwin/lib) 
  115.     To set it up properly for OpenWindows in the (C shell):
  116.  
  117.             "setenv LD_LIBRARY_PATH /usr/lib:/usr/openwin/lib"
  118.  
  119.     To set it up properly for OpenWindows in the (Korn, Bourne and 
  120.     POSIX shells):
  121.  
  122.             "LD_LIBRARY_PATH=/usr/lib:/usr/openwin/lib"
  123.             "export LD_LIBRARY_PATH"
  124.  
  125.     NOTE: No spaces around "=" sign.
  126.  
  127.     7) make xanim
  128.  
  129.     If your not sure where your X11 libs or includes are, your SysAdm should
  130.     know or I can help as well. Also the Makefile.unx file has example places
  131.     on where to look.
  132.  
  133.  
  134. Please see the file "Compile_Errs.doc" for a list of common compilation
  135. problems and their solutions.
  136.  
  137. Please see the file "Problems.doc" for a list of common runtime
  138. problems and their solutions.
  139.  
  140. Thanks,
  141.  
  142. Mark Podlipec
  143. podlipec@ici.net
  144.