Clarify docstrings for :value-fn

See comments on DJSON-12, especially:
http://dev.clojure.org/jira/browse/DJSON-12?focusedCommentId=31605&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-31605