I have extended the API in the comments and added comments related to precision support and to cumulative values in history lists

git-svn-id: https://svn.erp5.org/repos/public/erp5/trunk@9987 20353a03-c40f-0410-a6d1-a30d3c3de9de