[PATCH] Add Windows Subsystem for Linux to RSB Doc

[Alan Cudmore]

 doc/source-builder.txt | 56
+++++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 44 insertions(+), 12 deletions(-)

diff --git a/doc/source-builder.txt b/doc/source-builder.txt
index 3bcc397..d676e63 100644
--- a/doc/source-builder.txt
+++ b/doc/source-builder.txt
@@ -39,7 +39,7 @@ from source and taught this tool. The RTEMS Source
Builder has been tested on:
 * <<_freebsd,FreeBSD>>
 * <<_netbsd,NetBSD>>
 * <<_macos,MacOS>>
-* <<_mint,Linux Mint>>
+* <<_linuxmint,LinuxMint>>
 * <<_opensuse,openSUSE>>
 * <<_raspbian,Raspbian>>
 * <<_ubuntu,Ubuntu>>
@@ -3112,6 +3112,15 @@ $ sudo apt-get build-dep binutils gcc g++ gdb unzip
git
 $ sudo apt-get install python2.7-dev
 -------------------------------------------------------------

+LinuxMint
+^^^^^^^^^
+zlib package is required on Linux Mint. It has a different name (other
+than the usual zlib-dev):
+
+-------------------------------------------------------------
+# sudo apt-get install zlib1g-dev
+-------------------------------------------------------------
+
 FreeBSD
 ~~~~~~~

@@ -3157,16 +3166,6 @@ The RTEMS Source Builder has been tested on Mountain
Lion. You will need to
 install the Xcode app using the _App Store_ tool, run Xcode and install the
 Developers Tools package within Xcode.

-Linux Mint
-^^^^^^^^^^
-
-zlib package is required on Linux Mint. It has a different name (other
-than the usual zlib-dev):
-
--------------------------------------------------------------
-# sudo apt-get install zlib1g-dev
--------------------------------------------------------------
-
 Mavericks
 ^^^^^^^^^

@@ -3204,13 +3203,15 @@ debugging experiences may vary and if this is an
issue please raised the topic
 on the RTEMS Users mailing list.

 Building the tools or some other packages may require a Unix or POSIX type
-shell. There are a few options, Cygwin and MSYS2. I recommend MSYS2.
+shell. There are a few options, Cygwin, MSYS2, and Windows Subsystem for
Linux
+(WSL) on Windows 10 with the 2016 Windows Anniversary Update. I recommend
MSYS2.

 .Ready To Go Windows Tools
 NOTE: From time to time I provide tools for Windows at
 http://ftp.rtems.org/pub/rtems/people/chrisj/source-builder/4.11/mingw32/

 MSYS2
+^^^^^

 This is a new version of the old MinGW project's original MSYS based
around the
 Arch Linux pacman packager. MSYS and MSYS2 are a specific fork of the
Cygwin
@@ -3237,6 +3238,7 @@ Install a suitable version of Python from
http://www.python.org/ and add it to
 the start of your path. The MSYS2 python does not work with waf.

 Cygwin
+^^^^^^

 Building on Windows is a little more complicated because the Cygwin shell
is
 used rather than the MSYS2 shell. The MSYS2 shell is simpler because the
@@ -3352,6 +3354,36 @@ reasons they cannot be avoided in all cases. Cygwin
and it's fork MSYS are
 fantastic pieces of software in a difficult environment. I have found
building
 a single tool tends to work, building all at once is harder.

+Windows Subsystem for Linux (WSL)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The Windows Subsystem for Linux is a port of the user mode binaries from
+Ubuntu 14.04 LTS to Windows 10. It was first made available in the August
2016
+Windows 10 Anniversary Update.
+
+WSL installs a Bash shell and many of the Ubuntu command line linux
utilities
+including a fully working apt-get command. Graphical or X-Windows
applciations
+are not supported.
+
+.Installing WSL
+NOTE: There are many articles on the internet describing how to install
WSL.
+Here is an example:
+https://msdn.microsoft.com/en-us/commandline/wsl/install_guide
+
+Once WSL is installed, using the RTEMS Source Builder is nearly the same as
+as using it on Ubuntu Linux 14.04. I had to install the following packages
+to allow RSB to work on WSL
+
+-------------------------------------------------------------
+$ sudo apt-get install autoconf automake bison flex binutils gcc \
+g++ gdb texinfo unzip ncurses-dev python-dev git zlib1g-dev make
+-------------------------------------------------------------
+
+Once the RSB toolchain is compiled, I was able to add the toolchain to my
path
+by editing .bashrc in my WSL home directory. For some reason, .profile was
not
+run when starting a bash shell like it does when logging into a real Ubuntu
+system.
+

 Build Status By Host
 ~~~~~~~~~~~~~~~~~~~~
-- 
2.7.4 (Apple Git-66)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20160817/1ae93c46/attachment-0001.html>