wmud/old-codebase/doc/README.MSVC4
2012-03-07 16:24:50 +01:00

139 lines
6.5 KiB
Plaintext

Compiling CircleMUD using Microsoft Visual C++ v4.x
by Jeremy Elson (jelson@circlemud.org)
For help, write to help@circlemud.org
CircleMUD compiles relatively easily under Windows 95 and NT using
the Microsoft Visual C++ compiler version 4.x. These instructions won't
work for any compiler except for MSVC++ 4.0; if you have a different
compiler, take a look at the main README.WIN file for instructions.
Note MSVC++ 4.x is a commercial product and must be bought from your local
software store. It can't be downloaded from any (legal) FTP sites, and I
will not send you a copy, so please don't ask. Use the FREE GNU-Win32
package mentioned in the README.WIN file if you don't want to buy MSVC.
1) Download the latest version of CircleMUD. You can always find the latest
version at the following anonymous FTP sites:
ftp.circlemud.org:/pub/CircleMUD
ftp2.circlemud.org:/pub/CircleMUD
You can also find information at the WWW site:
http://www.circlemud.org/
The latest version will be called something ending in .zip, like
"circle30bplXX.zip". (where 'XX' is the patchlevel)
2) When you unzip the .zip archive, MAKE SURE to use an unzip program that
can handle long filenames. Old versions of pkunzip (e.g. 2.x) do NOT
handle long filenames. WinZip (http://www.winzip.com) can.
3) Open a window with an MS-DOS prompt. Note, this does not mean you are
"compiling under DOS" -- the MS-DOS prompt is just a command-line
interface to Windows 95. This step can be done by going to the Start
menu, going to the Programs submenu, and selecting "MS-DOS prompt". All
the following commands are performed at the MS-DOS prompt.
4) Use the CD command to switch to the main CircleMUD directory. For
example, type "CD \circle30bplXX", where 'XX' is the patchlevel of the
version of Circle you downloaded. Also note that the full path will
depend on where you decided to uncompress it.
5) Go to the src directory and rename conf.h.win to conf.h, and replace
the Makefile with Makefile.msvc. This can be accomplished with the
following commands:
cd src
copy conf.h.win conf.h
del Makefile
copy Makefile.msvc Makefile
6) If you have MSVC++ 4.x installed in C:\MSDEV, skip to the next step.
Otherwise, bring up the Makefile in your favorite text editor (for
example, to use the DOS EDIT command, type "EDIT MAKEFILE".) Find the
two lines that start with "CLFAGS =" and "LIB=", respectively. On BOTH
lines, change the part that says "C:\MSDEV\" to reflect where your copy
of MSVC++ 4.x is installed. Then, save the Makefile and exit the
editor. You should still be in the "src" directory.
7) Make sure that MSVC++ binary directory (i.e., the directory where
the actual programs are kept, such as NMAKE.EXE) is in your PATH. You
can see what your path is by typing PATH. Your MSVC++ binary directory
should be listed (for example, C:\MSDEV\BIN). Add MSVC's binary
directory to your path if it's not already there. If you do not know
how to change your path, contact someone who knows how to use the DOS
command prompt for help, or check the manual to learn how to use the
PATH command.
8) To compile Circle, stay in the src directory and type:
NMAKE
This will invoke Microsoft's make program and should build the entire
CircleMUD server and create a file called 'circle.exe'. If you see the
error message "Bad command or filename", then MSVC++'s binary directory
is not in your path, so your computer can't find MS's NMAKE program.
Go back to step 7.
9) 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 (do not write me mail) if you have any
additional questions about how to set up TCP/IP under Windows 95.
YOU MUST INSTALL AND CONFIGURE YOUR TCP/IP STACK, EVEN IF YOU ARE NOT
CONNECTED TO THE INTERNET.
10) Go back to Circle's main directory (like in Step 4), and run the server
by typing "src\circle". You should see boot messages appearing on the
screen. Wait until the line "No connections. Going to sleep." appears
at the bottom of the screen -- this means Circle is ready to accept
connections. Go on to step 11 if you see this.
If you see "Winsock Error #10047", your TCP/IP stack is not correctly
configured; go back to Step 9.
If you see "Fatal error changing to data directory: No such file
or directory", that means you are trying to run Circle from the
"src" directory. Your current directory must be Circle's top-level
directory -- the same directory that you were in during Step 4.
11) 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.zuggsoft.com/zmud/zmudinfo.htm .
If you have problems, read this document again. Most of the questions
I receive in email are answered in this README file. If you're still
having problems and you're *sure* that this document doesn't answer
your question, try reading the CircleMUD FAQ at
ftp://ftp.circlemud.org/pub/CircleMUD/FAQ. If all else fails, you can
get help by sending mail to help@circlemud.org. Note, however, that
if you ask a question that is answered in this document, all I'll do
is mail it to you.
Have fun!
Jeremy Elson
jelson@circlemud.org
(To get help, write to help@circlemud.org)