tbamud/doc/README.CYGWIN

Updated: Apr 2007
                            Compiling tbaMUD
                  under Microsoft Windows using CygWin

tbaMUD compiles under Cygwin without needing any special modifications.
This free pseudo-Unix environment for Windows includes the "bash" shell, "gcc"
family of compilers, and a full set of programs and libraries for Windows users
to compile and run programs from source code intended for Unix. It can be
downloaded from: http://cygwin.com/

Compiling tbaMUD under Cygwin is basically the same as it would be under
another form of Unix:

1) Download from: http://cygwin.com/setup.exe
   Select open.
   Install from Internet
   Select "just me" "dos"
   Choose a mirror site.
   Leave selected package as default. 
   Select the following from devel: autoconf, gcc, make, and patchutils
   Click Next.
   Install, follow prompts.

2) Download and uncompress the latest version of tbaMUD:
   http://cwg.lazuras.org/modules.php?name=Downloads&d_op=viewdownload&cid=16
   Join the forums as they will be a great resource for any problems that you
   encounter. Once you download and uncompress tbaMUD (I use winRAR) read 
   through the /doc directory.

3) Start the Cygwin "bash" shell by double clicking the Cygwin Icon. This will 
   open a telnet looking window that mimics a *nix server where you can run the
   MUD. Go to the directory where you extracted tbaMUD by using the "cd" change
   directory command and "dir" directory listing to find the correct files. For
   example "C:\tbaMUD". "cd c:/tbaMUD" "dir" in the listed files you should see 
   one called configure. DO NOT go into the SRC directory yet.

OPTIONAL: Make the following change to src/Makefile.in to make copyover work:

	--- Makefile.in.old 2007-02-26 05:52:19.000000000 +0100
	+++ Makefile.in     2007-03-26 17:21:56.000000000 +0200
	@@ -61,6 +61,8 @@ circle:
	        $(MAKE) $(BINDIR)/circle

	 $(BINDIR)/circle : $(OBJFILES)
	+       @-rm $(BINDIR)/circleold.exe
	+       @-mv $(BINDIR)/circle.exe $(BINDIR)/circleold.exe
	        $(CC) -o $(BINDIR)/circle $(PROFILE) $(OBJFILES) $(LIBS)

	 clean:

   The above is a "patch" file. All you need to do is add the two lines with
   the +'s to your file Makefile.in. If you are still confused check out these
   links on how to patch: http://www.circlemud.org/cdp/wtfaq/handpatch.html
   http://cwg.lazuras.org/modules.php?name=Forums&file=viewtopic&t=757

4) Run the configure script by typing "./configure".  This will automatically 
   detect what programs and library functions are available, and create the 
   files "Makefile" and "conf.h" based on the results.

   If you get complaints from bash that it will not run the configure script
   either because it cannot find it or because it claims the file is not
   an executable, you can also try "sh configure", "sh ./configure",
   "bash configure" and "bash ./configure" until one of them works.

5) NOW change to the /tbaMUD/src directory "cd src", and type "make", and watch
   tbaMUD and the additional utilities included in the tbaMUD distribution
   automatically being compiled and placed in /tbaMUD/bin.

6) Go back to /tbaMUD, and run the MUD either directly by typing
   "bin/tbaMUD", or by using the "./autorun &" script.

7) Start a telnet program.  Open a connection to your own machine "localhost"
   on port 4000.  You should see the MUD's login screen welcoming you. The
   first person to login will be promoted to IMP.

If you have problems, read this document again.  Most of the questions received
in email or which are posted to USENET newsgroups are answered in this file, or 
in other documents included in the tbaMUD distribution.  If you are still 
having problems and you're *sure* that your question is not answered in this 
document or in one of the others files in the /tbaMUD/doc directory, try 
reading the forums at http://cwg.lazuras.org/ or stop by TBA for assistance.

It really can not be stressed enough: READ EVERYTHING.

Authors: Jeremy Elson, David Goldstein, Tony Robbins, and George Greer.

Rumble
The Builder Academy
builderacademy.net 9091