How to guide for Enlightenment/2 and Windowmaker/2

By Christoph Vogelbusch

The following steps are only NO-FAIL steps. That means you do not have to do it that way, but that way has proven to work. The description shows first what to do than "how to do". The "how to do" means you have to be in a shell, e.g. OS/2 window and the downloaded files are on the root of your system drive while it is supposed that the system drive is C: else please exchange C: through your system drive. (Sometimes here is used a * instead of mentioning all the different names, this can be used as long as there are no other ZIPs in your root than the mention ones. If you do not have unzip.exe get it from ftp://ftp.infozip.org/pub/infozip/os2/ and run it to extract it. Last copy at least the 'unzip.exe' to your path (e.g. C:\OS2).

1) Steps for installation
Location = Files = download these " " = enter these lines in a shell (without ") ' ' = enter these string in the mentions position (without ')


 * Enlightenment/2 (optional)
 * Location:Enlightenment/2
 * Files:
 * required section: everything
 * optional Files: epplets (+MESA), E/2 Config

Step (Unzippping)
"C:" "cd \" and unzip all E/2-archives "unzip *"
 * Got to the root of your system drive: e.g. C:\

Step (Start Enlightenment and ESD default)
(Enlightenment/2 will work on next Xfree86OS/2 start)
 * Open your \XFree86\lib\X11\xinit\xinitrc.cmd "e C:\XFree86\lib\X11\xinit\xinitrc.cmd"
 * search for the line 'twm' (Ctrl+F) and exchange 'twm' through 'enlightenment'. Add 'detach ESD.EXE -public -terminate'.
 * Note: Both lines need the ' ' this time!!!
 * Note: You may also remove the lines that are starting xman, xclock, xterm
 * Now you can save and exit.
 * Note: On the middle mouse button menu you can find 'regenerate menus' under 'maintenance'.

New Installation
If you have problems with a new installation, try to delete .enlightenment in your home directory.

XFree86 3.3.5
You can use E/2 with XFree86 3.3.5 but without a fixed server TTF support is missing. To add TTF support you can use XFSTT. Here is the page with the How To Use XFSTT

BlueSTeel
To switch to completely BlueSteel (You need GTK-Engine and E/2): Or get the GNOME Control Center to install (needs GNOME).
 * Download BlueSteel.etheme to XFree86\lib\X11\enlightenment\themes
 * Unzip the GTK-Theme ZIP to your X/2 root
 * Run: "copy X:\XFree86\share\themes\BlueSteel\gtk\.gtkrc %HOME%
 * Now you have only to enter E/2 and select blue Steel from the Themes (3rd Mouse Button)

More Tips
Using X-Apps from a network-computer:
 * Start X
 * Press Ctrl+ESC to return to PM
 * Connect to the computer you wish through ssh or telnet
 * run an xterm (xterm &)
 * Now you can switch to X (through tasklist) and use the xterm to run apps
 * Note: if you've used ssh the further usage of the xterms and other apps is still secured

... install Windowmaker
 * Unzip all necessary files or use the WPI Package.
 * Edit the file xinitrc.cmd (in the directory XFree86/lib/X11/xinit). Replace the lines containing the name of your window manager (e.g. icewm.exe or twm.exe) by wmaker.exe.
 * Run the install script /XFree86/bin/wmaker-inst.cmd. These step is not needed if you use the wpi package, it is done automatically.

How to report bugs for Enlightenment/2
Bugs of E/2 are mostly 2 types - critical, which causes Segmentation Faults, E/2 not starting and so on and common.

If you think you've found a bug, do not hesitate to mail the author (Platon Fomichev), however please do not write something like "I have big bad bug, E/2 crashes, please help." Please Also plz attach config.sys and xf86config if you have a grave bug.
 * 1'st tell him ALL about your computer (Processor, Video, RAM)
 * 2'nd OS/2 things - OS/2 version, Fixpack, X version, EMX version
 * 3'rd - E/2 things - E version, E executable size and date.