Review return values

[maedoc]

• fill out in/out doxygen
• \return codes
• handle return codes properly in lib and test (comp flags)
• should complement error and log handler system