clean up the commenting code
make the TAGS file autogenerate
update the doce to reflect the last few changes