
README

MultiWM
Release 1 (Debut)
April 10th 1997



NAME
	multiwm - an interactive bash-script to choose right window manager
	and window manager configuration before starting X

SYNOPSIS
	multiwm [8|15|16|-w|-c]

DESCRIPTION
	NOTE: Before you try this script, you must take backups of files that
	will be removed by this script (see those rm commands at the beginning
	of script).

	Multiwm-script that you can download from Internet, is just an example
	to be modified to correspond current system and especially window
	managers available and users own personal (perverted?) taste. Script
	itself is so well commented, that it should not be very hard task at
	all. Sys admins are strongly ancouraged to modify this script
	respectively, when window managers are added, upgraded and/or
	removed. They can also add this script or pieces of this script to
	system wide xinit and/or startx scripts if they can. But if sys
	admins are not co-operative with user wanting to use this script,
	that user can use this script from his/her home directory.

	When multiwm is started, it removes some configuration-files used by
	X from user's home directory and then asks if user wants to use
	default window manager or not. If answer is q, script quits itself.
	If answer is yes or user press return, default window manager will be
	used under X. If answer is no, user is asked to choose one window
	manager and in some cases configuration type from a list. Answer must
	be given as number found on list. After that multiwm moves some
	configuration files from users directory called .multiwm and its
	subdirectories to users home directory and creates a symbolic link
	from .Xclients to .xsession. If user did not include 8 or 16 after
	multiwm command, he will be prompted to choose right display state
	(8 or 16 bytes per pixel). And then X is started via startx-script.

OPTIONS
	8 
		Use 8 bits per pixel

	15
		Use 15 bits per pixel

	16
		Use 16 bits per pixel

	-w
		Show warnings
 
	-c
		Show GNU GPL

	NOTE: There are commented lines in bash script to be used in display
	modes 8, 15, 16 24 and 32 bits per pixel (not available in all
	systems).

FILES AND INSTALLATION FOR NORMAL USER
	Uncompress a file multiwm-R1.tar.gz to your home directory. (gunzip
	multiwm-R1.tar.gz ; tar -xvf multiwm-R1.tar). Go to the directory
	called .multiwm and move files in a way that after all you have
	directories and files something like this:

	~/bin/multiwm - the script itself. Modify it to correspond your system
		and its available windows managers and configurations and your
		personal (perverted?) taste. That directory must be in your
		path.

	~/.multiwm/ - a directory for different configuration files. It have
		following subdirectories

		xbase/ - contains a .Xdefaults file used by most window
			managers and their configurations, except FVWM with
			look and feel of 4DWM of IRIX of SGI and Enlightenment.

		4dwm, 9wm, afterstep, amiwm, enlightenment, fvwm, fvwm2,
			fvwm2TNL, fvwm95-2, fvwm95-2TNL, mlvwm,	twm etc. -
			subdirectories containing a proper .*wm*rc,
			.Xdefaults and/or .xinitrc for chosen window manager
			and its configuration. NOTE: Enlightenment has own
			directory called .enlightenment in users 
			homedirectory. Let files in that directory be there.

	/usr/doc/multiwm-R1/
		If you are a sys admin, you can create this directory
		and put files called README (this file), DOWNLOAD and COPYING
		there.

SEE ALSO
	- man pages and other documentations for window managers and X 
	- DOWNLOAD to find information about Internet-sites with window
	  managers and information about them.
	- COPYING to read GNU GPL

BUGS AND LIMITATIONS
	There should not be any bugs. Practically every user must modify this
	script to fit his/her own system and personal (perverted?) taste, and
	that is not a feature, it's a limitation. If you find some bugs or
	have some ideas to improve this script, send them via E-mail to
	Juhapekka Tolvanen (juhtolv@cc.jyu.fi). 

FUTURE 
	Maybe some new releases, bug fixes etc. but always remember, that
	Juhapekka Tolvanen thinks it's more imporant to get a life, gf and
	a degree M.Soc.Sc. :-) And it would be nice, if somebody could create
	a Debian and RPM packages of this.

AUTHORS
	Juhapekka Tolvanen (juhtolv@cc.jyu.fi)
		Ideas, most testing, documentation, publicity issues,
		distributing and some bash coding. Nerdish and geekish
		student of sociology. User of Linux, Sun Solaris and OS/2. 

	Mika Jorma Saaristo (mjsaaris@cc.jyu.fi)
		Most of the bash-coding and some testing. Student of
		mathematics. Real geek, nerd and computer guru. User of
		Minix, Linux, Sun Solaris etc.

HISTORY
	Version numbering and naming convention will be like this:
	Release X (some kewl nickname)

	Release 1 (Debut) released in April 10th 1997. Development
	environments included following hardware and software:
		Juhapekka Tolvanen:
		- An Intel Pentium 133 MHz w/ 48 Megs Memory
		- Red Hat Linux 4.1 with Kernel 2.0.29
		- XFree86 3.2 for S3 ViRGE and ViRGE VX
		- bash 1.14.7-1
		- FVWM95-2.0.42a-6 (The Next Level does not work with later,
		  I think)

		Mika Jorma Saaristo:
		- An Intel Pentium 150 MHz w/ 32 Megs Memory
		- Red Hat Linux 4.1 with Kernel 2.0.27
		- XFree86 3.2 for S3
		- FVWM95-2.0.42a-6 (The Next Level does not work with later,
		  I think)

UPDATES
	Latest version should be available from www-pages of
	Juhapekka Tolvanen:

	http://www.cc.jyu.fi/~juhtolv/unix/

	See the file DOWNLOAD to find some information about how to obtain
	different window managers and their configuration files.

LICENCING
	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
	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., 675 Mass Ave, Cambridge, MA 02139, USA.














