5267b71995-08-09Fredrik Hübinette (Hubbe) This is what you need to do to install uLPC: 1) Run ./configure, this is a sh script that will generate machine.h and Makefile from machine.h.in and Makefile.in, use --prefix=/foo/bar if you want to install ulpc in /foo/bar, default is /usr/local.
2e2dbf1996-06-21Fredrik Hübinette (Hubbe)  You might have to set the environment variables C_INCLUDE_PATH and
f3c90d1996-07-09Fredrik Hübinette (Hubbe)  LD_LIBRARY_PATH to enable the configure script to find gdbm, readline and gmp. If the configure script does not find those libraries those modules will not be available.
2e2dbf1996-06-21Fredrik Hübinette (Hubbe) 
5267b71995-08-09Fredrik Hübinette (Hubbe) 2) edit config.h and Makefile to suit your purposes. I've tried to make it so that you don't have to change config.h or Makefile very much. If you need to do what you consider 'unnessecary changes' then mail me and I'll try to fit it into configure. If possible, use gnu make, gcc, gnu sed and bison. 3) Run make. 4) optionally, run 'make verify' to check that the compiled driver works
2a50101995-11-06Fredrik Hübinette (Hubbe)  as it should (might be a good idea) This will take a little time and use
5267b71995-08-09Fredrik Hübinette (Hubbe)  quite a lot of memory, because the testprogram is quite large. If everything works out fine no extra messages are written. 5) If you want to install ulpc, write 'make install'
8ce9ad1996-05-16Fredrik Hübinette (Hubbe) 6) Optionally do 'make html_docs' to create a directory called docs which will contain the uLPC documentation in html. This directory can then be copied to anywhere you want.
5267b71995-08-09Fredrik Hübinette (Hubbe) What to do when it doesn't work: 1) Try again.
2a50101995-11-06Fredrik Hübinette (Hubbe) 2) Your sh might be too buggy to run ./configure. (This is the case on A/UX) Try using bash, zsh or possibly ksh. To use bash, first run /bin/sh and type: $ CONFIG_SHELL=full_path_for_bash $ export CONFIG_SHELL $ $CONFIG_SHELL ./configure 3) ./configure relies heavily on sed, if you have several sed in your path
5267b71995-08-09Fredrik Hübinette (Hubbe)  try another sed. (preferably gnu sed)
2a50101995-11-06Fredrik Hübinette (Hubbe) 4) configure might have done something wrong, check machine.h and report
5267b71995-08-09Fredrik Hübinette (Hubbe)  any errors back to me.
2a50101995-11-06Fredrik Hübinette (Hubbe) 5) Try a different compiler, malloc, compiler-compiler and/or make.
5267b71995-08-09Fredrik Hübinette (Hubbe)  (if you have any other)
2a50101995-11-06Fredrik Hübinette (Hubbe) 6) On Linux Slackware machines (older than slackware 3.0), uLPC sometimes fails to find -lm, this is because of a bug in /usr/lib/libm.sa (or possibly libg.a) in slackware.
bf4a8d1995-10-20Fredrik Hübinette (Hubbe)  Compile with 'make EXTRALIBS="-lc -lm"' to get around this bug. 7)
5267b71995-08-09Fredrik Hübinette (Hubbe) If you find a bug in the interpreter, the first thing to do is to make sure the interpreter is compiled with DEBUG defined. If not recompile with DEBUG and see if you get another error. When you've done this, please report the
2a50101995-11-06Fredrik Hübinette (Hubbe) bug to hubbe@lysator.liu.se and include as much as you can muster of the following:
5267b71995-08-09Fredrik Hübinette (Hubbe) 
2a50101995-11-06Fredrik Hübinette (Hubbe)  o The version of the driver. (can be found in lib/simulate.lpc)
5267b71995-08-09Fredrik Hübinette (Hubbe)  o What kind of system hardware/software you use (OS, compiler, etc.) o the piece of code that crashes or bugs. (preferably in a very small lpc-script with the bug isolated) Please send a complete running example of something that makes the interpreter bug. o a description of what it is that bugs and when. o if you know how then also give me a backtrace and dump of vital variables at the point of crash. o or, if you found the error and corrected it, just send me the bugfix along with a description of what you did and why.
cb22561995-10-11Fredrik Hübinette (Hubbe)  /Fredrik Hubinette