removed @abstract for consistency
added documentation to other main public header