h1. ANNA

Multi-purpose C++ development suite, focused on Telco resources (communications, protocols and tools).
ANNA is acronym for "Anna is not nothingness anymore", that is to say: "Anna is something to take into
account" (like a SONaTINA).

ANNA is a complete suite of tools and resources to build proffesional applications with minimum cost.

h2. Revision control

Based on GIT, hosted on www.bitbucket.org.

You could use my pre-commit specific template if you want to do some basic checkings (i.e.
 astyle code processing): Execute './scr/git/use-pre-commit.sh'

h2. Documentation

Execute 'scons doc'

h2. Unit tests

Execute 'scons test'

h2. Examples

Execute 'scons example' to generate example binaries

h2. Install

Execute 'scons install'
(install-include-and-lib and install-example, are another aliases for selective installation)

h2. Uninstall

Execute 'scons uninstall'



h2. Some basic ubuntu requirements

h3. Scons python-based building suite:
     sudo apt-get install scons

h3. OpenSSL:
     sudo apt-get install libssl-dev
 
h3. Gnome XML:
     sudo apt-get install libxml2-dev

h3. OpenLDAP:
     sudo apt-get install libldap2-dev

h3. MySql:
     sudo apt-get install libmysqlclient-dev

h3. Oracle:
     https://help.ubuntu.com/community/Oracle%20Instant%20Client
     Set 'ORACLE_HOME' environment variable in your profile, i.e.:
        export ORACLE_HOME=/usr/lib/oracle/12.1/client64/

     Be sure to create in that directory, a link to oracle includes,
     for example:

	<user>@<host>:/usr/lib/oracle/12.1/client64$ ls -lrt
	total 8
	drwxr-xr-x 2 root root 4096 Feb 28 15:59 bin
	drwxr-xr-x 2 root root 4096 Feb 28 15:59 lib
	lrwxrwxrwx 1 root root   33 Feb 28 16:07 include -> /usr/include/oracle/12.1/client64

     The alternative is to edit SConstruct file directly to set
     oracle includes directory.

h3. Oracle-OpenLDAP conflict:
     as usual, Oracle is doing things very bad. Move the ldap.h from oracle includes, i.e.:

        cd /usr/include/oracle/12.1/client64
        sudo mv ldap.h ldap.h.orig

h3. Boost:
     Although the more i use, the more i dislike, this suite is included (ambition to learn
     new things...):

        sudo apt-get install libboost-dev
        sudo apt-get install libboost-test-dev