fix populate.clj's usage of functions from other namespaces
add comments about usage.