software: add more comments