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.