update api documentation
reindent some code
change some emphasis in loop part
complete loop part with property class delcaration
modify loop pat