efl/legacy/elementary
Tom Hacohen e558e6180c Eolian: Added a variable for the needed deps's Eolian flags. 2014-03-13 10:09:51 +00:00
..
cmakeconfig Added ElementaryConfigVersion.cmake.in 2013-04-03 14:37:02 +01:00
config focus: Added focus highlight clip disable feature. 2014-03-09 03:39:23 +09:00
data actionslider: Fixed wrong signal names but still support backward 2014-03-11 02:27:26 +09:00
doc documentation style cleanup for release 2014-02-21 22:26:22 +09: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 right after the release! 2014-02-26 01:27:13 +09:00
src Eolian: Fix building of .eo files. 2014-03-13 08:51:10 +00: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 Anand to author file. 2014-03-10 17:58:10 +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 Added Eolian support. 2014-03-11 09:51:15 +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