nethack-gwaa-kiwi/nethack
1
0
Fork 0
Code Pull Requests Activity

update bottom of NewInstall.unx document with WANT_WIN_ build steps

Browse Source
This commit is contained in:
nhmall
2020-08-13 13:34:18 -04:00
parent 674021428d
commit c67ef6acf8
1 changed files with 102 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

103
sys/unix/NewInstall.unx
View File

@@ -29,6 +29,9 @@ If you are using the traditional configuration system, see Install.unx.
If the build fails, remove all the generated files before retrying the
build with: cd $Top; make spotless
See the "User Interface Build Customizations" section below if you want to
configure your build with support for interfaces beyond traditional TTY.
The 'make fetch-Lua' step really only needs to be done one time unless
your sources get refreshed, or the lib folder and its contents get
removed.
@@ -45,6 +48,104 @@ If you are using the traditional configuration system, see Install.unx.
5. If it all worked, you're done. If something went wrong, see Install.unx
for information about the settings the hints file tried to automate.
# NetHack 3.7 NewInstall.unx $NHDT-Date: 1596498295 2020/08/03 23:44:55 $ $NHDT-Branch: NetHack-3.7 $:$NHDT-Revision: 1.5 $
=======================================
* User Interface Build Customizations *
=======================================
NetHack can support multiple user interfaces within the same binary on many
platforms. The various interface options can be specified by defining specific
variables, either on the make command line, or by setting environment variables
prior to the "make all" and "make install" steps. If you dont specify any
WANT_WIN_* customization, the build will only include traditional tty support.
As an example, to build a binary with tty + curses + X11 support, you can use
the following build command:
make WANT_WIN_TTY=1 WANT_WIN_CURSES=1 WANT_WIN_X11=1 all
make WANT_WIN_TTY=1 WANT_WIN_CURSES=1 WANT_WIN_X11=1 install
To build a binary with tty + curses + X11 + Qt support (that is, all the
available interaces that are supported, you can use the following shorthand
build command:
make WANT_WIN_ALL all
make WANT_WIN_ALL install
Alternatively, you can set the variables in the environment first, prior
to issuing your make commands:
export WANT_WIN_TTY=1
export WANT_WIN_X11=1
make all
make install
That example above will result in a build with support for tty + X11.
Note that curses, X11, and Qt will almost certainly require the installation
of prerequisite packages in order to successfully build with support for
additional interfaces. See below.
+----------+---------+-----------------+-------------------------------------+
| Platform |Interface| Build Variable | Prerequisite package |
|----------+---------+-----------------+-------------------------------------|
| MacOS | tty | WANT_WIN_TTY | none |
|----------+---------+-----------------+-------------------------------------|
| MacOS | curses | WANT_WIN_CURSES | ncurses development libraries |
|----------+---------+-----------------+-------------------------------------|
| MacOS | X11 | WANT_WIN_X11 | You will need to obtain and |
| | | | install XQuartz if you want X11 |
| | | | support in your build. |
| | | | (Attempting to run X11.app will |
| | | | describe where to get it) |
| | | | |
| | | | One possible way: |
| | | | brew install xquartz |
|----------+---------+-----------------+-------------------------------------|
| MacOS | Qt | WANT_WIN_QT | You will need to obtain and |
| | | | install Qt if you want Qt |
| | | | support in your build. |
| | | | |
| | | | One possible way: |
| | | | brew install Qt |
|----------+---------+-----------------+-------------------------------------|
| Linux | tty | WANT_WIN_TTY | |
| (Ubuntu) | | | |
|----------+---------+-----------------+-------------------------------------|
| Linux | curses | WANT_WIN_CURSES | If it isn't already included |
| (Ubuntu) | | | in your distribution, here is one |
| | | | possible way: |
| | | | |
| | | | sudo apt-get install libncurses-dev |
|----------+---------+-----------------+-------------------------------------|
| Linux | X11 | WANT_WIN_X11 | Here is one possible way to obtain |
| (Ubuntu) | | | the required packages: |
| | | | |
| | | |sudo apt-get install libx11-dev |
| | | |sudo apt-get install libmotif-dev |
| | | |sudo apt-get install libxaw7-dev |
| | | |sudo apt install xfonts-utils |
| | | |(That last one is for bdftopcf and |
| | | | mkfontdir utils) |
| | | | |
|----------+---------+-----------------+-------------------------------------|
| Linux | Qt | WANT_WIN_QT | Here is one possible way to obtain |
| (Ubuntu) | | | the required packages: |
| | | | |
| | | |sudo apt-get install qtbase5-dev |
| | | |sudo apt-get install qtmultimedia-dev|
| | | | |
| | | |Another odd note about Qt on Linux is|
| | | |that if you find you are getting the |
| | | |following error trying to run NetHack|
| | | |after you build it with Qt support: |
| | | |"error while loading shared |
| | | |libraries: libQt5Core.so.5: cannot |
| | | |open shared object file: No such file|
| | | |or directory", |
| | | |you may have to fix that (one-time) |
| | | |by issuing the command below: |
| sudo strip \ |
| --remove-section=.note.ABI-tag/usr/lib/x86_64-linux-gnu/libQt5Core.so.5 |
+----------+---------+-----------------+-------------------------------------+
# NetHack 3.7 NewInstall.unx $NHDT-Date: 1597340052 2020/08/13 17:34:12 $ $NHDT-Branch: NetHack-3.7 $:$NHDT-Revision: 1.6 $
# Copyright (c) 2009 by Kenneth Lorber, Kensington, Maryland
# NetHack may be freely redistributed. See license for details.