summaryrefslogtreecommitdiff
path: root/old/README.ecore
diff options
context:
space:
mode:
authorVincent Torri <vincent.torri@gmail.com>2012-12-02 22:41:16 +0000
committerVincent Torri <vincent.torri@gmail.com>2012-12-02 22:41:16 +0000
commit3b016183f95ddfeb996dfc1f41fc2dcf33c96660 (patch)
treeab68ae58dca217c7096f08e0b0c46a0a5a92a7af /old/README.ecore
parent7d6010b12c47a20e492da808e3192c3f87dab619 (diff)
merge: missing some informations changes about ecore
SVN revision: 79996
Diffstat (limited to 'old/README.ecore')
-rw-r--r--old/README.ecore98
1 files changed, 98 insertions, 0 deletions
diff --git a/old/README.ecore b/old/README.ecore
new file mode 100644
index 0000000000..e9cedf3e85
--- /dev/null
+++ b/old/README.ecore
@@ -0,0 +1,98 @@
1Ecore 1.7.99
2
3******************************************************************************
4
5 FOR ANY ISSUES PLEASE EMAIL:
6 enlightenment-devel@lists.sourceforge.net
7
8******************************************************************************
9
10Requirements:
11-------------
12
13Must:
14 libc
15 eina (1.1.0 or better)
16 (For windows you also need: evil)
17
18Recommended:
19 libX11
20 libXext
21 libXcursor
22 libXprint
23 libXinerama
24 libXrandr
25 libXss
26 libXrender
27 libXcomposite
28 libXfixes
29 libXdamage
30 libXdpms
31 libXtest
32 GNUTLS or OpenSSL
33 CURL
34 evas (1.1.0 or better)
35
36Optional:
37 XCB (fully working)
38 SDL
39 DirectFB
40 glib
41 tslib
42
43Ecore is a clean and tiny event loop library with many modules to do
44lots of convenient things for a programmer, to save time and effort.
45
46It's small and lean, designed to work on embedded systems all the way
47to large and powerful multi-cpu workstations. It serialises all system
48signals, events etc. into a single event queue, that is easily
49processed without needing to worry about concurrency. A properly
50written, event-driven program using this kind of programming doesn't
51need threads, nor has to worry about concurrency. It turns a program
52into a state machine, and makes it very robust and easy to follow.
53
54Ecore gives you other handy primitives, such as timers to tick over
55for you and call specified functions at particular times so the
56programmer can use this to do things, like animate, or time out on
57connections or tasks that take too long etc.
58
59Idle handlers are provided too, as well as calls on entering an idle
60state (often a very good time to update the state of the program). All
61events that enter the system are passed to specific callback functions
62that the program sets up to handle those events. Handling them is
63simple and other Ecore modules produce more events on the queue,
64coming from other sources such as file descriptors etc.
65
66Ecore also help you work in a multi threaded environment and setup a
67thread pool that help you use the EFL on multi-cpu system. It help split
68the part that can't be called outside of the ecore main loop from the
69computation heavy function that could run on another CPU. Be aware that
70Evas and most of Ecore API is not thread safe and should only be called
71in the main loop. Eina and Eet could be used, if done carefully, in any
72heavy function on another cpu.
73
74Ecore also lets you have functions called when file descriptors become
75active for reading or writing, allowing for streamlined, non-blocking
76IO.
77
78------------------------------------------------------------------------------
79COMPILING AND INSTALLING:
80
81 ./configure
82 make
83(as root unless you are installing in your users directories):
84 make install
85
86------------------------------------------------------------------------------
87NOTE:
88
89You can experience main loop lock (and more likely see UI lock) if libcurl
90doesn't use an asynchronous dns resolver. Since Curl 7.21.0, you can use the
91native dns resolver asynchronously by turning --enable-threaded-resolver
92on during configure time. For older version, C-Ares is the way to solve that
93issue (see: http://c-ares.haxx.se/ ).
94
95Also the wayland support (ecore_wayland) is considered experimental as
96wayland itself is still unstable and liable to change core protocol.
97If you use this api, it is possible it will break in future, until this
98notice is removed.