108 lines
3.6 KiB
Plaintext
108 lines
3.6 KiB
Plaintext
Copyright (c) Alex Kompel, 2002
|
|
NetHack may be freely redistributed. See license for details.
|
|
========================================================================
|
|
Instructions for compiling and installing
|
|
NetHack 3.4 on a Windows CE or PocketPC system
|
|
========================================================================
|
|
Last revision: $Date$
|
|
|
|
Credit for the porting of NetHack to Windows CE goes to Alex Kompel who
|
|
initially developed and contributed the port.
|
|
|
|
In order to build NetHack for Windows CE, you need *both* of the following:
|
|
|
|
o A copy of Microsoft Visual C V6.0 SP3 or later. Things may work with
|
|
an earlier version of the compiler, but the current code has not been
|
|
tested with an earlier version.
|
|
o Embedded Visual C++ 3.0 or later
|
|
|
|
|
|
FIRST STEP:
|
|
|
|
The first step in building NetHack for Windows CE is to execute
|
|
sys/wince/cesetup.bat.
|
|
|
|
From the command prompt:
|
|
cd sys\wince
|
|
cesetup
|
|
|
|
From a Windows explorer window:
|
|
double-click on cesetup.bat
|
|
|
|
A "wince" directory will be created off the top of the NetHack source
|
|
tree, and a Microsoft embedded C workspace file will be placed in the
|
|
top of the NetHack source tree. The "wince" directory will also have
|
|
the subdirectories wince\ceinc and wince\ceinc\sys.
|
|
|
|
------------
|
|
| BUILDING |
|
|
------------
|
|
|
|
Boostrapping the build process on Windows NT/2000/XP
|
|
|
|
1. With the Visual C++ 6.0 tools in your path,
|
|
Run "nmake /f bootstrp.mak" from the wince folder.
|
|
|
|
Compiling
|
|
|
|
2. Start the Embedded Visual C IDE. In the Embeddd Visual C IDE
|
|
Menus, choose:
|
|
File | Open Workspace
|
|
|
|
3. Set up for the build.
|
|
|
|
o In the Visual C "Open Workspace" dialog box, navigate to the top
|
|
of your NetHack source directory tree.
|
|
|
|
In there, highlight "wince.vcw" and click on Open.
|
|
Once the workspace has been opened, you should see the following
|
|
list in the Visual C selection window:
|
|
+ winhack files
|
|
+ recover files
|
|
|
|
o On the Embedded Visual C menus, choose:
|
|
Project | Set Active Project | winhack
|
|
|
|
o On the Visual C menus again, choose either:
|
|
Build | Set Active Configuration | Release (for your handheld platform)
|
|
or
|
|
Build | Set Active Configuration | Debug (for your handheld platform)
|
|
|
|
Building
|
|
|
|
4. Start your build.
|
|
|
|
o On the Embedded Visual C menus once again, choose:
|
|
Build | Build winhack
|
|
This starts the build. It is likely that the IDE message window
|
|
where you are doing the compiling will be occupied for a while.
|
|
Notes:
|
|
|
|
o You may get a bunch of warnings regarding missing include files in the
|
|
beginning of the build process - ignore them. For some reason the tool
|
|
that produces these messages ignores preprocessor directives. The actual
|
|
build will go just fine.
|
|
o Sometimes the compiler chokes on do_wear.c Ignore that - let the build
|
|
finish. Then run it again - it will compile just fine. (Seems to be some
|
|
sort of bug in EVC++)
|
|
|
|
Transfer
|
|
|
|
5. Transfer the files and executables to your handheld by extracting the
|
|
files into some folder on the CE device - that should do it.
|
|
|
|
|
|
PROBLEMS
|
|
|
|
If you encounter a bug and wish to report it, please send e-mail to:
|
|
nethack-bugs@nethack.org
|
|
|
|
If you have any comments or suggestions, feel free to drop us a line c/o:
|
|
DevTeam@nethack.org
|
|
|
|
You may wish to vist the NetHack Development Team's website occasionally
|
|
to check for updates or known bugs. The website can be found at:
|
|
http://www.nethack.org/
|
|
|
|
Happy NetHacking!
|