some Windows build doc updates and typo fixes
This commit is contained in:
@@ -23,7 +23,7 @@ We provide documentation for the follow three different approaches
|
|||||||
and tool suites that may be used to compile and package
|
and tool suites that may be used to compile and package
|
||||||
NetHack for Windows:
|
NetHack for Windows:
|
||||||
|
|
||||||
1. With the Visusal Studio Integrated Development Environment (IDE).
|
1. With the Visual Studio Integrated Development Environment (IDE).
|
||||||
The steps are documented in sys/windows/build-vs.txt.
|
The steps are documented in sys/windows/build-vs.txt.
|
||||||
|
|
||||||
2. At the Windows command line, using Visual Studio's nmake.exe.
|
2. At the Windows command line, using Visual Studio's nmake.exe.
|
||||||
|
|||||||
@@ -1,26 +1,33 @@
|
|||||||
Building NetHack using the Visual Studio IDE
|
Building NetHack using MSYS2
|
||||||
|
|
||||||
Prerequisite Requirements:
|
Prerequisite Requirements:
|
||||||
|
|
||||||
MSYS2
|
o MSYS2
|
||||||
- https://www.msys2.org/
|
- https://www.msys2.org/
|
||||||
- Download the installer, and start the UCRT64 shell.
|
- Download the installer, and start the UCRT64 shell.
|
||||||
then
|
then
|
||||||
pacman -S mingw-w64-ucrt-x86_64-gcc
|
pacman -S mingw-w64-ucrt-x86_64-gcc
|
||||||
pacman -S git
|
pacman -S git
|
||||||
pacman -S vim (or your editor of choice)
|
pacman -S vim (or your editor of choice)
|
||||||
pacman -S man (otherwise "git help foo" will not work)
|
pacman -S man (otherwise "git help foo" will not work)
|
||||||
|
o Lua
|
||||||
|
NetHack 3.7 for Windows requires 3rd party Lua source that is not part
|
||||||
|
of the NetHack distribution or repository.
|
||||||
|
|
||||||
OR
|
A windows cmd command procedure for fetching prerequisite sources
|
||||||
|
is available, and can be run as follows from the top of the
|
||||||
|
NetHack source tree to obtain lua:
|
||||||
|
sys\windows\fetch.cmd lua
|
||||||
|
o pdcursesmod (Only required if curses interface support is desired)
|
||||||
|
If you want to include curses interface support in NetHack 3.7 for
|
||||||
|
3rd part pdcursesmod source code is required and is not part of the
|
||||||
|
NetHack distribution or repository.
|
||||||
|
|
||||||
|
A windows cmd command procedure for fetching prerequisite
|
||||||
|
sources is available, and can be run as follows from the top of
|
||||||
|
the NetHack source tree to obtain pdcursesmod:
|
||||||
|
sys\windows\fetch.cmd pdcursesmod
|
||||||
|
|
||||||
[the follow is untested]
|
|
||||||
MinGW-w64 - winlibs standalone build
|
|
||||||
- https://github.com/brechtsanders/winlibs_mingw
|
|
||||||
- Download one of the releases from
|
|
||||||
https://github.com/brechtsanders/winlibs_mingw/releases
|
|
||||||
and extract the contents into a folder (ideally in a folder
|
|
||||||
without spaces in the path), and add the location of the
|
|
||||||
subfolder containing gcc.exe to your PATH.
|
|
||||||
|
|
||||||
/---------------------------------------------\
|
/---------------------------------------------\
|
||||||
| Directories for a Windows NetHack build |
|
| Directories for a Windows NetHack build |
|
||||||
@@ -143,5 +150,14 @@ Notes:
|
|||||||
For Microsoft compiler:
|
For Microsoft compiler:
|
||||||
make -f Makefile.mingw32
|
make -f Makefile.mingw32
|
||||||
|
|
||||||
|
2. An alternative to MSYS2 may be MinGW-w64 - winlibs standalone build.
|
||||||
|
That has not been tested by us at time of writing.
|
||||||
|
MinGW-w64 - winlibs standalone build
|
||||||
|
- https://github.com/brechtsanders/winlibs_mingw
|
||||||
|
- Download one of the releases from
|
||||||
|
https://github.com/brechtsanders/winlibs_mingw/releases
|
||||||
|
and extract the contents into a folder (ideally in a folder
|
||||||
|
without spaces in the path), and add the location of the
|
||||||
|
subfolder containing gcc.exe to your PATH.
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1,30 @@
|
|||||||
Building NetHack using the Visual Studio IDE
|
Building NetHack using the Visual Studio nmake from the command line
|
||||||
|
|
||||||
Prerequisite Requirements:
|
Prerequisite Requirements:
|
||||||
|
|
||||||
|
o Visual Studio Community Edition
|
||||||
|
A copy of Microsoft Visual Studio Community Edition needs to
|
||||||
|
be installed on your machine. See:
|
||||||
|
https://visualstudio.microsoft.com/vs/community/
|
||||||
|
o Lua
|
||||||
|
NetHack 3.7 for Windows requires 3rd party Lua source that is not part
|
||||||
|
of the NetHack distribution or repository.
|
||||||
|
|
||||||
|
A windows cmd command procedure for fetching prerequisite sources
|
||||||
|
is available, and can be run as follows from the top of the
|
||||||
|
NetHack source tree to obtain lua:
|
||||||
|
sys\windows\fetch.cmd lua
|
||||||
|
o pdcursesmod (Only required if curses interface support is desired)
|
||||||
|
If you want to include curses interface support in NetHack 3.7 for
|
||||||
|
3rd part pdcursesmod source code is required and is not part of the
|
||||||
|
NetHack distribution or repository.
|
||||||
|
|
||||||
|
A windows cmd command procedure for fetching prerequisite
|
||||||
|
sources is available, and can be run as follows from the top of
|
||||||
|
the NetHack source tree to obtain pdcursesmod:
|
||||||
|
sys\windows\fetch.cmd pdcursesmod
|
||||||
|
|
||||||
|
|
||||||
A copy of Microsoft Visual Studio Community Edition needs to
|
A copy of Microsoft Visual Studio Community Edition needs to
|
||||||
be installed on your machine, and the Lua prerequisite source
|
be installed on your machine, and the Lua prerequisite source
|
||||||
files are required as outlined in sys/windows/Install.windows.
|
files are required as outlined in sys/windows/Install.windows.
|
||||||
@@ -39,28 +62,6 @@ You can use one of the following build environments:
|
|||||||
| Visual Studio Community Editions |
|
| Visual Studio Community Editions |
|
||||||
\-----------------------------------------------------------/
|
\-----------------------------------------------------------/
|
||||||
|
|
||||||
Required components that are not bundled in the NetHack repository, but
|
|
||||||
are required to build NetHack yourself.
|
|
||||||
|
|
||||||
Lua
|
|
||||||
NetHack 3.7 for Windows requires 3rd party Lua source that is not part
|
|
||||||
of the NetHack distribution or repository.
|
|
||||||
|
|
||||||
A windows cmd command procedure for fetching prerequisite
|
|
||||||
sources is available, and can be run as follows from the top of
|
|
||||||
the NetHack source tree to obtain lua:
|
|
||||||
sys\windows\fetch.cmd lua
|
|
||||||
|
|
||||||
Curses
|
|
||||||
If you want to include curses interface support in NetHack 3.7 for
|
|
||||||
3rd part pdcursesmod source code is required and is not part of the
|
|
||||||
NetHack distribution or repository.
|
|
||||||
|
|
||||||
A windows cmd command procedure for fetching prerequisite
|
|
||||||
sources is available, and can be run as follows from the top of
|
|
||||||
the NetHack source tree to obtain pdcursesmod:
|
|
||||||
sys\windows\fetch.cmd pdcursesmod
|
|
||||||
|
|
||||||
Building
|
Building
|
||||||
|
|
||||||
Two different versions of NetHack will be built for Windows from the
|
Two different versions of NetHack will be built for Windows from the
|
||||||
|
|||||||
@@ -2,16 +2,35 @@ Building NetHack using the Visual Studio IDE
|
|||||||
|
|
||||||
Prerequisite Requirements:
|
Prerequisite Requirements:
|
||||||
|
|
||||||
A copy of Microsoft Visual Studio Community Edition needs to
|
o Visual Studio Community Edition
|
||||||
be installed on your machine, and the Lua prerequisite source
|
A copy of Microsoft Visual Studio Community Edition needs to
|
||||||
files are required as outlined in sys/windows/Install.windows.
|
be installed on your machine. See:
|
||||||
|
https://visualstudio.microsoft.com/vs/community/
|
||||||
|
o Lua
|
||||||
|
NetHack 3.7 for Windows requires 3rd party Lua source that is not part
|
||||||
|
of the NetHack distribution or repository.
|
||||||
|
|
||||||
The nmake build Makefiles and procedures produce two executable
|
A windows cmd command procedure for fetching prerequisite sources
|
||||||
|
is available, and can be run as follows from the top of the
|
||||||
|
NetHack source tree to obtain lua:
|
||||||
|
sys\windows\fetch.cmd lua
|
||||||
|
o pdcursesmod (Only required if curses interface support is desired)
|
||||||
|
If you want to include curses interface support in NetHack 3.7 for
|
||||||
|
3rd part pdcursesmod source code is required and is not part of the
|
||||||
|
NetHack distribution or repository.
|
||||||
|
|
||||||
|
A windows cmd command procedure for fetching prerequisite
|
||||||
|
sources is available, and can be run as follows from the top of
|
||||||
|
the NetHack source tree to obtain pdcursesmod:
|
||||||
|
sys\windows\fetch.cmd pdcursesmod
|
||||||
|
|
||||||
|
This processes produces a zip file containing two executable
|
||||||
versions:
|
versions:
|
||||||
|
|
||||||
a. A TTY and curses version of NetHack in nethack.exe
|
a. A TTY and curses version of NetHack in nethack.exe
|
||||||
b. A Windows and curses graphical version in nethackw.exe.
|
b. A Windows and curses graphical version in nethackw.exe.
|
||||||
|
|
||||||
|
|
||||||
/---------------------------------------------\
|
/---------------------------------------------\
|
||||||
| Directories for a Windows NetHack build |
|
| Directories for a Windows NetHack build |
|
||||||
\---------------------------------------------/
|
\---------------------------------------------/
|
||||||
|
|||||||
Reference in New Issue
Block a user