wmud/doc/README.CYGWIN

         Compiling CircleMUD under Microsoft Windows 95 or Windows NT
                    using CygWin (formerly GNU-Win32)
               by David Goldstein (goldstei@cs.sunysb.edu)

CircleMUD compiles under version b19 or later of Cygnus Solutions'
GNU-Win32 environment without needing any special modifications.  This free
pseudo-Unix environment for Windows 95 and NT 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 Cygnus' own servers or a number of mirror sites
through http://sourceware.cygnus.com/cygwin/download.html.

Compiling Circle under GNU-Win32 is basically the same as it would be under
another form of Unix:

1) Download and install full.exe from Cygnus' ftp server or one of the mirror
   sites, if you haven't already.  It is a good idea to set the environment
   variables for Cygwin in your startup sequence (autoexec.bat, etc.).

   Note that there are show-stopping bugs in b19.0 and b20.0.  If you already
   have one of these installed, be certain to upgrade to b19.1 or b20.1.

2) Again, if you haven't already done so, mount the directory containing the
   bulk of the executable Cygwin programs, C:\Cygnus\B20\H-i586-cygwin\bin
   by default, as /bin, by typing
        mount C:\Cygnus\B20\H-i586-cygwin\bin /bin
   from a DOS prompt (NOT the bash shell).  You can check this by running
   "mount" without any parameters, and checking for an entry for /bin.  Also,
   make certain that the DOS path contains all of the correct backslashes.

3) Download and uncompress the latest version of CircleMUD according to the
   instructions in the main README file.  (The FTP site is ftp.circlemud.org,
   in the pub/CircleMUD directory).  Make sure that if you have downloaded the
   "zipped" version (circle30bplXX.zip, or example), that you use an unzip
   program which can handle long file names to unzip it (like the Win32 version
   of Info-Zip's "unzip").  Otherwise, download ther "tarred, gzipped" version
   (circle30bplXX.tar.gz), and extract the files using the versions of tar and
   gunzip which come with the full Cygwin package.

4) Start the "bash" shell and go to the directory where you have extracted
   CircleMUD (we will assume "C:\circle30bplXX", or "/circle30bplXX" from
   within bash, where 'XX' is the current patchlevel).  DO NOT go into the
   "src" directory yet.

5) Run the shell script "./configure".  This will automatically detect
   whether or not certain programs and library functions are available, and
   create the files "Makefile" and "conf.h" based on the results.

   If you get complains from bash that it will not run the configure script
   either because it cannot find it or because of 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.

6) NOW change to the /circle30bplXX/src directory, and type "make", and watch
   CircleMUD and the additional utilies included in the Circle distribution
   automatically being compiled and placed in /circle30bplXX/bin. (Remember,
   'XX' is the current patchlevel number, e.g., 'circle30bpl20'.)

7) Make sure your TCP/IP stack is installed, correctly configured, and running.
   If you are already using TCP/IP applications from your Windows machine such
   as Netscape or telnet, then no changes should be necessary; otherwise go to
   the Control Panel's "Network" settings, select "Add Protocol", and add
   Microsoft's TCP/IP.  Consult the documentation for Windows 95 if you have
   any additional questions about how to set up TCP/IP under Windows 95.  (Do
   not send mail to me or Jeremy Elson on this topic.  Microsoft has an
   excellent tech support line, and chances are that your ISP has a decent tech
   support line too.)

   YOU MUST INSTALL AND CONFIGURE YOUR TCP/IP STACK, EVEN IF YOU ARE NOT 
   CONNECTED TO THE INTERNET.

8) Go back to /circle30bplXX, and run the MUD either directly by typing
   "bin/circle", or by using the "./autorun" script.

9) Start a telnet program (SEE NOTE BELOW).  Open a connection to your
   own machine ("localhost", or whatever the name of your machine happens
   to be) on port 4000.  You should see the MUD's login screen welcoming
   you and asking for your name.

   VERY IMPORTANT NOTE:  The standard telnet program that comes free with
   Windows 95 and NT does *not* work correctly for connecting to any MUD
   because it does not support telnet's line-mode interface (so you can't
   see what you are typing).  Note that simply turning on the "local echo"
   option does not fix the problem; this prevents echo from being turned
   off while you're typing your password, and screws up the display if you
   try to hit the backspace key too many times.

   Do not use Microsoft's telnet applet -- instead, use EWAN, CRT, zMUD, or
   any other Winsock telnet application.  EWAN and CRT can be downloaded
   from any number of sites (for example, www.windows95.com).  zMUD is an
   excellent MUD client; for more information, see the official home page
   at http://www.trail.com/~zugg/zmud.html.

Known errata:

1) CircleMUD cannot use the version of the crypt() function written by Andy
   Piper and distributed by Sergey Okhapkin (http://miracle.geol.msu.ru/sos/).
   If you have this "libcrypt.a" library installed, you need to disable it
   prior to running "./configure".  I do not know if another version of crypt()
   will work or not.  The problem manifests itself at runtime, when the program
   tries to encrypt passwords, and results in a segmentation fault which will
   crash the MUD.

If you have problems, read this document again.  Most of the questions which
Jeremy Elson receives in email or which are posted to USENET newsgroups are
answered in this README file, or in other documents included in the CircleMUD
distribution.  If you are still having problems and you're *sure* that this
your question is not answered in this document or in one of the others files
in the /circle30bplXX/doc directory, try reading the CircleMUD FAQ at
ftp://ftp.circlemud.org/pub/CircleMUD/FAQ.  If all else fails, you can send me
or Jeremy Elson mail for help.  Note, however, that if you ask me any question
that is answered in these documents, all we'll do is mail you the appropriate
file.

Credit where credit is due:

Some parts of this document have been derived or outright copied from other
files in the CircleMUD distribution, including the files README and README.WIN
by Jeremy Elson.

-David Goldstein


--- Additional items of note.

* Make sure /bin points somewhere useful, like your
  /cygnus/cygwin-b20/H-i586-cygwin32/bin directory.
  If you didn't follow the directions given in #2
  above, you can do the following command:

  ln -s /cygnus/cygwin-b20/H-i586-cygwin32/bin /bin

  Obviously you'll need to adjust the path if you
  do not keep your installation in c:\cygnus.

* Make sure /tmp exists.  You can either make it a
  real directory or point it at the system temp
  folder with:

  ln -s /windows/temp /tmp

(Information from Tony Robbins.)

-George Greer