doxygen: refactored doxygen in libbsp to illustrate new rule set