new manual
misc fixes
better comments