/
INSTALL
313 lines (227 loc) · 11.3 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
Installing Fvwm-Nightshade
==========================
Requirements
============
Required: Fvwm >= 2.6.5, python-2.7, python-xdg, xterm, conky,
xscreensaver, feh, imagemagick, librsvg2-bin, xwd,
stalonetray, cpufrequtils*, gksu/beesu
Recommended: gnomes network manager, Volume Icon
Useful: fdpowermon, blueman-applet, pm-utils, LxApearance,
qtconfig for qt3, qtconfig for qt4, xneurs
* unfortunatelly not usable in Arch at the moment. They have changed from
cpufrequtils to cpupower but it's not supported at the moment
-> see issue #40 in the bugtracker.
Preparation
===========
Fvwm
----
1. Get latest Fvwm
a. from distribution if available
b. from Fvwm homepage
- open http://www.fvwm.org/download/ and download latest release
- unpack it
c. from Fvwm CVS:
- Open http://www.fvwm.org/documentation/dev_cvs.php
- Do the Initial Setup
- Checking Out Source Code:
$ cvs -d :pserver:anonymous@cvs.fvwm.org:/home/cvs/fvwm co -r branch-2_6 fvwm
If distribution package is not available (b and c)
1. Prepare environment
rpm:
- follow instructions under http://www.fvwm.org/documentation/dev_creating_rpms.php
"Before you Begin" and install listed packages (don't forget 'rpm-build' ^^).
- next step "Where rpms will be created" and create ~/.rpmmacros file with
%_topdir /home/<your_user_home>/redhat
- read "Creating binary and source rpm packages" but wait ...
unfortunatelly rpm-dist doesn't work at the moment. You've to fix the following:
- rename bin/fvwm-menu-desktop-config.fpl into bin/fvwm-menu-desktop-config.fpl.in
- add in configure.ac after line 1766:
bin/fvwm-menu-desktop-config.fpl
deb:
- it's mostly easier to do "3. Building the Tree" before installing packages because the
absent packages/dev-libs are in braces in the "no" lines at the end of the summary ;)
- if X11/Intrinsic.h not found while make you need package libXt-dev, too.
Arch:
- xsltproc is equivalent to libxslt. librplay not available but normally not needed.
- next step: 4. Compile Fvwm
2. Building the Tree:
- execute in the terminal
$ utils/configure_dev.sh
Hint:
You can ignore "With GNOME libs support in FvwmGtk? no: Can't find working gnome-config"
because Fvwm wants Gtk+ Version 1 which is obsolete since ages and newer distributions
don't has it anymore.
3. Compile Fvwm:
deb:
- run
$ ./configure --prefix=/usr
- after that
$ make deb-inplace
rpm:
- run
$ make rpm-dist
Arch:
- build the package:
1. Create directory where you want to build the package and change to
$ mkdir -p /home/<your_user_name>/packages/fvwm
$ cd /home/<your_user_name>/packages/fvwm
2. Copy from arch/PKGBUILD_FVWM into the directory rename it to PKGBUILD and run
$ makepkg -s
3. enter password 'guest' for CVS login
2. Install Fvwm
- To install Fvwm you need root rights!
a. from distribution
use the package manager
b/c. from Fvwm homepage
rpm:
- The package is located under /home/[your_user_name]/redhat/RPMS/i386/
# rpm -ivh /home/<your_user_name>/redhat/RPMS/i386/fvwm-2.6.x-0.<date>.i386.rpm
deb:
- The package is created one level higher than the fvwm folder
# dpkg -i ../<path_to_fvwm>/fvwm-2.6.x-0.<date>.i386.deb
Arch:
- The package is created in the previous generated directory. Run
# pacman -U fvwm-cvs-2.6.6-1-architecture.pkg.tar.xz
Installation of Fvwm-Nightshade
===============================
1. download package from http://fvwm-nightshade.github.io/Fvwm-Nightshade
2. unpack it and switch into the expanded directory
Remark: don't use file-roller because the tool cannot handle unix rights in zip files
Use unzip instead.
3. Switch into the unpacked directory
4. Now you have different possibilities to install Fvwm-Nightshade.
- General
Fvwm-Nightshade will be installed to /usr/local by default. So root
permissions are required. Run
# make install
If you want to install Fvwm-Nightshade to another directory you can
change the prefix:
# make prefix=<other_dir> install
If you haven't installed a display-manager like GDM you can add the option
displaymanager=no to the make call:
# make install displaymanager=no
If Fvwm is installed in another directory then /usr/share/fvwm you have
to told make where because there are some scripts which have to be installed
into Fvwm.
# make fvwm_path=<path_to_fvwm> install
If you haven't root rights you can install Fvwm-Nightshade locally. All you
need is a directory e.g. ~/.local with write permissions. Also an entry in
your PATH variable in your .bashrc, .bash_profile or .profile like
PATH=$PATH:$HOME/.local/bin
Now you can install Fvwm-Nightshade with the following make call:
$ make prefix=~/.local install local=yes
Don't forget to install the required packages from the beginning of this document!
- deb:
Run
# make deb
A Debian package is created in the directory above. Install it with the two liner:
# dpkg -i fvwm-nightshade-<version>.deb
# apt-get -f install
- rpm:
Type in the terminal
# make rpm
A rpm package is created in /home/<your_user_name>/redhat/RPMS/noarch/. Install it with
Fedora/Redhat:
# yum --nogpgcheck localinstall /home/<your_user_name>/redhat/RPMS/noarch/fvwm-nightshade_<version>_noarch.rpm
SuSE:
# yast -i /home/<your_user_name>/redhat/RPMS/noarch/fvwm-nightshade_<version>_noarch.rpm
For others (dependencies must installed before):
# rpm -ivh /home/<your_user_name>/redhat/RPMS/noarch/fvwm-nightshade_<version>_noarch.rpm
- Arch:
Type in the terminal
# make arch
The package is created in the directory above. Run as root
# pacman -U fvwm-nightshade-<version>-any.pkg.tar.xz
- Gentoo:
An additional overlay repository for custom ebuilds which are not in the official
Portage is needed. It will be set over the PORTDIR_OVERLAY variable in
/etc/portage/make.conf. The normal personal per-machine overlay is /usr/local/portage.
But another could used also.
The Fvwm-Nightshade ebuild has to be created from the template in gentoo/.
Also the dist package for the installation. This can done with one step.
Type in the terminal:
$ make gentoo-prepare
The make rule creates the dist package ../fvwm-nightshade-<version>.tar.gz and adds
the current version of the downloaded package to the ebuild name and saves it in
the current directory.
A sub directory 'fvwm-nightshade' in the category 'x11-themes' have to be created
(if you use the overlay /usr/local/portage you need root permissions!):
$|# mkdir -p <overlay_directory>/x11-themes/fvwm-nightshade
Copy the versioned fvwm-nightshade ebuild into your personal overlay repository:
$|# cp fvwm-nightshade-<version>.ebuild <overlay_directory>/x11-themes/fvwm-nightshade/
Copy the dist package as root to /usr/portage/disfiles:
# cp ../fvwm-nightshade-<version>.tar.gz /usr/portage/distfiles/
Create the manifest:
$|# ebuild --force <overlay_directory>/x11-themes/fvwm-nightshade/fvwm-nightshade-<version>.ebuild digest
Unmask the package with your system architecture -> ~x86 or ~amd64 :
# echo x11-themes/fvwm-nightshade ~x86 >> /etc/portage/package.keywords
Install Fvwm-Nightshade with
# emerge x11-themes/fvwm-nightshade
Perhaps you need some additional USEs. Emerge told you which. Echo them into /etc/portage/package.use:
# echo "<USEs>" >> /etc/portage/package.use
Emerge again.
Fvwm-Nightshade is installed. Congratulation!
If you haven't a graphical login manager copy xinitrc template into your home directory
$ cp <system>/share/doc/fvwm-nightshade/xinitrc-example ~/.xinitrc
or add the following line to your .xinitrc:
exec fvwm-nightshade
and start the xserver with
$ startx
Change the base settings and enjoy.
If you have a graphical login manager there's now a new entry "Fvwm-Nightshade" in your sessions dialog.
Login, change the base settings and enjoy.
If you have installed Fvwm-Nightshade locally and want to use a display-manager copy (with root rights)
fvwm-nightshade.desktop-example from the doc directory to /usr/share/xsessions:
# cp <system>/share/doc/fvwm-nightshade/fvwm-nightshade.desktop-example /usr/share/xsessions/fvwm-nightshade.desktop
Deinstallation
==============
- General
To remove Fvwm-Nightshade expect ~/.fvwm-nightshade run as root
# make uninstall
If you have installed Fvwm-Nightshade to another directory you have to change the prefix:
# make prefix=<other_dir> uninstall
That applies for local installation without root rights, too.
Also, if Fvwm is installed in another directory then /usr/share/fvwm you have
to told make where Fvwm is located
# make fvwm_path=<path_to_fvwm> uninstall
Since 0.6.7 'make install' creates an install log. For previous versions which haven't this
file you must use
# make uninstall-alternative
It checks the default installation locations and try to uninstall all installed files. Maybe
some files won't found. Excuse the inconvenience.
- For all others use the package management system.
Tips
====
How to get the required packages
--------------------------------
Some distributions haven't all packages in their main repositories. But you can get them
over some other ways.
OpenSuse:
http://software.opensuse.org/search
To install a downloaded package use yast (as root) to solve package dependencies with
# yast -i <path_to_rpm_package>
or, if you have zypper installed use (as root)
# zypper install <path_to_rpm_package>
Fedora:
https://apps.fedoraproject.org/packages/
http://koji.fedoraproject.org/koji/search
To install a downloaded package use yum (as root) to solve package dependencies with
# yum --nogpgcheck localinstall <path_to_rpm_package>
Arch:
https://www.archlinux.org/packages/
https://aur.archlinux.org/
To install a downloaded package use pacman (as root) to solve package dependencies with
# pacman -U <path_to_arch_package>
Gentoo:
http://en.znurt.org/
Slackware:
http://www.slackabduction.com/sse/index.php
Some other package search sites:
http://pkgs.org
http://rpm.pbone.net/
http://www.rpmseek.com/index.html
Bugs and Wishes
===============
If you have problems or suggestions send an email to fvwmnightshade@gmail.com
Thanks for installing Fvwm-Nightshade :-)
Your Fvwm-Nightshade team