From 22cde7d3b3dd0c80f38fba771d134cf5fc6cf919 Mon Sep 17 00:00:00 2001
From: Daniel Hahler <git@thequod.de>
Date: Sat, 1 Feb 2014 21:01:00 +0100
Subject: [PATCH] README: document local themes dirs and formatting

Ref: https://github.com/shimmerproject/Numix/issues/93
---
 README.md | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index d6d1756..db11b25 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,28 @@
-Numix is a modern flat theme with a combination of light and dark elements. It supports Gnome, Unity, XFCE and Openbox.
+Numix is a modern flat theme with a combination of light and dark elements. It
+supports Gnome, Unity, XFCE and Openbox.
 
 Numix is a part of the [Numix Project](http://numixproject.org).
 
 ### Manual installation
 
-Extract the zip file to the themes directory i.e. `/usr/share/themes/`
+Extract the zip file (or clone the Git repository) to the themes directory.
 
-To set the theme in Gnome, run the following commands in Terminal,
+ * To install it system-wide (for all users), use `/usr/share/themes/`.
+ * To install it for your user only:
+	 * From Gnome 3.10 onwards, Gnome uses `~/.local/share/themes`.
+	 * Previously (and for GTK2), `~/.themes` is used.
+	 * You can use a symlink from `~/.themes/Numix` to
+	   `~/.local/share/themes/Numix`.
+
+To activate the theme in Gnome, run the following commands in a terminal (or
+use something like gnome-teak-tool):
 
 ```
 gsettings set org.gnome.desktop.interface gtk-theme "Numix"
 gsettings set org.gnome.desktop.wm.preferences theme "Numix"
 ```
 
-To set the theme in Xfce, run the following commands in Terminal,
+To set the theme in Xfce, run the following commands in Terminal:
 
 ```
 xfconf-query -c xsettings -p /Net/ThemeName -s "Numix"
@@ -22,12 +31,11 @@ xfconf-query -c xfwm4 -p /general/theme -s "Numix"
 
 ### Requirements
 
-GTK+ 3.6 or above
-
-Murrine theme engine
+ * GTK+ 3.6 or above
+ * Murrine theme engine
 
 ### Code and license
 
-Report bugs or contribute at [GitHub](https://github.com/shimmerproject/Numix)
+Report bugs or contribute at [GitHub](https://github.com/shimmerproject/Numix).
 
 License: GPL-3.0+