addressing @authmillenon's comments and fixed another comment to meet coding conventions
added "must not be NULL" to doxygen docs in cib.h where needed