From: Daniel Kolesa <d.kolesa@osg.samsung.com>
Date: Mon, 20 Apr 2015 13:38:18 +0000 (+0100)
Subject: elua lib: start adding documentation
X-Git-Tag: v1.15.0-alpha1~752^2~32
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=81e3f753da5ab2edc3a0cb2ba7576dffbb0863ed;p=platform%2Fupstream%2Fefl.git

elua lib: start adding documentation
---

diff --git a/src/lib/elua/Elua.h b/src/lib/elua/Elua.h
index 81a6421..bd4b20b 100644
--- a/src/lib/elua/Elua.h
+++ b/src/lib/elua/Elua.h
@@ -52,6 +52,50 @@ extern "C" {
 # include <config.h>
 #endif
 
+/**
+ * @page elua_main Elua library (BETA)
+ *
+ * @date 2015 (created)
+ *
+ * @section toc Table of Contents
+ *
+ * @li @ref elua_main_intro
+ * @li @ref elua_main_compiling
+ * @li @ref elua_main_next_steps
+ *
+ * @section elua_main_intro Introduction
+ *
+ * The Elua library provides all necessary infrastructure required to set up
+ * a fully functional Lua state able of running Elua scripts. This is provided
+ * as a library in order to encourage reuse from different libraries and apps.
+ *
+ * @section elua_main_compiling How to compile
+ *
+ * As Elua is a library, compiling is very simple.
+ *
+ * Compiling C or C++ files into object files:
+ *
+ * @verbatim
+   gcc -c -o main.o main.c `pkg-config --cflags elua`
+   @endverbatim
+ *
+ * Linking object files into a binary executable:
+ *
+ * @verbatim
+   gcc -o my_application main.o `pkg-config --libs elua`
+   @endverbatim
+ *
+ * See @ref pkgconfig
+ *
+ * @section elua_main_next_steps Next Steps
+ *
+ * There is a comperehensive API reference available that should get you up
+ * and running.
+ *
+ * @addtogroup Elua
+ * @{
+ */
+
 #ifdef EFL_BETA_API_SUPPORT
 
 #include <Eina.h>