A bit of tidying, adding comments and removing dead code in preparation
from BOUT++ workshop.