From bf0d21d97d7f1a67ab64e77c39f9f2b5b8e48885 Mon Sep 17 00:00:00 2001 From: Bryson Steck Date: Thu, 24 Mar 2022 15:45:27 -0600 Subject: added wsl instructions --- INSTALL.rst | 24 ++++++++++++++++++++---- 1 file changed, 20 insertions(+), 4 deletions(-) diff --git a/INSTALL.rst b/INSTALL.rst index ffac132..3ebd071 100644 --- a/INSTALL.rst +++ b/INSTALL.rst @@ -1,6 +1,13 @@ Installation ============= +Instructions are available for the following operating systems: +* `Linux/BSD <#linuxbsd>`_ +* `Windows <#windows>`_ + +Linux/BSD +========== + To install ``uirc``, you need to have the following items: * A C compiler (``uirc`` uses ``gcc`` by default, but you can change what compiler you use in the `config.mk file `_.) @@ -58,12 +65,10 @@ FreeBSD/OpenBSD ---------------- .. code:: bash - $ doas pkg_add git curl - # in BSD, you must install the 'stb' library manually from GitHub. - # in order to do this, make sure wget is installed with: - $ doas pkg_add wget + $ doas pkg_add git curl wget # then, clone the repository and install the 'stb' library: $ git clone https://github.com/brysonsteck/uirc && cd uirc + # in BSD, you must install the 'stb' library manually from GitHub. do this with: $ doas make stb To build ``uirc`` on BSD, you need to uncomment the OPTIONS line at the bottom of the `config.mk `_ file. Additionally, if you would rather use ``cc`` instead of ``gcc``, you can change that in this file as well. Then, you can continue with the instructions. @@ -74,3 +79,14 @@ To build ``uirc`` on BSD, you need to uncomment the OPTIONS line at the bottom o $ make # or, if you want to install globally, use: $ doas make install + +Windows +======== + +To build on Windows, you need to install a Linux distribution through WSL. This can be done with the following command in Command Prompt:: + + >wsl --install + +Once installed and you set up your user account, run ``sudo apt update && sudo apt upgrade`` and confirm to install the updates. Let it sit here, this might take a while. + +Once you have updated your WSL instance, read the `Linux <#linuxbsd>`_ section above, following instructions for your WSL distribution (if you followed this guide to install, you will be following instructions for Debian). -- cgit v1.2.3