Add comments to files

Add comments and description in several methods and parameters;
Some methods/parameters are not documented yet, those are labeled as
"Add xxx description here";
Add warnings of possible incomplete method implementation;