From 01aa0aedd5dbbe74f7bda645ac6d12574e091c07 Mon Sep 17 00:00:00 2001 From: Mike Swanson Date: Sat, 2 Jan 2016 08:22:47 -0800 Subject: [PATCH] COMPILING: Update the guide considering lack of symlinks --- COMPILING.adoc | 24 +++++++++++------------- 1 file changed, 11 insertions(+), 13 deletions(-) diff --git a/COMPILING.adoc b/COMPILING.adoc index 297e6dbf..bf9297c9 100644 --- a/COMPILING.adoc +++ b/COMPILING.adoc @@ -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