add missing header comment and update doblocks