1Welcome to FVWM Themes, a stable release. 2 3 4HOW TO INSTALL 5-------------- 6 7To install this package unpack the fvwm-themes tarball and execute: 8 9 ./configure 10 make 11 make install 12 13You can run two first commmands as any user and the last one as the user 14having write permissions to fvwm installation (supposedly root). 15 16After that, the package can be uninstalled at any time using: 17 18 make uninstall 19 20It is possible (but not recommended) to install fvwm-themes to any place, 21regardless of fvwm installation, but you should really know what you do, 22see the last section of this file for instructions. 23 24To install additional themes from fvwm-themes-extra pack, you may execute 25this command as the same user that did "make install" for fvwm-themes: 26 27 [/path/]fvwm-themes-config --site --install fvwm-themes-extra.tar.gz 28 29Individual themes may be removed by removing the corresponding directories. 30 31Please report any installation problems to fvwm-themes-devel mailing list. 32 33 34FVWM THEMES CONFIGURE OPTIONS 35----------------------------- 36 37Try ./configure --help for the list of all the options to configure. 38In addition to the standard options there is the following option: 39 40--enable-gnome-icons - This causes fvwm-themes installation procedure 41to find and convert GNOME PNG icons into xpm icons and mini-icons (under 42datadir/fvwm/tr-images directory). For that you need GNOME and ImageMagick 43installed. Use this option if you want original GNOME icons into your fvwm 44GNOME menus and for the Icon and MiniIcon Style of the GNOME applications. 45See the FAQ and the fvwm-themes-images man page for more details. 46 47--enable-kde2-icons - As above for KDE version 2. 48 49THE DEFAULT DIRECTORIES 50----------------------- 51 52The fvwm-themes is designed as an add-on, integrated to fvwm 2.4 versions. 53The default is to install fvwm-themes to the same directories as fvwm itself, 54more specifically, to ones returned by: 55 56 fvwm-config --bindir --mandir --fvwm-datadir 57 58If fvwm bin directory (fvwm-config utility is part of fvwm-2.3.17+) is not 59in your $PATH, we suggest you to add this directory to your $PATH or specify 60--with-fvwm-bindir parameter to ./configure. Adding fvwm bin to your $PATH 61is needed anyway if you want to use all features (like fvwm-menu-* scripts). 62 63IMPORTANT NOTE: If you have 2 fvwm installations, for example the 64stable and unstable one, you should install fvwm-themes twice for each 65installation with different --with-fvwm-bindir parameters. Then run correct 66/path/[un]stable/fvwm-themes-start, everything else should work as expected. 67Just be aware that if you have different fvwm-themes versions installed, 68your ~/.fvwm/themes* files and directories may be out of sync. If you 69always run fvwm-themes-start the problems should not happen. You may also 70do "Reset all to default", or "/path/[un]stable/fvwm-themes-config --reset". 71 72 73HOW TO CHANGE THE DEFAULT DIRECTORIES 74------------------------------------- 75 76You should normally skip this section. Currently installation to an 77alternative (non fvwm) place will not work without many changes. 78 79You can overwrite the default directories by giving one or more parameters 80to ./configure: --bindir, --mandir, --datadir (or --with-ft-datadir). 81 82Note, fvwm-themes (like fvwm itself) installs all goodies to $datadir/fvwm. 83 84You can also specify --prefix parameter, in this case the mentioned 85directories will default to this prefix ($prefix/bin, $prefix/man, 86$prefix/share/fvwm). Normally, the prefix is not used. 87 88Example: env DEBUG=1 ./configure --prefix=/tmp/fvwm-themes --bindir=/tmp 89