From 81e3f753da5ab2edc3a0cb2ba7576dffbb0863ed Mon Sep 17 00:00:00 2001 From: Daniel Kolesa Date: Mon, 20 Apr 2015 14:38:18 +0100 Subject: [PATCH] elua lib: start adding documentation --- src/lib/elua/Elua.h | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) 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 #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 -- 2.7.4