DOC: Fixes to docstrings
- [X] xref #27979
- [ ] tests added / passed
- [ ] passes `black pandas`
- [ ] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry

Partially resolves issue 
Hello @realjohnward! Thanks for updating this PR. We checked the lines you've touched for [PEP 8](https://www.python.org/dev/peps/pep-0008) issues, and found:









* In the file [`pandas/io/pytables.py`](https://github.com/pandas-dev/pandas/blob/0273150d25146f22bdeec9127141618beae89a6d/pandas/io/pytables.py):

> [Line 1178:89](https://github.com/pandas-dev/pandas/blob/0273150d25146f22bdeec9127141618beae89a6d/pandas/io/pytables.py#L1178): [E501](https://duckduckgo.com/?q=pep8%20E501) line too long (99 > 88 characters)





##### Comment last updated at 2019-08-22 17:01:41 UTC just saw you did reference the issue in the PR, you can check how we usually do (the hash makes github create a link to this PR in the issue) Thank you @datapythonista for looking over this PR and requesting changes. I am creating another PR with the requested changes made.