<page columns=1 padding=12 name=front background=bg.jpg linkcolor=#88dddd>
<font face=verdana/22 color=#eeeeee>
<p align=50%> E-FancyLauncher

<font face=verdana/14 color=#eeee00>
<p align=50%> An Icon Launcher Epplet<br>

<font face=verdana/10 color=#ffffff>
Version 0.7 - 11.03.2000<br>
By Alexandre David
<p>
This is a simple but highly customizable launcher epplet. 
When you start the epplet for the first time or when you 
upgrade, this help will be displayed. To view it again 
later, press F1 when the epplet has focus. To exit the epplet, 
press Escape or close it (Alt right click - close).

<p align=50%>
_Usage(usage)<br>
_Configuration(config)<br>
_Changes(changes)<br>
_Examples(snap)

<p>
adavid@docs.uu.se<br>
http://www.docs.uu.se/~adavid
<p>
Credits to Timothy Metz (tmetz@frankfurt.netsurf.de)
for suggestions and reviewing the documentation.<br>
This font comes from the theme spiffE.

<page columns=1 padding=12 name=usage background=bg.jpg linkcolor=#88dddd>
<font face=verdana/14 color=#eeee00>
<p>
Usage

<font face=verdana/10 color=#ffffff>
<p>
This epplet uses pixmap buttons to launch programs easily. 
By default there is a (1) on the first page, and a (2) and a (3), 
respectively, on the second and third pages. To change pages 
press mouse buttons 1,2 or 3 while over this special button. 
Keys 1,2 and 3 work as well.
<p>
In transparent mode the mouse has to be over the pixmap to
get the focus. If raiseable button is set, the button gets
a new background depending on the epplet theme and it is then
easier to press the button. This effect may be desired if the 
pixmap has transparent holes (yes, icon transparency is fully 
supported). When a button gets the focus a tooltip is immediately 
displayed if one is defined (and if tooltips are enabled).
<p>
See the _configuration(config) to customize your pixmaps, the
button and epplet dimensions, the grid and the tooltips.

<page columns=1 padding=12 name=config background=bg.jpg linkcolor=#88dddd>
<img src=config_window.png x=70 y=112>
<font face=verdana/14 color=#eeee00>
<p>
Configuration

<font face=verdana/10 color=#ffffff>
<p>
To get the configuration window press the first icon on the
second page (default configuration) or press F2.
To change pages in the button list, press keys 1,2,3 or change pages on
the main epplet.
The window (reduced) looks like this :

<page columns=1 padding=12 name=config2 background=bg.jpg linkcolor=#88dddd>
<font face=verdana/10 color=#ffffff>
<p>
When moving the mouse on the list of buttons, the focused
buttons raise themselves if the raise flag is on. Pressing
a line in the list selects a button and displays it in the
different fields "Pixmap", "Command" and "Tooltip".
Changing them and pressing Enter updates the buttons.
If enter is not pressed, editing the fields has no committed
effect unless "Apply" is pressed. The fields reflect
directly the _configuration_file_format(configfile) of the
epplet.
<p>
You can move the buttons in the list by just dragging
them. The mouse cursor will change and the buttons
will be updated instantaneously in the main epplet.
<p>
You can change the epplet width and height. Notice that
if you press Enter for one of these, the other is
recomputed in order to keep the ratio. The same is true
when changing the number of columns and rows of the
layout. You have to press "Apply" to commit the change.
<br>
The list height (or size) can be changed interactively
as well. Minimum value is 3. You have to press "Apply"
to commit this.
<p>
The pixmap may have an inner border inside the buttons
that is controlled by the "Inner border" field. Press
enter of "Apply" to see the change.
<p>
Transparency of the background, raiseable buttons and tooltips
are controlled by the three toggle buttons on the right.

<page columns=1 padding=12 name=configfile background=bg.jpg linkcolor=#88dddd>
<font face=verdana/14 color=#eeee00>
<p>
Configuration File

<font face=verdana/10 color=#ffffff>
<p>
Configuration is defined in the directory ~/.enlightenment/epplet_config/E-FancyLauncher/.
Entries in the configuration files are of the form key values.
The different key definitions are:
<br>
_EPPLET_WIDTH(dimension)<br>
_EPPLET_HEIGHT(dimension)<br>
_COLUMNS(dimension)<br>
_ROWS(dimension)<br>
_TRANSPARENT(more)<br>
_RAISE(more)<br>
_TOOLTIPS(more)<br>
_ICON_BORDER(more)<br>
_LIST_HEIGHT(more)<br>
_PAGEx_ICONy(button)<br>
_PAGEx_PROGy(button)<br>
_PAGEx_TOOLTIPy(button)<br>
_TRANSP_RAISE(button)
<p>
Obsolete key definitions are:<br>
_EPPLET_WIDTHx16(obsolete)<br>
_EPPLET_HEIGHTx16(obsolete)<br>

<page columns=1 padding=12 name=dimension background=bg.jpg linkcolor=#88dddd>
<font face=verdana/14 color=#eeee00>
<p>
Epplet Dimension

<font face=verdana/10 color=#ffffff>
<p>
Dimension of the E-FancyLauncher is configurable via the
definitions of EPPLET_WIDTH and EPPLET_HEIGHT. These expect a 
number for the size in pixels or *number for the size in multiples 
of 16. NOTE: This is the epplet size and not the button size. Icons 
will be scaled to fill the defined dimensions.
<p>
Example:
<font face=verdana/10 color=#ccdddd>
EPPLET_WIDTH *3<br>
EPPLET_WIDTH 48
<font face=verdana/10 color=#ffffff>
<p>
These two are equivalent. Multiples of 16
are useful since common epplets use this.
These are "Epplet width" and "Epplet height" in
the configuration window.
<p>
<font face=verdana/14 color=#eeee00>
Button Layer

<font face=verdana/10 color=#ffffff>
<p>
The buttons are organized in a grid. You can define how many rows 
and how many columns to use. The grid will use the whole size of 
the epplet. Columns and rows are defined by COLUMNS and ROWS respectively.
These are "Columns" and "Rows" in the configuration window.
Notice that the icon size depends on the epplet size and
the layout and is adjusted automatically.

<page columns=1 padding=12 name=more background=bg.jpg linkcolor=#88dddd>
<font face=verdana/14 color=#eeee00>
<p>
Fancy Configuration

<font face=verdana/10 color=#ffffff>
<p>
E-FancyLauncher's fancy features are transparency, 
raiseable buttons and tooltips, hence its name.
<p>
The background of the epplet can be transparent
or have the default epplet background. The flag
TRANSPARENT controls this. Its values are 0 and 1.
Default is 0.
<p>
Buttons can be raised or flat when the mouse is over them.
This is even compatible with the transparency !!! The flag
controlling this is named RAISE and its values are 0 and 1.
Default is 1.
<p>
Tooltips are displayed when the mouse is over a
button if this button defines a tooltip. 
To enable or disable this feature, use the flag
TOOLTIPS, its values are 0 and 1. Default is 1.
<p>
Icon border inside the buttons is controlled by
the ICON_BORDER resource.
<p>
The list height in the configuration window is
controlled via the LIST_HEIGHT resource.

<page columns=1 padding=12 name=button background=bg.jpg linkcolor=#88dddd>
<font face=verdana/14 color=#eeee00>
<p>
Button Configuration

<font face=verdana/10 color=#ffffff>
<p>
The buttons are defined for each page. Icons, programs
to launch and tooltips are defined respectively with the generic
format PAGEx_ICONy, PAGEx_PROGy and PAGEx_TOOLTIPy. x is the page 
number and y is the button number. The buttons are then layered in 
order in the defined grid, first horizontaly and then verticaly to 
fill the grid.
<p>
The icon definition is the image name, relative to
/usr/share/pixmaps, /usr/share/icons, your home.
You can provide the absolute path as well.
<p>
The program definition is the command line to
execute in sh syntax. If the command begins with
!, the epplet will wait for the command to
complete. This is used in the default configuration
for the mount/umount commands and this allows the
epplet to display a failure message.<p>

Instead of a program for the command line you
can use _special(special) command names.
<p>
The transparent raise button feature is experimental
and works well when the epplet is not hidden and
is fully on the current screen.

<page columns=1 padding=12 name=special background=bg.jpg linkcolor=#88dddd>
<font face=verdana/14 color=#eeee00>
<p>
Special Commands
<font face=verdana/10 color=#ffffff>
<p>
__SWITCH(example)
defines the page switcher action, so you can have it
wherever you want (or not at all). Clicking it with
mouse button 1 (or pressing key "1") will get you to 
page 1, and the same for pages 2 and 3.
<p>
__QUIT defines an exit button. Escape is the shortkey.
<p>
__INFO will display this help. F1 is the shortkey.
<p>
__CONFIG will open the configuration window. F2 is the
shortkey.
<p>
You are free to use these commands wherever you
want exactly as normal commands, or ommit them.
<p>
_Button_configuration_cont.(button2)

<page columns=1 padding=12 name=button2 background=bg.jpg linkcolor=#88dddd>
<font face=verdana/14 color=#eeee00>
<p>
Button Configuration (cont.)

<font face=verdana/10 color=#ffffff>
<p>
Tooltips are just plain text. In some cases it is good
to leave a blank space at the end of the tooltip because 
enlightenment has problems with computing the right size.
<p>
You can define a null entry with "-". Do not use
empty definitions (better to remove them), because enlightenment
does not return "" as expected. By using a null entry
you can disable a button, a tooltip or a program.
You can create custom spacing in the epplet. The button will
be pressable only if the program associated with
is not a null.
<p>
If too many buttons are defined for a grid on a page
they are not displayed. If not enough buttons are
defined to fill the grid, the remaining cells are
empty.
<p>
When an icon is not found (and may be the case for
default icons on your system), blank buttons are
used. This is true even in transparent mode to
show that there is a button to press.

<page columns=1 padding=12 name=obsolete background=bg.jpg linkcolor=#88dddd>
<font face=verdana/14 color=#eeee00>
<p>
Obsolete Configuration

<font face=verdana/10 color=#ffffff>
<p>
In version 0.1, EPPLET_WIDTHx16 and EPPLET_HEIGHTx16
were used to define the size in multiples of 16. These
are now obsolete. When starting 0.2 for the first time,
the launcher will parse them for backward compatibility
reasons. They will ignored if EPPLET_WIDTH and EPPLET_HEIGHT 
are defined with the new syntax. Do not use the old method 
any more.
<p>
When upgrading after 0.1, the new options and syntax will be 
written at the end of the configuration file, but remember 
that the two options from the beginning will be ignored when
they are found at the end with the new syntax. Do NOT use the old
syntax any more.
<p>
The old configuration file will contain a line starting
with "Please customize...". You can remove this line, the
new one is marked with the epplet version to notify
the user with the help window at each upgrade.

<page columns=1 padding=12 name=example background=bg.jpg linkcolor=#88dddd>
<font face=verdana/14 color=#eeee00>
<p>
Example : Default Configuration

<font face=verdana/10 color=#ffffff>
<p>
The default configuration looks like this :
<p>
<font face=verdana/7 color=#bbbbbb>
### Automatically generated Epplet config file for E-FancyLauncher.<br>
<br>
v0.4:Please customize your entries. Removing this line will display the help again.<br>
EPPLET_WIDTH *3<br>
EPPLET_HEIGHT *9<br>
COLUMNS 2<br>
ROWS 6<br>
LIST_HEIGHT 6<br>
TRANSPARENT 1<br>
RAISE 1<br>
ICON_BORDER 0<br>
TOOLTIPS 1<br>
PAGE0_ICON0 /usr/share/enlightenment/epplet_data/E-FancyLauncher/1.gif<br>
PAGE0_PROG0 __SWITCH(button)<br>
PAGE0_TOOLTIP0 Switch page<br>
PAGE0_ICON1 mc/i-directory.png<br>
PAGE0_PROG1 rxvt -title "Midnight Commander" -e mc<br>
PAGE0_TOOLTIP1 Midnight Commander<br>
PAGE0_ICON2 emacs.png<br>
<p>
<font face=verdana/10 color=#ffffff>
The line v0.4:... is used to mark the file and the epplet
version to start the help the first time you launch the epplet.
Removing it will start the help again and the line will
reappear. When upgrading you can remove it since the new
one has a different version.

<page columns=1 padding=12 name=changes background=bg.jpg linkcolor=#88dddd>
<font face=verdana/14 color=#eeee00>
<p>
Changes since 0.1

<font face=verdana/10 color=#ffffff>
<p>
0.2:<br>
Improved epplet dimension configuration.<br>
Added transparency, raiseable button and tooltip
flags.<br>
Drawing routines redesigned.<br>
Theme change fixed (delayed actually, but it works).<br>
Multiple instances fixed.<br>
Rewrote the documentation.<br>
Added _snapshots(snap) .
<p>
0.3: Bug fixes!
<p>
0.4:<br>
Configuration window.<br>
Added inner borders and special commands.<br>
Some bug fixes.<br>
New default configuration.
<p>
0.5: Wheel mouse support.
<p>
0.6: fixed 0.5!
<p>
0.7: experimental transparent raise button.

<page columns=2 padding=12 name=snap background=bg.jpg linkcolor=#88dddd>
<img src=E-FancyLauncher.s3.png x=180 y=12>
<img src=E-FancyLauncher.h2.png x=16 y=170>
<img src=E-FancyLauncher.v1.png x=316 y=6>
<img src=E-FancyLauncher.v1t.png x=356 y=3>
<img src=E-FancyLauncher.v1ttip.png x=410 y=6>
<font face=verdana/14 color=#eeee00>
<p>
Configuration examples

<font face=verdana/10 color=#ffffff>
<p>
Default :
<p>
<p>
<p>
Horizontal :
<p>
<p>
<p>
Vertical, focused ->
<p>
Vertical transparent -->
<p>
Vertical transparent, focused with tooltip --->
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p>
<p align=100%> - Have fun - <br> Alexandre




