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)
_______________________________________________ devel mailing list devel@rtems.org http://lists.rtems.org/mailman/listinfo/devel
