all comments for the former public "low level" interface have been removed

since they were out-of-date and not correct anymore.

moved around some struct fields