genscheme 1.1
~~~~~~~~~~~~~

Genscheme is a package which aids you in the simple but tedious task
of migrating your Windows 95 (TM) or Windows NT (TM) color schemes to
your Un*x-based setup ("scheme" here does not refer to the Scheme
language).  Some sample support is included for versions of fvwm2, as
well as some template resource definitions.

The actual color schemes from the Windows 95/NT (TM) operating systems
are not included, but a utility to obtain them is.  The included
getscheme.exe program is specifically designed for both Windows 95
(TM) and Windows NT 4.0 (TM), and will probably not work with other
versions (may change in the future).


Requirements
~~~~~~~~~~~~

	- Something to use it with (i.e., fvwm2, fvwm95 or anything else)

	- Perl version 5 (>= version 5.003)

	- M4 preprocessor

	- A Windows 95/NT (TM) machine to use getscheme.exe


Installation
~~~~~~~~~~~~
	
Genscheme is configured with GNU Autoconf.  Decide where to install it
with the --prefix option if you want.  You should be able to:

./configure
make
make install

This will make a directory named "genscheme" in the prefix directory
(default is /usr/local) and copy some template files to it as well as
the getscheme.exe Win32 executable.  It will also install the Perl
executable and man page.

The first thing you want to do is copy the getscheme.exe program to a
Windows 95 (TM) or Windows NT 4 (TM) machine to obtain some data.
Copy the output of getscheme.exe to your Un*x machine (no carriage
return translation is necessary).  Operation from here is pretty
simple and flexible, but it might take a bit of getting used to.
Please consult the man page as it contains usage instructions and a
number of examples.


Quick examples and tips to get you started
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- Let's say that you run fvwm2 and that the output from getscheme.exe
(run on Windows 95/NT) is transferred to your Un*x home directory in
the file schemes.txt.

In the directory in which you run fvwm2 from (typically your home
directory), run the following commands exactly as shown (make sure the
Schemes directory does not exist in your home directory).

genscheme < schemes.txt -o Schemes -appendfn Schemes.fi -m4opts "-DFont=9x15" fvwm2
genscheme < schemes.txt -o Schemes -m4opts \
   "-Dcmd=\"Exec xsetroot -solid \\\"Background\\\"\"" cmd

These commands will create a number files in a directory named
Schemes.  Then, edit your .fvwm2rc and add the following near the menu
section:

Read "Schemes/Schemes.fi"

Then, add the menu named Schemes to one of your menus with the line:

AddToMenu "SomeMenu"
[other items]
+ "Schemes" Popup Schemes

- fvwm 2.0.44 (and above) has features to support these color schemes
better.  See README.templates for descriptions of some sample
templates which take advantage of these features.

- If you use fvwm95, the commands above are similar but refer to the
fvwm95 template instead.  The fvwm95 template does not affect the
MenuFont as the fvwm2 MenuStyle command does (thus the Font m4 options
is unneeded).  Thus, the commands you might run:

genscheme < schemes.txt -o Schemes -appendfn Schemes.fi fvwm95
genscheme < schemes.txt -o Schemes -m4opts \
   "-Dcmd=\"Exec xsetroot -solid \\\"Background\\\"\"" cmd

Then you would add the menu commands to the .fvwm95rc (or .fvwm2rc95)
file instead of the .fvwm2rc.

Note: if putting the Read command in your rc file causes your TaskBar
to turn white (or other strange things), then instead of the Read
command above, insert the entire menu file in your .fvwm95rc where the
Read command would have been.

- Restart your window manager, and then choose a particular scheme
from the menu you added.

- I use a shell script similar to the following to simplify the above
process (following works best for the fvwm2* templates):

#! /bin/sh
if [ "$#" != 3 ]; then
	echo "usage: $0 <color file> <output dir> <template>";
	echo "warning: output directory will be removed!";
	exit 1;
fi
rm -rf "$2"
genscheme < "$1" -o "$2" -m4opts \
        "-DFont=-adobe-helvetica-medium-r-*-*-12-*-*-*-*-*-*-*" \
        -appendfn Schemes.fi "$3"
genscheme < "$1" -o "$2" -m4opts \
        "-Dcmd=\"Exec xsetroot -solid \\\"Background\\\"\"" cmd

- You could also load a scheme at startup by placing something like

Read "Schemes/MyScheme"

near the beginning of your rc file (but after or replacing your setup
commands).

- Please read the genscheme man page and the template files themselves
since there are many more things you can do with them with a bit more
customization.


Note: Windows 95 and Windows NT are trademarks of Microsoft Corp.
--
December 27, 1996
Andrew Veliath <veliaa@rpi.edu>
