update README.md

1 files changed, 13 insertions, 9 deletions

diff --git a/README.md b/README.md
index 1630541..9ffa7bd 100644
--- a/README.md
+++ b/README.md
@@ -46,16 +46,16 @@ A non-transparent version of the theme is available here: [Arc Solid OBS repo](h
 To build the theme the follwing packages are required 
 * `autoconf`
 * `automake`
-* `pkg-config` or `pkgconfig` if you use Fedora
+* `pkg-config` or `pkgconfig` for Fedora
 * `libgtk-3-dev` for Debian based distros or `gtk3-devel` for RPM based distros
-* `git` if you want to clone the source directory
+* `git` to clone the source directory
 
-**Note:** If your distribution doesn't ship separate development packages you just need GTK 3 instead of the `-dev` packages.
+**Note:** For distributions which don't ship separate development packages, just the GTK 3 package is needed instead of the `-dev` packages.
 
 For the theme to function properly, install the following
-* GNOME Shell, GTK 3.14 - 3.22
+* GNOME Shell 3.14 - 3.24, GTK 3.14 - 3.22
 * The `gnome-themes-standard` package
-* The murrine engine. This has different names depending on your distro.
+* The murrine engine. This has different names depending on the distro.
   * `gtk-engine-murrine` (Arch Linux)
   * `gtk2-engines-murrine` (Debian, Ubuntu, elementary OS)
   * `gtk-murrine-engine` (Fedora)
@@ -89,11 +89,15 @@ Other options to pass to autogen.sh are
     --disable-unity            disable Unity support
     --disable-xfwm             disable XFWM support
 
-    --with-gnome=<version>     build the theme for a specific GNOME version (3.14, 3.16, 3.18, 3.20)
-                               Note: Normally the correct version is detected automatically and this
+    --with-gnome=<version>     build the theme for a specific GNOME version (3.14, 3.16, 3.18, 3.20, 3.22)
+                               Note 1: Normally the correct version is detected automatically and this
                                option should not be needed.
+                               Note 2: For GNOME 3.24, use --with-gnome-version=3.22
+                               (this works for now, the build system will be improved in the future)
 
-After the installation is complete you can activate the theme with `gnome-tweak-tool` or a similar program by selecting `Arc`, `Arc-Darker` or `Arc-Dark` as Window/GTK+ theme and `Arc` or `Arc-Dark` as GNOME Shell/Cinnamon theme.
+After the installation is complete the theme can be activated with `gnome-tweak-tool` or a similar program by selecting `Arc`, `Arc-Darker` or `Arc-Dark` as Window/GTK+ theme and `Arc` or `Arc-Dark` as GNOME Shell/Cinnamon theme.
+
+If the `--disable-transparency` option was used, the theme will be installed as `Arc-solid`, `Arc-Darker-solid` and `Arc-Dark-solid`.
 
 ## Uninstall
 
@@ -128,7 +132,7 @@ The Arc Dark theme for the Ubuntu Software Center by [mervick](https://github.co
 
 ## Troubleshooting
 
-If you have Ubuntu with a newer GTK/GNOME version than the one included by default (i.e Ubuntu 14.04 with GTK 3.14 or Ubuntu 15.04 with GTK 3.16, etc.) the prebuilt packages won't work properly and you have to install the theme manually as described above.
+If you use Ubuntu with a newer GTK/GNOME version than the one included by default (i.e Ubuntu 14.04 with GTK 3.14 or Ubuntu 15.04 with GTK 3.16, etc.) the prebuilt packages won't work properly and the theme has to be installed manually as described above.
 This is also true for other distros with a different GTK/GNOME version than the one included by default
 
 --