HDFStore documentation PEP8-compliant

(This is to be applied after a PR from https://github.com/jreback/pandas/tree/pytables_update7, as it is based on it) 

This is my first PR and I am hoping to get right the github worfklow to start with 'real contibutions'. Any hints on how to PR better very welcome.