From 4eaf071fc247dc3cc71a4de65895ebcee84f5de7 Mon Sep 17 00:00:00 2001
From: Arun Prakash Jana <engineerarun@gmail.com>
Date: Sun, 21 Aug 2016 16:02:03 +0530
Subject: [PATCH] Document NOICE_FALLBAK_OPENER.

---
 README.md | 10 +++++++++-
 noice.1   |  4 ++++
 noice.c   |  4 ++--
 3 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 4500b0d1..de056b5e 100644
--- a/README.md
+++ b/README.md
@@ -18,7 +18,7 @@ Additional customization to make it more friendly towards major distros (which `
     - Associate common audio file types with lightweight fmedia (http://fmedia.firmdev.com/)
     - Associate PDF files with zathura
     - Removed less
-    - Use `xdg-open` to open other unrecognised files
+    - Use environment variable `NOICE_FALLBACK_OPENER` to open other non-associated files
 - Compilation
     - Use `-O3` for compilation, fixed warnings
     - Added compilation flag `-march=native` (compile only, no plans to package).
@@ -32,3 +32,11 @@ Additional customization to make it more friendly towards major distros (which `
 ## Help
 
     $ man noice
+
+## Change associations
+
+If you want to set custom applications for certain mime types, or change the ones set already (e.g. vim, fmedia, zathura), modify the `assocs` structure in **config.def.h** (it's easy). Then run the following commands to re-compile and install:
+
+    $ make clean
+    $ make
+    $ sudo make install
diff --git a/noice.1 b/noice.1
index 603af051..d39be8fb 100644
--- a/noice.1
+++ b/noice.1
@@ -109,6 +109,10 @@ when dealing with the !, e and p commands respectively.
 mime opener to override all custom mime associations.
 .br
 Examples: xdg-open, gnome-open, gvfs-open.
+.Pp
+\fBNOICE_FALLBACK_OPENER:\fR set to your desktop environment's default
+mime opener to use as a fallback when no association is set for a file
+type. Custom associations are listed in the EXAMPLES section below.
 .Sh EXAMPLES
 The following example shows one possible configuration for
 file associations which is also the default if environment
diff --git a/noice.c b/noice.c
index 7ba37963..03b159c7 100644
--- a/noice.c
+++ b/noice.c
@@ -670,8 +670,8 @@ nochange:
 				char *execvim = "vim";
 
 				if (bin == NULL) {
-					/* If a custom hander application is not set, open
-					   plain text files with vim, then try xdg-open */
+					/* If a custom handler application is not set, open
+					   plain text files with vim, then try fallback_opener */
 					FILE *fp;
 					char cmd[MAX_LEN];
 					int status;
-- 
2.51.0