Permalink
Browse files

update INSTALL and README

  • Loading branch information...
1 parent 23129a3 commit cb6c39ef1a2ed8c3b0ec5b6525569f4a196a961d @ThomasFunk ThomasFunk committed Sep 9, 2012
View
@@ -14,6 +14,7 @@ History:
$[FVWM_USERDIR]/wallpapers/.thumbs
- add IgnoreModifiers L25 for problems with ClickToFocus
- update Makefile
+- update INSTALL and README
08/21/2012 V 0.5.2
- change structure from user to system configuration:
View
181 INSTALL
@@ -1,49 +1,150 @@
-Unfortunatelly no Makefile is available to install Fvwm-Nightshade easily.
-Also only the login via login manager is supported because .xinitrc not finished.
+Installing Fvwm-Nightshade
+==========================
-so, if you're willing to test Fvwm-Nightshade follow the steps below:
+Requirements
+============
+
+Required: Fvwm >= 2.6.6 (compiled with all features), python-xdg,
+ xterm, conky, xscreensaver, eterm, imagemagick,
+ stalonetray, wm-icons
+
+Recommended: gnomes network manager, Volume Icon
+
+Useful: fdpowermon, bluetooth-applet, pm-utils, LxApearance,
+ qtconfig for qt3, qtconfig for qt4, xneurs
+
+
+
+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
+
+2. Prepare source code
+ rpm:
+ - follow instructions under http://www.fvwm.org/documentation/dev_creating_rpms.php
+ - about rpm-dist:
+ unfortunatelly it 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
-1. Get latest Fvwm from 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
- Building the Tree:
utils/configure_dev.sh
-2. Install all needed dev libs:
- deb:
- - mostly the libs in braces in the "no" lines at the end of the
- configure call
- - also package libXt-dev if X11/Intrinsic.h not found while make
- rpm:
- - for full list see http://www.fvwm.org/documentation/dev_creating_rpms.php
+
+3. Install all needed dev libs:
+ deb:
+ - mostly the libs in braces in the "no" lines at the end of the
+ configure call
+ - also package libXt-dev if X11/Intrinsic.h not found while make
+ rpm:
+ - for full list see http://www.fvwm.org/documentation/dev_creating_rpms.php
+
3. Compile Fvwm:
- deb:
- - make deb-inplace
- rpm:
- unfortunatelly the rpm way doesn't work at the moment. The following fix this
- problem:
- - rename bin/fvwm-menu-desktop-config.fpl into bin/fvwm-menu-desktop-config.fpl.in
- - added in configure.ac after line 1766:
- bin/fvwm-menu-desktop-config.fpl
- - do make rpm-dist
+ - run ./configure --prefix=/usr
+ deb:
+ - make deb-inplace
+ rpm:
+ - make rpm-dist
+
4. Install Fvwm
-5. Install all required packages for Fvwm-Nightshade:
- python-xdg, xterm, conky, xscreensaver, eterm, imagemagick, stalonetray, wm-icons
-6. Install Fvwm-Nighshade:
- - download it from https://github.com/Fvwm-Nightshade/Fvwm-Nightshade/tree/develop
- - unpack it and enter expanded folder
- - change to root
- cp bin/* /usr/local/bin/
- cp system/fvwm-nightshade.desktop /usr/share/xsessions/
- cp -r fvwm-nightshade /usr/local/share/
- mkdir /usr/local/share/doc
- mkdir /usr/local/share/doc/fvwm-nightshade
- cp doc/* /usr/local/share/doc/fvwm-nightshade/
- cp AUTHORS ChangeLog COPYING README INSTALL /usr/local/share/doc/fvwm-nightshade/
- cp fvwm/* /usr/share/fvwm/ (or where you've installed Fvwm)
-7. login into Fvwm-Nightshade, change the base settings and enjoy.
+
+
+Other Packages
+--------------
+
+Install all required packages for Fvwm-Nightshade:
+ - python-xdg (normally installed on most systems)
+ - xterm (normally installed with xserver but some distributions swapped it out
+ in a seperate package)
+ - conky
+ - xscreensaver
+ - eterm (not in all distributions available. See Tips)
+ - imagemagick
+ - stalonetray (not in all distributions available. See Tips)
+ - wm-icons (not in all distributions available. See Tips)
+
+
+
+Installation
+============
+
+1. download package from https://github.com/Fvwm-Nightshade/Fvwm-Nightshade/tree/develop
+2. unpack it and switch into the expanded directory
+3. 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 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
+
+
+Now Fvwm-Nightshade is installed and you can login, change the base settings and enjoy.
+
+
+
+Deinstallation
+==============
+To remove Fvwm-Nightshade completely run as root
+
+ make uninstall
+
+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
+
+
+Tips
+====
+
+Get the required packages
+-------------------------
+
+Some distributions haven't some package in their main repositories. But you can get it
+over some other ways.
+
+OpenSuse:
+http://software.opensuse.org/search
+
+Fedora:
+https://apps.fedoraproject.org/packages/
+
+Some 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
-Your Fvwm-nightshade team
+
+
+Thanks for installing Fvwm-Nightshade :-)
+
+Your Fvwm-Nightshade team
View
5 README
@@ -60,7 +60,7 @@ Featurelist of Fvwm Nightshade:
- Some themes/decors (Default, Ambience and Air). Can be changed on the
fly without restart
- Own themes and layouts can be created with templates (at the moment
- only theme emplates available)
+ only theme templates available)
- Autostart possibility (starting apps while startup)
- A useful set of GUI tools to configure the global system (Gtk+, Qt,
mouse, keyboard, etc)
@@ -238,8 +238,7 @@ Button 4/5: Switch with active window to page left/right with SHIFT-CTRL
Installation
============
-Makefile for installation is in progress. For Install Fvwm-Nightshade by
-hand read the INSTALL file.
+For installation description see the INSTALL file.
Bugs and Feature requests
Deleted file not rendered
Deleted file not rendered
Deleted file not rendered
Deleted file not rendered
Deleted file not rendered

0 comments on commit cb6c39e

Please sign in to comment.