home *** CD-ROM | disk | FTP | other *** search
/ ftp.freefriends.org / ftp.freefriends.org.tar / ftp.freefriends.org / arnold / Source / gwm-dist.tar.gz / gwm-dist.tar / README.build-gwm < prev    next >
Text File  |  1993-07-08  |  3KB  |  64 lines
  1. Building gwm.
  2.  
  3.  
  4. Follow Colas's instructions, but there are two traps to watch out for
  5. besides what he mentions in there.
  6.  
  7. Firstly, with many X clients where there is a choice between an Imakefile
  8. and a Makefile, I find it is usually best to just type "xmkmf" and "make".
  9. (Especially if, as so often, the supplied Makefile is what imake generated
  10. on the author's machine.)  Watch out with gwm; this is not the case.
  11. The Imakefile always gets things wrong; I have never managed to use
  12. it successfully.  The Makefile is a real, hand-written, customisable
  13. Makefile.  Modify it as needed for your system and compile without
  14. fear; you won't regret it.
  15.  
  16. Secondly, when you _are_ modifying the Makefile, you need to do something
  17. special if you have a MIPS compiler (say, actual MIPS RISC/os, or cc on
  18. Ultrix RISC DECstations): you need to make sure that all the compiles
  19. and the link are done with a "-G 0" flag.  Don't ask me why; all I know
  20. is, if you do that it works, and if you don't do that it won't link, and
  21. gives obscure messages that might mean something if you understood the
  22. MIPS architecture in intimate detail.  If you are using other compilers
  23. and a MIPS CPU, good luck (I've never tried that).
  24.  
  25. Easy build instructions, taking the above into account (Colas's README
  26. is fairly involved):
  27.  
  28. [Note: These instructions are for rc/es.  Users of other shells should
  29. change to rc. 1/2 :) ]
  30.  
  31. here = `pwd
  32. mach = <short name for this gwm build; say, "dec" or "sparc" or such>
  33.  
  34. cd /gwm/source/directory
  35. zcat $here ^ /gwm-1.7i.tar.Z | tar xvpf -
  36.  
  37. cd gwm
  38. patch <$here/PATCH
  39. make 'DIR=' ^ $mach dir
  40. cd ../ ^ $mach
  41. sam Make. ^ $mach &
  42.  
  43. [Edit the make template as required: set XDIR, XLIBDIR if needed.  Add
  44. "-G 0" to FLAGS and LFLAGS if needed, see above.  Set C_COMPILER if you
  45. will.  Set -DX11R4; don't worry, that means "R4 or later", not "R4 precisely".
  46. (If you are pre-R4, good luck, though you don't deserve it.)  You can
  47. probably leave DEFINES set the way it comes out of the box; in particular,
  48. Colas's comments about "decstations" either relate to versions of
  49. Ultrix prior to 4.1 or are incorrect or refer to VAX DECstations --
  50. what he suggests is not needed on RISC Ultrix 4.1 or above.
  51. Set INSTALL_GWM, like to /usr/local/bin, and INSTALL_DIR, like
  52. to /usr/local/lib/gwm.  Best leave INSTALL_PATH as is.]
  53.  
  54. make
  55. make install
  56. cd ../gwm
  57.  
  58. [Install gwm.man by hand as appropriate for your local manual entries.
  59. If you want to build the (rather large) reference manual, "cd doc"
  60. and go for it; you need latex.]
  61.  
  62. John Mackin <john@civil.su.oz.au>, or <john@physiol.su.oz.au>
  63. 8 July 1993
  64.