efl/legacy/elementary
Daniel Zaoui f660fc7456 Eolian: Integration of Entry 2014-03-23 10:56:44 +02:00
..
cmakeconfig
config focus: Added optional focus feature - focus movement by mouse_in. 2014-03-23 02:04:16 +09:00
data gengrid : Implementation for gengrid item focus support 2014-03-21 17:00:46 +09:00
doc Eolian: Integration of Access 2014-03-19 07:04:34 +02:00
m4 autotools: let's override what we just did set. 2014-01-24 11:13:57 +09:00
pkgbuild elm_web: disable support for Webkit/EFL. 2014-02-06 16:04:37 +09:00
po po: Updated po files. 2014-03-18 14:08:08 +09:00
src Eolian: Integration of Entry 2014-03-23 10:56:44 +02:00
tests
.arcconfig
.gitignore gitignore: added autotools tool. 2013-12-01 21:14:27 +09:00
.mailmap update .mailmap 2014-03-08 15:16:56 +01:00
AUTHORS author: Added Subhransu to authors list. 2014-03-18 13:16:42 +09:00
COMPLIANCE compliance/licensing - clarify, fix formatting and point to tldrlegal.com 2013-10-30 19:28:36 +09:00
COPYING update copying dates 2014-02-12 16:02:36 +09:00
COPYING.images
ChangeLog ChangeLog: Add forgetten out of date notice 2014-03-11 13:44:11 +01:00
INSTALL
Makefile.am Add COPYING.images to make dist 2014-01-10 15:28:24 +09:00
Makefile_Elm_Helpers.am autotools: forgotten files. 2013-12-01 23:36:44 +09:00
Makefile_Eolian_Helper.am Eolian helper: Update to regenerate if generator is updated. 2014-03-19 09:43:07 +00:00
NEWS Release version 1.9.0 2014-02-25 09:43:26 +01:00
README update readme version 2014-02-12 16:01:44 +09:00
TODO
autogen.sh
configure.ac Eolian: Added a variable for the needed deps's Eolian flags. 2014-03-13 10:09:51 +00:00
elementary.pc.in deps removal - fix pc file to match 2013-11-12 23:13:41 +09:00
elementary.spec.in

README

Elementary 1.9.0
================

******************************************************************************
 FOR ANY ISSUES PLEASE EMAIL:
 enlightenment-devel@lists.sourceforge.net
******************************************************************************

Elementary is a basic widget set library that is easy to use and is based on
EFL. It provides the basic building blocks for creating applications and user
interfaces.

For more details about elementary widgets and how to use them kindly refer to
the following link for the latest documentation:

http://www.enlightenment.org/p.php?p=docs


COMPONENTS
----------

**Library:**

//LGPL v2 license//

The library you will find in src/lib/ and modules it loads as demos or
actual implementations in src/modules/. The library depends on at
least on default theme that is built in data/themes/ and some default
config installed from config/.

**Theme:**

The default theme is large and includes data for every widget and then
some. The Theme includes some images that are creative-commons
licensed (see COPYING.images) and is otherwise considered LGPL as well
as the library.

**Test App:**

There is a full test app in src/bin/ and you will find its main source
as test.c with every test split into test_*.c files. This should serve
as a general tester for Elementary as well as example code on writing
UIs with Elementary. Run this app (once installed) with elementary_test.

**Configuration App:**

A simple rough configuration tool is provided called
elementary_config. This tool allows you to play with some basic
configuration of elementary and it saves your config in your home
directory in ~/.elementary as well as applying it to all Elementary
using applications. Themes are normally looked for in
~/.elementary/themes and the system elementary data dir
(PREFIX/share/elementary/themes/).


COMPILING AND INSTALLING
------------------------

    ./configure
    make
    sudo make install

If you have doxygen, then you csan build documentation with:

    make doc

You will find documentation in the doc/ directory.


COMPILER FLAGS
--------------

You likely don't need static libraries most of the time so you can
disable them with:

    --disable-static

You may want to change the install prefix for EFL with:

    --prefix=/path/to/prefix
        
There are also examples in src/examples/ as well. To compile examples
use this option to configure:

    --enable-build-examples

Also you may wish to install the examples, then use:

    --enable-install-examples


REQUIREMENTS
------------

Elementary requires EFL to be installed and available first.


CONFIGURATION
-------------

Configuration for a user is normally stored in ~/.elementary/config,
but if this does not exist, the system configuration in
PREFIX/share/elementary/config is used instead. Overriding either of
these is per-screen or per-virtual-desktop configuration that may be
stored on the root window as a property in X11 or via appropriate
other protocols depending on display system.

By default the profile.cfg file contains a config key that indicates
the name of the profile to use. See config/Makefile.am as to how to
generate this. The directories each contain per-profile configuration.
The cfg files are files generated by Eet and can be generated from
text. See the above Makefile.am