Eagle Mode -
Install and Start

Copyright © 2008 Oliver Hamann. Homepage: http://eaglemode.sourceforge.net/

# Contents

1 How to install Eagle Mode
2 How to start Eagle Mode
3 Special cases
3.1 Proper installation to /usr
3.2 FreeBSD
3.3 Cygwin

# 1 How to install Eagle Mode

For installing Eagle Mode, first unpack the source package and cd into the unpacked directory. After that, the project has to be compiled (built) and then it can be installed. Here are the basic commands for doing that:

`perl make.pl build`
`perl make.pl install`

This would build the project using the GNU compiler, and it would install to a default directory (on UNIX-like systems it is `/usr/local/eaglemode`). There are some options you could give to the commands. For example, if you want to install to another directory, say something like:

`perl make.pl install dir=/opt/eaglemode`

A full description of all the options can be seen with:

`perl make.pl help`

Hints:

- You could skip the `install` step and run Eagle Mode directly from the source directory after `build`.

- `make.pl` installs nothing outside the installation directory.

- There is no problem in moving the installation directory afterwards. Its path and name are not stored in any files.

# 2 How to start Eagle Mode

For starting Eagle Mode, go into the directory where Eagle Mode has been installed, and run the file `eaglemode.sh`. Exception: Windows users have to run `eaglemode.wsf` instead.

If you wonder about the files in the `bin` directory: These executables need some special environment variables and cannot be run directly.

# 3 Special cases

## 3.1 Proper installation to /usr

Originally, Eagle Mode is designed for being installed in an own directory like `/usr/local/eaglemode` or `/opt/eaglemode`. But if you want to have it divided in `/usr/bin`, `/usr/lib`, `/usr/share` and so on, you could do it like in this example:

> `perl make.pl build`
> `perl make.pl install dir=/usr/lib/eaglemode`
> ``
> `cd /usr/lib/eaglemode`
> `mv -T doc ../../share/doc/eaglemode`
> `ln -s ../../share/doc/eaglemode doc`
> `mv -T res ../../share/eaglemode`
> `ln -s ../../share/eaglemode res`
> `mv -T etc /etc/eaglemode`
> `ln -s /etc/eaglemode etc`
> ``
> `cd /usr/bin`
> `ln -s ../lib/eaglemode/eaglemode.sh eaglemode`
> ``
> `cd /usr/lib`
> `ln -s eaglemode/lib/*.so .`
> ``
> `cd /usr/include`
> `ln -s ../lib/eaglemode/include/* .`

## 3.2 FreeBSD

Before building Eagle Mode on FreeBSD, you should execute the following commands, otherwise certain plugins may fail to build.

> `CPATH=/usr/local/include`
> `export CPATH`
> `LIBRARY_PATH=/usr/local/lib`
> `export LIBRARY_PATH`

## 3.3 Cygwin

Rebase DLL's!

After installing Eagle Mode on Cygwin, and before starting it for the first time, you must rebase all Cygwin DLL's including those of Eagle Mode. Please get familiar with the rebaseall program. The basic steps are as follows (remember to replace the paths according to your installation):

> Quit all programs, stop the "CYGWIN cygserver" service (if running), open a Windows Command box and type these commands:
> `# set PATH=c:\cygwin\bin`
> `# ash`
> `# bash`
> `# ls -1 --indicator-style=none /usr/local/eaglemode/lib/*.dll > /tmp/extra.lst`
> (At this point you could add further non-standard DLL's to /tmp/extra.lst)
> `# cat /tmp/extra.lst`
> (Check that the Eagle Mode DLL's are shown by the above command)
> `# exit`
> (Back in ash, never do the following in bash or while any other Cygwin program is running)
> `# rebaseall -T /tmp/extra.lst -v`

You have the choice: emX11 or emWnds

If you want Eagle Mode to use the Windows API directly instead of X11, set the environment variable `EM_GUI_LIB=emWnds` before starting. But note that the file manager commands require X11 in any case.

Flaws

- Eagle Mode does not perform very fast on Cygwin.
- Do not enter the fullscreen mode with emX11 on Cygwin. Otherwise the keyboard focus may get lost.

Next Reading: General User Guide