sys/be/README

   1 This file is sys/be/README.  It is for those intending to compile
   2 NetHack 3.6 on a BeOS 4.5 system.
   3
   4 BeOS NetHack currently only supports the TTY windowing system.  In
   5 order to compile it, it would benefit you greatly to think of your Be
   6 system as a UNIX variant.  It is possible to compile using BeIDE.
   7 However, there are four executables and several steps involved in making
   8 NetHack.  Unless you are extremely familiar with the build sequence and
   9 are willing to modify the code somewhat, I suggest you avoid it for now.
  10 Let the UNIX Makefiles take care of all that for you.
  11
  12
  13 Known problems:
  14 + No special characters for walls.  None of the fonts available for use
  15   in a tty window has the graphics characters needed to improve the look.
  16   If such a font existed, then all you need to do is set the dungeon,
  17   object, and/or monter mappings in your defaults file.
  18 + The arrow keys don't work.
  19
  20
  21
  22 Build instructions.  From a freshly unpacked source tree:
  23
  24 1. Copy the Makfiles in sys/unix to their proper spots.  You may
  25    use setup.sh or copy them by hand.  Using setup.sh to create
  26    links instead of copying the Makefiles will work, but BeOS will
  27    not let you edit a link.   It may be helpful to read
  28    sys/unix/Install.unx.
  29
  30 2. Edit src/Makefile:
  31         o Change System to SysBe.
  32         o Comment out the UNIX versions of SYSSRC and SYSOBJ variables.
  33         o Uncomment the BeOS versions of SYSRC and SYSOBJ.
  34         o Uncomment the BeOS versions of CC, CFLAGS, LD, and LFLAGS.  The
  35           flags are different for Intel vs BeBox/Mac.
  36         o Uncomment one of the Intel or BeBox/Mac BeOS versions of CC, CFLAGS,
  37           LD, and LFLAGS.
  38         o Comment out the default CFLAGS and LFLAGS.
  39         o Change WINTTYLIB to be -ltermcap.
  40
  41 3. Edit util/Makefile:
  42         o If on a BeBox/Mac:
  43           - Uncomment the BeOS versions of CC and CFLAGS
  44           - Comment out the default CFLAGS and LFLAGS.
  45         o If on Intel:
  46           - the default values of CFLAGS and LFLAGS work fine
  47         o Change YACC and LEX to be bison -y and flex respectively.
  48
  49 4. Edit include/config.h to change HACKDIR to be the location of your
  50    install directory.
  51
  52 5. Edit top level Makefile and change GAMEDIR to match HACKDIR in
  53    include/config.h.  Make sure the path to GAMEDIR exists.  Change
  54    SHELLDIR to a "throw away" directory, like /tmp.  We don't use the
  55    shell.  Change CHOWN and CHGRP commands to "true", there really
  56    aren't groups on the BeOS.
  57
  58 6. Type "make install" at the top level.
  59
  60
  61
  62 It is possible that some necessary steps needed to make the game have been
  63 omitted.  Feel free to ad-lib as necessary.