Improved comments and made some formatting improvements

Also, removed unused member meant to store an observer ID for the
internal piecewise scalar function in
vtkDiscretizableColorTransferFunction.

Change-Id: I38f4d730e86cc0bed2cd13574c89d1d307136ab7
Merge topic 'transfer_function_cleanup' into master

c723181a Improved comments and made some formatting improvements