From 7a0118e7f17ab481c322a70031b72a8d1125a464 Mon Sep 17 00:00:00 2001 From: "Carsten Haitzler (Rasterman)" Date: Sat, 4 Jun 2022 16:10:20 +0100 Subject: [PATCH] move to readme.md --- INSTALL | 59 ------- README => README.md | 392 +++++++++++++++++++++++--------------------- data/readme/efl.png | Bin 0 -> 16283 bytes 3 files changed, 205 insertions(+), 246 deletions(-) delete mode 100644 INSTALL rename README => README.md (71%) create mode 100644 data/readme/efl.png diff --git a/INSTALL b/INSTALL deleted file mode 100644 index 2eac4a6af4..0000000000 --- a/INSTALL +++ /dev/null @@ -1,59 +0,0 @@ -** COMPILING and INSTALLING ** ------------------------------- - -Meson is the build system used for this project. For more information please -see: - - http://mesonbuild.com - ----- - -Normal compilation in /usr/local: - - meson . build - ninja -C build - sudo ninja -C build install - -For meson build generic options: - - meson --help - -For a list of project specific options supported: - - cat meson_options.txt - -To set 1 or more project specific options: - - meson --prefix=/path/to -Doption=value [-Dother=value2] [...] . build - -To display current configuration: - - meson configure build - -The above will only work after at least the following is done: - - meson . build - -** QUICK AND DIRTY HELP ** --------------------------- - -How clean out the build and config and start fresh: - - rm -rf build - -How to make a dist tarball and check its build: -(must do it from git tree clone and commit all changes to git first) - - ninja -C build dist - -How to change prefix: - - meson --prefix=/path/to/prefix . build - -How to install in a specific destination directory for packaging: - - DESTDIR=/path/to/destdir ninja -C build install - -How to build with verbose output (full commands run): - - ninja -C build -v diff --git a/README b/README.md similarity index 71% rename from README rename to README.md index 72f49366f1..e3ccb33005 100644 --- a/README +++ b/README.md @@ -1,10 +1,12 @@ -EFL -=== +![EFL](/data/readme/efl.png) +# EFL -****************************************************************************** - FOR ANY ISSUES PLEASE EMAIL: - enlightenment-devel@lists.sourceforge.net -****************************************************************************** +----- + +*Please report bugs/issues at* +[git.enlightenment.org](https://git.enlightenment.org/enlightenment/efl/issues) + +----- EFL is a collection of libraries for handling many common tasks a developer may have such as data structures, communication, rendering, @@ -24,10 +26,9 @@ Config files installed to help developers build against EFL. For more documentation please see: -https://www.enlightenment.org/docs +[www.enlightenment.org/doc](https://www.enlightenment.org/docs) -PLATFORMS ---------- +## Platforms EFL is primarily developerd on Linux (GNU/Linux) and should work on most distributions as long as dependencies are provided. It has been @@ -35,12 +36,11 @@ compiled and run also on Windows (using MSYS2 + mingw-w64 - please see https://phab.enlightenment.org/w/windows/), Mac OS X, FreeBSD and NetBSD. -COMPONENTS ----------- +## Components **Ecore:** -//BSD 2-Clause license// +*BSD 2-Clause license* This is the core main-loop, system events and execution layer. This handles running the main loop, integrating with external data and @@ -48,31 +48,25 @@ timing sources (the system clock, file descriptors, system signals), and producing an event queue, walking that queue and dispatching events to appropriate callbacks. - - **Ecore Audio:** -//BSD 2-Clause license// +*BSD 2-Clause license* This library provides an API for audio playback and recording. It uses pulse audio underneath to handle mixing and policies. The API for this should not be considered stable right now because it relies on EO and EO is not considered finalized yet. - - **Ecore Cocoa:** -//BSD 2-Clause license// +*BSD 2-Clause license* This provides wrappers/abstractions around Max OS-X Cocoa APIs to help Mac porting. - - **Ecore Con:** -//BSD 2-Clause license// +*BSD 2-Clause license* This provides a completely event-based TCP/UDP and Unix domain socket API that integrates with the main-loop. This means no blocking to send @@ -83,11 +77,9 @@ verification, CURL wrapping for HTTP connection usage (GETs, POSTs etc.), asynchronous DNS lookups and provides the ability to also be a server, not just a client, with the same event-based API. - - **Ecore Evas:** -//BSD 2-Clause license// +*BSD 2-Clause license* This acts as glue between the display target (X11, Wayland, Frame buffer, Cocoa on OSX, Win32 etc.) and Evas. It creates/provides a @@ -96,69 +88,55 @@ input events (Keyboard, Mouse, Multi-touch) into Evas, which then selects the target object and calls the callbacks. It also provides wrappers/glue for manipulating the Window/Surface. - - **Ecore Fb:** -//BSD 2-Clause license// +*BSD 2-Clause license* This provides virtual terminal allocation, access and handling, frame buffer information, raw input handling for keyboard, mouse and touch (via tslib). - - **Ecore File:** -//BSD 2-Clause license// +*BSD 2-Clause license* This provides file access convenience APIs for doing simple file operations like renames, copies, listing directories and more. It also supports file change monitoring and URL downloads. - - **Ecore IMF:** -//BSD 2-Clause license// +*BSD 2-Clause license* This is an input method abstraction framework to allow EFL to talk to things like SCIM, IBus, Wayland and XIM. This allows for complex text entry in languages such as Chinese, Japanese and Korean. - - **Ecore IMF Evas:** -//BSD 2-Clause license// +*BSD 2-Clause license* This library glues Input method support from Ecore IMF and Evas together. - - **Ecore Input:** -//BSD 2-Clause license// +*BSD 2-Clause license* This acts as a generic input layer where multiple display systems can post events in the same format to the event queue. - - **Ecore Input Evas:** -//BSD 2-Clause license// +*BSD 2-Clause license* This Routes events from Ecore Input into a given Evas canvas which will then route the event further to the destination object and callbacks. - - **Ecore IPC:** -//BSD 2-Clause license// +*BSD 2-Clause license* This acts as a layer on top of Ecore Con which handles entire IPC message packets, dealing with header delta compression and @@ -167,50 +145,39 @@ go as a single IPC message, regardless of payload data size. The entire API is event based almost exactly like Ecore Con and thus it supports all the transport layers Ecore Con supports. - - - **Ecore SDL:** -//BSD 2-Clause license// +*BSD 2-Clause license* This acts as a wrapper/glue around SDL to handle SDL Windows as well as input events from SDL and tie them to the Ecore main-loop and event queue. - - **Ecore Wayland:** -//BSD 2-Clause license// +*BSD 2-Clause license* This is a glue/wrapper library to interface EFL to Wayland libraries to tie them into the Ecore main-loop and event queue. - - **Ecore Win32:** -//BSD 2-Clause license// +*BSD 2-Clause license* This acts as glue/wrapper around Windows Win32 APIs to tie them into the Ecore main-loop and event queue. - - **Ecore X:** -//BSD 2-Clause license// +*BSD 2-Clause license* This is a library to wrap/deal with Xlib make dealing with X11 less painful and less footwork as well as being glue to tie these into the Ecore main-loop and event queue. - - **Edje:** -//BSD 2-Clause license// (except the epp binary which is GPLv2) +*BSD 2-Clause license* (except the epp binary which is GPLv2) This is a graphics event, input, theme, animation and theme abstraction library used to place many UI/UX elements into data files @@ -222,11 +189,9 @@ data files managed by Eet). These "edj" files are fully portable and can work on any OS/Architecture just like a JPEG or PNG might be portable. - - **Eet:** -//BSD 2-Clause license// +*BSD 2-Clause license* This library is a data storage, encoding and decoding library designed to be extremely compact, fast and easy to use. It can take @@ -241,29 +206,23 @@ Terminology. It supports encryption of data too via SSL, signing of files, as well as various compression techniques. It also supports encoding and decoding of image data in lossless or lossy form. - - **Eeze:** -//BSD 2-Clause license// +*BSD 2-Clause license* This library acts as an abstraction to discovering hardware interfaces for sensors as well as removable media and much more. - - **EFL:** -//BSD 2-Clause license// +*BSD 2-Clause license* This is just some core common header data like a common version number for EFL and how to expose the EO API. - - **Efreet:** -//BSD 2-Clause license// +*BSD 2-Clause license* This library provides code for handling Freedesktop.org standards such as .desktop files, XDG Menus, Icon search paths and more. It provides @@ -271,11 +230,9 @@ a central daemon to handle monitoring for changes that the library talks to, and the daemon handles updating local cache files the library reads. - - **Eina:** -//LGPL v2 license// +*LGPL v2 license* This library provides low-level routines for common things like linked lists, hash tables, growable arrays, basic string buffers, shared @@ -284,29 +241,23 @@ memory pools, copy-on-write segments, iterators, matrices, general data models, red/black trees, quad-trees, a simple SAX XML parser and more. - - **EIO:** -//LGPL v2 license// +*LGPL v2 license* This is an asynchronous I/O library for doing disk I/O without blocking. - - **ElDBus:** -//LGPL v2 license// +*LGPL v2 license* This is a DBus access library to allow you to create DBus services as well as clients. This glues in DBus into the main-loop so all access is asynchronous. - - **Embryo:** -//Small license (same as ZLib license)// +*Small license (same as ZLib license)* This is a small C-like language compiler and byte-code interpreter library. This is used for scripting in Edje. The code is based on @@ -314,11 +265,9 @@ original source from the Pawn/Small Language but has been made portable (endianness issues fixed) and 64bit issues fixed, with the runtime library being refactored to be extremely small. - - **Emotion:** -//BSD 2-Clause license// +*BSD 2-Clause license* This is a wrapper around Gstreamer 1.x pluggable decoder libraries This glues in the decoder library, and its output into a smart Evas object @@ -326,11 +275,9 @@ that will display the playback for you as the video plays, as well as providing higher level controls to seek, play, pause and query the stream regardless of the back-end used. - - **EO:** -//BSD 2-Clause license// +*BSD 2-Clause license* This is a core object system API that EFL 1.8 and on depend on. The API is not finalized, so do not depend on it yet in EFL 1.8, but @@ -341,43 +288,35 @@ strong and weak references, auto-deletion of child objects, unifies callback handling with a single path, and also abstracts object pointers to be indirect table lookups for increased safety at runtime. - - **EPhysics:** -//BSD 2-Clause license// +*BSD 2-Clause license* This library provides a wrapper around the Bullet physics library, allowing for it to be linked directly with Evas objects and control their behavior as if they were real physical objects. This is now disabled by default as it's rarely if ever used by anything. - - **Ethumb:** -//LGPL v2 license// +*LGPL v2 license* This library provides core API for a thumbnailing daemon as well as the thumbnail daemon itself. Ethumb Client talks with Ethumb to pass off thumbnail generation to a central location to be done asynchronously. - - **Ethumb Client:** -//LGPL v2 license// +*LGPL v2 license* This is the client-side part of Ethumb that provides an API for clients to request the Ethumb thumbnailer to generate or find cached thumbnails of files. - - **Evas:** -//BSD 2-Clause license// +*BSD 2-Clause license* This is the core rendering and scene graph abstraction library for EFL. It manages a stateful 2D scene graph that defines the entire @@ -386,120 +325,103 @@ display systems like X11, Windows, Wayland, Frame-buffer etc. and via many rendering APIs like OpenGL, OpenGL-ES 2, and pure software implementations that are fast and accurate. - - **Evil:** -//BSD 2-Clause license// +*BSD 2-Clause license* This library acts as a porting library for Windows to provide missing libc calls not in Mingw32 that EFL needs. It is used internally and no symbol is public. +----- -**Heif:** - -//LGPL v3 license// - -The license doesnt affect efl or apps using efl, but gpl3 or lgpl3 -affects the entire os requiring any gpl/lgpl3 component be -user-replacable. -The end user must be able to modify the libheif code and still be -able to use the efl. - - -COMPILING AND INSTALLING ------------------------- - -For sample configuration options please look in the ./confs/ directory -for scripts that pass in commonly used options. - -See the INSTALL file: https://git.enlightenment.org/core/efl.git/tree/INSTALL - - -REQUIREMENTS ------------- +## Requirements EFL requires a C and C++ compiler by default. C++ exists mostly to interface to C++ libraries like Bullet and our C++ bindings. Required by default: - * libpng - * libjpeg - * openjpeg2 - * gstreamer (Ensure all codecs you want are installed.) - * zlib - * luajit (lua 5.1 or 5.2 support optional) - * libtiff - * openssl - * curl - * dbus - * libc - * fontconfig - * freetype2 - * fribidi - * harfbuzz - * libpulse - * libsndfile - * libx11 - * libxau - * libxcomposite - * libxdamage - * libxdmcp - * libxext - * libxfixes - * libxinerama - * libxrandr - * libxrender - * libxss - * libxtst - * libxcursor - * libxi (2.2 or newer) - * opengl(mesa etc.) (opengl/glx/full or opengl-es2/egl. full opengl only on osx - must be explicitly specified to be full to have support) - * giflib/libgif - * util-linux (limbount + libblkid) - * systemd / libudev - * poppler / poppler-cpp - * libraw - * libspectre - * librsvg - * openmp (clang needs libomp, while gcc uses libgomp) - * libwebp +* libpng +* libjpeg +* openjpeg2 +* gstreamer (Ensure all codecs you want are installed.) +* zlib +* luajit (lua 5.1 or 5.2 support optional) +* libtiff +* openssl +* curl +* dbus +* libc +* fontconfig +* freetype2 +* fribidi +* harfbuzz +* libpulse +* libsndfile +* libx11 +* libxau +* libxcomposite +* libxdamage +* libxdmcp +* libxext +* libxfixes +* libxinerama +* libxrandr +* libxrender +* libxss +* libxtst +* libxcursor +* libxi (2.2 or newer) +* opengl(mesa etc.) (opengl/glx/full or opengl-es2/egl. full opengl only on osx - must be explicitly specified to be full to have support) +* giflib/libgif +* util-linux (limbount + libblkid) +* systemd / libudev +* poppler / poppler-cpp +* libraw +* libspectre +* librsvg +* openmp (clang needs libomp, while gcc uses libgomp) +* libwebp -Wayland support: + +### Wayland support You may also want wayland support when on Linux. This enables support for EFL to trget wayland support for client applications. To do this supply: +``` sh +-Dwl=true +``` - -Dwl=true - -Framebuffer support: - -This requires linux frame-buffer support, headers etc. This supports -basic frame-buffers like /dev/fb as well as input via /dev/input for -keyboards and mice in a basic way. Enable this with: - - -Dfb=true +### Framebuffer support For more modern framebuffer support you may want drm/kms rendering support so enable this. This is what you also want for wayland compositor support in enlightenment as it will want to be able to render to a moder framebuffer tarbet with atomic buffer swapping. To do this provide: +``` sh +-Ddrm=true +``` - -Ddrm=true +Legacy fbcon support also exist6s, but yuou probably no longer want to +use this as it is not maintained anymore. This supports basic frame-buffers +like /dev/fb as well as input via /dev/input for keyboards and mice in a +basic way. Enable this with: +``` sh +-Dfb=true +``` You may want to change the install prefix for EFL with: - - --prefix=/path/to/prefix +``` sh +--prefix=/path/to/prefix +``` The default prefix if not given is "/usr/local". Many people like to use prefixes like /opt/e or /opt/efl or /home/USERNAME/software etc. -COMPILER FLAGS --------------- +### Compiler flags You can affect compilation optimization, debugging and other factors by setting your CFLAGS environment variable (and CXXFLAGS). Be aware @@ -518,12 +440,108 @@ have been carefully considered to provide full functionality so users will not be missing anything. -CRYPTOGRAPHY ------------- +### Cryptography EFL officially offers openssl or gnutls as cryptography backends. By default it uses "openssl" to do signature, cipher and related. Alternatively one can use "gnutls" (some distros are strict about licenses and want gnutls instead of openssl) You can switch to gnutls with: +``` sh +-Dcrypto=gnutls +``` - -Dcrypto=gnutls +----- + +## Compiling and Installing + +Meson is the build system used for this project. For more information +please see [mesonbuild.com](https://mesonbuild.com) + +You will need normal build tooling installed such as a compiler (gcc +or clang for example), pkg-config, ninja, any relevant package-dev or +package-devel packages if your distribution splits out development +headers (e.g. libc6-dev) etc. + +Depending on where dependencies (like efl) are installed, you might have to +set your `PKG_CONFIG_PATH` environment variable like: +```sh +export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:/usr/lib/pkgconfig +``` + +Also note that some distributions like to add extra arch directories +to your library locations so you might have to have more like: +```sh +export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig:/usr/local/lib/x86_64-linux-gnu/pkgconfig:/usr/lib/pkgconfig:/usr/lib64/pkgconfig:/usr/lib/x86_64-linux-gnu/pkgconfig +``` + +You will need to enusre that the destination library directory (e.g. +`/usr/local/lib` is in your /etc/ld.so.conf or /etc/ld.so.conf.d/ +files and after insgtaling anything that installes libraries you +re-run `ldconfig`. Please see relevant documentation on ldconfig and +ld.so.conf for your distribution. + +You might also want to add the destination bin dir to your environment +variable PATH (see documentation on your shell PATH variable) such as: +```sh +export PATH=/usr/local/bin:/usr/bin:/bin +``` + +Normal compilation in /usr/local: +```sh +meson . build +ninja -C build +sudo ninja -C build install +``` + +For meson build generic options: +```sh +meson --help +``` + +For a list of project specific options supported: +```sh +cat meson_options.txt +``` + +To set 1 or more project specific options: +```sh +meson --prefix=/path/to -Doption=value [-Dother=value2] [...] . build +``` + +To display current configuration: +```sh +meson configure build +``` + +The above will only work after at least the following is done: +```sh +meson . build +``` + +### Quick build help + +How clean out the build and config and start fresh: +```sh +rm -rf build +``` + +How to make a dist tarball and check its build: +(must do it from git tree clone and commit all changes to git first) +```sh +ninja -C build dist +``` + +How to change prefix: +```sh +meson --prefix=/path/to/prefix . build +``` + +How to install in a specific destination directory for packaging: +```sh +DESTDIR=/path/to/destdir ninja -C build install +``` + +How to build with verbose output (full commands run): +```sh +ninja -C build -v +``` diff --git a/data/readme/efl.png b/data/readme/efl.png new file mode 100644 index 0000000000000000000000000000000000000000..b5cd21aae9a81aaed84bcfa8ace6e729e171c109 GIT binary patch literal 16283 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