COMPILING: Update the guide considering lack of symlinks

This commit is contained in:
Mike Swanson 2016-01-02 08:22:47 -08:00
parent fc42061b45
commit 01aa0aedd5

View file

@ -62,23 +62,21 @@ Building on Microsoft Windows
Freedoom has normally seen all of its development on Unix-like
systems, nevertheless some people like to compile Freedoom on Windows.
This is possible, although complicated by our use of symbolic links in
the repository. While it may be possible to build software for
Windows Vista and newer utilizing native NTFS symbolic links, none of
the required software in the Freedoom build process supports them in a
``native'' Win32-API-only manner.
This is possible, although complicated by our choice of tooling for
the project.
https://cygwin.com/[Cygwin] will thus be required to build Freedoom on
Windows, it should contain all the needed software except for DeuTex.
The previously-mentioned https://github.com/Doom-Utils/deutex[repository]
contains some needed fixes for building and installing DeuTex on
Cygwin.
It may be possible to use regular Windows versions of all the required
software, but https://cygwin.com/[Cygwin] is highly recommended to
recreate the Unix environment on this operating system anyway. It
will simplify the process of building Freedoom greatly. The
previously-mentioned https://github.com/Doom-Utils/deutex[DeuTex
repository] will require a C compiler (such as `gcc` or `clang`) to be
installed in order to build.
It is important that you install the Cygwin-specific versions of all
the required software. Native versions of Make, Python, ImageMagick,
and DeuTex will not understand the Cygwin-specific symbolic links,
which itself is *not* identical to the native method provided by
Windows Vista and newer.
and DeuTex are not likely to interact well with Cygwin versions of the
software.
As Cygwin provides a GNU system and interface on top of Windows, its
command line is (by default) Bash and not `cmd.exe`. Instructions on