1                              Compiling CircleMUD
 2                     under OS/2 Warp Connect v3.0 or 2.1
 3                               by David Carver
 4  
 5  
 6  To compile CircleMUD under OS/2, you must have the following:
 7  All needed files can be found at the hobbes.nmsu.edu FTP site.
 8  
 9  
10  * OS/2 Warp Connect Version 3.0, or OS/2 Version 2.1 with TCP/IP installed.
11    You should have at least 8 megs of memory.  (Circle runs quite well on an
12    8 meg machine).
13  
14  * An HPFS formatted drive.  CircleMUD needs to be uncompressed on an HPFS
15    drive because it uses long filenames.
16  
17  * The EMX09b runtime and compilation systems.  These are free and
18    can be downloaded by anonymous FTP at hobbes.nmsu.edu in os2/unix/emx09b
19  
20  * The OS/2 port of GNU's GCC compiler.  This can also be found at
21    hobbes.nmsu.edu in os2/unix/emx09b.  Please make sure you have the most
22    recent version of the GCC compiler for OS/2, as files needed by CircleMUD
23    were not included in earlier versions of GCC for OS/2.  The current version
24    is 2.7.0
25  
26  * GNU's TAR and GZIP programs to decompress the necessary files.  Again 
27    these can be found at hobbes.nmsu.edu in os2/unix.
28    **** You only need this if you plan on getting some of the various
29    **** addons for Circle that others have coded.
30  
31  * A MAKE program.  Either the GNU Make, or IBM's NMAKE should work.  You 
32    can obtain the NMAKE from either IBM's Developers kit or from
33    hobbes.nmsu.edu in os2/16dev.
34  
35  
36  Installation:
37  
38  ***  IMPORTANT
39  ***
40  ***  You must have EMX and GCC installed and the directories in your
41  ***  PATH and LIBPATH statements in your CONFIG.SYS.  Please read the
42  ***  EMX installation instructions included with that package for more
43  ***  information on how to install both EMX and GCC.
44  
45  Download the ZIP archive of Circle and use your favorite UNZip utility
46  to extract it.
47  
48  After you have uncompressed the files, switch to the directory that has
49  the CircleMUD files in it, and then to the SRC subdirectory.  Rename
50  the following files:
51  
52  Rename 'conf.h.os2' to 'conf.h'.
53  Delete the old 'makefile', and rename 'makefile.os2' to 'makefile'.
54  
55  To compile the MUD type the following at an OS/2 command line:
56  
57  NMAKE /i
58  
59  CircleMUD will be compiled and the executable will be put in your current
60  directory.  Copy the CIRCLE.EXE file to the circle30\bin directory.  Then
61  follow the CircleMUD instructions in README on how to start up the MUD.
62  
63  NOTE: General questions about CircleMUD can be addressed to the author,
64  Jeremy Elson, at jelson@circlemud.org.  However, all questions which
65  specifically deal with the OS/2 port of Circle should go to my address,
66  listed below.
67  
68  David Carver
69  dcarver@cougar.colstate.cc.oh.us
70  dcarver@iwaynet.net