1Installing NetHack with a Qt or KDE interface
2---------------------------------------------
3
4This document describes the installation of NetHack with a Qt interface
5on X11.  The Qt interface is an alternative to the Athena-widgets interface
6found in ../X11.  You can download Qt for UNIX from http://www.troll.no.
7You need Qt 2.0 or later to use this code.
8
9There are no explicit UNIX dependencies in this code, but we only regularly
10test it under UNIX.  If you have Qt for Windows, that should also work.
11
12To use this code:
13
14   1. follow the directions for the UNIX installation (in ../../sys/unix)
15      to create the Makefiles.
16
17   2. ../../include/config.h
18
19        define QT_GRAPHICS (search for it).  You can comment out
20        TTY_GRAPHICS if you want to, or leave it in to support both
21        interfaces (in which case be sure you have the right curses
22        libraries etc. required for that interface).
23
24   3. ../../src/Makefile
25
26	ensure your QTDIR environment variable was set correctly when
27	you installed Qt - $QTDIR/include/qwidget.h should exist, for
28	example.
29
30	ensure CXX and LD are set to the compiler and linker you need
31	for compiling and linking C++ software (e.g., set both to g++).
32
33        add $(WINQTSRC), $(WINQTOBJ), and $(WINQTLIB) to WINSRC, WINOBJ,
34        and WINLIB respectively, and compile.  This will give you an
35        executable supporting both Qt and tty windowing.
36
37   4. ../../Makefile (the top-level makefile)
38
39        change the VARDATND setting to contain the files "x11tiles"
40        and "rip.xpm".
41
42   5. Follow all the instructions in ../../sys/unix/Install.unx for
43      the remainder of the installation process.
44
45   6. Consider adding the lines below to your .nethackrc, as they are
46      likely to give the best interface for this window port:
47
48        OPTIONS=name:player,number_pad,menustyle:partial,!time,showexp
49        OPTIONS=hilite_pet,toptenwin,msghistory:200
50
51
52If you are using KDE, you may want to also try the KDE version. It just
53uses the KDE menubar and follows other KDE conventions - there is no
54extra functionality. To do so, first ensure that you have KDE 2.x
55libraries on your system (in 1999 KDE 1.x was the norm); then, add
56$(KDECXXFLAGS) to the CXXFLAGS definition, $(KDELFLAGS) to the LFLAGS
57definition and $(WINKDELIB) to WINLIB.  Some additional files here -
58knh-mini.xpm, knh.xpm, and knethack.lnk are useful if you want to
59install "knethack" in the KDE games directory.
60
61