TimeSeries.read is poorly documented

The TimeSeries.read method is poorly documented. One user tried the following:

data = TimeSeries.read('/archive/frames/A6/raw/H1/H-H1_R-11112/H-H1_R-1111231744-64.gwf', 'H1:LSC-DARM_IN1_DQ', 1111231750, 1111231770)

which should work, but doesn't because of the way the keyword arguments are passed around.

Improvements need to be made to the keyword argument handling, and the docstring for the read() classmethod.