Doc: libpe_status: document API

It was likely an oversight that status.h never had \ingroup doxygen markup
to build the API documentation. However we will use this opportunity to
declare that the API is now public.