README.md

   1 # Riscose -- a RISC OS emulator
   2
   3 Some of us ex-Acorn users miss Zap, but here's your chance to do something
   4 about it!  I've cobbled together this emulation which runs some simple RISC
   5 OS binaries (mostly those written in C which rely on SharedCLib, but try
   6 your luck...).
   7
   8 To test it, you'll obviously need a RISC OS binary; I'd suggest grep because
   9 I know it works, at least partially :-)  I've put a page up with some of the
  10 binaries I've used for testing at:
  11
  12        http://riscose.sourceforge.net/testbinaries.html
  13
  14 So just dump it into the src/ folder for now and type:
  15
  16     ./configure && make
  17     (cd src && ./riscose grep free) <README
  18
  19 or something like that, i.e. the arguments to the riscose program are
  20 the name of the binary (currently only `Absolute' executables are
  21 supported), followed by the arguments you want passed to the RISC OS
  22 binary, e.g.
  23
  24     cd src && ./riscose grep -n free ../README
  25
  26 If you're inspired by that, and know a bit about RISC OS check out the ToDo
  27 file and get hacking.
  28
  29 If you've acquired riscose from git then you need to have maintainer
  30 tools available.
  31
  32     aclocal && autoheader && automake --add-missing && autoconf
  33
  34 --
  35 Matthew (and Dave)