updated inline docs (cntd)