add documentation of all public functions and stucts
rename include to less generic name
change include in test code and add comments
change include filename in Makefile.am
remove automatically generated Makefile from git