convert control file doc to markdown
update gitignore
fix yard warning
add inst files documentation