add some comments to explain the twisted nature of this driver