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 Freedoom has normally seen all of its development on Unix-like
systems, nevertheless some people like to compile Freedoom on Windows. systems, nevertheless some people like to compile Freedoom on Windows.
This is possible, although complicated by our use of symbolic links in This is possible, although complicated by our choice of tooling for
the repository. While it may be possible to build software for the project.
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.
https://cygwin.com/[Cygwin] will thus be required to build Freedoom on It may be possible to use regular Windows versions of all the required
Windows, it should contain all the needed software except for DeuTex. software, but https://cygwin.com/[Cygwin] is highly recommended to
The previously-mentioned https://github.com/Doom-Utils/deutex[repository] recreate the Unix environment on this operating system anyway. It
contains some needed fixes for building and installing DeuTex on will simplify the process of building Freedoom greatly. The
Cygwin. 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 It is important that you install the Cygwin-specific versions of all
the required software. Native versions of Make, Python, ImageMagick, the required software. Native versions of Make, Python, ImageMagick,
and DeuTex will not understand the Cygwin-specific symbolic links, and DeuTex are not likely to interact well with Cygwin versions of the
which itself is *not* identical to the native method provided by software.
Windows Vista and newer.
As Cygwin provides a GNU system and interface on top of Windows, its 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 command line is (by default) Bash and not `cmd.exe`. Instructions on