fixed opening docstring to reflect recent major additions/changes