init rev2
various small fixes
init md documentation