e16
/
e16
3
0
Fork 1
Code Issues Pull Requests Projects Releases Wiki Activity

docs: Corrections after conversion, remove obsolete stuff, updates

This commit is contained in:
Kim Woelders 2022-06-02 08:24:59 +02:00
parent 356120fd31
commit 63a89ade81
1 changed files with 192 additions and 403 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

595
docs/e16.asc
View File

@ -1,3 +1,5 @@
= The e16 window manager
[[documentation]]
== User Documentation
@ -84,7 +86,7 @@ This may vary from system to system. The OS and X server may also vary
the method in which you do this, if it is possible. Not having a middle
mouse button in e16, or for that matter X, is not a good thing as it is
almost assumed to be there, and is used by many applications, including
E.
e16.
If you have a Wheel-Mouse and X is configured to use it, e16 supports it
by default.
@ -160,25 +162,37 @@ remember the current window border.
Below are the keybindings for e16 as it comes "from the factory"
ALT+(F1 - F8) - Go to desktop 0 - 7, ALT+Tab - Switch focus to the next
window, CTRL+ALT+Home - Auto-arrange windows, CTRL+ALT+Del - Log out,
CTRL+ALT+End - Restart, CTRL+ALT+Ins - Launch Eterm, CTRL+ALT+Left - Go
to the previous desktop, CTRL+ALT+Right - Go to the next desktop,
SHIFT+ALT+Up - Move to the virtual desktop above, SHIFT+ALT+Down - Move
to the virtual desktop below, SHIFT+ALT+Left - Move to the virtual
desktop on the left, SHIFT+ALT+Right - Move to the virtual desktop on
the right, CTRL+SHIFT+F1 - Show User menu, CTRL+SHIFT+F2 - Show
Enlightenment menu, CTRL+SHIFT+F3 - Show Settings menu, CTRL+SHIFT+F4 -
Show Window List menu, CTRL+ALT+A - Toggle visibility of all buttons,
CTRL+ALT+B - Toggle visibility of theme buttons, CTRL+ALT+C - Toggle
visibility of configuration buttons, CTRL+ALT+Up - Raise active window,
CTRL+ALT+Down - Lower active window, CTRL+ALT+X - Close active window,
CTRL+ALT+K - Kill active window nastily, CTRL+ALT+I - Iconify active
window, CTRL+ALT+R - Shade/unshade active window, CTRL+ALT+S -
Stick/unstick active window, CTRL+ALT+M - Maximize/unmaximize active
window, CTRL+ALT+F - Enter/leave fullscreen mode for active window,
CTRL+ALT+W - Show Window Operations menu for active window, ALT+Enter -
Zoom/unzoom active window
[horizontal]
ALT+(F1-F8) :: Go to desktop 0 - 7
ALT+Tab :: Switch focus to the next window
CTRL+ALT+Home :: Auto-arrange windows
CTRL+ALT+Del :: Log out
CTRL+ALT+End :: Restart
CTRL+ALT+Ins :: Launch xterm
CTRL+ALT+Left :: Go to the previous desktop
CTRL+ALT+Right :: Go to the next desktop
SHIFT+ALT+Up :: Move to the virtual desktop above
SHIFT+ALT+Down :: Move to the virtual desktop below
SHIFT+ALT+Left :: Move to the virtual desktop on the left
SHIFT+ALT+Right :: Move to the virtual desktop on the right
CTRL+SHIFT+F1 :: Show User menu
CTRL+SHIFT+F2 :: Show Enlightenment menu
CTRL+SHIFT+F3 :: Show Settings menu
CTRL+SHIFT+F4 :: Show Window List menu
CTRL+ALT+A :: Toggle visibility of all buttons
CTRL+ALT+B :: Toggle visibility of theme buttons
CTRL+ALT+C :: Toggle visibility of configuration buttons
CTRL+ALT+Up :: Raise active window
CTRL+ALT+Down :: Lower active window
CTRL+ALT+X :: Close active window
CTRL+ALT+K :: Kill active window nastily
CTRL+ALT+I :: Iconify active window
CTRL+ALT+R :: Shade/unshade active window
CTRL+ALT+S :: Stick/unstick active window
CTRL+ALT+M :: Maximize/unmaximize active window
CTRL+ALT+F :: Enter/leave fullscreen mode for active window
CTRL+ALT+W :: Show Window Operations menu for active window
ALT+Enter :: Zoom/unzoom active window
[[desktops]]
=== Multiple & Virtual Desktops
@ -410,6 +424,7 @@ run, apply the current location, size, border style or any other
attribute to that window. E16 can also launch the application for you
upon startup if you so wish.
[[settings]]
=== Settings
When you click the right mouse button on the desktop background you will
@ -456,7 +471,7 @@ group(s) of a window. Click again to returning to the previous border.
Windows can be in multiple groups at the same time, so for many options
you have to indicate which group you are referring to. Selecting the
appropriate checkboxes (showing the group members' titles) at the top of
appropriate checkboxes (showing the group member's titles) at the top of
the dialog windows.
[[backgrounds]]
@ -469,7 +484,6 @@ theme may add a background or two to your available selections, but most
users want to have even more backgrounds to choose from. To add
backgrounds to your selection, make a backgrounds directory under your
home directory. To do this using most shells you can type
....
$ mkdir ~/.e16/backgrounds
....
@ -489,6 +503,7 @@ select "Background". You can use this dialog to change your background,
too, as well as fine-tune all the various settings for each individual
background available.
[[tooltips]]
=== Tooltips
From time to time, as you use e16, if you don't remember what does what,
@ -501,11 +516,10 @@ selecting "Tooltips" in the link:#settings[Settings Dialog].
=== Audio
Of course, e16 comes preconfigured to play lots of little blips and
beeps when you do various things on your desktop. In order to use sound
in e16, you must have both EsounD and audiofile installed.
If enabled and the theme supports it e16 will play lots of little blips
and beeps when you do various things on your desktop.
You can enable and/or disable sound at runtime by selecting "Sound" in
You can enable and/or disable sound at run-time by selecting "Sound" in
the link:#settings[Settings Dialog].
[[focus]]
@ -541,7 +555,7 @@ ALT+TAB link:#defkeys[Keybinding].
=== Moving Windows
E16 comes with several different available methods for moving a window.
You can perform the actual moves using the Window link:#border[Border],
You can perform the actual moves using the window link:#border[border],
or by using the available link:#mousebind[Mouse Bindings]. This will
cause the window to move until you have released the mouse button.
@ -550,10 +564,6 @@ default), open up the link:#settings[Settings Dialog], and select
"Move/Resize". You can select the mode from a list. Experiment until you
find one that suits you best.
For some serious eye candy, try out the Translucent move mode. This will
only work if your X server and e16 are running on the same machine,
however.
[[resizemode]]
=== Resizing Windows
@ -568,10 +578,6 @@ the default), open up the link:#settings[Settings Dialog], and select
"Move/Resize". You can select the mode from a list. Experiment until you
find one that suits you best.
The best eye candy resize mode is probably technical move mode. This
mode shows you the height and width of the window, in addition to the
distance from the nearest edge.
[[windowops]]
=== The Window Operations Menu
@ -637,20 +643,20 @@ every new window that attempts to map itself.
=== E16 and IPC
E16 has a fairly interesting IPC system that allows external
applications (such as Eterm) to talk to e16 and both ask for information
applications to talk to e16 and both ask for information
and change information. There is a program that was installed with e16
called "eesh" that is a simple shell interface to the IPC in e16. It's
even got its own documentation. You can go into eesh and type "help" and
it should spit back a list of commands that it understands.
Note: there are many commands that will show up in E's IPC that don't
Note: there are many commands that will show up in e16's IPC that don't
necessarily work yet, or aren't fully implemented. You CAN potentially
do some really bizarre things to your system by using eesh, but for the
most part it's just another interesting interface to E. In your
distribution package you should have received some sample scripts
written in Perl that interface to E through eesh showing how you can
externally script E to do more things outside E's base functionality.
Expect the IPC to flesh out even more in future revisions.
most part it's just another interesting interface to e16.
In your distribution package you should have received some sample scripts
written in Python or Perl that interface to e16 through eesh showing how
you can externally script e16 to do more things outside e16's base
functionality.
To exit eesh, hit CTRL + D (EOF)
@ -664,7 +670,7 @@ controls the contents of your left-mouse button link:#rootmenu[Menu].
The very first line of this file contains the title for the menu, and
the remainder of the file looks something like this:
"Eterm" NULL exec "Eterm"
"xterm" NULL exec "xterm"
Where each column represents:
@ -682,8 +688,7 @@ To set your own keybindings, all you have to do is find the bindings.cfg
file that was installed with e16, and make a copy in your ~/.e16
directory. This file shouldn't be too difficult to edit. Be careful! The
keybindings in this file will override ALL the default keybindings, as
long as this file exists, so edit this file with extreme caution (unless
you know what you're doing).
long as this file exists, so edit this file with caution.
To reset your keybindings back to the default, simply remove this file
from your ~/.e16 directory. The next time you restart e16 it should
@ -699,7 +704,7 @@ themes are distributed in the e16-themes package. You can select the the
theme from the link:#rootmenu[Settings menu], going to the "Themes"
selector, and then choosing a new theme.
Many more themes are available elsewhere, see link:#res[themes]
Many more themes are available elsewhere, see link:#res[themes].
To install a new theme is simple: all you need to do is take the
bleh.etheme file and drop it into your ~/.e16/themes directory. Once
@ -707,7 +712,7 @@ you've restarted e16, it will automatically show up in your Themes
link:#rootmenu[menu], and you can choose it just like any other theme.
[[eyecandy]]
=== E16's Eye candy Features
=== E16's Eye Candy Features
Of course, e16 wouldn't be complete without just a few bits of eye candy
to play with.
@ -720,10 +725,6 @@ the bottom of your screen.
The waves effect - similar to ripples, but this one waves up and down as
opposed to side-to-side
On the "Transparency" link:#settings[settings] dialog you can enable
"Theme Transparency". A slider controls the opacity of the window
borders, etc. with respect to the desktop background.
[[maint]]
=== Included Maintenance Scripts
@ -741,7 +742,7 @@ theme. This will help keep your disk usage by e16 down.
[[faq]]
=== Frequently Asked Questions
==== Q: I can't find my link:#iconbox[Iconbox] or change its settings.
==== Q: I can't find my link:#iconbox[iconbox] or change its settings.
A: There are two possibilities here.
@ -752,21 +753,21 @@ middle-click and select Desktop/Create new iconbox
and see if your icon appears. If so, right click on it to reconfigure
your Iconbox.
==== Q: I Can't Seem To Find My Left Mouse Menu
==== Q: I can't seem to find my left mouse menu
A: Your menu files may be destroyed. Try rerunning the program that
initially generated them. First you'll want to remove the
~/.e16/menus/*.menu files. Rebuild them using the
link:#maint[Maintenance] menu.
==== Q: All My Settings Are Mangled And I Can't Fix It
==== Q: All my settings are mangled and I can't fix it
A: Well, if things get really messed up, you can always remove all of
e16's automatically saved files. Go into ~/.e16, and remove the
e_config* files, and then blow away the cached directory. The next time
you start e16 it should reset everything to the default.
==== Q: I Upgraded My Theme, But The New One Isn't Being Used
==== Q: I upgraded my theme, but the new one isn't being used
A: When you upgrade a theme that does not come with e16, when you go
into your ~/.e16/themes directory, be sure to delete the unpacked
@ -793,44 +794,42 @@ link:#iconbox[Iconbox] documentation for more help
A: There is a special config option for it under the
link:#tooltips[tooltip] link:#settings[settings] menu.
==== Q: These Docs Didn't Help, Where Can I Get More Help?
==== Q: These docs didn't help, where can I get more help?
A: Well, we obviously can't answer all of your questions just by
predicting them, so I would try the link:#res[website] as well as
looking at the link:#res[mailing lists], especially the mail archives.
Chances are that someone else has probably had the same problem that you
have. And if all that still fails, you might try someone on the
link:#res[irc] channel
predicting them, so please check out the resources listed
link:#res[here].
== Additional Notes
=== Configuration
=== Configuration Settings
The configuration is stored in +$ECONFDIR/e_config--D.S.cfg+.
+$ECONFDIR+ is normally +\~/.e16+.
+D+ (+$DISPLAY+) and +S+ (screen) depend on your X setup but will typically be +0.0+.
So typically the configuration is stored in +~/.e16/e_config--0.0.cfg+.
All settings can be shown and set using eesh.
To get a full list of settings:
....
$ eesh show
....
To set some parameter:
....
$ eesh set <parameter> <value>
....
Some settings will not be effective until E is restarted.
Some settings will not be effective until e16 is restarted.
To get a list of all eesh commands:
....
$ eesh help full
....
The available configuration options are shown below. Values are the
defaults.
The available configuration options are shown below.
Values are the defaults.
....
# [bool] High quality background rendering
backgrounds.hiquality = 1
@ -870,7 +869,7 @@ compmgr.fading.time = 200
# Should normally be 1 but 0 may be a partial workaround of problems with vanishing
# pop-ups on certain X-server/toolkit versions.
compmgr.override_redirect.mode = 1
# [int] Opacity of override-redirect windows (pop-up's, etc)
# [int] Opacity of override-redirect windows (pop-ups, etc)
compmgr.override_redirect.opacity = 90
# [int] Number of desktops
@ -914,6 +913,8 @@ focus.transientsfollowleader = 1
focus.switchfortransientmap = 1
# [bool] Focus new windows
focus.all_new_windows_get_focus = 0
# [bool] Focus new transients if group is focused
focus.new_windows_get_focus_if_group_focused = 1
# [bool] Focus new transients
focus.new_transients_get_focus = 0
# [bool] Focus new transients if group is focused
@ -988,14 +989,17 @@ misc.dock.startx = 0
misc.dock.starty = 0
# [bool] Enable desktop background compatibility mode
# Fixes background in many apps using pseudotransparency
# Fixes background in many apps using pseudo-transparency
# May cause major slowdowns in certain setups
misc.hints.set_xroot_info_on_root_window = 0
# [bool] Logging destination (0: stdout, 1: stderr)
misc.log.dest = 0
# [bool] Show differential time in debug output
misc.log.difftime = 0
# [bool] Logging destination (0: stdout, 1: stderr)
misc.log.dest = 0
# [int] Magnifier zoom level
misc.magwin.zoom_res = 4
# [int] Move mode (0: opaque, 1: technical, 2: box, 3: shaded, 4: semi-solid, 5: translucent)
misc.movres.mode_move = 0
@ -1017,6 +1021,12 @@ misc.movres.update_while_moving = 0
misc.movres.enable_sync_request = 0
# [bool] Do not cover dragbar when maximizing
misc.movres.dragbar_nocover = 0
# [bool] Enable "smart" maximization
misc.movres.enable_smart_max_hv = 0
# [bool] Animate maximization
misc.movres.maximize_animate = 0
# [bool] Maximization animation speed
misc.movres.maximize_speed = 6000
# [int] Composite opacity of menu windows
misc.opacity.menus = 85
@ -1037,6 +1047,15 @@ misc.place.manual_mouse_pointer = 0
misc.place.center_if_desk_full = 0
# [bool] Ignore windows with struts (e.g. panels) when placing new window
misc.place.ignore_struts = 0
# [bool] Ignore struts when fullscreening windows
misc.place.ignore_struts_fullscreen = 0
# [bool] Ignore struts when maximizing windows
misc.place.ignore_struts_maximize = 0
# [int] Screen struts - strips at screen edge to avoid when placing windows
misc.place.screen_struts.left = 0
misc.place.screen_struts.right = 0
misc.place.screen_struts.top = 0
misc.place.screen_struts.bottom = 0
# [bool] Raise fullscreen windows (increase stacking level while fullscreen)
misc.place.raise_fullscreen = 0
# [bool] Slide windows in
@ -1086,6 +1105,7 @@ misc.testing.argb_internal_clients = 0
misc.testing.argb_clients = 0
misc.testing.argb_clients_inherit_attr = 0
misc.testing.image_cache_size = -1
misc.testing.ximage_cache_count = -1
misc.testing.mask_alpha_threshold = 8
misc.testing.enable_startup_id = 1
misc.testing.use_render_for_scaling = 0
@ -1123,6 +1143,8 @@ sound.theme =
# [int] Bits masks for disabling particular sounds
sound.mask1 = 0
sound.mask2 = 0
# [string] Sound engine name (esound, pulse, alsa, player, sndio)
sound.engine =
# [string] Theme
theme.name = winter
@ -1162,7 +1184,6 @@ warplist.warp_on_select = 0
warplist.show_shape = 0
# [bool] Icon mode (0: none, 3: e/app/snap, 4: app/e/snap)
warplist.icon_mode = 3
....
[[configurationfiles]]
@ -1170,37 +1191,33 @@ warplist.icon_mode = 3
Skip this section unless you *really* want to know...
It is here assumed that `+--prefix+` is `+/usr+`, and that the default
user configuration directory (`+~/.e16+`) is used.
It is here assumed that +--prefix+ is +/usr+, and that the default
user configuration directory (+~/.e16+) is used.
In general, the configuration search order for theme related
configuration files, say `+xyz.cfg+`, is:
configuration files, say +xyz.cfg+, is:
[arabic]
. User configuration directory, i.e. `+~/.e16/xyz.cfg+`.
. Theme directory, i.e. `+/usr/share/e16/themes/<theme>/xyz.cfg+`, or
`+~/.e16/themes/<theme>/xyz.cfg+`.
. User configuration directory, i.e. +~/.e16/xyz.cfg+.
. Theme directory, i.e. +/usr/share/e16/themes/<theme>/xyz.cfg+, or
+~/.e16/themes/<theme>/xyz.cfg+.
. Default configuration directory, i.e.
`+/usr/share/e16/config/xyz.cfg+`.
+/usr/share/e16/config/xyz.cfg+.
Mouse and keybindings are defined in `+bindings.cfg+`. `+bindings.cfg+`
is searched in
Mouse and keybindings are defined in +bindings.cfg+. +bindings.cfg+
is searched in:
[arabic]
. User configuration directory, i.e. `+~/.e16/bindings.cfg+`.
. Default configuration directory, i.e.
`+/usr/share/e16/config/bindings.cfg+`.
. User configuration directory, i.e. +~/.e16/bindings.cfg+.
. Default configuration directory, i.e. +/usr/share/e16/config/bindings.cfg+.
Window matches (border and icon associations) are defined in
`+windowmatches.cfg+` and `+matches.cfg+`. `+windowmatches.cfg+`
+windowmatches.cfg+ and +matches.cfg+. +windowmatches.cfg+
(deprecated, border associations only) is loaded first, and should be
found only in theme directories. `+matches.cfg+` is loaded next, and
searched in
found only in theme directories. +matches.cfg+ is loaded next, and
searched in:
[arabic]
. User configuration directory, i.e. `+~/.e16/matches.cfg+`.
. User configuration directory, i.e. +~/.e16/matches.cfg+.
. Default configuration directory, i.e.
`+/usr/share/e16/config/matches.cfg+`.
+/usr/share/e16/config/matches.cfg+.
Window match items are appended to the window match list, in the order
in which they are read from the configuration files. When doing
@ -1210,96 +1227,78 @@ and the first matching item will be used.
[[sessionscripts]]
=== Session Scripts
Enlightenment can now automatically run user scripts or applications
E16 can automatically run user scripts or applications
during Startup, Restart, and Shutdown. This facilitates the loading of
system tray applets, rss readers, screen savers, and other daemons (e.g.
dbus), and allows for cleanup of programs that don't terminate properly
when E quits (this is especially common with KDE applications in E and
when e16 quits (this is especially common with KDE applications in e16 and
the arts daemon or dcop server keeps running).
Enlightenment accomplishes this with the addition of two new keys in the
`+$ECONFDIR/e_config--#.#.cfg+` (#.# may vary depending on your X setup
-- for most people, it will be 0.0). These are:
The session script feature is controlled by the configuration keys
(shown with default values):
....
misc.session.enable_script
misc.session.script
misc.session.enable_script = 0
misc.session.script = $EROOT/scripts/session.sh
....
`+misc.session.enable_script+` is a boolean. When set to 1,
Enlightenment will execute the script in the `+misc.session.script+`
key. By default, this feature is disabled. When enabled, it will do
nothing until the user configures his/her home directory (`+$ECONFDIR+`
-- normally `+~/.e16+`).
+misc.session.enable_script+ is a boolean. When set to 1,
e16 will execute the script in the +misc.session.script+ key.
By default, this feature is disabled. When enabled, it will do nothing
until the home directory (+$ECONFDIR+ -- normally +~/.e16+) is configured.
The default session.script is located in `+$EROOT/scripts/session.sh+`
(`+$EROOT+` is normally `+/usr/share/e16+` or `+/usr/local/share/e16+`).
It will look for directories in the user's `+$ECONFDIR/+` (`+~/.e16/+`)
The default session.script is located in +$EROOT/scripts/session.sh+
(+$EROOT+ is normally +/usr/share/e16+ or +/usr/local/share/e16+).
It will look for directories in the user's +$ECONFDIR/+ (+~/.e16/+)
called:
....
~/.e16/ ($ECONFDIR)
Init/
Start/
Stop/
~/.e16/ ($ECONFDIR)
Init/
Start/
Stop/
....
and run any and/or all scripts or executables in each when E starts,
and run any and/or all scripts or executables in each when e16 starts,
restarts, and shuts down. If no scripts or executables are present, or
if any of the directories `+Init+`, `+Start+`, and `+Stop+` do not
exist, NOTHING will happen and E will start up as usual. So, in order to
use session scripts, all the user has to do is to populate the `+Init+`,
`+Start+`, and `+Stop+` directories with scripts, applications, or links
to applications that should run during Startup, Restart, or when E is
if any of the directories +Init+, +Start+, and +Stop+ do not
exist, nothing will happen and e16 will start up as usual. So, in order to
use session scripts, all the user has to do is to populate the +Init+,
+Start+, and +Stop+ directories with scripts, applications, or links
to applications that should run during Startup, Restart, or when e16 is
stopped.
The default values for the new keys are:
....
misc.session.enable_script = 0
misc.session.script = $EROOT/scripts/session.sh
....
The user may write a custom script and place it anywhere. Simply modify
the config file by using:
....
$ eesh set misc.session.script myscript
....
and modify it (be sure to `+chmod +x+` the file otherwise it won't run).
and modify it (be sure to +chmod +x+ the file otherwise it won't run).
The session script is called with one of three command parameters;
`+init+`, `+start+`, and `+stop+`. Any custom script should have a code
block similar to this in order to function properly in Enlightenment.
+init+, +start+, and +stop+. Any custom script should have a code
block similar to this in order to function properly in e16.
....
case "$1" in
init)
# do blah
# or do function init
start)
# do blah
# of do function start
stop)
# do blah
# or do function stop
esac
case "$1" in
init)
# do blah
# or do function init
start)
# do blah
# of do function start
stop)
# do blah
# or do function stop
esac
....
Automatic script running can be enabled/disabled in the Settings Dialog
under "Session", by editing the user cfg file and setting the
`+misc.session.enable_script+` key to 1/0, or with
under "Session", or by setting +misc.session.enable_script+ key to 1/0:
....
$ eesh set misc.session.enable_script 1/0
....
This process is very flexible since when used, the user can turn off
individual scripts and applications by `+chmod -x+` or simply leave the
individual scripts and applications by +chmod -x+ or simply leave the
startup directories empty or remove them.
[[compositemanagernotes]]
@ -1315,15 +1314,15 @@ windows using ARGB visuals (for transparency) are "ugly". Applications
may use ARGB visuals intentionally (e.g. fdclock) or not (e.g. xv on 16
bit root depth). Applications unintentionally using an ARGB visual will
normally not be rendered properly at all and should be started with the
environment variable `+XLIB_SKIP_ARGB_VISUALS+` set. To fix border
rendering on "real" ARGB windows it is required to use `+imlib2+` with
environment variable +XLIB_SKIP_ARGB_VISUALS+ set. To fix border
rendering on "real" ARGB windows it is required to use +imlib2+ with
version >= 1.3.0.
Tweaks:
As of e16 >= 0.16.8.9: If there is any kind of trouble with the
composite manager, first check `+compmgr.mode+` (`+eesh show compmgr+`),
and set it to 1 if it isn't (`+eesh set compmgr.mode 1+`, restart).
composite manager, first check +compmgr.mode+ (+eesh show compmgr+),
and set it to 1 if it isn't (+eesh set compmgr.mode 1+, restart).
If pop-up windows disappear immediately after having appeared (may
happen e.g. with certain pop-up windows when using gnome > 2.12), try:
@ -1343,19 +1342,19 @@ the theme has font alias support.
For themes with font alias support the fonts are determined by a font
configuration file. This file is selected as follows, first hit applies:
* If `+theme.use_alt_font_cfg+` is set (default off) and the the file
specified by `+theme.font_cfg+` is found the fonts are determined by
* If +theme.use_alt_font_cfg+ is set (default off) and the the file
specified by +theme.font_cfg+ is found the fonts are determined by
this file.
* If `+theme.use_theme_font_cfg+` is set (default off) and the theme has
a `+fonts.theme.cfg+` the fonts are determined by the theme's
`+fonts.theme.cfg+`.
* If e16 was built with pango support, look for `+fonts.pango.cfg+`.
* If e16 was built with xft support, look for `+fonts.xft.cfg+`.
* Look for `+fonts.cfg+`.
* If +theme.use_theme_font_cfg+ is set (default off) and the theme has
a +fonts.theme.cfg+ the fonts are determined by the theme's
+fonts.theme.cfg+.
* If e16 was built with pango support, look for +fonts.pango.cfg+.
* If e16 was built with Xft support, look for +fonts.xft.cfg+.
* Look for +fonts.cfg+.
The font configuration file search path is `+~/.e16, <theme-dir>+`, and
`+/usr/share/e16/config+`. Default `+fonts.pango.cfg+` and
`+fonts.xft.cfg+` are provided in `+/usr/share/e16/config+`.
The font configuration file search path is +~/.e16, <theme-dir>+, and
+/usr/share/e16/config+. Default +fonts.pango.cfg+ and
+fonts.xft.cfg+ are provided in +/usr/share/e16/config+.
The default theme (winter) and the core themes (BlueSteel,
BrushedMetal-Tigert, Ganymede, and ShinyMetal) do have font alias
@ -1372,268 +1371,58 @@ in the theme configuration files.
There are several ways to specify a font (in the font configuration file
or in TextClasses):
* "<font name>/<size>", e.g. "Vera/8".
+
In this case e16 must be able to find "Vera.ttf" in `+<theme
dir>/ttfonts+` or `+/usr/share/e16/fonts+`.
* TrueType fonts, +"<font name>/<size>"+, e.g. +"Vera/8"+. +
In this case e16 must be able to find +Vera.ttf+ in +<theme dir>/ttfonts+
or +/usr/share/e16/fonts+.
* XLFD font sets, e.g.
"-*-lucida-medium-r-normal-*-12-120-*-*-*-*-*-*,-*-gulim*-medium-r-normal-*-12-120-*-*-*-*-ksc5601.1987-*".
+
xfontsel, xlsfonts, and xfd can be used to select and show these fonts.
* Fontconfig font names, prefixed by "xft:", e.g. "xft:Luxi
Sans-10:bold".
+
fc-list and xfd can be used to select and show these fonts. This
possibility (Xft support) is available as of version 0.16.8.5.
* Pango font names, prefixed by "pango:", e.g. "pango:sans bold 10".
+
This possibility (Pango support) is available as of version 0.16.8.9.
Pango support must be explicitly enabled at build time with
`+--enable-pango+`.
[[usinge16withgnome]]
=== Using E16 with GNOME
Setting up e16 as WM in a GNOME session unfortunately depends on the
version of gnome-session.
Recent versions of gnome-session seem to require that a gconf key is set
and that an `+e16.desktop+` file can be found:
....
$ gconftool-2 --set /desktop/gnome/session/required_components/windowmanager --type string e16
$ gnome-sesssion
....
`+/usr/share/applications/e16.desktop+` (or
`+~/.local/share/applications/e16.desktop+`):
....
[Desktop Entry]
Encoding=UTF-8
Type=Application
Name=E16
Comment=The Enlightenment (E16) window manager
Exec=e16
Icon=/usr/share/e16/icons/e16.png
....
The section below seems to be obsolete as of gnome-session-2.2x(?)
The GNOME desktop can be started using e16 as WM with:
....
$ export WINDOW_MANAGER=e16
$ gnome-sesssion
....
The section below is obsolete as of gnome-session-2.16
However, somewhere along the way the script `+/usr/bin/gnome-wm+` is
called. This is supposed to handle differences in all the different WM's
out there, but does not know of "e16". This will cause a major delay
when starting up the GNOME desktop. One way to fix this is to use
gnome-session-properties to get rid of the "gnome-wm" session entry.
Another is to apply this patch to `+/usr/bin/gnome-wm+`:
....
--- /usr/bin/gnome-wm-org 2005-04-19 21:33:53.000000000 +0200
+++ /usr/bin/gnome-wm 2005-11-15 20:46:09.000000000 +0100
@@ -69,7 +69,7 @@
OPT2=
if [ ! -z "$SMID" ] ; then
case `basename $WINDOW_MANAGER` in
- sawfish|sawmill|metacity)
+ sawfish|sawmill|metacity|e16)
OPT1=--sm-client-id=$SMID
;;
openbox)
....
[[usinge16withkde]]
=== Using E16 with KDE
The KDE desktop can be started using e16 as WM with:
....
$ export KDEWM=e16
$ startkde
....
=== Versions
e16-1.0.0:::
No major changes, might as well have been 0.16.8.16.
e16-0.16.8::
* Released Feb 2006
* enlightenment -> e16
* Major internal rewrite
* Changed configuration system
* Added compositing manager
enlightenment-0.16.7::
* Released Jul 2004
* Migrated to imlib2
enlightenment-0.16.6::
* Released Nov 2003
* Added extended window manager hint support
enlightenment-0.16.5::
Released Oct 2000
enlightenment-0.16.0::
Released Oct 1999
[[majorchangesandnewfeaturesin0168]]
=== Major changes and new features in 0.16.8
The following sections are only relevant for users upgrading from
version 0.16.7 or older.
Changes:
* "enlightenment" has been renamed to "e16".
* The default user configuration directory is "`+~/.e16+`".
* The data install path is "`+<somepath>/e16+`", e.g.
"`+/usr/share/e16+`". Thus, an e16.8 installation should not clash with
any other versions.
* Various configuration file formats have changed and should be easier
to read and modify, if needed.
* The configuration is stored per display and per screen. E.g. for
`+DISPLAY=:1.0+` the main configuration file is
"`+~/.e16/e_config--1.0.cfg+`".
* Actions(used by menus, keybindings, etc.) and IPC functions(eesh) have
been merged.
* Many IPC(eesh) commands have been changed, possibly breaking
compatibility with a few epplets.
* Window matches and icondefs have been merged (into `+matches.cfg+`),
see below.
New features:
* Built-in composite manager.
* An iconbox can be configured to act as System Tray
([.menuchoice]#Desktop > Create Systray#).
* Possibility to run programs on startup, restart, and shutdown, see
link:#sessionscripts["Session Scripts"] below.
* Possibility to track changes in remembered settings.
* Window operations by window matches (class, name, transient, ...),
e.g. for making all windows of a certain type sticky, put it on a
certain layer, etc. (see `+matches.cfg+`).
0.16.8 should be compatible with most e16 themes. However, user
installed themes will have to be moved/linked to `+~/.e16/themes/+` or
`+<datadir>/e16/themes/+`. A few themes will have to be tweaked to work
with e16.8. The most likely problem is that configuration settings are
included in .cfg files where they are no longer accepted. See the
link:#migratingfromversionsolderthan0168["Migrating ..."] section below
for additional information.
e16keyedit >= 0.3 works with e16.8.
If used to change the keybindings, the modified settings will be stored
in `+~/.e16/bindings.cfg+`. It should also be fairly straightforward to
modify the key- and buttonbindings by hand. Copy
`+/usr/share/e16/config/bindings.cfg+` to `+~/.e16/bindings.cfg+` and
modify as desired.
NB! e16keyedit only modifies keybindings, not buttonbindings.
NB!!! Do not rename `+~/.enlightenment+` to `+~/.e16+`. It will only
cause trouble.
[[migratingfromversionsolderthan0168]]
=== Migrating from versions older than 0.16.8
Users upgrading from enlightenment 0.16.7 need to read the following.
Several organizational changes have occurred that will require some
manual adjustments. Mainly these deal with changes to configuration and
shared directory names. This was done to avoid collisions with the new
enlightenment DR17.
[arabic]
. home configuration directory is now `+~/.e16+`, not
`+~/.enlightenment+`.
. menu files have been moved to a subdirectory called menus you will
need to move customized menus and subdirectories to `+~/.e16/menus+`.
. you will need to move `+~/.enlightenment/backgrounds+` files to
`+~/.e16+` and any themes as well.
. `+$prefix/share/enlightenment+` has been changed to
`+$prefix/share/e16+`
. if installed E-docs and Epplet directories will have to be moved to
`+$prefix/share/e16+`
. any additional themes that were added to the
`+$prefix/share/enlightenment+` directory will have to be moved to
`+$prefix/share/e16+`
. any startup scripts or Session scripts that reference the startup
executable ``+enlightenment+`` must be edited to the new `+e16+`
program.
A few themes have to be tweaked to work with 0.16.8.
Some themes (Maw, Black E) have an `+actionclasses.cfg+` like:
....
#include <definitions>
__E_CFG_VERSION 0
#include </usr/local/enlightenment/config/actionclasses.cfg>
#include </usr/share/enlightenment/config/actionclasses.cfg>
....
The absolute path is obviously no longer valid. The most sensible fix
for these themes is to remove the themes `+actionclasses.cfg+`. e16 will
then fall back to the default one.
+"-*-lucida-medium-r-normal-*-12-120-*-*-*-*-*-*,-*-gulim*-medium-r-normal-*-12-120-*-*-*-*-ksc5601.1987-*"+. +
xfontsel, xlsfonts, and xfd can be used to select and show these fonts.
* Fontconfig font names, prefixed by "+xft:+", e.g. +"xft:Luxi Sans-10:bold"+. +
fc-list and xfd can be used to select and show these fonts.
* Pango font names, prefixed by "+pango:+", e.g. +"pango:sans bold 10"+. +
fc-list and pango-view can be used to select and show these fonts.
== Installation
Requirements:
* `+imlib2+` >= 1.2.0 is required, >= 1.4.2 is recommended.
* `+imlib2+` must be built with png support.
* +imlib2+ >= 1.2.0 is required, >= 1.4.2 is recommended.
* +imlib2+ must be built with png support.
It is recommended that e16 is built with support for:
* Pango
* Xft
* RandR
* Render
* Composite
Extract distribution tarball, build, and install:
....
$ tar -xzvf e16-<version>.tar.gz
$ cd e16-<version>
$ ./configure
$ make
$ sudo make install
....
For additional help on package configuration, see
....
$ ./configure --help
....
[[res]]
== Resources
Enlightenment web site:::
http://www.enlightenment.org
Forums:::
http://forum.enlightenment.org
https://www.enlightenment.org
Mailing lists:::
http://sourceforge.net/mail/?group_id=2
https://sourceforge.net/mail/?group_id=2
Download:::
http://sourceforge.net/projects/enlightenment/files
https://sourceforge.net/projects/enlightenment/files
Themes and theming documentation:::
http://themes.effx.us/e16
IRC:::
#e on freenode
== Credits
This note contains contributions by
* Kim Woelders
* Peter Hyman pete4abw@comcast.net
* Yasufumi Haga yasufumi.haga@nifty.com
https://themes.effx.us/ +
https://github.com/dharrop/themes