diff options
| author | Tony Theodore <tonyt@logyst.com> | 2017-11-13 22:24:53 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2017-11-13 22:24:53 (GMT) |
| commit | dbdd7ae1f8e60fe1a436df4bd0308f54e98b44d9 (patch) | |
| tree | 0c362ba244180408450650fcbe10cef93b5a8783 | |
| parent | 89990ecabb469fe42dd2a3d9eba3da6657d844e9 (diff) | |
| parent | 226e6e8fa23f2de93e5baf14cb27f984b0ba02c9 (diff) | |
| download | mxe-dbdd7ae1f8e60fe1a436df4bd0308f54e98b44d9.zip mxe-dbdd7ae1f8e60fe1a436df4bd0308f54e98b44d9.tar.gz mxe-dbdd7ae1f8e60fe1a436df4bd0308f54e98b44d9.tar.bz2 | |
Merge pull request #1979 from tonytheodore/wsl-doc
docs: add Windows Subsystem for Linux notes
| -rw-r--r-- | docs/index.html | 41 |
1 files changed, 35 insertions, 6 deletions
diff --git a/docs/index.html b/docs/index.html index 5971ef2..82e8040 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,5 +1,5 @@ <!DOCTYPE html> -<html> +<html lang="en"> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"> @@ -136,6 +136,7 @@ </p> <p> How to choose MXE target: + </p> <ol> <li>If you want a 64 bit Windows executable, statically linked into one big executable: @@ -150,6 +151,7 @@ split into an executable and dependant dlls use MXE_TARGETS i686-w64-mingw32.shared.</li> </ol> + <p> Remark: The 'w64-mingw32' in those names are left-overs from historical evolutions in the open source cross-compilation world and refer in no way to the result being 64 or 32 bit Windows. @@ -542,6 +544,7 @@ USE_OSGPLUGIN(<plugin2>) <li><a href="#requirements-gentoo">Gentoo</a></li> <li><a href="#requirements-macos">Mac OS X</a></li> <li><a href="#requirements-opensuse">openSUSE</a></li> + <li><a href="#requirements-wsl">Windows Subsystem for Linux</a></li> </ul> <table class="requirements"> @@ -847,11 +850,9 @@ USE_OSGPLUGIN(<plugin2>) <p> Mac OS X versions ≤ 10.9 are no longer tested. </p> - <p> <h5>Certain packages have open issues on OS X</h5> - </p> <p> - For Xcode <7.3, run: + For Xcode <7.3, run: </p> <pre>make EXCLUDE_PKGS='nsis'</pre> @@ -872,6 +873,30 @@ USE_OSGPLUGIN(<plugin2>) gcc-32bit glibc-devel-32bit libgcc46-32bit \ libgomp46-32bit libstdc++46-devel-32bit</pre> + <h3 id="requirements-wsl">Windows Subsystem for Linux</h3> + + <p> + Requirements should match the Debian, Fedora, openSUSE etc. sections + above, but care should be taken to ensure MXE is installed in the + Linux subsystem under <code>/</code> instead of the mounted Windows + folders in <code>/mnt</code>. + </p> + + <p> + It can be <a href="https://github.com/mxe/mxe/issues/1892#issuecomment-344004704"> + made to work using symlinks and specifying</a>: + </p> + <pre>make MXE_TMP=/tmp/mxe-tmp ...</pre> + <p> + See further reading in: + </p> + <ul> + <li><a href="https://msdn.microsoft.com/en-us/commandline/wsl/faq#how-do-i-use-a-windows-file-with-a-linux-app"> + WSL FAQ file section</a></li> + <li><a href="https://blogs.msdn.microsoft.com/commandline/2016/11/17/do-not-change-linux-files-using-windows-apps-and-tools/"> + MSDN Blog</a></li> + </ul> + <h3 id="issue-non-multilib">Issues without a 32-bit compiler</h3> <p> @@ -1246,18 +1271,23 @@ local-pkg-list: $(LOCAL_PKG_LIST)</pre> </p> <p> To track releases set: + </p> <pre>$(PKG)_GH_CONF := owner/repo/releases[/latest][, tag prefix, tag suffix, tag filter-out, version separator]</pre> + <p> Releases may require setting _FILE, _SUBDIR, _URL, depending on the naming convention used by the project for tarballs. </p> <p> To track tags set: - <pre>$(PKG)_GH_CONF := owner/repo/tags[, tag prefix, tag suffix, tag filter-out, version separator]</pre> </p> + <pre>$(PKG)_GH_CONF := owner/repo/tags[, tag prefix, tag suffix, tag filter-out, version separator]</pre> <p> To track branches, set: + </p> <pre>$(PKG)_GH_CONF := owner/repo/branch</pre> + <p> See the following packages for examples: + </p> <ul> <li> <a href="https://github.com/mxe/mxe/blob/master/src/gc.mk">gc.mk</a> @@ -1277,7 +1307,6 @@ local-pkg-list: $(LOCAL_PKG_LIST)</pre> present in source tree </li> </ul> - </p> <p> The <a href="gmsl.html">GNU Make Standard Library</a> is also |