added mopre detailed comments (asdoc)