Document the reconnect implementation options

The default of trying to reconnect forever particularly needs to be
undocumented.
Merge pull request #189 from sam-github/document_reconnect

Document the reconnect implementation options