1This file is sys/be/README.  It is for those intending to compile
2NetHack 3.3 on a BeOS 4.5 system.
3
4BeOS NetHack currently only supports the TTY windowing system.  In
5order to compile it, it would benefit you greatly to think of your Be
6system as a UNIX variant.  It is possible to compile using BeIDE.
7However, there are four executables and several steps involved in making
8NetHack.  Unless you are extremely familiar with the build sequence and
9are willing to modify the code somewhat, I suggest you avoid it for now.
10Let the UNIX Makefiles take care of all that for you.
11
12
13Known 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
22Build instructions.  From a freshly unpacked source tree:
23
241. 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
302. 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
413. 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
494. Edit include/config.h to change HACKDIR to be the location of your
50   install directory.
51
525. 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
586. Type "make install" at the top level.
59
60
61
62It is possible that some necessary steps needed to make the game have been
63omitted.  Feel free to ad-lib as necessary.
64