update some comments related with OOIION-1495 (no changes in code)