Tweaks to doc strings and comments in scheduler.