--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Mon Mar 09 12:15:10 2015 +0100
@@ -0,0 +1,77 @@
+Sonar xfwm4 Theme
+=================
+
+The Sonar xfwm4 theme is based on the identically named Metacity theme.
+
+Build Instructions
+------------------
+
+Distributions of released versions already include pregenerated images.
+
+The following tools are required to (re)generate the PNG and XPM images from
+their sources:
+
+- GNU make >= 3.81
+- GNU or BSD install
+- Imagemagick or GraphicsMagick
+
+Before generating the images check the commented macros in the Makefile for any
+macros you may need to override depending on the used toolchain and operating
+system.
+
+By default, all files will be installed under the "/usr/local" directory, a
+different installation path prefix can be set via the `prefix` macro.  In
+addition, a second path prefix can be specified via the `DESTDIR` macro which
+will be prepended to any path, incuding the `prefix` macro path prefix.  In
+contrast to `prefix`, the path specified via the `DESTDIR` macro will only be
+prepended to paths during installation and not be used for constructing
+internal paths.
+
+The following instructions assume that `make` is GNU make, on some platforms
+it may be installed under a different name or a non-default path.  In order to
+start the build process run `make all`.  After a successful build, run `make
+install` to install the theme files.
+
+Previously generated images can be removed by running `make clean`.
+
+Contact
+-------
+
+Please send any feedback or bug reports via email to
+<guido+sonar-xfwm4-theme@berhoerster.name>.
+
+Bug Reports
+-----------
+
+When sending bug reports, please always mention the exact version of the Sonar
+xfwm4 theme with which the issue occurs as well as the version of xfwm4 and
+the operating system you are using and make sure that you provide sufficient
+information to reproduce the issue and include any input, output, any error
+messages.
+
+In case of build issues, please also specify the implementations and versions
+of the tools you are using.
+
+License
+-------
+
+The Sonar xfwm4 theme is derived from the Sonar Metacity theme and distributed
+under the same license terms as the original work (see below for the full
+license text):
+
+Copyright (C) 2010 Guido Berhoerster <guido+sonar-xfwm4-theme@berhoerster.name>  
+Copyright (C) 2009 Jakub Steiner, Aaron Bockover, Novell Inc.
+
+This program is free software; you can redistribute it and/or
+modify it under the terms of the GNU General Public License
+as published by the Free Software Foundation; either version 2
+of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.