Edit tor-error comment to reflect shared ideas

This edits the comment in tor-error/lib.rs to better reflect (I hope) what we agreed on (I hope) at today's discussion.

I'm going to try to use this as my basis for revising ErrorKinds (again).

Part of #348 (closed)