summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorJosé Bollo <jose.bollo@iot.bzh>2015-12-29 12:40:47 +0100
committerJosé Bollo <jose.bollo@iot.bzh>2015-12-29 12:40:47 +0100
commit17c7bedf81a10d204724a7fbe41d02d71349aac9 (patch)
treed267ffb03fa56830c7d30726bbac2bd7dcbd4003 /README.md
parent641fb1f9cf4e18e960adf47a5c5cf20f77b445d4 (diff)
README: more documentation
Change-Id: Ib8293faffc5e81bb84b5de92a97e3ae69a9dabcf
Diffstat (limited to 'README.md')
-rw-r--r--README.md101
1 files changed, 97 insertions, 4 deletions
diff --git a/README.md b/README.md
index a763b27..c8995c4 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,107 @@
-= Summary
+# afm-main
-This is the package **afm-main**.
-It stands for **AGL Framework Master - Main**.
+## Overview
-This package is providing few less behaviour that
+This repository is named **afm-main** because
+it stands for **AGL Framework Master - Main**.
+
+It contains programs and services to create widgets,
+to install widgets, to run widgets.
+
+## How to compile?
+
+This project uses CMAKE and C compiler suite to be compiled.
+
+### Dependencies
+
+This package requires the following libraries or modules:
+
+- ***libxml-2.0***
+- ***openssl***
+- ***xmlsec1***
+- ***xmlsec1-openssl***
+- ***json-c***
+- ***dbus-1***
+
+This package also requires either ***libzip*** (version >= 0.11)
+or the binaries ***zip*** and ***unzip***. By default, it will
+use ***libzip***.
+
+### Compiling
+
+The main scheme for compiling the project is:
+
+> cmake .
+> make
+> sudo make install
+
+By default, the installation is made in ***/usr***.
+To change this behaviour, you should set the variable
+CMAKE_INSTALL_PREFIX as in the below example:
+
+> cmake -DCMAKE_INSTALL_PREFIX=$(pwd)/root .
+
+You could check the documentation of the standard CMake module
+[GNUInstallDirs](https://cmake.org/cmake/help/v3.4/module/GNUInstallDirs.html).
+
+To forbid the use of ***libzip*** and replace it with the
+use of programs ***zip*** and ***unzip***, type:
+
+> cmake -DUSE_LIBZIP=0 .
+
+## Content
+
+This package content source files for several programs.
+The installed programs are:
+
+- ***afm-system-daemon***: D-Bus daemon to install,
+ uninstall, list the widgets.
+
+ It runs on the system bus.
+
+- ***afm-user-daemon***: D-Bus daemon to list
+ available widgets, to start, pause, resume, stop it.
+
+ It runs on the user session bus.
+
+- ***wgtpkg-info***: command line tool to display
+ informations about a widget file.
+
+- ***wgtpkg-installer***: command line tool to
+ install a widget file.
+
+- ***wgtpkg-pack***: command line tool to create
+ a widget file from a widget directory.
+
+- ***wgtpkg-sign***: command line tool to add a signature
+ to a widget directory.
+
+## Comparison with Tizen framework
+
+This package is providing few less behaviour than
the following Tizen packages:
+
- platform/appfw/app-installers
- platform/core/security/cert-svc
- platform/core/appfw/ail
- platform/core/appfw/aul-1
- platform/core/appfw/libslp-db-util
+## Links
+
+### Details about widgets
+
+
+### Details about dependencies
+
+For details, you can dig into internet the following links:
+
+- [libxml2](http://xmlsoft.org/html/index.html)
+- [OpenSSL](https://www.openssl.org)
+- [XMLSec](https://www.aleksey.com/xmlsec)
+- [JSON-c](https://github.com/json-c/json-c)
+- [D-Bus](http://www.freedesktop.org/wiki/Software/dbus)
+- [libzip](http://www.nih.at/libzip)
+- [CMake](https://cmake.org)
+