added Jordan's explanations for dcml_private.c functions