From f451217f22e0482b8f9aa38b09a7c3b9a12ba65b Mon Sep 17 00:00:00 2001
From: Robert Dailey <rcdailey@gmail.com>
Date: Sat, 23 Oct 2021 12:23:26 -0500
Subject: [PATCH] docs: add troubleshooting guide

First troubleshooting entry documents error message seen when missing
read permission on the trash executable.

Fixes #14
---
 README.md               |  1 +
 wiki/Troubleshooting.md | 14 ++++++++++++++
 2 files changed, 15 insertions(+)
 create mode 100644 wiki/Troubleshooting.md

diff --git a/README.md b/README.md
index 60f09dff..c5ee1e81 100644
--- a/README.md
+++ b/README.md
@@ -105,6 +105,7 @@ provided below for some main topics.
 
 - [Command Line Reference](../../wiki/Command-Line-Reference)
 - [Configuration Reference](../../wiki/Configuration-Reference)
+- [Troubleshooting](../../wiki/Troubleshooting)
 
 ## Important Notices
 
diff --git a/wiki/Troubleshooting.md b/wiki/Troubleshooting.md
new file mode 100644
index 00000000..40b7a8d5
--- /dev/null
+++ b/wiki/Troubleshooting.md
@@ -0,0 +1,14 @@
+# Errors & Solutions
+
+* On Mac or Linux OS, you may see the following error when you run `trash`:
+
+  ```txt
+  Failed to map file. open(/Users/foo/Downloads/trash) failed with error 13
+  Failure processing application bundle.
+  Couldn't memory map the bundle file for reading.
+  A fatal error occured while processing application bundle
+  ```
+
+  This cryptic message is actually a permissions error, likely because your executable does not have
+  read permissions set. Simply run `chmod u+rx trash` to add read + execute permissions on the
+  `trash` executable. This is also done in the linux one-liner outlined in the main `README.md`.