Also document, rename unclear variables, and comment / XXX improvable areas


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