I'd prefer to see Doxygen documentation of public PIOS functions.