------------------------
additional documentation
see comments in libs/*/*