Clean up code to filter server transport options
Add code examples to get_public_options doc str

Further document BaseTransport's get_public_options
using a simple example torrc and code sample.
Merge branch 'david-transport-public-options' into david-bananaphone