From d6c26e1363cadb73ec026efe1f4040d54c3cbd36 Mon Sep 17 00:00:00 2001 From: Eugenetanwl3881 Date: Mon, 7 Nov 2022 22:19:24 +0800 Subject: [PATCH 1/2] Fix spacing issue --- docs/_layouts/default.html | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html index 3d11f1fc17c..9bf2d7bdec5 100644 --- a/docs/_layouts/default.html +++ b/docs/_layouts/default.html @@ -1,5 +1,4 @@ --- -layout: compress --- From 295fdc571ed83aafaf6189e87d4834be8e775ad9 Mon Sep 17 00:00:00 2001 From: Eugenetanwl3881 Date: Mon, 7 Nov 2022 22:32:46 +0800 Subject: [PATCH 2/2] Simplify Troubleshooting --- docs/_ug/Troubleshooting.md | 29 ++++------------------------- 1 file changed, 4 insertions(+), 25 deletions(-) diff --git a/docs/_ug/Troubleshooting.md b/docs/_ug/Troubleshooting.md index 7070fda7b45..3b144e1deb8 100644 --- a/docs/_ug/Troubleshooting.md +++ b/docs/_ug/Troubleshooting.md @@ -13,38 +13,22 @@ The JAR file not launching even after double-clicking the file. * Search for "terminal" and click it to launch. 1. On your terminal, run `java -jar "foodrem.jar"` -If the issue still persists it might be due to the following errors: **Problem:** The JAR file not launching in Windows Subsystem for Linux (WSL). ```note -WSL does not support GUI applications by default. WSL users have to manually install and set up a X-server to run such apps on WSL. - -Options include: -* VcXsrv Windows X Server -* gWSL (which can be installed from the Microsoft Store and helps handle the setting up of X-server) - -An exception is windows 11. There seems to be some support for running GUI applications in WSL 2 for windows 11 though it's limited to Windows 11 Build 22000 or later. +WSL does not support GUI applications by default. ``` **Solution:** -1. Our recommendation is to run FoodRem in windows natively and not on WSL. +1. Our recommendation is to run FoodRem on Windows and not on WSL. **Problem:** The JAR file not launching in Linux machines running Wayland. - -To check if the Linux machine is running Wayland, run the following command: - -```Bash -echo $XDG_SESSION_TYPE -``` - -If the output is `wayland`, then the Linux machine is indeed running Wayland. - **Solution:** ```info @@ -52,10 +36,7 @@ Under the hood, FoodRem uses JavaFX 11 to render the UI for the GUI. Unfortunately, JavaFX 11 has poor support for Wayland which is why FoodRem is unable to support Wayland currently. ``` -1. Install Xorg if it is not present on the machine. - * Log out of the current session running Wayland and switch to a session running Xorg. The app should now launch properly in Xorg. -2. Install any virtual machine that is not running Wayland on a hypervisor such as VirtualBox or VMware. - * The app should also launch properly in the virtual machine if configured properly. +1. FoodRem is only supported on machines with the following operating systems: Windows, macOS and Linux11. Please use a computer running on these operating systems. **Problem:** @@ -63,6 +44,4 @@ Unable to exit/save FoodRem to data file **Solution:** -1. Verify that the JAR file `foodrem.jar` is not placed in a write-protected folder where administrator privileges are required to write/save FoodRem to the data file. E.g of write-protected folders include `C:\WINDOWS\System32` in windows and the `/etc` dir in linux. - -1. If the JAR file is located in a write-protected folder, move it to a folder that is not write-protected. +1. This error is due to `foodrem.jar` being started in a protected folder. (Examples of write-protected folders include `C:\WINDOWS\System32` in windows and the `/etc` dir in linux)
Please move the `foodrem.jar` file into another folder in your computer and start FoodRem from that folder.