sys/wince/Install.ce

   1 Copyright (c) Alex Kompel, 2002
   2 NetHack may be freely redistributed.  See license for details.
   3 ========================================================================
   4                  Instructions for compiling and installing
   5                NetHack 3.6 on a Windows CE or PocketPC system
   6 ========================================================================
   7                       Last revision: $NHDT-Date: 1432512799 2015/05/25 00:13:19 $
   8
   9 Credit for the porting of NetHack to Windows CE goes to Alex Kompel who
  10 initially developed and contributed the port.
  11
  12 In order to build NetHack for Windows CE, you need *both* of the following:
  13
  14   o A copy of Microsoft Visual C V6.0 SP3 or later.  Things may work with
  15     an earlier version of the compiler, but the current code has not been
  16     tested with an earlier version.
  17   o Embedded Visual C++ 3.0 or later
  18
  19
  20 FIRST STEP:
  21
  22 The first step in building NetHack for Windows CE is to execute
  23 sys/wince/cesetup.bat.
  24
  25 From the command prompt:
  26         cd sys\wince
  27         cesetup
  28
  29 From a Windows explorer window:
  30         double-click on cesetup.bat
  31
  32 A "wince" directory will be created off the top of the NetHack source
  33 tree, and a Microsoft embedded C workspace file will be placed in the
  34 top of the NetHack source tree.
  35
  36 ------------
  37 | BUILDING |
  38 ------------
  39
  40 Boostrapping the build process on Windows NT/2000/XP
  41
  42 1. With the Visual C++ 6.0 tools in your path,
  43    Run "nmake /f bootstrp.mak" from the wince folder.
  44
  45 Compiling
  46
  47 2. Start the Embedded Visual C IDE. In the Embedded Visual C IDE
  48        Menus, choose:
  49            File | Open Workspace
  50
  51 3.  Set up for the build.
  52
  53         o In the Visual C "Open Workspace" dialog box, navigate to the top
  54             of  your NetHack source directory tree.
  55
  56             In there, highlight "wince.vcw" and click on Open.
  57             Once the workspace has been opened, you should see the following
  58             list in the Visual C selection window:
  59               + nethack_hpc files
  60               + nethack_palm_pc files
  61               + nethack_pocket_pc files
  62               + nethack_smartphone files
  63
  64         o On the Embedded Visual C menus, choose:
  65               Build | Set Active Platform
  66                 Select the platform that corresponds to your device:
  67                 Palm-size PC 2.11  - palm size PC running Windows CE version 2.11
  68                 Pocket PC          - palm-size PC running Windows CE 3.0 and higher (PocketPC)
  69                 H/PC Pro 2.11      - handheld computers running Windows CE 2.11 anf higher
  70                 Smartphone 2002  - Microsoft SmartPhone device
  71
  72         o On the Visual C menus again, choose either:
  73               Build | Set Active Configuration
  74                 where configuration is one of the following (make sure it matches the platform
  75                 you have selected):
  76                 nethack_hpc - Win32 (WCE MIPS) HPCRelease  - H/PC Pro 2.11 MIPS processor release executable
  77                 nethack_hpc - Win32 (WCE x86em) HPCDebug   - H/PC Pro 2.11 x86 emulation debug executable
  78                 nethack_hpc - Win32 (WCE ARM) HPCRelease   - H/PC Pro 2.11 ARM processor release executable
  79                 nethack_hpc - Win32 (WCE SH3) HPCRelease   - H/PC Pro 2.11 SH3 processor release executable
  80                 nethack_hpc - Win32 (WCE x86em) HPCRelease - H/PC Pro 2.11 x86 emulation release executable
  81                 nethack_hpc - Win32 (WCE SH4) HPCRelease   - H/PC Pro 2.11 SH4 processor release executable
  82                 nethack_palm_pc - Win32 (WCE MIPS) PalmPCRelease  - Palm-size PC 2.11 MIPS processor release executable
  83                 nethack_palm_pc - Win32 (WCE x86em) PalmPCDebug   - Palm-size PC 2.11 x86 emulation debug executable
  84                 nethack_palm_pc - Win32 (WCE SH3) PalmPCRelease   - Palm-size PC 2.11 SH3 processor release executable
  85                 nethack_palm_pc - Win32 (WCE x86em) PalmPCRelease - Palm-size PC 2.11 x86 emulation release executable
  86                 nethack_pocket_pc - Win32 (WCE MIPS) PocketPCRelease  - Pocket PC MIPS processor release executable
  87                 nethack_pocket_pc - Win32 (WCE ARM) PocketPCRelease   - Pocket PC ARM processor release executable
  88                 nethack_pocket_pc - Win32 (WCE x86em) PocketPCRelease - Pocket PC x86 emulation release executable
  89                 nethack_pocket_pc - Win32 (WCE x86em) PocketPCDebug   - Pocket PC x86 emulation debug executable
  90                 nethack_pocket_pc - Win32 (WCE SH3) PocketPCRelease   - Pocket PC SH3 processor release executable
  91                 nethack_smartphone - Win32 (WCE ARM) SPhoneRelease   - Smartphone 2002 ARM processor release executable
  92                 nethack_smartphone - Win32 (WCE x86em) SPhoneDebug   - Smartphone 2002 x86 emulation debug executable
  93
  94 Building
  95
  96 4.  Start your build.
  97
  98         o On the Embedded Visual C menus once again, choose:
  99               Build | Build nethackm.exe
 100           This starts the build.  It is likely that the IDE message window
 101           where you are doing the compiling will be occupied for a while.
 102     Notes:
 103
 104         o You may get a bunch of warnings regarding missing include files in the
 105           beginning of the build process - ignore them. For some reason the tool
 106           that produces these messages ignores preprocessor directives. The actual
 107           build will go just fine.
 108         o Sometimes the compiler chokes on do_wear.c  Ignore that - let the build
 109           finish. Then run it again - it will compile just fine. (Seems to be some
 110           sort of bug in EVC++)
 111
 112 Transfer
 113
 114 5.  Transfer the files and executables to your handheld by extracting the
 115     files into some folder on the CE device - that should do it.
 116
 117
 118 Notes
 119
 120     If you want to use IBMGraphics make sure that you have a proper
 121     font installed on the device that supports OEM character set
 122     (for example, Lucida Console)
 123
 124
 125 PROBLEMS
 126
 127
 128     If you discover a bug and wish to report it, or if you have comments
 129     or suggestions we recommend using our "Contact Us" web page at:
 130         http://www.nethack.org/common/contact.html
 131
 132     If you don't have access to the web, or you want to send us a patch
 133     to the NetHack source code feel free to drop us a line c/o:
 134         DevTeam (at) nethack.org
 135
 136     Happy NetHacking!