From c01428c764dcc67345155109258a560ce09cddb7 Mon Sep 17 00:00:00 2001
From: Daniel Stenberg <daniel@haxx.se>
Date: Mon, 8 Apr 2024 10:05:56 +0200
Subject: [PATCH] build/windows: remove custom visual studio mention, use cmake

We recommend using cmake to generate the build files. Also mention mingw
support.
---
 build/windows.md | 88 +++++-------------------------------------------
 1 file changed, 8 insertions(+), 80 deletions(-)

diff --git a/build/windows.md b/build/windows.md
index c3b951c54..864736737 100644
--- a/build/windows.md
+++ b/build/windows.md
@@ -24,88 +24,16 @@ this (split into several lines for readability):
 
 ## Visual C++ project files
 
-curl tarballs ship with pre-generated project files that you can load and
-build curl with.
+Using [CMake](cmake.md), you can generate a set of Visual Studio project
+files:
 
-Project files are provided for several different Visual C++ versions.
+    cmake -B build -G 'Visual Studio 17 2022'
 
-To build with VC++, you need to first install VC++ which is part of Visual
-Studio.
+Once generated, you import them and build with Visual Studio like normally.
 
-Once you have VC++ installed you should launch the application and open one of
-the solution or workspace files. The VC directory names are based on the
-version of Visual C++ that you use. Each version of Visual Studio has a
-default version of Visual C++. We offer these versions:
+## Mingw
 
- - VC14      (Visual Studio 2015 Version 14.0)
- - VC14.10   (Visual Studio 2017 Version 15.0)
- - VC14.20   (Visual Studio 2019 Version 16.0)
- - VC14.30   (Visual Studio 2022 Version 17.0)
+You can build curl with the mingw compiler suite. Use [CMake](cmake.md) to
+generate the set of Makefiles for you:
 
-Separate solutions are provided for both libcurl and the curl command line
-tool as well as a solution that includes both projects. libcurl.sln, curl.sln
-and curl-all.sln, respectively. We recommend using curl-all.sln to build both
-projects.
-
-For example, if you are using Visual Studio 2022 then you should be able to
-use `VC14.30\curl-all.sln` to build curl and libcurl.
-
-## Running DLL based configurations
-
-If you are a developer and plan to run the curl tool from Visual Studio (eg
-you are debugging) with any third-party libraries (such as OpenSSL, wolfSSL or
-libSSH2) then you need to add the search path of these DLLs to the
-configuration's PATH environment. To do that:
-
- 1. Open the 'curl-all.sln' or 'curl.sln' solutions
- 2. Right-click on the 'curl' project and select Properties
- 3. Navigate to 'Configuration Properties > Debugging > Environment'
- 4. Add `PATH='Path to DLL';C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem`
-
-... where 'Path to DLL` is the configuration specific path. For example the
-following configurations in Visual Studio 2010 might be:
-
-DLL Debug - DLL OpenSSL (Win32):
-
-    PATH=C:\openssl\build\Win32\VC10\DLL Debug;C:\Windows\system32;
-    C:\Windows;C:\Windows\System32\Wbem
-
-DLL Debug - DLL OpenSSL (x64):
-
-    PATH=C:\openssl\build\Win64\VC10\DLL Debug;C:\Windows\system32;
-    C:\Windows;C:\Windows\System32\Wbem
-
-DLL Debug - DLL wolfSSL (Win32):
-
-    PATH=C:\wolfssl\build\Win32\VC10\DLL Debug;C:\Windows\system32;
-    C:\Windows;C:\Windows\System32\Wbem
-
-DLL Debug - DLL wolfSSL (x64):
-
-    PATH=C:\wolfssl\build\Win64\VC10\DLL Debug;C:\Windows\system32;
-    C:\Windows;C:\Windows\System32\Wbem
-
-If you are using a configuration that uses multiple third-party library DLLs
-(such as `DLL Debug - DLL OpenSSL - DLL LibSSH2`) then 'Path to DLL` needs to
-contain the path to both of these.
-
-## Notes
-
-The following keywords have been used in the directory hierarchy:
-
- - `<platform>`      - The platform (For example: Windows)
- - `<ide>`           - The IDE (For example: VC10)
- - `<architecture>`  - The platform architecture (For example: Win32, Win64)
- - `<configuration>` - The target configuration (For example: DLL Debug, LIB
-   Release - LIB OpenSSL)
-
-If you are using the source code from the git repository, rather than a
-release archive or nightly build, you need to generate the project
-files. Please run "generate -help" for usage details.
-
-Should you wish to help out with some of the items on the TODO list, or find
-bugs in the project files that need correcting, and would like to submit
-updated files back then please note that, whilst the solution files can be
-edited directly, the templates for the project files (which are stored in the
-git repository) need to be modified rather than the generated project files
-that Visual Studio uses.
+    cmake -B build -G "MinGW Makefiles"