From d176368fff6c3083378fb1d727cc6f35a15fabd3 Mon Sep 17 00:00:00 2001
From: Daniel Friesel <derf@finalrewind.org>
Date: Sun, 28 Aug 2016 11:53:01 +0200
Subject: Only install icons to /usr/share when running make install app=1

---
 README | 28 ++++++++++++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)

(limited to 'README')

diff --git a/README b/README
index 9a2b59a..61fdd4d 100644
--- a/README
+++ b/README
@@ -28,20 +28,38 @@ Recommended
 Installation
 ------------
 
+For end users:
+
+$ make
+$ sudo make install app=1
+
+For package maintainers and users who do not want feh to install its
+icons into /usr/share:
+
 $ make
 $ sudo make install
 
+Explanation: feh ships some icons and an X11 desktop entry, which allow it to
+be used from file managers, desktop menus and similar. However, installing
+icons to /usr/local/share/... does not seem to work reliable in all cases.
+Because of this, when using "make install app=1", feh will install its icons
+to /usr/share/..., even though they technically belong into /usr/local.
+
 ZSH Completion for feh is available at
 <http://git.finalrewind.org/zsh/plain/etc/completions/_feh>
 
 Make flags
 ----------
 
-Use "make flag=bool", e.g. "make xinerama=0 debug=1" to disable Xinerama
-support and get a debug build.
+Flags can be used to control the build and installation process, e.g. via "make
+flag=bool", "make install flag=bool", or "export flag=bool; make && make
+install".  For example, "make xinerama=0 debug=1" will disable Xinerama support
+and produce a debug build.
 
 Available flags are:
 
+ * app      (default 0) - install icons to /usr/share, regardless of DESTDIR
+                          and PREFIX, and call gtk-update-icon-cache afterwards
  * cam      (default 0) - install deprecated feh-cam und gen-cam-menu scripts
  * curl     (default 1) - use libcurl to view http:// and similar images
  * debug    (default 0) - debug build, enables --debug
@@ -52,6 +70,12 @@ Available flags are:
 
 So, by default libcurl and Xinerama are enabled, the rest is disabled.
 
+Additionally, the standard variables PREFIX and DESTDIR are supported.
+PREFIX (default /usr) controls where the application and its data files
+will be installed. It must be set both during "make" and "make install".
+DESTDIR (default empty) sets the installation root during "make install". It
+is mostly useful for package maintainers.
+
 Note: config.mk is designed so that in most cases, you can set environment
 variables instead of editing it. E.g.:
 CFLAGS='-g -Os' make
-- 
cgit v1.2.3