aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README21
-rw-r--r--manifest8
2 files changed, 23 insertions, 6 deletions
diff --git a/README b/README
index eb244c0..def94df 100644
--- a/README
+++ b/README
@@ -1,2 +1,19 @@
-Note that while this project is called msvc-linux, you may be able to use it
-on other UNIX-like systems supported by Wine.
+Cross-compiling from UNIX to Windows with MSVC using Wine.
+
+NOTE: we no longer recommend using this approach unless you absolutely
+must. Firstly, the whole setup is very hacky and brittle (and potentially
+illegal: we were told it's against the license to run MSVC like that) and
+often doesn't work with the most recent versions of MSVC (because Wine hasn't
+caught up on the new APIs yet). Also, there are edge cases where build2 does
+not fully support this "mode" of running MSVC. It works for projects that
+don't do anything unusual, but, for example, you won't be able to build
+anything that requires MASM. We believe if you must test with MSVC, the only
+sane way to do it is with a Windows VM (which is what we do on our CI). If you
+just need to test that your code builds for Windows, another option is to use
+Clang and the LLVM linker (lld-link) as a cross-compiler. With this approach
+you will only need to copy the MSVC standard library and PlatformSDK (and
+won't need to mess with Wine).
+
+See INSTALL for setup instructions. Note that while this project is called
+msvc-linux, you may be able to use it on other UNIX-like systems supported
+by Wine.
diff --git a/manifest b/manifest
index 7af3f8f..72d1095 100644
--- a/manifest
+++ b/manifest
@@ -1,6 +1,6 @@
: 1
name: msvc-linux
-version: 0.15.0-a.0.z
+version: 0.17.0-a.0.z
project: build2
summary: MS Visual C++ as cross-compiler driver scripts
license: MIT
@@ -14,6 +14,6 @@ src-url: https://git.build2.org/cgit/etc/msvc-linux/tree/
email: users@build2.org
build-warning-email: builds@build2.org
requires: c++14
-depends: * build2 >= 0.14.0-
-depends: * bpkg >= 0.14.0-
-depends: libbutl [0.15.0-a.0.1 0.15.0-a.1)
+depends: * build2 >= 0.16.0-
+depends: * bpkg >= 0.16.0-
+depends: libbutl [0.17.0-a.0.1 0.17.0-a.1)