document new methods, make _add_header private
add make clean target