complete the sourcecode comments
add documents built with docco
change arsenal descriptions