compile a module:

It is really simple:

 lutin yourModuleName
 #example:
 lutin etk

Option working:

Lutin have a complex option methodologie. We can consider 3 part of the option:

global option
target option
modules

Global options:

Globals option is parse first and manage global setting of the build (not specific of a target)

this keep the last value config set

Display help:

Availlable everywhere ...

1 lutin -h

2 lutin --help

You can see in this help that it take a litle time to react. The first time you run lutin, it parse all the file in your sub-directory. But the system(OS) keep the data in cash, then the next time it is faster.

At the end of the help you an see an help about the etk librery with the associated help.

Build in color:

1 lutin -C

2 lutin --color

Display build line in pretty print mode:

when an error apear, the gcc or clang compile line can be really unreadable:

1 g++ -o /home/heero/dev/plop/out/Linux_x86_64/release/build/gcc/etk/obj/etk/Color.cpp.o -I/home/heero/dev/plop/etk -std=c++11 -D__CPP_VERSION__=2011 -D__TARGET_OS__Linux -D__TARGET_ARCH__x86 -D__TARGET_ADDR__64BITS -D_REENTRANT -DNDEBUG -O3 -fpic -D__STDCPP_GNU__ -Wall -Wsign-compare -Wreturn-type -Wno-write-strings -Woverloaded-virtual -Wnon-virtual-dtor -Wno-unused-variable -DMODE_RELEASE -c -MMD -MP /home/heero/dev/plop/etk/etk/Color.cpp

whith this option you can transform this not obvious line in a readable line:

1 lutin -P

2 lutin --pretty

result:

 g++ \
     -o /home/XXX/dev/out/Linux_x86_64/release/build/gcc/etk/obj/etk/Color.cpp.o \
     -I/home/XXX/dev/etk \
     -std=c++11 \
     -D__CPP_VERSION__=2011 \
     -D__TARGET_OS__Linux \
     -D__TARGET_ARCH__x86 \
     -D__TARGET_ADDR__64BITS \
     -D_REENTRANT \
     -DNDEBUG \
     -O3 \
     -fpic \
     -D__STDCPP_GNU__ \
     -Wall \
     -Wsign-compare \
     -Wreturn-type \
     -Wno-write-strings \
     -Woverloaded-virtual \
     -Wnon-virtual-dtor \
     -Wno-unused-variable \
     -DMODE_RELEASE \
     -c \
     -MMD \
     -MP \
     /home/XXX/dev/etk/etk/Color.cpp

lutin log:

Lutin have an internal log system. To enable or disable it just select your debug level with the option:

1 lutin -v4

2 lutin --verbose 4

The level availlables are:

0: None
1: error
2: warning (default)
3: info
4: debug
5: verbose
6: extreme_verbose

Select the number of CPU core used:

By default lutin manage only 1 CPU core (faster to debug) but for speed requirement you can use use multiple core:

 #for 5 core
 lutin -j5
 lutin --jobs 5

Force rebuild all:

Sometime it is needed to rebuild all the program, just do:

 lutin -B
 lutin --force-build
 # or remove the build directory
 rm -rf out/

Force strip all library and programs:

Force strip of output binary (remove symboles)

1 lutin -s

2 lutin --force-strip

Manage Cross compilation:

The main objective of lutin is managing the cross compilation to build from linux to other platform:

For android you can use:

1 lutin -t Android your-module

2 lutin -t Windows your-module

Build in debug mode:

To developp it is fasted with debug tools

1 lutin -m debug your-module

2 lutin -m release your-module

You can desire to have compilation optimisation when you build in debug mode:

1 lutin -m debug --force-optimisation your-module

Execute your program after building it:

You can execute some action in a single line for a module:

1 lutin -m debug your-module?clean?build?run:--run-option1:--run-option2

Why use ?run istead of direct calling the binary?

This is simple: you does nok knoww where the binary is installed... when you build for linux in debug it will be set in out/Linux_x86_64/debug/staging/clang/edn/edn.app/ for edn application. Note that the path is distinct for gcc/clang, debug/release, Linux/windows/Android/..., 64/32 bits, and for every applications ...

Then it is really easy to run the wrong binary.

Install your program after building it:

You can install your build module:

1 lutin -m debug your-module?build?install

This option is not availlablke on all platform ...

Index:

Table of Contents