[doc] various info
sorting out testcase, and other changes
[ok] make run working with vim (xterm preffered)