1                       Compiling CircleMUD under RiscOS
 2                 by Gareth Duncan (garethduncan@argonet.co.uk)
 3                               
 4  You will need:
 5  The CircleMUD source code.
 6  !GCC, !UnixLib, drlink and make avaliable from Hensa.
 7  Acorns sockets library avaliable form the Acorn ftp site.
 8  A copy of !FreeNet and !FreeTerm.
 9                               
10  1) Firstly obtain a copy of !GCC, !UnixLib, drlink, make and Acorns 
11     sockets libary.
12  
13  2) Place the directory Sockets from the sockets library inside 
14     !UnixLib37.src.clib  
15     
16  3) Unpack the CircleMUD binary and start setting up the directory
17     structures in the src directory.
18     
19  4)                               src
20                                    |
21                       ----------------------------------
22                       |      |     |      |      |     |
23                     util    act    c      h      o    conf
24                              |
25                       --------------- 
26                       |      |      |
27                       c      h      o
28   
29  5) Place all the files in the correct directories according to their
30     name remembering to remove the directory information from the 
31     filename.
32     e.g. ban/c goes in the directory c and is renamed to ban.
33          act/item/c goes in the directory act then c and is renamed to 
34          item.
35     
36  6) Set the type of any data files in the src directories to text.
37  
38  7) Copy the acorn configure file (should be conf/h/arc) into the h
39     directory and rename it conf.
40     
41  8) Create an obey file called !Compile in the src containing the 
42     following lines
43     
44     -- begin (don't linclude this line)   
45     WimpSlot -min 10000K -max 10000K
46     dir <Obey$Dir>
47  
48     make -r
49     -- end (don't linclude this line)   
50     
51     and set the wimpslot to as much memory as you can afford.
52  
53  9) Place the make program in the src directory and rename the file
54     Makefile/arc to Makefile removing the old file already called 
55     Makefile.
56  
57  10) Unpack GCC and Unixlib placing them where you want and then 
58      double click on them. Then run the !Compile file. Everything 
59      should run okay. Make sure that drlink is placed inside GCC in the
60      bin directory. If you get any error messages check that the code 
61      changes at the bottom of this file are present. If not alter the
62      code as instructed.
63      
64  11) Place the module CallASWI from !UnixLib37.src.CallASWI in the bin
65      directory.
66      
67  12) Now get a copy of the FreeNet internet stack or a recent version
68      of Acorns stack and FreeTerm. Make sure the FreeUser start up 
69      script has the line 
70      
71      ifconfig lo0 inet 127.0.0.1 up
72      
73      Then run the startup script, run FreeTerm and then open a task 
74      window. Run the !Run file (which should be placed in the directory
75      above src) from the task window by typing in its file name and 
76      then press return, the Mud should load (you should be able to just
77      shift drag the !Run file onto the window if you are using !Zap).
78      
79  13) To log onto the mud type localhost and set the port to 4000 in 
80      FreeTerm and then press connect
81      
82  Please excuse the poor spelling and grammar in this and if you have
83  any trouble contact garethduncan@argonet.co.uk.
84  
85  Bye.
86  
87  -Gareth
88