From a7f502259131190195542abc71a3b6e3270d9062 Mon Sep 17 00:00:00 2001 From: Paul Sokolovsky Date: Sun, 30 Apr 2017 00:37:05 +0300 Subject: [PATCH] windows/README: Convert to Markdown. --- windows/{README => README.md} | 49 ++++++++++++++++++++--------------- 1 file changed, 28 insertions(+), 21 deletions(-) rename windows/{README => README.md} (54%) diff --git a/windows/README b/windows/README.md similarity index 54% rename from windows/README rename to windows/README.md index 4b383eaed3..b181908fe8 100644 --- a/windows/README +++ b/windows/README.md @@ -4,53 +4,60 @@ The port requires additional testing, debugging, and patches. Please consider to contribute. -To cross-compile under Debian/Ubuntu Linux system: +Building on Debian/Ubuntu Linux system +--------------------------------------- -sudo apt-get install gcc-mingw-w64 -make CROSS_COMPILE=i686-w64-mingw32- + sudo apt-get install gcc-mingw-w64 + make CROSS_COMPILE=i686-w64-mingw32- If for some reason the mingw-w64 crosscompiler is not available, you can try mingw32 instead, but it comes with a really old gcc which may produce some spurious errors (you may need to disable -Werror): -sudo apt-get install mingw32 mingw32-binutils mingw32-runtime -make CROSS_COMPILE=i586-mingw32msvc- + sudo apt-get install mingw32 mingw32-binutils mingw32-runtime + make CROSS_COMPILE=i586-mingw32msvc- -To compile under Cygwin: +Bulding under Cygwin +-------------------- Install following packages using cygwin's setup.exe: -mingw64-i686-gcc-core, mingw64-x86_64-gcc-core, make + +* mingw64-i686-gcc-core +* mingw64-x86_64-gcc-core +* make + Build using: -make CROSS_COMPILE=i686-w64-mingw32- + make CROSS_COMPILE=i686-w64-mingw32- -or for 64bit: +Or for 64bit: -make CROSS_COMPILE=x86_64-w64-mingw32- + make CROSS_COMPILE=x86_64-w64-mingw32- -To compile using Visual Studio 2013 (or higher): +Building using MS Visual Studio 2013 (or higher) +------------------------------------------------ -Open micropython.vcxproj and build +In IDE, open `micropython.vcxproj` and build. + +To build from command line: + + msbuild micropython.vcxproj -To compile using Visual Studio 2013 (or higher) commandline: - -msbuild micropython.vcxproj - - -To run on Linux using Wine: +Running on Linux using Wine +--------------------------- The default build (MICROPY_USE_READLINE=1) uses extended Windows console -functions and thus should be run using "wineconsole" tool. Depending +functions and thus should be run using `wineconsole` tool. Depending on the Wine build configuration, you may also want to select the curses backend which has the look&feel of a standard Unix console: wineconsole --backend=curses ./micropython.exe -For more info, see https://www.winehq.org/docs/wineusr-guide/cui-programs +For more info, see https://www.winehq.org/docs/wineusr-guide/cui-programs . If built without line editing and history capabilities (MICROPY_USE_READLINE=0), the resulting binary can be run using the standard -"wine" tool. +`wine` tool.