update inline documentation, see #74