added KM; updated & improved doc