improved the documentation in "common.js"