1266 lines
55 KiB
Groff
1266 lines
55 KiB
Groff
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
|
|
.\"
|
|
.\" Standard preamble:
|
|
.\" ========================================================================
|
|
.de Sh \" Subsection heading
|
|
.br
|
|
.if t .Sp
|
|
.ne 5
|
|
.PP
|
|
\fB\\$1\fR
|
|
.PP
|
|
..
|
|
.de Sp \" Vertical space (when we can't use .PP)
|
|
.if t .sp .5v
|
|
.if n .sp
|
|
..
|
|
.de Vb \" Begin verbatim text
|
|
.ft CW
|
|
.nf
|
|
.ne \\$1
|
|
..
|
|
.de Ve \" End verbatim text
|
|
.ft R
|
|
.fi
|
|
..
|
|
.\" Set up some character translations and predefined strings. \*(-- will
|
|
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
|
.\" double quote, and \*(R" will give a right double quote. | will give a
|
|
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
|
|
.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
|
|
.\" expand to `' in nroff, nothing in troff, for use with C<>.
|
|
.tr \(*W-|\(bv\*(Tr
|
|
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
|
.ie n \{\
|
|
. ds -- \(*W-
|
|
. ds PI pi
|
|
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
|
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
|
. ds L" ""
|
|
. ds R" ""
|
|
. ds C` ""
|
|
. ds C' ""
|
|
'br\}
|
|
.el\{\
|
|
. ds -- \|\(em\|
|
|
. ds PI \(*p
|
|
. ds L" ``
|
|
. ds R" ''
|
|
'br\}
|
|
.\"
|
|
.\" If the F register is turned on, we'll generate index entries on stderr for
|
|
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
|
|
.\" entries marked with X<> in POD. Of course, you'll have to process the
|
|
.\" output yourself in some meaningful fashion.
|
|
.if \nF \{\
|
|
. de IX
|
|
. tm Index:\\$1\t\\n%\t"\\$2"
|
|
..
|
|
. nr % 0
|
|
. rr F
|
|
.\}
|
|
.\"
|
|
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
|
.\" way too many mistakes in technical documents.
|
|
.hy 0
|
|
.if n .na
|
|
.\"
|
|
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
|
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
|
. \" fudge factors for nroff and troff
|
|
.if n \{\
|
|
. ds #H 0
|
|
. ds #V .8m
|
|
. ds #F .3m
|
|
. ds #[ \f1
|
|
. ds #] \fP
|
|
.\}
|
|
.if t \{\
|
|
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
|
. ds #V .6m
|
|
. ds #F 0
|
|
. ds #[ \&
|
|
. ds #] \&
|
|
.\}
|
|
. \" simple accents for nroff and troff
|
|
.if n \{\
|
|
. ds ' \&
|
|
. ds ` \&
|
|
. ds ^ \&
|
|
. ds , \&
|
|
. ds ~ ~
|
|
. ds /
|
|
.\}
|
|
.if t \{\
|
|
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
|
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
|
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
|
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
|
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
|
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
|
.\}
|
|
. \" troff and (daisy-wheel) nroff accents
|
|
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
|
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
|
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
|
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
|
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
|
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
|
|
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
|
.ds ae a\h'-(\w'a'u*4/10)'e
|
|
.ds Ae A\h'-(\w'A'u*4/10)'E
|
|
. \" corrections for vroff
|
|
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
|
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
|
. \" for low resolution devices (crt and lpr)
|
|
.if \n(.H>23 .if \n(.V>19 \
|
|
\{\
|
|
. ds : e
|
|
. ds 8 ss
|
|
. ds o a
|
|
. ds d- d\h'-1'\(ga
|
|
. ds D- D\h'-1'\(hy
|
|
. ds th \o'bp'
|
|
. ds Th \o'LP'
|
|
. ds ae ae
|
|
. ds Ae AE
|
|
.\}
|
|
.rm #[ #] #H #V #F C
|
|
.\" ========================================================================
|
|
.\"
|
|
.IX Title "E16 1"
|
|
.TH E16 1 "2005-03-19" "Enlightenment 0.16.8" "Enlightenment Man Pages"
|
|
.SH "NAME"
|
|
Enlightenment \- The Window Manager that dares to do what others don't
|
|
.SH "WARNING"
|
|
.IX Header "WARNING"
|
|
This documentation is automatically generated for you from the
|
|
online help documentation. It is \s-1NOT\s0 to be considered a full
|
|
substitute for this documentation. It may be accessed by
|
|
middle clicking on your desktop and selecting the \*(L"Help\*(R" item.
|
|
If you are not currently running enlightenment, you may access
|
|
this documentation by running the dox Help Browser
|
|
To do this, run ENLIGHTENMENT_BIN/dox ENLIGHTENMENT_ROOT/E\-docs
|
|
(where \s-1BIN\s0 and \s-1ROOT\s0 are the locations of your e binaries and shared
|
|
files, respectively)
|
|
.SH "DESCRIPTION"
|
|
.IX Header "DESCRIPTION"
|
|
Enlightenment version 0.16.8
|
|
.PP
|
|
Topics:
|
|
How To Use Documentation
|
|
About Enlightenment
|
|
Copyright
|
|
Credits
|
|
Website
|
|
\&\s-1IRC\s0
|
|
Email
|
|
.PP
|
|
User Documentation
|
|
Frequently Asked Questions
|
|
.PP
|
|
Welcome to the Enlightenment Documentation Viewer. Please select a topic from
|
|
the list.
|
|
.PP
|
|
This Documentation is intended to take you step by step through Enlightenment
|
|
and its default setup, how to use it, modify settings, and put it to use for
|
|
you. When you have finished reading each page please press the \s-1NEXT\s0 button on
|
|
the top of this window to go to the next page, or use the Back button until you have reached the Docs Index
|
|
.PP
|
|
If you are reading this right now you have managed to get Enlightenment itself
|
|
installed correctly and are either running Enlightenment for the first time or
|
|
have just upgraded to a new version. Congratulations. Now it's time to take
|
|
you on a quick tour of the desktop you will have before you.
|
|
.PP
|
|
Please remember that if you use a theme other than the default
|
|
(Brushed Metal) that it may look slightly or completely different to the
|
|
contents of this User Documentation. Some behavior may also vary.
|
|
.PP
|
|
To relaunch this Help Browser at any time, middle click on your
|
|
desktop and select the \*(L"Help\*(R" Item. The documentation should come
|
|
back up, reloading to the first page.
|
|
You can also use the \*(L"Home\*(R" key to take you back to the introduction page at
|
|
any time during the program.
|
|
.PP
|
|
Enlightenment is your Window Manager. The Window Manager controls the
|
|
appearance of the borders of your windows, their behavior and
|
|
all user interaction with positioning, killing, resizing, moving, iconifying,
|
|
shading etc. your windows, virtual desktops, multiple desktops, menus attached
|
|
to windows and some root window menus and can also control the background
|
|
of your desktop(s).
|
|
.PP
|
|
Enlightenment is a large and complex program and is by no means perfect,
|
|
but it is being worked on and is as stable as possible. It has many advanced
|
|
features, but may also be missing some features that you would like to see.
|
|
The version you are now running (0.16.8) is by no means the
|
|
end of development and improvements, fixes and new exciting features are
|
|
being worked on all the time. Please visit the
|
|
.PP
|
|
Web site often for
|
|
new versions, fixes, patches and updates.
|
|
.PP
|
|
We hope that you enjoy using Enlightenment as much as we have enjoyed writing
|
|
it. We'd like to think that even if this isn't the right software for you, you
|
|
at least can have fun playing around with what we have created.
|
|
.PP
|
|
Copyright (C) 1997\-2007 The Enlightenment Development Team
|
|
.PP
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the \*(L"Software\*(R"), to
|
|
deal in the Software without restriction, including without limitation the
|
|
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
|
|
sell copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
.PP
|
|
The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.
|
|
.PP
|
|
\&\s-1THE\s0 \s-1SOFTWARE\s0 \s-1IS\s0 \s-1PROVIDED\s0 \*(L"\s-1AS\s0 \s-1IS\s0\*(R", \s-1WITHOUT\s0 \s-1WARRANTY\s0 \s-1OF\s0 \s-1ANY\s0 \s-1KIND\s0, \s-1EXPRESS\s0 \s-1OR\s0
|
|
\&\s-1IMPLIED\s0, \s-1INCLUDING\s0 \s-1BUT\s0 \s-1NOT\s0 \s-1LIMITED\s0 \s-1TO\s0 \s-1THE\s0 \s-1WARRANTIES\s0 \s-1OF\s0 \s-1MERCHANTABILITY\s0,
|
|
\&\s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0 \s-1AND\s0 \s-1NONINFRINGEMENT\s0. \s-1IN\s0 \s-1NO\s0 \s-1EVENT\s0 \s-1SHALL\s0
|
|
\&\s-1THE\s0 \s-1AUTHORS\s0 \s-1BE\s0 \s-1LIABLE\s0 \s-1FOR\s0 \s-1ANY\s0 \s-1CLAIM\s0, \s-1DAMAGES\s0 \s-1OR\s0 \s-1OTHER\s0 \s-1LIABILITY\s0, \s-1WHETHER\s0
|
|
\&\s-1IN\s0 \s-1AN\s0 \s-1ACTION\s0 \s-1OF\s0 \s-1CONTRACT\s0, \s-1TORT\s0 \s-1OR\s0 \s-1OTHERWISE\s0, \s-1ARISING\s0 \s-1FROM\s0, \s-1OUT\s0 \s-1OF\s0 \s-1OR\s0 \s-1IN\s0
|
|
\&\s-1CONNECTION\s0 \s-1WITH\s0 \s-1THE\s0 \s-1SOFTWARE\s0 \s-1OR\s0 \s-1THE\s0 \s-1USE\s0 \s-1OR\s0 \s-1OTHER\s0 \s-1DEALINGS\s0 \s-1IN\s0 \s-1THE\s0 \s-1SOFTWARE\s0.
|
|
.PP
|
|
Enlightenment has been written by:
|
|
.PP
|
|
The Rasterman (Carsten Haitzler),
|
|
Mandrake (Geoff Harrison),
|
|
Chutt (Isaac Richards),
|
|
Michael Jennings (KainX),
|
|
Christian Kreibich (cK),
|
|
Sung-Hyun Nam,
|
|
Kimball Thurston,
|
|
Michael Kellen,
|
|
Frederic Devernay,
|
|
Felix Bellaby,
|
|
Peter Kjellerstedt,
|
|
Troy Pesola,
|
|
Owen Taylor,
|
|
Stalyn,
|
|
Knut Neumann,
|
|
Nathan Heagy,
|
|
Simon Forman,
|
|
Brent Nelson,
|
|
Martin Tyler,
|
|
Graham MacDonald,
|
|
Jesse Michael,
|
|
Paul Duncan,
|
|
Daniel Erat,
|
|
Tom Gilbert,
|
|
Peter Alm,
|
|
Ben FrantzDale,
|
|
Hallvar Helleseth,
|
|
Kameran Kashani,
|
|
Carl Strasen,
|
|
David Mason,
|
|
Tom Christiansen
|
|
And others (see \s-1AUTHORS\s0 file).
|
|
.PP
|
|
A big thanks to several companies that helped support Enlightenment.
|
|
.PP
|
|
Red Hat Software (www.redhat.com) for allowing developers resources and time
|
|
to work on Enlightenment.
|
|
.PP
|
|
\&\s-1VA\s0 Linux Systems (www.valinux.com) for providing hardware, bandwidth, Coke, and
|
|
the patience to hire a couple of loony bin candidates to work on something we
|
|
(and hopefully you) think is interesting.
|
|
.PP
|
|
Xi Graphics (www.xig.com) for providing X servers to test out code on.
|
|
.PP
|
|
Not only should these people be thanked, but the whole E community \- those on
|
|
the E mailing list, on #E on \s-1IRC\s0 on openprojects.net and all E users who have provided
|
|
feedback and debugging information, bug\-fixes, patches and support. A big
|
|
thanks goes out to all of you who make a project like this possible.
|
|
.PP
|
|
In addition we'd like to thank several other projects \- such
|
|
as XFree86, Imlib, Esound, Freetype and many others, The people working on
|
|
these equally important projects should not be forgotten.
|
|
.PP
|
|
For updated information on Enlightenment, development, bug\-fixes, snapshots of
|
|
development versions etc. please visit:
|
|
.PP
|
|
http://www.enlightenment.org/
|
|
.PP
|
|
You may want to visit this site often as it changes
|
|
regularly with fixes and development releases \*(-- also visiting the
|
|
daily-snapshots section
|
|
on the \s-1FTP\s0 site is a good idea (see the snapshots section on the website for
|
|
more information).
|
|
.PP
|
|
There is an Official Enlightenment \s-1IRC\s0 channel where you can go and \*(L"hang out\*(R"
|
|
if you want \- talk to other E users, developers, get some help, drool
|
|
together, or whatever. #E will kill me for this but get onto any
|
|
openprojects irc server (irc.openprojects.net) then join #E. For example:
|
|
.PP
|
|
epic4 your_nick irc.openprojects.net
|
|
.PP
|
|
or
|
|
.PP
|
|
irc your_nick irc.efnet.org
|
|
.PP
|
|
or use your favorite graphical \s-1IRC\s0 client.
|
|
.PP
|
|
Please remember that it can get busy with 100's of people talking at once.
|
|
Not everyone is actually listening all the time or are in the middle of a
|
|
conversation. Be polite and patient, and have a sense of humor and you'll
|
|
have fun.
|
|
.Sh "\s-1CVS\s0 Commit List Mail"
|
|
.IX Subsection "CVS Commit List Mail"
|
|
To receive \s-1CVS\s0 Commit mails, please go to the
|
|
\&\s-1CVS\s0 Commits List mail page:
|
|
http://www.enlightenment.org/mailman/listinfo/cvs\-commits\-list
|
|
.PP
|
|
This mailing list does not accept user\-submissions. It is automatically
|
|
generated email that is sent out whenever the enlightenment \s-1CVS\s0 server
|
|
receives a commit. Sometimes it can generate a lot of email, sometimes it
|
|
doesn't.
|
|
.Sh "Developer Mailing List"
|
|
.IX Subsection "Developer Mailing List"
|
|
If you would like to receive mail from the developer mailing list, please go
|
|
to the E\-develop Mailing List mail page:
|
|
http://enlightenment.org/mailman/listinfo/e\-develop.
|
|
.PP
|
|
This mailing list is for discussing Enlightenment and it's development, bugs,
|
|
feature requests, etc. It is not a general chatter list. The developers do
|
|
read this mailing list and will often comment on subjects brought up on the
|
|
list.
|
|
.Sh "Welcome To Enlightenment"
|
|
.IX Subsection "Welcome To Enlightenment"
|
|
Basic Intro
|
|
Using Menus
|
|
Mouse Bindings
|
|
Mouse Configuration
|
|
Using The Window Border
|
|
Changing Window Borders
|
|
Default Keybindings
|
|
Multiple Desktops
|
|
Changing Desktops
|
|
Taking Apps Between Desks
|
|
The Dragbar
|
|
The Pager
|
|
The Iconbox
|
|
Recovering Minimized Apps
|
|
Remembering App Properties
|
|
Intro To Settings
|
|
Window Groups
|
|
.PP
|
|
Desktop Backgrounds
|
|
Tooltips
|
|
Audio
|
|
Special Effects
|
|
Setting The Focus
|
|
Moving Windows
|
|
Resizing Windows
|
|
Window Operations
|
|
Window Placement Options
|
|
Autoraise Settings
|
|
Quick Intro to \s-1IPC\s0
|
|
How To Edit Menus
|
|
How To Change Keybindings
|
|
Themes
|
|
Extra Eyecandy
|
|
Maintenance Scripts
|
|
.PP
|
|
Now that you have started Enlightenment, if you are using it for your desktop
|
|
shell, your screen should look something like the image here on the left.
|
|
.PP
|
|
Across the whole top of the screen you will see a bar with arrows pointing
|
|
up and down on the left and right ends. This is your desktop
|
|
Dragbar .
|
|
.PP
|
|
On the bottom-left you'll see 3 boxes. The top box with the scrollbar attached
|
|
will be your Iconbox.
|
|
.PP
|
|
The other 2 boxes below it are Pagers for desktops 0 and 1. Everything
|
|
else is your desktop background.
|
|
.PP
|
|
Using Menus
|
|
When you click with your left mouse button on the desktop background you will
|
|
see an \*(L"User Menus\*(R" menu appear (example displayed on the right here).
|
|
Applications you may have installed will appear in this menu. To launch one
|
|
of them simply select it from the menu.
|
|
.PP
|
|
Note: Menus in Enlightenment work like most menu systems. Either hold
|
|
down the mouse button and navigate with the button down, releasing on the
|
|
selection you want, or release elsewhere to not select anything. You can also
|
|
quickly click and release, then navigate: move the mouse, and click
|
|
again on the item you wish to select, or elsewhere if you do not wish to
|
|
select an entry.
|
|
.PP
|
|
To \*(L"stick\*(R" a menu up and leave it up so you can select items from
|
|
it multiple times, click and hold down the mouse and release on the title of
|
|
the menu (if it has one) and it will remain up. You can move it and
|
|
manipulate it like a normal window. Close the window to unstick the menu.
|
|
.PP
|
|
Clicking the middle button on the desktop background will display
|
|
Enlightenment's main menu. You can access the other menus plus more options
|
|
from this menu (including those to log out, restart and display Help
|
|
information). A sample of this menu is shown to our left.
|
|
.PP
|
|
When you click the right mouse button
|
|
a menu with the title \*(L"Settings\*(R" will appear. This is
|
|
Enlightenment's settings menu. From it you can select various
|
|
configuration dialogs that will assist you in customizing your desktop to
|
|
better suit your needs.
|
|
.PP
|
|
Mouse Bindings
|
|
Of course, when you click on the desktop background of
|
|
your screen, normally you will bring up a menu. And of course, when you
|
|
click on the border of a window, you will do various things. But these
|
|
are not the only things you can do with your mouse.
|
|
.PP
|
|
In Enlightenment, there are several other actions that the mouse can do by
|
|
default. For example, by holding down the \s-1ALT\s0 key when you click the left
|
|
mouse button anywhere in a window, you will find that you can move the window
|
|
around the screen, just as if you had used the titlebar. You can also \s-1ALT\s0
|
|
middle-click in a window to resize it, or use \s-1ALT\s0 and right-click to bring up
|
|
the Window Operations Menu.
|
|
.PP
|
|
You will find that holding down the \s-1ALT\s0 key while clicking the middle
|
|
mouse button on the background of your desktop will bring up a
|
|
menu with the titles of all currently active
|
|
application windows. Selecting one of these will take you to that application.
|
|
By using the \s-1CTRL\s0 key instead of \s-1ALT\s0 you will get a menu displaying all
|
|
current desktops as sub\-menus, with applications on each desktop in the
|
|
desktop sub\-menu.
|
|
.Sh "Mouse Configuration"
|
|
.IX Subsection "Mouse Configuration"
|
|
Enlightenment makes extensive use of the mouse.
|
|
However, you may be missing some features because of the way
|
|
that your mouse is configured on your X server.
|
|
.PP
|
|
If your mouse does not have a middle button you should enable
|
|
\&\*(L"Emulate 3 Buttons\*(R" in your X server. This option allows you to
|
|
emulate a three-button mouse by pressing both left and
|
|
right mouse buttons at once.
|
|
If this does not work, three-button emulation may not be enabled. See
|
|
your X server documentation to configure this emulation.
|
|
.PP
|
|
This may vary from system to system. The \s-1OS\s0 and X server may also
|
|
vary the method in which you do this, if it is possible. Not having
|
|
a middle mouse button in
|
|
Enlightenment, 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.
|
|
.PP
|
|
If you have a Wheel-Mouse and X is configured to use it, Enlightenment
|
|
supports it by default.
|
|
.PP
|
|
Rolling your wheel up on the desktop background will take you back a
|
|
desktop . Rolling your wheel downward you will advance
|
|
forward a desktop.
|
|
.PP
|
|
If this doesn't work, then it may be you haven't configured your X server to
|
|
understand a mouse with a wheel. If you use XFree86 you may need to edit your
|
|
XF86Config to have a \*(L"Pointer\*(R" Section like:
|
|
.PP
|
|
.Vb 6
|
|
\& Section "Pointer"
|
|
\& Protocol "MousemanPlusPS/2"
|
|
\& Device "/dev/mouse"
|
|
\& ZAxisMapping 4 5
|
|
\& Buttons 5
|
|
\& EndSection
|
|
.Ve
|
|
.PP
|
|
You may need to modify this for your mouse.
|
|
.PP
|
|
Using the Window Border
|
|
When you start an application, unless it has special properties, it will come
|
|
up on your screen with a border surrounding it that contains a titlebar and
|
|
several control buttons.
|
|
This border is the primary interface to controlling an application window.
|
|
The Default setup (shown on the next page) gives adequate control but still
|
|
retains simplicity.
|
|
.PP
|
|
If you click left mouse button on the titlebar and keep the mouse button down
|
|
the window will follow your mouse wherever it moves. Respectively if you click
|
|
your left mouse button and drag on any of the resize handles, the window will
|
|
be resized in that direction. Clicking right mouse button on the resize
|
|
handles will raise the windows to the top.
|
|
.PP
|
|
Clicking right mouse button on the titlebar or any button on the window
|
|
operations menu button on the top-left will display a menu that has window
|
|
manipulation options in it.
|
|
.PP
|
|
Double-Clicking (clicking the mouse twice in succession really fast) will
|
|
make the Window shade or unshade (depending if it was unshaded or shaded to
|
|
start with).
|
|
.PP
|
|
Clicking left mouse button on the iconify button will iconify the window
|
|
and send it off to the Iconbox . Hitting the Maximize button will
|
|
maximize the
|
|
size of the application fill your screen. Hitting it again will Unmaximize,
|
|
bringing the window back to its normal size.
|
|
.PP
|
|
Clicking with the left mouse button on the close button will close the window.
|
|
If the application that owns that window does not respond to a nice request to
|
|
exit, then press the right mouse button on the close button to forcibly
|
|
terminate that window. This should not be used unless the application is
|
|
visibly \*(L"hung\*(R".
|
|
.PP
|
|
In addition to these methods, there are additional ways to manipulation
|
|
windows.
|
|
.PP
|
|
If you hold down the \s-1ALT\s0 key and hold down left mouse button anywhere in the
|
|
window (on the border \s-1OR\s0 in the application part) while dragging, you will
|
|
move this window around. Doing the same but with the middle mouse button will
|
|
resize the window in that direction. Clicking the right mouse button anywhere
|
|
in the window while holding down the \s-1ALT\s0 key will bring up the window
|
|
operations menu.
|
|
.Sh "Changing Window Borders"
|
|
.IX Subsection "Changing Window Borders"
|
|
From time to time you may find that you don't like a particular border that a
|
|
window uses, for some reason or another. You can easily change the border
|
|
style of a window in Enlightenment using the
|
|
.PP
|
|
Window Operations
|
|
menu, however. Select the \*(L"Set Border Style\*(R" menu, and a list will be
|
|
presented to you of available borders in this theme. The most common use
|
|
for this is to make an application shed its border, using the
|
|
\&\s-1BORDERLESS\s0 border type.
|
|
.PP
|
|
You can always click with \s-1ALT\s0 + Right mouse button anywhere in the window to
|
|
bring up the window operations menu again.
|
|
.PP
|
|
If you want to remember the border style for the next time you run this
|
|
application, you can always use the Remember dialog to remember
|
|
the current window border.
|
|
.Sh "Default Keybindings"
|
|
.IX Subsection "Default Keybindings"
|
|
Below are the keybindings for E as it comes \*(L"from the factory\*(R"
|
|
.PP
|
|
CTRL+ALT+Home \- Re-shuffle windows on screen to be Clean
|
|
.PP
|
|
CTRL+ALT+Del \- Exit Enlightenment and Log Out
|
|
.PP
|
|
CTRL+ALT+End \- Restart Enlightenment
|
|
.PP
|
|
CTRL+ALT+Up\-Arrow \- Raise window to top
|
|
.PP
|
|
CTRL+ALT+Down\-Arrow \- Lower window to the bottom
|
|
.PP
|
|
CTRL+ALT+Left\-Arrow \- Go to the previous desktop
|
|
.PP
|
|
CTRL+ALT+Right\-Arrow \- Go to the next desktop
|
|
.PP
|
|
\&\s-1CTRL+ALT+X\s0 \- Close the currently focused window
|
|
.PP
|
|
\&\s-1CTRL+ALT+K\s0 \- Kill the currently focused window nastily
|
|
.PP
|
|
\&\s-1CTRL+ALT+I\s0 \- Iconify the currently focused window
|
|
.PP
|
|
\&\s-1CTRL+ALT+R\s0 \- Shade/Unshade the currently focused window
|
|
.PP
|
|
\&\s-1CTRL+ALT+S\s0 \- Stick/Unstick the currently focused window
|
|
.PP
|
|
\&\s-1CTRL+ALT+M\s0 \- Maximize/unmaximize the currently focused window
|
|
.PP
|
|
\&\s-1CTRL+ALT+F\s0 \- Toggle fullscreen mode of the currently focused window
|
|
.PP
|
|
\&\s-1CTRL+ALT+\s0(F1 \- F12) \- Go directly to desktops 0 \- 11
|
|
.PP
|
|
ALT+Tab \- Switch focus to the next window
|
|
.PP
|
|
ALT+Enter \- Zoom/Unzoom the currently focused window
|
|
.PP
|
|
SHIFT+ALT+Left\-Arrow \- Move to the virtual desktop on the left if there is one
|
|
.PP
|
|
SHIFT+ALT+Right\-Arrow \- Move to the virtual desktop on the right if there is
|
|
one
|
|
.PP
|
|
SHIFT+ALT+Up\-Arrow \- Move to the virtual desktop above if there is one
|
|
.PP
|
|
SHIFT+ALT+Down\-Arrow \- Move to the virtual desktop below if there is one
|
|
.PP
|
|
Note: Zooming in and out of windows will only work if you have an XFree86
|
|
server or one that implements the Xf86VidMode extension. You also need
|
|
to define lots of screen modes for your display, so ensure your \*(L"Display\*(R"
|
|
subsection of your XF86Config looks like:
|
|
.PP
|
|
.Vb 4
|
|
\& SubSection "Display"
|
|
\& Depth 16
|
|
\& Modes "1600x1200" "1280x1024" "1152x864" "1024x768" "800x600" "640x480" "512x384" "400x300" "320x240"
|
|
\& EndSubSection
|
|
.Ve
|
|
.PP
|
|
Have a \*(L"Display\*(R" subsection per depth (this example is for 16 bit) and all
|
|
the resolutions defined as above.
|
|
.PP
|
|
Multiple & Virtual Desktops
|
|
.PP
|
|
Enlightenment supports both Multiple and Virtual desktops. There are
|
|
distinct difference between the two, and Enlightenment treats them differently.
|
|
.PP
|
|
When you start Enlightenment you will by default have two desktops. In
|
|
Enlightenment desktops are geometrically unrelated work areas. They are
|
|
visually stacked on top of each other and can even be dragged down to expose
|
|
desktops underneath.
|
|
.PP
|
|
The best way to imagine this is that each desktop is a sheet of paper with the
|
|
first desktop (desktop 0) being glued in\-place. You can re-shuffle the stack
|
|
of papers and slide one down to reveal a piece of paper underneath \- the only
|
|
paper you can't slide is the first one. Each desktop (or sheet) contains your
|
|
application windows.
|
|
.PP
|
|
Windows normally live on one desktop, but can be made
|
|
to exist on all desktops \- whenever you change to a new desktop the window
|
|
will follow you and be on that desktop too. This is known as being sticky.
|
|
if a window is sticky it will \*(L"stick to the glass of your screen\*(R" and stay
|
|
there until it is not sticky anymore or the window is closed.
|
|
.PP
|
|
Virtual desktops (also known as desktop areas) is a measure of how big your
|
|
desktops are. A desktop can be a multiple of your screen size in size (2x1,
|
|
2x2, 3x3, 4x2 etc.). That means each desktop has an AxB screen size of area
|
|
allocated to it and you can be looking at any screen-sized part of it at any
|
|
time. It's just like getting more sheets of paper and taping them to the sides
|
|
of your current sheet of paper. An easy way of changing your view is by just
|
|
sliding your mouse in the direction of a currently unviewable part of your
|
|
desktop. As long as you have Edge Flip enabled Enlightenment will
|
|
automatically scroll over to that part of the desktop.
|
|
.PP
|
|
To change the number of virtual desktops that you have, use the \*(L"Multiple
|
|
Desktop Settings\*(R" dialog from the right mouse settings menu . You
|
|
should see a menu that looks something like the menu to the right. You can use
|
|
the slider bar to quickly select the appropriate number of virtual desktops you
|
|
would like to use.
|
|
.PP
|
|
To change the number of virtual areas, use the \*(L"Virtual Desktop Settings\*(R"
|
|
menu. This will bring up a menu that looks something like the one on the left.
|
|
Use the slider bars to extend the size of the virtual areas to the size that
|
|
you prefer. You can also use this dialog to enable/disable edge
|
|
resistance (when your mouse hits the edge of an area) moving between
|
|
virtual areas.
|
|
.PP
|
|
Enlightenment also allows you to set a different desktop backdrop per desktop
|
|
to help you customize your environment and differentiate which desktop is
|
|
which.
|
|
.PP
|
|
An easy way of having Enlightenment automatically pick up any pictures you have
|
|
is to make a directory in your ~/.enlightenment directory called
|
|
backgrounds and then fill that with your favorite backdrops. Enlightenment
|
|
will automatically discover this and index them for you allowing you to
|
|
select them and change their settings. More on this topic is explained in the
|
|
Desktop Backgrounds section.
|
|
.Sh "Changing Desktops"
|
|
.IX Subsection "Changing Desktops"
|
|
There are several ways that you can change your current desktop \- let's go over
|
|
a few of them here.
|
|
.PP
|
|
You can use the Keybindings alt\-F1 through alt\-F12 for the first 12
|
|
desktops.
|
|
You can use the Keybindings Ctrl-Alt-Left and Ctrl-Alt-Right to
|
|
navigate to the next/previous desktop.
|
|
You can use the Keybindings shift-alt-directional arrow to change
|
|
virtual areas in a given direction.
|
|
You can use the Pager to quickly navigate to the desktop/area you want
|
|
by clicking on the desired area.
|
|
You can use the Dragbar to quickly navigate to a particular
|
|
application or a particular desktop by using the middle and right mouse
|
|
buttons.
|
|
You can also use external applications such as the \s-1GNOME\s0 panel's pager or the
|
|
\&\s-1KDE\s0 panel's pager to navigate desktops and/or applications.
|
|
.Sh "Moving Applications Between Desktops"
|
|
.IX Subsection "Moving Applications Between Desktops"
|
|
There are several ways that you can move applications from one desktop to
|
|
another. We'll go over a few of them now.
|
|
.PP
|
|
The first way you can move apps between desktops is using the Pager.
|
|
.PP
|
|
You can also move applications between desktops using the
|
|
Dragbar.
|
|
.PP
|
|
You can also move applications between desktops using the \s-1KDE\s0 or \s-1GNOME\s0
|
|
desktop pagers.
|
|
.PP
|
|
You can also move a window, then bring the window with you as you
|
|
change desktops using keybinding.
|
|
=head2 The Dragbar
|
|
.PP
|
|
If you look along the top of your screen, you will notice a long thin bar that
|
|
looks something like the bar pictured below. This is called your Dragbar. It
|
|
gets its name from its primary purpose, which is dragging desktops around.
|
|
.PP
|
|
If
|
|
you are on any desktop except desktop 0, you can pick up and move that desktop
|
|
in another direction. Desktops documentation has more information
|
|
on how to change desktops. Once you have dragged a desktop down, you can
|
|
proceed to move windows between desktops this way, instead of using the
|
|
pager.
|
|
.PP
|
|
You can also use the Dragbar to retrieve windowlists. Use the middle mouse
|
|
button to retrieve a windowlist, and the right mouse button for a
|
|
windowlist sorted by desktops.
|
|
.PP
|
|
The Pager
|
|
Pagers may not be a new idea in desktop environments, but the Pager in
|
|
Enlightenment (as seen on the right) is a highly advanced and highly
|
|
configurable tool for desktop and window control, as well as a navigation tool.
|
|
.PP
|
|
The pager lets you see your desktop screen area in miniature. It lets you click
|
|
on a certain desktop to \*(L"visit\*(R" it, click and drag windows around in the pager
|
|
itself to move them about the screen quickly, or between desktops. In this example, we have two virtual areas. You can see the current area (the
|
|
one with the windows in it) is also highlighted.
|
|
.PP
|
|
Dragging a window from
|
|
one area of a pager to another will move it there, or to another desktop.
|
|
Dragging it out onto the actual desktop will drop that window right there.
|
|
You can also drag a window into the Iconbox to iconify the window.
|
|
.PP
|
|
Pressing right-mouse button over a blank portion of the pager gets you the
|
|
pager menu, allowing you to change settings. This will allow you to
|
|
set a couple of quick options, as shown on the left. For more available
|
|
options, you can select the \*(L"Pager Settings\*(R" item, and another dialog will pop
|
|
up, that looks like the one below.
|
|
.PP
|
|
This dialog box will allow you to set all sorts of additional parameters, many
|
|
of which can increase the performance of Enlightenment on your system.
|
|
Disabling high quality snapshots and/or snapshots in general as well as
|
|
continuous updates can seriously improve performance \- these features are
|
|
intended for high end machines.
|
|
.PP
|
|
You can resize the pager to make it the size you'd like. Hold down
|
|
\&\s-1ALT\s0 and use the middle-mouse button to resize the pager in any direction. Using
|
|
left-mouse button while holding \s-1ALT\s0 and dragging will move the window. Holding
|
|
down \s-1ALT\s0 while pressing right-mouse button, just like any normal window will
|
|
get you a window operations menu.
|
|
.PP
|
|
In the default theme clicking the tab on the right side of the pager with the
|
|
arrow pointing right will shade and unshade the pager window horizontally,
|
|
allowing you to hide and unhide the window easily.
|
|
.PP
|
|
The striped area above this tab on the pager's border is a handle that will
|
|
allow you to move the pager about, just like the titlebar of any window.
|
|
.Sh "The Iconbox"
|
|
.IX Subsection "The Iconbox"
|
|
The iconbox is the place the icons for all your iconified windows go. It is
|
|
one method of recovering minimized applications. Whenever
|
|
you iconify or minimize a window it will go into an iconbox and have an icon
|
|
displayed for it there. Clicking on the icon again will de-iconify it.
|
|
.PP
|
|
You can have as many icon boxes on your desktop as you want to. You can create
|
|
more by using the Middle Click Menu \- select Desktop\->Create New Iconbox
|
|
and a new Iconbox will pop up on your desktop. Each of these Iconboxes can
|
|
have individual configurations, as detailed on the next page.
|
|
.PP
|
|
You can move the Iconbox around the screen using Alt-Leftclick
|
|
on the window, and then moving it to the desired location on the screen. You
|
|
can resize the Iconbox by alt-middleclicking on the window and
|
|
then adjusting the size as described in the Mouse Bindings
|
|
section.
|
|
.PP
|
|
Clicking the right-mouse button anywhere in the Iconbox will bring up a menu
|
|
to configure that iconbox. This menu will look a little something like the one
|
|
here to the right. This menu allows you to also close the Iconbox or open up
|
|
an additional Iconbox.
|
|
.PP
|
|
To change the settings of an individual Iconbox, we'll use the right mouse
|
|
button menu and select \*(L"This
|
|
Iconbox Settings\*(R" \- this should get us a dialog that looks something like the
|
|
one to our left. You can change the orientation, icon size, scrollbar
|
|
options, display policy, base image, and many more options of the Iconbox
|
|
from this dialog. You may choose to change the anchor of
|
|
alignment for resizes \- play with it until it resizes appropriately for your
|
|
Iconbox location.
|
|
.PP
|
|
If you want to customize the images used for the icons in your iconbox, there
|
|
is already an example configuration supplied. To make your own configuration
|
|
copy the icondefs.cfg file installed in your Enlightenment system config
|
|
directory (/usr/local/enlightenment/config/icondefs.cfg or
|
|
/usr/share/enlightenment/config/icondefs.cfg) to your ~/.enlightenment
|
|
directory and then edit it. On each line you will find 4 fields. The first
|
|
field is the image file to be used. The image is searched for in the usual
|
|
search path if it is not an absolute path to the image file. The search path
|
|
is in order: ~/.enlightenment, \s-1THEME_DIR/\s0, ENLIGHTENMENT_ROOT/config.
|
|
.PP
|
|
The second field on the line is a shell-glob like match for the title of
|
|
a window.
|
|
If this field is irrelevant, \s-1NULL\s0 is used instead. \s-1NB:\s0 the only valid wildcard
|
|
in the glob pattern is \*(L"*\*(R". The third field is the \s-1NAME\s0 property of the window
|
|
and the fourth is the \s-1CLASS\s0. The order of search priority is last to first,
|
|
so the last entry in the file that matches a window's title, name and class
|
|
globs will use the icon image defined on the first line.
|
|
.PP
|
|
If you want all windows to have an icon then use:
|
|
.PP
|
|
\&\*(L"pix/pimage.png\*(R" \s-1NULL\s0 \s-1NULL\s0 \s-1NULL\s0
|
|
.PP
|
|
This is the most general match for an icon and will match \s-1ALL\s0 windows. If you
|
|
use this make sure it's at the start of the file so it will only match if no
|
|
other matches are found.
|
|
.PP
|
|
There are several examples of using the globbing and matching in the system
|
|
icondefs.cfg file. Use that as a reference for your own additions.
|
|
.Sh "Recovering Minimized Applications"
|
|
.IX Subsection "Recovering Minimized Applications"
|
|
There are several ways to recover an application once you have minimized it.
|
|
The most obvious way is to use the
|
|
Iconbox . Of course, you might
|
|
have had some applications in your Iconbox when you accidentally closed it. Or
|
|
maybe you minimized some applications and forgot you didn't have an Iconbox.
|
|
Or maybe you don't like the Iconbox and usually use \s-1KDE\s0 or \s-1GNOME\s0's panel to
|
|
recover them and forgot to launch them. Never fear. You can always
|
|
middle click on the Dragbar
|
|
and get a menu that will allow you
|
|
to recover them. You can also Alt or Ctrl-Middleclick on the desktop to get
|
|
the same menus (in case you don't have a Dragbar anymore).
|
|
.PP
|
|
Remember, at any time you can always create a new Iconbox to catch
|
|
your applications as they minimize, if you want to re-enable it. Unfortunately
|
|
you'll have to reconfigure it since each Iconbox can have its own
|
|
settings.
|
|
.PP
|
|
Remembering Application Properties
|
|
In the window operations menu of every window you will see an
|
|
entry labeled
|
|
\&\*(L"Remember...\*(R". If you select this it will bring up the \*(L"Remember\*(R" dialog for
|
|
that window (Note: only one of these dialogs can be active at any one time), as
|
|
shown to our right.
|
|
.PP
|
|
This dialog lets you selectively snapshot certain attributes of that window at
|
|
that time and have Enlightenment remember them. You may choose to only remember
|
|
some of the attributes, and possibly not have the application started
|
|
automatically for you. Choose what you want Enlightenment to remember about that
|
|
window and hit \*(L"Apply\*(R" or \*(L"\s-1OK\s0\*(R" if you don't need the dialog anymore, and
|
|
Enlightenment will, the next time that instance of the application is run,
|
|
apply the current location, size, border style or any other attribute to
|
|
that window. Enlightenment can also launch the application for you upon startup
|
|
if you so wish.
|
|
.PP
|
|
Settings
|
|
When you click the right mouse button on the desktop background you will pop
|
|
up the Settings menu. From here you can select an aspect of Enlightenment to
|
|
configure to your liking. There are too many settings to actually document
|
|
fully right now, but the likelihood is if you want a particular behavior from
|
|
Enlightenment, it is achievable by merely playing with these options.
|
|
.PP
|
|
Combinations of options are often required to get the effect you want, so some
|
|
experimentation may be required. Do not be frightened. Nothing you can do
|
|
can't be undone by simply changing the options back to how they were and
|
|
clicking on Apply again.
|
|
.Sh "Window Groups"
|
|
.IX Subsection "Window Groups"
|
|
Sometimes you have a number of windows on your desktop that logically go
|
|
together. Enlightenment allows you to group windows
|
|
together, so that whenever you change a property of one window in a group,
|
|
the change is reflected on the other group members. If you have a group whose
|
|
members span multiple desktops , changing a group's property
|
|
affects only windows of that group that are on the current desktop.
|
|
.PP
|
|
The properties that you can change for an entire group include setting the window
|
|
border, iconifying, killing, moving, raising/lowering, sticking and shading of
|
|
a window.
|
|
.PP
|
|
To define what properties are applied to a group by default, you go to the
|
|
settings menu and pick the \*(L"Group Settings\*(R" option, which will give
|
|
you a dialog window in which you can configure the settings, as shown here on
|
|
the right.
|
|
.PP
|
|
There are two different methods for manipulating window groups. First, there's a
|
|
comprehensive submenu available in each window's operations menu
|
|
called \*(L"Window Groups\*(R". This menu is shown here on the right. You also are
|
|
able to configure the group individually apart from the default group settings
|
|
(as shown on the previous page).
|
|
.PP
|
|
The second way is the window titlebar, which has the most important options
|
|
directly available for convenience. Shift-click to start a group,
|
|
Ctrl-clicking to add a window to the youngest group (also referred to as the
|
|
\&\*(L"current\*(R" group) and Shift-Ctrl-Click to destroying a group. You can also click
|
|
the middle mouse button for visualizing the group(s) of a window. Click again
|
|
to returning to the previous border.
|
|
.PP
|
|
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 the dialog windows.
|
|
.PP
|
|
Selecting and Adding backgrounds
|
|
.PP
|
|
Often you will want to change the background of a particular desktop. There
|
|
are several ways you can do this. But of course, to change your desktop,
|
|
you'll need to give Enlightenment some graphics to play with. A desktop
|
|
theme may add a background or two to your available selections, but
|
|
most users want to have even 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
|
|
.PP
|
|
mkdir ~/.enlightenment/backgrounds
|
|
.PP
|
|
Once you've done this, you should restart Enlightenment \- this can be done
|
|
quickly and easily by simply hitting the Ctrl-Alt-End key combination. When
|
|
Enlightenment starts up, it will rescan these directories, and add new files
|
|
into the background selector.
|
|
.PP
|
|
Once you have added your backgrounds and restarted Enlightenment, you should be
|
|
able to go to the root menu desktop selector. To get to this menu, middle
|
|
click on the desktop, select \*(L"Desktop\*(R",
|
|
and go to Backgrounds. You should get something that looks similar to the
|
|
image on the right. From here you will be able to navigate the backgrounds
|
|
menus.
|
|
.PP
|
|
(Click next for more information)
|
|
.PP
|
|
Once you have opened up the backgrounds menu, you should see something similar
|
|
to the image below. From here, you can put your mouse over any of the images
|
|
there, and it will change the desktop background of the current desktop to the
|
|
image that you have selected.
|
|
.PP
|
|
Enlightenment will attempt to choose the best
|
|
settings for a particular background, but if it gets it wrong you can always
|
|
change the settings by hand. By bringing up the settings menu with the right
|
|
mouse button and selecting the \*(L"Desktop Background Settings\*(R" item, you can
|
|
bring up a dialog that looks something like the one on the next page . ..
|
|
.PP
|
|
You can use this dialog to change your background, too , as well as fine-tune
|
|
all the various settings for each individual background available.
|
|
.Sh "Tooltips"
|
|
.IX Subsection "Tooltips"
|
|
From time to time, as you use Enlightenment, if you don't remember what does
|
|
what, if you keep the mouse still for a little bit a tooltip will pop up. The
|
|
easiest example of this is when you hold the mouse over a Window Border.
|
|
.PP
|
|
You can disable the tooltips or change the delay before they pop up by
|
|
selecting the \*(L"Tooltip Settings\*(R" dialog from the settings menu, as
|
|
shown here on the left.
|
|
.Sh "Audio"
|
|
.IX Subsection "Audio"
|
|
Of course, Enlightenment comes preconfigured to play lots of little blips and
|
|
beeps when you do various things on your desktop. In order to use sound in
|
|
Enlightenment, you must have both ESounD and audiofile installed. You can find
|
|
more information about these libraries from http://www.gnome.org.
|
|
.PP
|
|
You can enable and/or disable sound at runtime simply by selecting from the
|
|
Settings menu the \*(L"Audio Settings\*(R" option, which brings up a dialog,
|
|
shown here at right.
|
|
.Sh "Special Effects"
|
|
.IX Subsection "Special Effects"
|
|
Enlightenment has many features that are configured via the \*(L"Special \s-1FX\s0\*(R"
|
|
settings dialog. Here you can configure the Dragbar ,
|
|
various sliding speeds (including the speed of a windowshade), as well as
|
|
toggle animation of different features. You can also configure the method used
|
|
for sliding windows, similar to
|
|
resize modes .
|
|
.PP
|
|
There are several \s-1FX\s0 features disabled by default
|
|
in a new installation, including the animated display of menus. You can also
|
|
enable saveunders here, which may improve or slow down the performance of
|
|
Enlightenment on your X server, depending on server and configuration.
|
|
.PP
|
|
Setting the Focus
|
|
.PP
|
|
Enlightenment offers lots of different options for focusing windows. By
|
|
default, it comes up in sloppy focus mode. There are two other primary focus
|
|
modes supported by Enlightenment \- click to focus and pointer focus.
|
|
.PP
|
|
Click To Focus most people are familiar with. You click on a window and it
|
|
receives the focus from Enlightenment.
|
|
.PP
|
|
Pointer Focus gives the focus to whichever window the pointer is sitting over
|
|
.PP
|
|
Sloppy Focus is similar to Pointer Focus, except that if you go over the
|
|
desktop background you still are focused on the last window
|
|
.PP
|
|
Next we'll tell you how to change these settings.
|
|
.PP
|
|
Enlightenment allows you to change your focus settings at any time. Simply
|
|
bring up the Settings menu and then select \*(L"Focus Settings\*(R" to bring
|
|
up a dialog that looks something like the one on the right. At the top, we can
|
|
select between our three focus modes, as described on the previous page.
|
|
.PP
|
|
We can also enable some other features, such as one that will allow a simple
|
|
mouse click to raise any window to the foreground, as well as several
|
|
other advanced focus settings.
|
|
.PP
|
|
Here we can also enable the focuslist feature. This feature requires Xkb to be
|
|
enabled in your X server. If you don't have Xkb enabled, please consult your X
|
|
server documentation to see how to do this. The focuslist is a
|
|
window list that pops up
|
|
as you cycle through your focus using the \s-1ALT\s0 + \s-1TAB\s0
|
|
Keybinding.
|
|
=head2 Moving Windows
|
|
.PP
|
|
Enlightenment comes with several different available methods for moving a
|
|
window. You can perform the actual moves using the Window
|
|
.PP
|
|
Border, or by using the available
|
|
.PP
|
|
Mouse Bindings . This will cause the window to move until you have
|
|
released the mouse button.
|
|
.PP
|
|
To change the mode that the moving of the windows uses (opaque being the
|
|
default), open up the Settings menu, and select \*(L"Move & Resize
|
|
Settings\*(R". You can select from a list that looks similar to the one here
|
|
above\-right. Experiment until you find one that suits you best.
|
|
.PP
|
|
For some serious eyecandy, try out the Translucent move mode. This will only
|
|
work if your X server and Enlightenment are running on the same machine,
|
|
however.
|
|
.Sh "Resizing Windows"
|
|
.IX Subsection "Resizing Windows"
|
|
Enlightenment also comes with several available methods for resizing windows.
|
|
You can perform the actual resize on the window by clicking on any
|
|
resize-handle of your window border and dragging to the desired size.
|
|
You can also get the same effect by using the \s-1ALT\s0 + middle button
|
|
mouse binding in any part of the window.
|
|
.PP
|
|
To change the mode that the resizing of the windows uses (opaque being the
|
|
default), open up the Settings menu, and select \*(L"Move & Resize
|
|
Settings\*(R". You can select from a list that looks similar to the one here
|
|
above\-right. Experiment until you find one that suits you best.
|
|
.PP
|
|
The best eyecandy 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.
|
|
.PP
|
|
The Window Operations Menu
|
|
The Window Operations menu is a commonly used menu that allows you to perform
|
|
many different actions onto the current window.
|
|
.PP
|
|
The Close function closes the window in question.
|
|
Annihilate destroys the window without
|
|
regard to the application the window belongs to, which is especially useful if
|
|
the application refuses to respond to being closed with Close.
|
|
.PP
|
|
The Iconify function iconifies the window.
|
|
If you have an
|
|
.PP
|
|
Iconbox
|
|
it is sent to the nearest one.
|
|
.PP
|
|
The Raise function raises the window above any windows
|
|
that may be obscuring it and Lower
|
|
lowers it below windows it is obscuring.
|
|
.PP
|
|
Shade/Unshade toggles the shaded state of the window. Note that borderless
|
|
windows are not allowed to be shaded.
|
|
.PP
|
|
Stick/Unstick toggles the sticky state of a window. A window that is sticky
|
|
remains \*(L"stuck to the glass\*(R" and thus is visible on all virtual and
|
|
multiple desktops.
|
|
.PP
|
|
Fullscreen/Window zooms in and out of the window changing resolutions
|
|
if possible. This feature will only work if you have your X server configured
|
|
correctly and it supports the XVidtune extension. Your X server may not like
|
|
having resolutions changed \- it is possible that an unstable X server could
|
|
crash if you use this. Be aware of this when using this feature.
|
|
.PP
|
|
Remember... displays the Remember Properties dialog that lets
|
|
you select things to remember about this instance of an application. The
|
|
attributes selected to be remembered in the state they are when you hit Apply or
|
|
Ok in this dialog. You will have to bring it up again if you wish to remember
|
|
a new state of the window.
|
|
.PP
|
|
In the Window Groups submenu there are various options for
|
|
configuring window
|
|
groups and how this window relates to any groups you may have. Note that you
|
|
cannot group Pagers windows or Iconboxes together with
|
|
each other or any other windows.
|
|
.PP
|
|
You can quickly modify the size of a window to one of several aspects of
|
|
maximum sizes using the Window Size submenu.
|
|
.PP
|
|
Set Stacking lets you change the stacking layer of that window.
|
|
.PP
|
|
You can change the border using the Set Border Style menu if
|
|
you wish to use a different window border. If you change themes after you have
|
|
changed the border, and the new theme doesn't provide a border of the same
|
|
name, the window will fall back to using the \s-1DEFAULT\s0 border until you
|
|
change it again.
|
|
.PP
|
|
Window Placement and Autoraise
|
|
.PP
|
|
These two Settings dialogs allow you to configure various options
|
|
for the placement of windows. The two Dialog window options are for windows
|
|
like the \s-1ALT+O\s0 open \s-1URL\s0 window in Netscape. Manual Placement will force you to
|
|
use the mouse to position every new window that attempts to map itself.
|
|
.PP
|
|
The Autoraise settings Dialog will allow you to set a timer event that causes a
|
|
window to automatically raise itself to the foreground after a set time. You
|
|
can enable it here, as well as change the timer. This is only useful in the
|
|
sloppy and pointer focus modes.
|
|
.PP
|
|
Enlightenment and \s-1IPC\s0
|
|
.PP
|
|
Enlightenment has a fairly interesting \s-1IPC\s0 system that allows external
|
|
applications (such as Eterm) to talk to Enlightenment and both ask for
|
|
information and change information. There is a program that was installed with
|
|
Enlightenment called \*(L"eesh\*(R" that is a simple shell interface to the \s-1IPC\s0 in
|
|
Enlightenment. It's even got its own documentation. You can go into
|
|
eesh and type \*(L"help\*(R" and it should spit back a list of commands that it
|
|
understands.
|
|
.PP
|
|
Note: there are many commands that will show up in E's \s-1IPC\s0 that don't
|
|
necessarily work yet, or aren't fully implemented. You \s-1CAN\s0 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 \s-1IPC\s0 to flesh out even more in future
|
|
revisions.
|
|
.PP
|
|
To exit eesh, hit \s-1CTRL\s0 + D (\s-1EOF\s0)
|
|
.PP
|
|
Editing Enlightenment's Menus
|
|
.PP
|
|
The first time you run Enlightenment as a user after you've installed it, it
|
|
should create a directory under your home directory called .enlightenment. In
|
|
this directory, there will be a file called \*(L"file.menu\*(R" \- this file controls
|
|
the contents of your left-mouse button Menu . The very first line
|
|
of this file contains the title for the menu, and the remainder of the file
|
|
looks something like this:
|
|
.PP
|
|
.Vb 1
|
|
\& "Eterm" NULL exec "Eterm"
|
|
.Ve
|
|
.PP
|
|
Where each column represents:
|
|
.PP
|
|
.Vb 1
|
|
\& Entry title , graphic for menu (or NULL) , exec "commandline"
|
|
.Ve
|
|
.PP
|
|
You may have several files in here, including a \s-1KDE\s0 menu and a Gnome menu if
|
|
Enlightenment has detected their presence during installation. If
|
|
detected, your primary apps will be located in another file called
|
|
user_apps.menu. Each of these files is for you to edit as desired.
|
|
.Sh "Editing Your Keybindings"
|
|
.IX Subsection "Editing Your Keybindings"
|
|
To set your own keybindings, all you have to do is find the keybindings.cfg
|
|
file that was installed with Enlightenment, and make a copy in your
|
|
~/.enlightenment directory. This file is fairly long, but shouldn't be too
|
|
difficult to edit. Be careful! The keybindings in this file will override \s-1ALL\s0
|
|
the default keybindings, as long as this file exists, so edit this file with
|
|
extreme caution (unless you know what you're doing).
|
|
.PP
|
|
To reset your keybindings back to the default, simply remove this file from
|
|
your ~/.enlightenment directory. The next time you restart Enlightenment
|
|
it should reload the default keybindings into memory.
|
|
.PP
|
|
Enlightenment and Themes
|
|
.PP
|
|
One of the strong points of Enlightenment, of course, is that you can change
|
|
around the complete look and feel of your desktop whenever you want to.
|
|
Included with the 0.16.8 release are a few themes, to show off a little bit of
|
|
this configurability. You can select them by using the middle mouse button
|
|
menu , going to the \*(L"Themes\*(R" selector, and then choosing a new
|
|
theme. Of course, there are plenty more themes for Enlightenment than come
|
|
with it by default. You can find more by going to:
|
|
.PP
|
|
http://e.themes.org
|
|
.PP
|
|
and searching around until you find something you like.
|
|
.PP
|
|
To install a new theme
|
|
is simple: all you need to do is take the bleh.etheme file and drop it into
|
|
your
|
|
~/.enlightenment/themes
|
|
directory. Once you've restarted Enlightenment,
|
|
it will automatically show up in your Themes menu, and you can
|
|
choose it just like any other theme.
|
|
.PP
|
|
Enlightenment's Eyecandy Features
|
|
.PP
|
|
Of course, Enlightenment wouldn't be complete without just a few bits of
|
|
eyecandy to play with.
|
|
.PP
|
|
On the \*(L"Special \s-1FX\s0\*(R" settings dialog you can chose two toys:
|
|
.PP
|
|
The ripples effect \- this causes little ripplets of water to reflect on the
|
|
bottom of your screen.
|
|
.PP
|
|
The waves effect \- similar to ripples, but this one waves up and down as
|
|
opposed to side-to-side
|
|
.PP
|
|
On the \*(L"Desktop Background\*(R" settings dialog you can enable \*(L"Theme
|
|
Transparecy\*(R". A slider controls the opacity of the window borders, etc. with
|
|
respect to the desktop background.
|
|
.Sh "Included Maintenance Scripts"
|
|
.IX Subsection "Included Maintenance Scripts"
|
|
Enlightenment comes with several scripts that are executable out of the middle
|
|
mouse button menu \- these scripts can perform all sorts of
|
|
maintenance on the files that Enlightenment creates automatically for you.
|
|
When you select \*(L"Maintenance\*(R" you should get a menu that looks something like
|
|
the one above\-right. You can also rebuild the \s-1KDE\s0 and \s-1GNOME\s0 menus
|
|
Enlightenment uses from here
|
|
.PP
|
|
As a warning, when you purge configuration information, the next time you
|
|
restart Enlightenment it will take longer to load. You can monitor
|
|
Enlightenment's usage using the query tools provided. If you change themes a
|
|
lot you will probably want to purge the config file cache after you've settled
|
|
on a theme. This will help keep your disk usage by Enlightenment down.
|
|
.Sh "Frequently Asked Questions"
|
|
.IX Subsection "Frequently Asked Questions"
|
|
Q: I can't find my Iconbox or change its settings.
|
|
.PP
|
|
A: There are two possibilities here.
|
|
.PP
|
|
1. You don't have an Iconbox on your desktop right now. Just middle-click and
|
|
select Desktop/Create new iconbox
|
|
.PP
|
|
2. Your Iconbox is transparent and borderless. Iconify a window and see if
|
|
your icon appears. If so, rightclick on it to reconfigure your Iconbox.
|
|
.PP
|
|
Q: I Can't Seem To Find My Left Mouse Menu
|
|
.PP
|
|
A: Your menu files may be destroyed. Try rerunning the program that initially
|
|
generated them. First you'll want to remove the ~/.enlightenment/*.menu files.
|
|
Rebuild them using the Maintenance menu.
|
|
.PP
|
|
Q: All My Settings Are Mangled And I Can't Fix It
|
|
.PP
|
|
A: Well, if things get really messed up, you can always remove all of
|
|
Enlightenment's automatically saved files. go into ~/.enlightenment, and
|
|
remove the ...e_session* files, and then blow away the cached directory. If
|
|
your theme is broken, remove the user_theme.cfg file, also. The
|
|
next time you start Enlightenment it should reset everything to the default.
|
|
.PP
|
|
Q: I Upgraded My Theme, But The New One Isn't Being Used
|
|
.PP
|
|
A: When you upgrade a theme that does not come with Enlightenment, when you go
|
|
into your ~/.enlightenment/themes directory, be sure to delete the unpacked
|
|
directory version of your theme that should be sitting next to the theme, if it
|
|
is there. Otherwise when Enlightenment attempts to start the new version it
|
|
will use the old files, which causes this problem.
|
|
.PP
|
|
Q: I set my window to borderless and can't set it back or move it.
|
|
.PP
|
|
A: \s-1ALT\s0 + Right mouse button when pressed anywhere in the window will give you
|
|
the window operations menu. \s-1ALT\s0 + Left mouse button will move the
|
|
window and \s-1ALT\s0 + Middle mouse button will resize the window.
|
|
.PP
|
|
Q: How can I move or resize the iconbox?
|
|
.PP
|
|
A: As described above, \s-1ALT\s0 + Right mouse button will give you the
|
|
window operations menu, \s-1ALT\s0 + Middle mouse button will resize the
|
|
iconbox and ALT+left mouse button will move it. See the Iconbox
|
|
documentation for more help
|
|
.PP
|
|
Q: How can I disable that annoying desktop tooltip?
|
|
.PP
|
|
A: There is a special config option for it under the tooltip
|
|
settings menu.
|
|
.PP
|
|
Q: How do I set up Enlightenment to work with \s-1GNOME\s0?
|
|
.PP
|
|
A: Start your \s-1GNOME\s0 session with
|
|
export WINDOW_MANAGER=enlightenment
|
|
exec gnome-session
|
|
.PP
|
|
Q: How do I set up Enlightenment to work with \s-1KDE\s0?
|
|
.PP
|
|
A: Start your \s-1KDE\s0 session with
|
|
export KDEWM=enlightenment
|
|
exec startkde
|
|
.PP
|
|
Q: These Docs Didn't Help, Where Can I Get More Help?
|
|
.PP
|
|
A: Well, we obviously can't answer all of your questions just by predicting
|
|
them, so I would try the website as well as looking at the
|
|
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 irc channel
|
|
.SH "FOR MORE INFORMATION"
|
|
.IX Header "FOR MORE INFORMATION"
|
|
Please see our web site at http://www.enlightenment.org
|