some more comments.
Also document the features of private API functions a bit better and more elaborate.
Use overloading instead of negative ROC id values for iterating
over all ROCs available.
Comment change.