1NetHack 3.4.3 Linux Elf
2
3This README provides the instructions for using the official Linux binary,
4system platform requirements, as well as steps used to create that binary.
5The same steps can be used from the source distribution to create a similar
6binary.
7
8The official Linux binary has support for tty and X11 windowing systems, but
9not Qt.  This means you will need to have X11 libraries installed on your
10system to run this binary, even in its tty flavor.
11
12
13The Linux binary package assumes that you have a user and a group named
14"games" on your system.  If you do not, you can simplify installation by
15creating them first.
16
17Log in as or su to "root".  Then, cd /, gunzip and untar the package,
18preserving permissions to put the NetHack files in /usr/games/nethack and
19/usr/games/lib/nethackdir.   For example, if the package in in your
20home directory you might perform these steps.
21    % su
22    # cd /
23    # tar xpvzf ~yourlogin/nethack-343-linux-X11.tgz
24
25If you have old record and logfile entries from a previous NetHack version,
26you might want to save copies before they get overwritten by the new empty
27files; old saved games and bones files from 3.4.x will work with 3.4.3.
28If you are installing from the RPM, there is no need to save the old record
29and logfile; they are automatically preserved.
30
31In addition to data files for running the game, you will find other useful
32things in /usr/games/lib/nethackdir (such as a copy of this README :-).
33
34The general documentation Guidebook.txt and the processed man pages
35nethack.txt and recover.txt should provide an introduction to the game.
36
37The sample config file called dot.nethackrc can be used by copying
38it to your home directory as .nethackrc and modifying it to your liking.
39
40If you are running X11 copy the nh10.pcf and ibm.pcf font files from
41/usr/games/lib/nethackdir to a X11 fonts directory (such as
42/usr/X11/lib/X11/fonts/misc) and run "mkfontdir", then restart X
43windows to load them.  If you prefer to use the graphical tiles,
44add the following to your .Xdefaults or .Xresources file:
45	NetHack.tile_file: x11tiles
46You may need to run "xrdb -merge $HOME/.Xdefaults" (or .Xresources) after
47doing this.
48
49The official Linux binary is set up to run setgid games, which allows
50multiple users on your system to play the game and prevents cheating by
51unprivileged users.  The usual default for NetHack is setuid games, but
52this causes problems with accessing .nethackrc on distributions with
53restrictive default security on home directories and users who don't know
54the tradeoffs of various permission settings.
55
56
57If you have problems, send us some email.
58
59nethack-bugs@nethack.org
60
61
62
63Steps used to build this binary release, in addition to the basic
64instructions found in sys/unix/Install.unx.  The step numbers below
65correspond to the step numbers in sys/unix/Install.unx.
66
67System:  gcc-3.2, XFree86-libs-4.2.1, ncurses-5.2, glibc-2.3.2 (GLIBC_2.3)
68
693.  Edit include/config.h and include/unixconf.h
70    config.h: define X11_GRAPHICS window support.
71              define USE_XPM support.
72              define COMPRESS as /bin/gzip as that is where it
73              seems to reside on newer Linux's.
74              define COMPRESS_EXTENSION as ".gz"
75              define DLB
76	      define AUTOPICKUP_EXCEPTIONS
77
78    unixconf.h: define LINUX
79                define TIMED_DELAY
80
816.  Makefile.src: define modern, non-BSD Linux and linux options throughout
82		  CC = gcc
83		  LFLAGS = -L/usr/X11R6/lib
84		  WINSRC = $(WINTTYSRC) $(WINX11SRC)
85		  WINOBJ = $(WINTTYOBJ) $(WINX11OBJ)
86		  WINTTYLIB = /usr/lib/libncurses.a
87		  WINX11LIB = -lXaw -lXmu -lXext -lXt -lXpm -lX11
88		  WINLIB = $(WINTTYLIB) $(WINX11LIB)
89
90    Makefile.utl: define modern, non-BSD Linux and linux options throughout
91                  Use bison/flex instead of yacc/lex
92		  CC = gcc
93		  LFLAGS = -L/usr/X11R6/lib
94		  YACC = bison -y
95		  LEX = flex
96
977.  Makefile.top: GAMEGRP = games
98		  GAMEPERM = 02755
99		  FILEPERM = 0664
100		  EXEPERM = 0755
101		  DIRPERM = 0775
102		  VARDATND = x11tiles NetHack.ad pet_mark.xbm rip.xpm
103
104    make all; su; make install
105
1069.  Additional step: As discussed in win/X11/Install.X11, convert nh10.bdf
107    and ibm.bdf to proper font files and place in font path.
108