This is a brief How-To for users of OzOS, e17_svn and easy_e17. It shows you how to simply add or remove components of e17 that are available in svn (source code).

Please do not use this method if you have e17 installed from a binary - ie. via your usual package manager.

The OzOS and easy_e17 scripts already download all the available e17 source code but are configured to "skip" (not compile and install) a number of components. You can change that configuration and use any of the "skipped" components - but please remember that these have been put on the default "skip" list for a reason - possibly because they simply don't work!

As always, when making changes that could break your system, make whatever backups you consider necessary (OzOS users and people who are using oz-e17-tools) can use the in-built "Backup e17" menu item to make a backup. It is also a good idea to do an"apt-get update" and apt-get upgrade" to ensure your scripts are up to date and to update e17 before you start.

1. To install a component that you currently "skip"

I'll use the "flame" application as an example - just substitute "flame" with the component you want to install.

Edit the easy_e17 configuration file that tells the script which packages to skip. Open it with:

> sudo {name of text editor} /etc/easy_e17.conf

(eg: "sudo scite /etc/easy_e17.conf" )

find and delete "flame" from the list then save.

Then update and compile the new app with the command:

> sudo easy_e17.sh --only=flame

That's it - I'll leave it to you to work out how to invoke and configure your new e17 component. (flame is a module, so it has to be loaded. It can then be configured from the Settings Panel>Look dialog.)

2. To Uninstall a Component

OK, let's say you installed "flame" but you don't want it anymore. Here's how to get rid of it - (thanks to smartboyathome for this procedure).

Firstly, you will need to find where the "flame" source code is located. It will be in a directory under /var/cache/e17_src - possibly (in this case anyway) in E-MODULES-EXTRA/

Open a terminal and change to that directory:

> cd /var/cache/e17_src/E-MODULES-EXTRA/flame/

Then manually uninstall it with:

> sudo make uninstall

> sudo make clean

That should do it. If uninstall doesn't work, try "sudo make remove" instead.

You then need to add "flame" back to /etc/easy_e17.conf so that it doesn't get installed again on the next update.

> sudo {name of text editor} /etc/easy_e17.conf

and add "flame," anywhere in the list.

have fun.

Aubrey