comparison README @ 0:801746b5cd7f

Initial revision
author Guido Berhoerster <guido+sonar-xfwm4-theme@berhoerster.name>
date Mon, 09 Mar 2015 12:15:10 +0100
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:801746b5cd7f
1 Sonar xfwm4 Theme
2 =================
3
4 The Sonar xfwm4 theme is based on the identically named Metacity theme.
5
6 Build Instructions
7 ------------------
8
9 Distributions of released versions already include pregenerated images.
10
11 The following tools are required to (re)generate the PNG and XPM images from
12 their sources:
13
14 - GNU make >= 3.81
15 - GNU or BSD install
16 - Imagemagick or GraphicsMagick
17
18 Before generating the images check the commented macros in the Makefile for any
19 macros you may need to override depending on the used toolchain and operating
20 system.
21
22 By default, all files will be installed under the "/usr/local" directory, a
23 different installation path prefix can be set via the `prefix` macro. In
24 addition, a second path prefix can be specified via the `DESTDIR` macro which
25 will be prepended to any path, incuding the `prefix` macro path prefix. In
26 contrast to `prefix`, the path specified via the `DESTDIR` macro will only be
27 prepended to paths during installation and not be used for constructing
28 internal paths.
29
30 The following instructions assume that `make` is GNU make, on some platforms
31 it may be installed under a different name or a non-default path. In order to
32 start the build process run `make all`. After a successful build, run `make
33 install` to install the theme files.
34
35 Previously generated images can be removed by running `make clean`.
36
37 Contact
38 -------
39
40 Please send any feedback or bug reports via email to
41 <guido+sonar-xfwm4-theme@berhoerster.name>.
42
43 Bug Reports
44 -----------
45
46 When sending bug reports, please always mention the exact version of the Sonar
47 xfwm4 theme with which the issue occurs as well as the version of xfwm4 and
48 the operating system you are using and make sure that you provide sufficient
49 information to reproduce the issue and include any input, output, any error
50 messages.
51
52 In case of build issues, please also specify the implementations and versions
53 of the tools you are using.
54
55 License
56 -------
57
58 The Sonar xfwm4 theme is derived from the Sonar Metacity theme and distributed
59 under the same license terms as the original work (see below for the full
60 license text):
61
62 Copyright (C) 2010 Guido Berhoerster <guido+sonar-xfwm4-theme@berhoerster.name>
63 Copyright (C) 2009 Jakub Steiner, Aaron Bockover, Novell Inc.
64
65 This program is free software; you can redistribute it and/or
66 modify it under the terms of the GNU General Public License
67 as published by the Free Software Foundation; either version 2
68 of the License, or (at your option) any later version.
69
70 This program is distributed in the hope that it will be useful,
71 but WITHOUT ANY WARRANTY; without even the implied warranty of
72 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
73 GNU General Public License for more details.
74
75 You should have received a copy of the GNU General Public License
76 along with this program; if not, write to the Free Software
77 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.