more windows instruction cleanup
This commit is contained in:
@@ -1,11 +1,11 @@
|
|||||||
Copyright (c) NetHack Development Team 1990-2012
|
Copyright (c) NetHack Development Team 1990-2015
|
||||||
NetHack may be freely redistributed. See license for details.
|
NetHack may be freely redistributed. See license for details.
|
||||||
==============================================================
|
==============================================================
|
||||||
Instructions for compiling and installing
|
Instructions for compiling and installing
|
||||||
NetHack 3.6 on a Windows system
|
NetHack 3.6 on a Windows system
|
||||||
(Windows XP and Windows 2003 or later only)
|
(Windows 7/8.x or later only. XP may work but is untested)
|
||||||
==============================================================
|
==============================================================
|
||||||
Last revision: $NHDT-Date: 1432512793 2015/05/25 00:13:13 $
|
Last revision: $NHDT-Date: 1432512793 2015/05/25 00:13:13 $
|
||||||
|
|
||||||
Credit for the porting of NetHack to the Win32 Console Subsystem goes to
|
Credit for the porting of NetHack to the Win32 Console Subsystem goes to
|
||||||
the NT Porting Team started by Michael Allison.
|
the NT Porting Team started by Michael Allison.
|
||||||
@@ -22,29 +22,15 @@ You can build either the TTY version of NetHack or the Windows Graphical
|
|||||||
version. In either case you can use one of the following build
|
version. In either case you can use one of the following build
|
||||||
environments:
|
environments:
|
||||||
|
|
||||||
o A copy of Microsoft Visual Studio 2010 Express
|
o A copy of Microsoft Visual Studio 2013 Express
|
||||||
The current NetHack code has not been tested with earlier versions
|
The current NetHack code has not been tested with earlier versions
|
||||||
of the compiler.
|
of the compiler.
|
||||||
|
|
||||||
64-bit Note: To build a 64-bit target with the Express edition, you
|
|
||||||
will also need to download and install the
|
|
||||||
Windows Software Development Kit version 7.1
|
|
||||||
Visual Studio 2010 Express does not include a 64 bit
|
|
||||||
C compiler by default.
|
|
||||||
(http://msdn.microsoft.com/en-us/windowsserver/bb980924.aspx)
|
|
||||||
|
|
||||||
OR
|
OR
|
||||||
|
|
||||||
o [UNTESTED FOR 3.5] A copy of Borland C 5.5.1 command line tools. Borland has made a
|
o A copy of MinGW. MinGW is a collection of header
|
||||||
version of its command line tools available for download after
|
|
||||||
registration at:
|
|
||||||
http://www.borland.com/bcppbuilder/freecompiler/
|
|
||||||
|
|
||||||
OR
|
|
||||||
|
|
||||||
o [UNTESTED FOR 3.5] A copy of MinGW 2.0 or later. MinGW is a collection of header
|
|
||||||
files and import libraries with which native Windows32 programs
|
files and import libraries with which native Windows32 programs
|
||||||
can be built; the MinGW 2.0 distribution contains the GNU Compiler
|
can be built; the MinGW distribution contains the GNU Compiler
|
||||||
Collection. You can download MinGW at
|
Collection. You can download MinGW at
|
||||||
http://www.mingw.org/
|
http://www.mingw.org/
|
||||||
Earlier versions of MinGW will not allow you to build the Windows
|
Earlier versions of MinGW will not allow you to build the Windows
|
||||||
@@ -107,18 +93,14 @@ I. Dispelling the Myths:
|
|||||||
|
|
||||||
We have provided a Makefile for each of the following compilers:
|
We have provided a Makefile for each of the following compilers:
|
||||||
|
|
||||||
o Microsoft Visual Studio 2010 Express Visual C++ Compiler
|
o Microsoft Visual Studio 2013 Express Visual C++ Compiler
|
||||||
o Borland C 5.5.1
|
|
||||||
o MinGW 2.0 (with GCC 3.2)
|
o MinGW 2.0 (with GCC 3.2)
|
||||||
|
|
||||||
The Microsoft Visual Studio 2010 Express Makefile was created for use
|
The Microsoft Visual Studio 2013 Express Makefile was created for use
|
||||||
with MS NMAKE which is provided with the Microsoft compiler.
|
with MS NMAKE which is provided with the Microsoft compiler.
|
||||||
The supplied Makefile may work with earlier versions of the Microsoft
|
The supplied Makefile may work with earlier versions of the Microsoft
|
||||||
compiler, but that has not been tested.
|
compiler, but that has not been tested.
|
||||||
|
|
||||||
The Borland C Makefile was created for use with Borland MAKE which
|
|
||||||
is provided with the Borland compiler.
|
|
||||||
|
|
||||||
The GCC Makefile was created for use with GNU Make version 3.79.1,
|
The GCC Makefile was created for use with GNU Make version 3.79.1,
|
||||||
which comes with the MinGW package.
|
which comes with the MinGW package.
|
||||||
|
|
||||||
@@ -127,7 +109,7 @@ I. Dispelling the Myths:
|
|||||||
they are required should you desire to make any changes to the level
|
they are required should you desire to make any changes to the level
|
||||||
and dungeon compilers.
|
and dungeon compilers.
|
||||||
|
|
||||||
II. To compile your copy of NetHack on a Windows NT/2000/XP machine:
|
II. To compile your copy of NetHack on a Windows machine:
|
||||||
|
|
||||||
Setting Up
|
Setting Up
|
||||||
|
|
||||||
@@ -136,44 +118,18 @@ Setting Up
|
|||||||
all the necessary environment variables for the compiler environment
|
all the necessary environment variables for the compiler environment
|
||||||
are set correctly.
|
are set correctly.
|
||||||
|
|
||||||
For Visual Studio 2010 Express, the installation should have placed
|
For Visual Studio 2013 Express, the installation should have placed
|
||||||
a command prompt option on the Start menus that is properly configured
|
a command prompt option on the Start menus that is properly configured
|
||||||
for building:
|
for building:
|
||||||
From
|
From
|
||||||
Start | All Programs | Microsoft Visual Studio 2010 Express
|
Start | All Programs | Microsoft Visual Studio 2013 Express
|
||||||
Select
|
Select
|
||||||
Visual Studio Command Prompt 2010
|
Visual Studio Command Prompt 2013
|
||||||
|
|
||||||
|
|
||||||
64-bit Note: The additional installation of Microsoft Windows SDK V7.1
|
|
||||||
will have placed a command prompt option on the Start menus
|
|
||||||
that is properly configured for building as well, but
|
|
||||||
supports the Windows SDK tools. That is what should be
|
|
||||||
used if you wish to target an x64 build for example.
|
|
||||||
From
|
|
||||||
Start | All Programs | Microsoft Windows SDK v7.1
|
|
||||||
Select
|
|
||||||
Windows SDK 7.1 Command Prompt
|
|
||||||
|
|
||||||
Then, for an x86 (32-bit) target run the following at the
|
|
||||||
command prompt:
|
|
||||||
SETENV /x86
|
|
||||||
|
|
||||||
If you prefer to target an x64 (64-bit) build run the
|
|
||||||
following at the command prompt:
|
|
||||||
SETENV /x64
|
|
||||||
|
|
||||||
|
|
||||||
For the GCC Makefile, add <mingw>\bin to your path, where <mingw>
|
For the GCC Makefile, add <mingw>\bin to your path, where <mingw>
|
||||||
is your MinGW root directory.).
|
is your MinGW root directory.).
|
||||||
|
|
||||||
For the Borland Makefile, you can simply invoke the Make utility
|
|
||||||
from the Makefile's directory (For the standard Borland compiler
|
|
||||||
installation you can just use the explicit path
|
|
||||||
"c:\borland\bcc55\bin\make /f Makefile.bcc". NetHack 3.6.0 has not
|
|
||||||
yet been tested with the Borland compiler.
|
|
||||||
|
|
||||||
|
|
||||||
2. Make sure all the NetHack files are in the appropriate directory
|
2. Make sure all the NetHack files are in the appropriate directory
|
||||||
structure. You should have a main directory with subdirectories
|
structure. You should have a main directory with subdirectories
|
||||||
dat, doc, include, src, sys\share, sys\winnt, util, and binary (The
|
dat, doc, include, src, sys\share, sys\winnt, util, and binary (The
|
||||||
@@ -256,42 +212,17 @@ Compiling
|
|||||||
|
|
||||||
5. Now that everything is set up...
|
5. Now that everything is set up...
|
||||||
|
|
||||||
For Visual Studio 2010 Express, as mentioned above, the installation should
|
For Visual Studio 2013 Express, as mentioned above, the installation should
|
||||||
have placed a command prompt option on the Start menus that is properly configured
|
have placed a command prompt option on the Start menus that is properly configured
|
||||||
for building:
|
for building:
|
||||||
From
|
From
|
||||||
Start | All Programs | Microsoft Visual Studio 2010 Express
|
Start | All Programs | Microsoft Visual Studio 2013 Express
|
||||||
Select
|
Select
|
||||||
Visual Studio Command Prompt 2010
|
Visual Studio Command Prompt 2013
|
||||||
Change your current directory to the NetHack src directory.
|
Change your current directory to the NetHack src directory.
|
||||||
Issue this command:
|
Issue this command:
|
||||||
nmake install
|
nmake install
|
||||||
|
|
||||||
64-bit Note: As previously mentioned, you should start your
|
|
||||||
command prompt from the Windows SDK v7.1 menu
|
|
||||||
which is properly configured for building using
|
|
||||||
the Windows SDK tools.
|
|
||||||
From
|
|
||||||
Start | All Programs | Microsoft Windows SDK v7.1
|
|
||||||
Select
|
|
||||||
Windows SDK 7.1 Command Prompt
|
|
||||||
Change your current directory to the NetHack src directory.
|
|
||||||
|
|
||||||
Then, for an x86 (32-bit) target run the following at the
|
|
||||||
command prompt:
|
|
||||||
SETENV /x86
|
|
||||||
nmake install
|
|
||||||
|
|
||||||
If you prefer to target an x64 (64-bit) build run the
|
|
||||||
following at the command prompt:
|
|
||||||
SETENV /x64
|
|
||||||
nmake install
|
|
||||||
|
|
||||||
For Borland compiler:
|
|
||||||
Change your current directory to the NetHack src directory.
|
|
||||||
Issue this command:
|
|
||||||
make /f Makefile.bcc install
|
|
||||||
|
|
||||||
For GCC:
|
For GCC:
|
||||||
Change your current directory to the NetHack src directory.
|
Change your current directory to the NetHack src directory.
|
||||||
Issue this command:
|
Issue this command:
|
||||||
@@ -316,9 +247,6 @@ Notes:
|
|||||||
For Microsoft compiler:
|
For Microsoft compiler:
|
||||||
nmake
|
nmake
|
||||||
|
|
||||||
For Borland compiler:
|
|
||||||
make /f Makefile.bcc
|
|
||||||
|
|
||||||
For GCC:
|
For GCC:
|
||||||
mingw32-make -f Makefile.gcc
|
mingw32-make -f Makefile.gcc
|
||||||
|
|
||||||
@@ -334,7 +262,7 @@ Notes:
|
|||||||
2. Depending on the build and compiler and tools used above, the
|
2. Depending on the build and compiler and tools used above, the
|
||||||
executable produced by the TTY build is either:
|
executable produced by the TTY build is either:
|
||||||
- a 32-bit (x86), flat-address space, non-overlayed .exe file,
|
- a 32-bit (x86), flat-address space, non-overlayed .exe file,
|
||||||
which should run on any true Win32 environment.
|
which should run on any recent Win32 environment.
|
||||||
or
|
or
|
||||||
- a 64-bit (x64) .exe file,
|
- a 64-bit (x64) .exe file,
|
||||||
which should run on any 64-bit Windows O/S.
|
which should run on any 64-bit Windows O/S.
|
||||||
@@ -342,11 +270,11 @@ Notes:
|
|||||||
To run NetHack, proceed to RUNNING NETHACK.
|
To run NetHack, proceed to RUNNING NETHACK.
|
||||||
|
|
||||||
/-------------------------------------------------\
|
/-------------------------------------------------\
|
||||||
| BUILDING USING VISUAL STUDIO 2010 EXPRESS IDE |
|
| BUILDING USING VISUAL STUDIO 2013 EXPRESS IDE |
|
||||||
\-------------------------------------------------/
|
\-------------------------------------------------/
|
||||||
|
|
||||||
Only the native port built on the Windows API, or Graphical
|
Only the native port built on the Windows API, or Graphical
|
||||||
NetHack, can be built using the Visual Studo 2010 Express IDE.
|
NetHack, can be built using the Visual Studo 2013 Express IDE.
|
||||||
|
|
||||||
I. Dispelling the Myths:
|
I. Dispelling the Myths:
|
||||||
|
|
||||||
@@ -360,17 +288,17 @@ I. Dispelling the Myths:
|
|||||||
back and do so before proceeding.
|
back and do so before proceeding.
|
||||||
|
|
||||||
II. To compile your copy of NetHack for Windows on a Windows machine
|
II. To compile your copy of NetHack for Windows on a Windows machine
|
||||||
using the Visual Studio 2010 Express IDE:
|
using the Visual Studio 2013 Express IDE:
|
||||||
|
|
||||||
Setting Up
|
Setting Up
|
||||||
|
|
||||||
1. It almost goes without saying that you should make sure that your
|
1. It almost goes without saying that you should make sure that your
|
||||||
tools are set up and running correctly. (For the Microsoft Visual
|
tools are set up and running correctly. (For the Microsoft Visual
|
||||||
Studio 2010 ExpressIDE it should correctly fire up when you choose
|
Studio 2013 ExpressIDE it should correctly fire up when you choose
|
||||||
it:
|
it:
|
||||||
Start | All Programs | Microsoft Visual Studio 2010 Express
|
Start | All Programs | Microsoft Visual Studio 2013 Express
|
||||||
and select
|
and select
|
||||||
Visual C++ 2010 Express
|
Visual C++ 2013 Express
|
||||||
|
|
||||||
2. Make sure all the NetHack files are in the appropriate directory
|
2. Make sure all the NetHack files are in the appropriate directory
|
||||||
structure. You should have a main directory with subdirectories
|
structure. You should have a main directory with subdirectories
|
||||||
@@ -421,12 +349,12 @@ Setting Up
|
|||||||
as explained above. However, the IDE build has full game
|
as explained above. However, the IDE build has full game
|
||||||
functionality.
|
functionality.
|
||||||
|
|
||||||
Start the Visual Studio 2010 Express IDE:
|
Start the Visual Studio 2013 Express IDE:
|
||||||
Start | All Programs | Microsoft Visual Studio 2010 Express
|
Start | All Programs | Microsoft Visual Studio 2013 Express
|
||||||
and select
|
and select
|
||||||
Visual C++ 2010 Express
|
Visual C++ 2013 Express
|
||||||
|
|
||||||
In the Visual C++ 2010 Express IDE menus, choose:
|
In the Visual C++ 2013 Express IDE menus, choose:
|
||||||
File | Open Project/Solution
|
File | Open Project/Solution
|
||||||
|
|
||||||
|
|
||||||
@@ -435,7 +363,7 @@ Setting Up
|
|||||||
In the Visual C dialog box, navigate to the top of
|
In the Visual C dialog box, navigate to the top of
|
||||||
your NetHack source directory.
|
your NetHack source directory.
|
||||||
|
|
||||||
In there, highlight "nethack.sln" for Visual C++ 2010 Express Edition
|
In there, highlight "nethack.sln" for Visual C++ 2013 Express Edition
|
||||||
and click on Open.
|
and click on Open.
|
||||||
|
|
||||||
Once the workspace or solution has been opened, you should see
|
Once the workspace or solution has been opened, you should see
|
||||||
@@ -452,11 +380,11 @@ Setting Up
|
|||||||
+ tilemap
|
+ tilemap
|
||||||
+ uudecode
|
+ uudecode
|
||||||
|
|
||||||
On the Visual C++ 2010 Express IDE menus, NetHackW should be the startup
|
On the Visual C++ 2013 Express IDE menus, NetHackW should be the startup
|
||||||
project in bold, but if it isn't make it so by right-clicking and
|
project in bold, but if it isn't make it so by right-clicking and
|
||||||
choosing "set as Startup Project."
|
choosing "set as Startup Project."
|
||||||
|
|
||||||
In Visual C 2010 Express IDE menus right-click on
|
In Visual C 2013 Express IDE menus right-click on
|
||||||
"Solution NetHack (12 Projects)" and select "Configuration Manager."
|
"Solution NetHack (12 Projects)" and select "Configuration Manager."
|
||||||
|
|
||||||
Set the "Active Solution Configuration" to either
|
Set the "Active Solution Configuration" to either
|
||||||
|
|||||||
@@ -60,17 +60,6 @@ echo ..\..\src\Makefile-orig
|
|||||||
copy Makefile.msc ..\..\src\Makefile >nul
|
copy Makefile.msc ..\..\src\Makefile >nul
|
||||||
echo Microsoft Makefile copied ok.
|
echo Microsoft Makefile copied ok.
|
||||||
|
|
||||||
echo Copying Borland Makefile - Makefile.bcc to ..\..\src\Makefile.bcc...
|
|
||||||
if NOT exist ..\..\src\Makefile.bcc goto :dobor
|
|
||||||
copy ..\..\src\Makefile.bcc ..\..\src\Makefile.bcc-orig >nul
|
|
||||||
echo Your existing
|
|
||||||
echo ..\..\src\Makefile.bcc
|
|
||||||
echo has been renamed to
|
|
||||||
echo ..\..\src\Makefile.bcc-orig
|
|
||||||
:dobor
|
|
||||||
copy Makefile.bcc ..\..\src\Makefile.bcc >nul
|
|
||||||
echo Borland Makefile copied ok.
|
|
||||||
|
|
||||||
echo Copying MinGW Makefile - Makefile.gcc to ..\..\src\Makefile.gcc...
|
echo Copying MinGW Makefile - Makefile.gcc to ..\..\src\Makefile.gcc...
|
||||||
if NOT exist ..\..\src\Makefile.gcc goto :dogcc
|
if NOT exist ..\..\src\Makefile.gcc goto :dogcc
|
||||||
copy ..\..\src\Makefile.gcc ..\..\src\Makefile.gcc-orig >nul
|
copy ..\..\src\Makefile.gcc ..\..\src\Makefile.gcc-orig >nul
|
||||||
|
|||||||
Reference in New Issue
Block a user