cleanup coms, added docs, cleanup public interface