From 157716ab35d5960e8330d646cacdf10e9c24cbe5 Mon Sep 17 00:00:00 2001 From: Louie S Date: Fri, 24 Feb 2023 16:11:05 -0800 Subject: Update documentation to reflect new build system --- docs/README.md | 28 +++++++++++++++++++--------- docs/windows_compile_instructions.md | 14 ++++++-------- 2 files changed, 25 insertions(+), 17 deletions(-) diff --git a/docs/README.md b/docs/README.md index fed6c1e..8219ebd 100644 --- a/docs/README.md +++ b/docs/README.md @@ -6,17 +6,24 @@ For Windows instructions, see [here](windows_compile_instructions.md) -terminal-media-launcher can be compiled on any system with make, gcc, and the ncurses library (libncurses-dev) installed. It can be compiled and installed on any Linux distribution, and can also be compiled and run on Windows 10. To compile and run terminal-media-launcher: +terminal-media-launcher can be compiled on any system with make, gcc, and the ncurses development library installed. It can be compiled and installed on any Linux distribution, and can also be compiled and run on Microsoft Windows. To compile and run terminal-media-launcher: -1. Clone the repository -2. Run the commands below in the directory the repository was cloned into. This will build the binary `src/terminal-media-launcher` +1. Install dependencies. On Debian and Debian-based systems: + +``` +# apt install gcc libncurses-dev make +``` + +2. Download the latest `.tar.gz` release + - The source acquired from the source repository can also be compiled, but requires additional dependencies to build (`autoconf`, `automake`, `autoconf-archive`) +3. Run the commands below in the directory the repository was cloned into. This will build the binary `src/terminal-media-launcher` ``` $ ./configure $ make ``` -3. To run the program: +4. To run the program: ``` $ src/terminal-media-launcher @@ -26,19 +33,21 @@ Note that terminal-media-launcher will not run until you have created a configur ### Installation -terminal-media-launcher can be installed on Linux by running: +terminal-media-launcher can be installed by running: ``` -sudo make install +make install ``` -This will install `terminal-media-launcher` to `/usr/local/bin/terminal-media-launcher` as well as man pages `terminal-media-launcher` and `terminal-media-launcher-config`. To uninstall these files: ``` -sudo make uninstall +make uninstall ``` +By default, the program and related files are installed with prefix `/usr/local`, but this prefix can be changed with `./configure --prefix=PREFIX` flag (i.e., `./configure --prefix=$HOME/.local` + + ## Screenshots @@ -75,4 +85,4 @@ terminal-media-launcher -c /path/to/config For Documentation of the configuration file, see [terminal-media-launcher-config](terminal-media-launcher-config.md). For a help message and list of flags, `terminal-media-launcher --help`. -If you installed terminal-media-launcher, you can also consult **terminal-media-launcher**(1) and **terminal-media-launcher-config**(5). +You can also consult the man pages **terminal-media-launcher**(1) and **terminal-media-launcher-config**(5) diff --git a/docs/windows_compile_instructions.md b/docs/windows_compile_instructions.md index 21530fb..3b90a6c 100644 --- a/docs/windows_compile_instructions.md +++ b/docs/windows_compile_instructions.md @@ -8,15 +8,13 @@ Compiling on Windows requires access to the MinGW toolchain. The easiest way to 3. Run `pacman -Syu` until all packages are up to date -4. `pacman -S git mingw-w64-x86_64-gcc mingw-w64-x86_64-ncurses make` to install necessary packages +4. From here, follow the Unix instructions. The command to install dependencies in MSYS2 is -5. `git clone https://github.com/lshprung/terminal-media-launcher` to clone the repository - -6. `cd terminal-media-launcher` to enter the repository - -7. `make` to compile +``` +$ pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-ncurses make +``` -If you did everything correctly, compilation should succeed. Open File Explorer in the current directory (can be done by running `explorer .` in MSYS2 terminal) and double click the generated executable (should be called terminal-media-launcher.exe) +Open File Explorer in the current directory (can be done by running `explorer .` in MSYS2 terminal) and double click the generated executable in `src/` ## Resolving Missing .dll Files @@ -32,7 +30,7 @@ This is usually the result of the MSYS2 MinGW libraries not being in your PATH. ### 1. Edit PATH (Recommended) -Add the following entry to your PATH environment variable: `C:\msys64\mingw64\bin` (replace `C:\msys64` with the location that MSYS2 was installed to). This will help Windows to find the library it thinks it is missing and the program should now lauch without an error +Add the following entry to your PATH environment variable: `C:\msys64\mingw64\bin` (replace `C:\msys64` with the location that MSYS2 was installed to). This will help Windows to find the library it thinks it is missing and the program should now lauch without an error. ### 2. Compile with -static flag -- cgit