You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Carsten Haitzler 41decc6522 update readme version 10 years ago
..
cmakeconfig Added ElementaryConfigVersion.cmake.in 11 years ago
config config - feature add - audio muting config and controls 10 years ago
data theme - default styles - make disabled all look properly disabled 10 years ago
doc doc/examples: added missing links to examples codes and made some 10 years ago
m4 autotools: let's override what we just did set. 10 years ago
pkgbuild elm_web: disable support for Webkit/EFL. 10 years ago
po po: Updated po files. 10 years ago
src fix version and date in doxygen 10 years ago
tests
.arcconfig add .arcconfig back. 11 years ago
.gitignore gitignore: added autotools tool. 10 years ago
.mailmap mailmap myself 10 years ago
AUTHORS spinner: After long press of inc/dec buttons, start continuously increasing/decreasing 10 years ago
COMPLIANCE compliance/licensing - clarify, fix formatting and point to tldrlegal.com 10 years ago
COPYING COPYING, elm_intro.h: updated copyright Date. 11 years ago
COPYING.images
ChangeLog ChangeLog/NEWS: Removed unnecessary ChangeLog and NEWS entries. 10 years ago
INSTALL
Makefile.am Add COPYING.images to make dist 10 years ago
Makefile_Elm_Helpers.am autotools: forgotten files. 10 years ago
NEWS ChangeLog/NEWS: Removed unnecessary ChangeLog and NEWS entries. 10 years ago
README update readme version 10 years ago
TODO add whitespace... 11 years ago
autogen.sh
configure.ac 1.9.0 alpha1 release 10 years ago
elementary.pc.in deps removal - fix pc file to match 10 years ago
elementary.spec.in Spec and build dependency fixes. 11 years ago

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