CDRIVER-1979 simpler RST markup

Now :symbol:`function()` and :symbol:`function` work the same, but let
you choose whether to display parentheses.