added some rubydoc comments for on*_nl cases