we are using Sphinx-like syntax, so this would be `param`, not `input` and the syntax would be like:

    :param db:  database connection

It is just better to stick with one syntax, otherwise reading different styles becomes distracting