Docs for Wsl

Author: faze-geek

doc/src/installation.md

@@ -122,6 +122,77 @@ Before the first build you have to set up the `ZLib`-pathes: Go to the CMake-Set
 
 Then you can generate the CMake-Cache and build the project.
 
+## Build from Git on Windows with WSL
+* In windows search "turn windows features on or off".
+* Tick Windows subsystem for Linux.
+* Press OK and restart computer.
+* Go to Microsoft store and download Ubuntu 22.04, and launch it.
+* Run the following commands.
+
+```bash
+wget  https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-x86_64.sh -O miniconda.sh
+bash miniconda.sh -b -p $HOME/conda_root
+export PATH="$HOME/conda_root/bin:$PATH"
+```
+* Now do the following to configure the path
+```bash
+sudo nano .bashrc
+```
+* Then go to the bottom of the file and paste the following
+```bash
+export PATH="$HOME/conda_root/bin:$PATH"
+```
+* Then press ctrl + O (save), Enter (confirm), ctrl + X (exit)
+* After that restart Ubuntu
+* Run the following
+```bash
+conda create -n lp -c conda-forge llvmdev=11.0.1 bison=3.4 re2c python cmake make toml
+conda init bash
+```
+* Note that Conda is slow for installing packages with specified versions.
+* Instead use Mamba for faster installation, with the following commands
+```bash
+conda create -n lp -c conda-forge re2c python cmake make toml numpy
+conda install mamba -c conda-forge
+mamba install llvmdev=11.0.1 bison=3.4
+conda init bash
+```
+* Restart Ubuntu again
+```bash
+conda activate lp
+sudo apt update
+sudo apt-get install build-essential
+sudo apt-get install zlib1g-dev
+sudo apt install clang
+```
+* You can change the directory to a Windows location using `cd /mnt/[drive letter]/[windows location]`.
+* e.g. `cd mnt/c/Users/name/source/repos/`
+
+* Now clone the Lpython git repository
+```bash
+git clone https://github.com/lcompilers/lpython.git
+cd lpython
+```
+
+* Run the following commands
+```bash
+conda activate lp
+./build0.sh
+cmake -DCMAKE_BUILD_TYPE=Debug -DWITH_LLVM=yes -DCMAKE_INSTALL_PREFIX=`pwd`/inst .\
+make -j8
+```
+
+* If everything compiles, you can use Lpython as follows
+```bash
+./src/bin/lpython examples/expr2.py
+```
+
+* Run tests
+```bash
+ctest
+./run_tests.py
+```
+
 ## Enabling the Jupyter Kernel
 
 To install the Jupyter kernel, install the following Conda packages also: